Mediaphone MEDIA e uma API que permite a gravar e reproduo de udio no smartphone , podendo tocar ficheiros armazenados localmente ou remotamente (Internet).No Phonegap o objecto medi tem 3 parametros, onde dois so opcionais:Src: esta e a URI onde se encontra o arquivo.mediaSucesso: esta e uma funo de Callback que e opcional, e invocada quando depois de objecto media completar a reproduo atual, gravao ou ao para a ao.mediaErro: esta e uma funo de Callback que e opcional, e invocada quando existe um erro na concretizao de uma ao.NB: E importante que as funes de CallBack estejam no escopo global da aplicao.A API Media permite a reproduo de qualquer formato de ficheiro udio no iOS e no Android, incluindo MP3. A gravao e meio diferente, pois no android pode gravar usando apenas a varivel bitrate e a extenso deve ser .3gp enquanto que no iOS suporta oformato WAV com extenso .wav.Algumas particularidades do iOS: Se o caminho refere-se a um recurso web (comea com http:// ou https://), o udio e reproduzido. Gravao no suportada. Se o caminho comea com document://, a localizao e assumida para ser relativa com as pastas dos documentos da apliacao. Se o caminho comea com cdvfile://, a localizao e relativa ao sistema de arquivos especificado. Por exemplo, cdvfile://localhost/persistent/ poderia referir ao Sistema de arquivo persistente, e cvvfile://localhost/temporary/ poderia referir pastas temporrias para a aplicao. Se o caminho e um caminho absoluto, a gravao ser feita nesse local, e a reproduo ser feita desde local Se o caminho e um caminho relativo, a gravao ser feita na pasta relativa ao app Na reproduo primeiro sera feita a verificao na pasta www para o arquivo e depois nas pastas temporrias.Algumas particularidades para Android: Se o caminho refere-se a um recurso web (comea com http:// ou https://), o udio e reproduzido. Gravao no suportada. Se o caminho comea com cdvfile://, a localizao e relativa ao sistema de arquivos especificado. Por exemplo, cdvfile://localhost/persistent/ poderia referir ao Sistema de arquivo persistente, e cvvfile://localhost/temporary/ poderia referir pastas temporrias para a aplicao. A Gravao e sempre feita em um diretrio temporrio e depois e movida para um diretrio especifico se possvel. Se a renomeao falhar o ficheiro temporrio permanecera no sistema d arquivos. Se o caminho e um caminho absoluto, a gravao ser movida de esse caminho para diretrio temporrio e a reproduo ser feita desde o local. SE o caminho e relativo, a gravao ira verificar se o carto SD foi montado, caso sim, o ficheiro gravado ser movido para o local relativo ao carto SD. Se o carto SD no esta montado, o ficheiro ser movido ao local relativo ao diretrio do cache da app(/data/data/package-name/cache/). Se o caminho comea com /android_asset/, a reproduo vai ocorrer do diretrio assets. Gravao no permitida. Metodos e propriedades:position: E usado para denotar a posio atual em segundos na reproduo do audio (no continuamente atualizado)duration: Devolver a duraa do audio em segundos. getCurrentPosition(): Chama se para saber a posio atualizada. Faz o callback com posio do udio.getDuration():Devolve a durao do audio. Tambem atribui a duraodo audio. As vezes a durao no e conhecida principalmente quando pretende-se tocar o audio remotamente, por isso e sempre bom verficar se o valor que retorna e menos -1 antes de visualizar a durao. No se assume que o valor da posio vai ser atualizada logo. E possivel receber o valor -1 quando a posio e desconhecidaplay(): comea a reproduo, caso esteja em pausa resume a reproduo.pause(): pausa a reproduo do audio. seekTo():Muda a posio do audio dando o tempo especifico em milisegundo. startRecord(): Comea a Gravao de uma sesso.stopRecord():para a Gravao de uma sesso. stop(): para a reproduo. f setVolume(): Atribui um volume a reproduo. release(): LIbera os recursos do sistema de audio(Muito importante no Android).