Add player.dispose() API documentation to api.md
Fixed due to feedback from code review

Fixed due to feedback from code review
Merge pull request #655 from johneke/master

Add player.dispose() API documentation to api.md