Autenticación DRM antes de la reproducción

Cuando los metadatos DRM de un vídeo son independientes del flujo de medios, debe autenticarse antes de comenzar la reproducción.

Un recurso de vídeo puede tener asociado un archivo de metadatos DRM, por ejemplo,:

  • "url": "https://www.domain.com/asset.m3u8"
  • "drmMetadata": "https://www.domain.com/asset.metadata"

En este ejemplo, puede utilizar DRMHelper métodos para descargar el contenido del archivo de metadatos DRM, analizarlo y comprobar si se necesita autenticación DRM.

  1. Uso loadDRMMetadata para cargar el contenido de la URL de metadatos y analizar los bytes descargados en una DRMMetadata.

    SUGERENCIA

    Este método es asincrónico y crea su propio subproceso.

    public static void loadDRMMetadata(
    final DRMManager drmManager,
    final String drmMetadataUrl,
    final DRMLoadMetadataListener loadMetadataListener);

    Por ejemplo:

    DRMHelper.loadDRMMetadata(drmManager,
                                   metadataURL,
                                   new DRMLoadMetadataListener());

  2. Notificar al usuario que esta operación es asincrónica; es aconsejable advertir al usuario de ello.

    Si los usuarios no saben que la operación es asincrónica, es posible que se pregunten por qué no ha comenzado la reproducción todavía. Por ejemplo, se puede mostrar una rueda giratoria mientras se descargan y analizan los metadatos de DRM.

  3. Implementar las llamadas de retorno en DRMLoadMetadataListener.

    El loadDRMMetadata llama a estos controladores de eventos.

    public interface DRMLoadMetadataListener {

    public void onLoadMetadataUrlStart();

    /**
    * @param authNeeded
    * whether DRM authentication is needed.
    * @param drmMetadata
    * the parsed DRMMetadata obtained.    */
    public void onLoadMetadataUrlComplete(boolean authNeeded, DRMMetadata drmMetadata);
    public void onLoadMetadataUrlError();
}

    Estos son detalles adicionales sobre los controladores:

    • onLoadMetadataUrlStart detecta cuándo ha comenzado la carga de la URL de metadatos.
    • onLoadMetadataUrlComplete detecta cuándo ha terminado de cargarse la dirección URL de metadatos.
    • onLoadMetadataUrlError indica que los metadatos no se han podido cargar.

  4. Una vez finalizada la carga, revise el DRMMetadata para determinar si es necesaria la autenticación DRM.

    public static boolean isAuthNeeded(DRMMetadata drmMetadata);

    Por ejemplo:

    @Override
public void onLoadMetadataUrlComplete(boolean authNeeded, DRMMetadata drmMetadata) {
    Log.i(LOG_TAG + "#onLoadMetadataUrlComplete",
          "Loaded metadata URL contents. Auth needed:" + authNeeded + ".");
    if (!authNeeded) {
        // Auth is not required. Start player activity.
        showLoadingSpinner(false);
        startPlayerActivity(ASSET_URL);
        return;
    }
}

  5. Complete una de las siguientes tareas:

    • Si no se requiere autenticación, inicie la reproducción.

    • Si se requiere autenticación, complete la autenticación adquiriendo la licencia.

      /**
* Helper method to perform DRM authentication.
*
* @param drmManager
* the DRMManager, used to perform the authentication.
* @param drmMetadata
* the DRMMetadata, containing the DRM specific information.
* @param authenticationListener
* the listener, on which the user can be notified about the
* authentication process status.
*/
public static void performDrmAuthentication(
     final DRMManager drmManager,
     final DRMMetadata drmMetadata,
     final String authUser,
     final String authPass,
     final DRMAuthenticationListener authenticationListener);

      En este ejemplo, para simplificar, el nombre y la contraseña del usuario se codifican explícitamente:

      DRMHelper.performDrmAuthentication(drmManager,
                                   drmMetadata,
                                   DRM_USERNAME,
                                   DRM_PASSWORD, new DRMAuthenticationListener() {
    @Override
    public void onAuthenticationStart() {
        Log.i(LOG_TAG + "#onAuthenticationStart", "DRM authentication started.");
        // Spinner is already showing.
    }
    @Override
    public void onAuthenticationError(int major,
                                      int minor,
                                      String errorString,
                                      String serverErrorURL) {
        Log.e(LOG_TAG +
              "#onAuthenticationError",
              "DRM authentication failed. " +
              major + " 0x" + Long.toHexString(minor));
        showToast(getString(R.string.drmAuthenticationError));
        showLoadingSpinner(false);
    }
    @Override
    public void onAuthenticationComplete(byte[] authenticationToken) {
        Log.i(LOG_TAG +
              "#onAuthenticationComplete", "Auth successful. Launching content.");
        showLoadingSpinner(false);
        startPlayerActivity(ASSET_URL);
    }
});

  6. Utilice un detector de eventos para comprobar el estado de autenticación.

    Este proceso implica la comunicación en red, por lo que también es una operación asincrónica.

    public interface DRMAuthenticationListener {
    /**
    * Called to indicate that DRM authentication has started.
    */
    public void onAuthenticationStart();
    /**
    * Called to indicate that DRM authentication has been successful.
    *
    * @param authenticationToken
    * the obtained token, which can be stored locally.
    */
    public void onAuthenticationComplete(byte[] authenticationToken);
    /**
    * Called to indicate that an error occurred while performing the DRM
    * authentication.
    *
    * @param major
    * the major code.
    * @param minorC
    * the minor code.
    * @param errorString
    * the exception thrown.
    * @param serverErrorURL
    * the URL of the server
    * on which the error occurred
    */
    public void onAuthenticationError(int major,
                                      int minor,
                                      String errorString,
                                      String serverErrorURL);
}

  7. Si la autenticación se realiza correctamente, inicie la reproducción.

  8. Si la autenticación no se realiza correctamente, notifique al usuario y no inicie la reproducción.

    La aplicación debe gestionar cualquier error de autenticación. Si no se autentica correctamente antes de reproducir, TVSDK se coloca en un estado de error y la reproducción se detiene. La aplicación debe resolver el problema, restablecer el reproductor y volver a cargar el recurso.

En esta página