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 desconhecida
play(): 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).