API doc for advanced microphone

last pull request for a while!