Plugin media

org.apache.cordova.media

Referencias: http://docs.phonegap.com/en/edge/cordova_media_media.md.html

El plugin Media permite escuchar y grabar archivos de audio. La funcionalidad esta dada a traves de una clase Media:

var media = new Media(archivoDeAudio, mediaSuccess, [mediaError], [mediaStatus]);

• archivoDeAudio: {string} ruta al archivo que escucharemos/grabaremos
• mediaSuccess: {function} callback cuando la instancia se realiza con exito
• mediaError: {function} - Opcional, callback de error, se ejecuta ante un error
• mediaStatus: {function} - Opcional, una funcion a ejecutar cuando la instancia (media) cambia de estados (play, stop, etc)

MediaStatus

El plugin define estas constantes, que son los valores que puede recibir la funcion mediaStatus:

• Media.MEDIA_NONE = 0;
• Media.MEDIA_STARTING = 1;
• Media.MEDIA_RUNNING = 2;
• Media.MEDIA_PAUSED = 3;
• Media.MEDIA_STOPPED = 4;

Metodos

La instancia de Media obtiene estos metodos:

• media.getCurrentPosition: devuelve la posicion de reproduccion del archivo de audio.
• media.getDuration: devuelve la duracion del archivo de audio.
• media.play: Reproducir o continuar reproduciendo el archivo de audio.
• media.pause: Pausar la reproduccion del archivo de audio.
• media.release: Liberar el recurso del archivo, tanto el audio como el sistema de archivos.
• media.seekTo: Mueve la posicion de reproduccion.
• media.setVolume: Modifica el volumen de reproduccion.
• media.startRecord: Comienza a grabar el archivo de audio.
• media.stopRecord: Detiene la grabacion de un archivo de audio.
• media.stop: Detiene la reproduccion del archivo de audio.

Propiedades

Ademas, la instancia de Media tiene estas propiedades solo lectura (en realidad pueden sobreescribirse, pero no es la idea).

• position: La posicion del cursor en el archivo de audio, en segundos.
  • No se actualiza automaticamente durante la reproduccion del archivo, hay que llamar a getCurrentPosition() para actualizar.
• duration: la duracion del archivo de audio, en segundos.

Para ver cada uno de los metodos y propiedades, hagamos un ejercicio