Reutilizar o quitar una instancia de MediaPlayer

Puede restablecer, reutilizar o liberar una instancia de MediaPlayer que ya no necesite.

Restablecer o reutilizar una instancia de MediaPlayer

Puede restablecer una instancia MediaPlayer para devolverla a su estado IDLE no inicializado definido en MediaPlayerStatus. También puede reemplazar el elemento de medios actual o establecer uno nuevo mediante un recurso de medios cargado previamente.

Esta operación resulta útil en los siguientes casos:

• Desea reutilizar una instancia MediaPlayer pero debe cargar un nuevo MediaResource (contenido de vídeo) y reemplazar la instancia anterior.

  El restablecimiento le permite reutilizar la instancia MediaPlayer sin necesidad de liberar recursos, volver a crear MediaPlayer y reasignar recursos. El método replaceCurrentItem realiza automáticamente estos pasos.

• Cuando el MediaPlayer está en estado ERROR y debe borrarse.

  IMPORTANTE

  Esta es la única manera de recuperarse del estado ERROR.

1. Llame a MediaPlayer.reset() para devolver la instancia MediaPlayer a su estado no inicializado:

   reset(); // returns AdobePSDK.PSDKErrorCode.SUCCESS 
            // on successful reset
   

2. Llame a MediaPlayer.replaceCurrentItem() para cargar otro MediaResource

   SUGERENCIA

   Para borrar un error, cargue el mismo MediaResource.

3. Llame al método prepareToPlay() .

   NOTA

   Cuando reciba el evento MediaPlaybackStatusChangeEvent.STATUS_CHANGED con el estado PREPARADO, puede iniciar la reproducción.

Liberar una instancia y recursos de MediaPlayer

Debe liberar una instancia y recursos MediaPlayer cuando ya no necesite MediaResource.

Estas son algunas razones para publicar un MediaPlayer:

• Mantener recursos innecesarios puede afectar al rendimiento.

• Dejar un objeto MediaPlayer innecesario puede llevar a un consumo continuo de batería para dispositivos móviles.

• Si en un dispositivo no se admiten varias instancias del mismo códec de vídeo, puede ocurrir un error de reproducción en otras aplicaciones.

• Suelte el MediaPlayer.

  void release()
  

  NOTA

  Una vez lanzada la instancia MediaPlayer, ya no puede usarla. Si se llama a algún método de la interfaz MediaPlayer después de su lanzamiento, se genera un IllegalStateException.