Guía de migración basada en escenarios de codificación

  • Artículo

logotipo de la guía de migración

pasos de migración 2

Importante

Ya no es necesario migrar de Azure Media Service v2 a v3, ya que el desuso de la API V2 se alineará con la retirada de Azure Media Services. Consulte la guía de retirada de Azure Media Services para más información.

En este artículo se proporcionan instrucciones basadas en escenarios de codificación que le ayudarán a migrar de Azure Media Services v2 a v3.

Requisitos previos

Antes de empezar a cambiar el flujo de trabajo de codificación, debe comprender las diferencias en la forma en que se administra el almacenamiento. En AMS v3, se usa la API de Azure Storage para administrar las cuentas de almacenamiento asociadas a su cuenta de Media Services.

Nota

Los trabajos y las tareas creados en v2 no se muestran en v3, ya que no están asociados con una transformación. Se recomienda cambiar a transformaciones y trabajos de v3.

Comparación de flujo de trabajo de codificación

Dedique unos minutos a examinar los siguientes diagramas de flujo para ver una comparación visual de los flujos de trabajo de codificación de v2 y v3.

Flujo de trabajo de codificación de v2

Haga clic en la imagen siguiente para ver una versión más grande.

Flujo de trabajo de codificación para v2

  1. Configuración
    1. Cree un recurso o use uno existente. Si usa un recurso nuevo, cargue el contenido en dicho recurso. Si usa un recurso existente, debe codificar los archivos que ya existen en el recurso.
    2. Obtenga los valores de los elementos siguientes:
      • Id. u objeto del procesador de multimedia
      • Cadena del codificador (nombre) que quiere usar
      • Id. del recurso nuevo o existente
    3. Para la supervisión, cree una suscripción de notificación de nivel de trabajo o tarea, o un controlador de eventos de SDK.
  2. Cree el trabajo que contiene las tareas. Cada tarea debe incluir los elementos anteriores, además de los siguientes:
    • Una directiva para indicar que es necesario crear un recurso de salida. El sistema crea el recurso de salida.
    • El nombre opcional del recurso de salida.
  3. Envíe el trabajo.
  4. Supervise el trabajo.

Flujo de trabajo de codificación de v3

Flujo de trabajo de codificación para v3

  1. Configurar
    1. Cree un recurso o use uno existente. Si usa un recurso nuevo, cargue el contenido en dicho recurso. Si usa un recurso existente, debe codificar los archivos que ya existen en el recurso. No debe cargar más contenido en ese recurso.
    2. Cree un recurso de salida. El recurso de salida es el lugar en el que se almacenarán los archivos codificados y los metadatos de entrada y salida.
    3. Obtenga los valores de la transformación:
      • Valor preestablecido de codificador estándar
      • Grupo de recursos de AMS
      • Nombre de cuenta de AMS
    4. Cree la transformación o use una existente. Las transformaciones se pueden reutilizar. No es necesario crear una nueva transformación cada vez que quiera enviar un trabajo.
  2. Creación de un trabajo
    1. En el caso del trabajo, obtenga los valores de los siguientes elementos:
      • Nombre de la transformación
      • URI base de la dirección URL de SAS para el recurso, la ruta de acceso del origen HTTPS del recurso compartido de archivos o la ruta de acceso local de los archivos. El elemento JobInputAsset también puede utilizar un nombre de recurso como entrada.
      • Nombres de los archivos
      • Recursos de salida
      • Un grupo de recursos
      • Nombre de cuenta de AMS
  3. Use Event Grid para supervisar su trabajo.
  4. Envíe el trabajo.

Valores preestablecidos personalizados de codificación de v2 a v3

Si el código de v2 llamó al codificador Standard con un valor preestablecido personalizado, primero debe crear una nueva transformación con el valor preestablecido de codificador Standard personalizado antes de enviar un trabajo.

Los valores preestablecidos personalizados ahora están basados en JSON, no en XML. Vuelva a crear el valor preestablecido en JSON siguiendo el esquema de valores preestablecidos personalizados, tal como se define en la documentación de la Open API de transformaciones (Swagger).

Archivos de metadatos de entrada y salida de un trabajo de codificación

En la versión v2, se generan archivos de metadatos de entrada y salida como resultado de un trabajo de codificación. En la versión v3, el formato de metadatos cambió de XML a JSON. Para más información acerca de los metadatos, consulte Metadatos de entrada y Metadatos de salida.

Soluciones de codificador Premium a codificador Standard v3 o soluciones de partners

La API de v2 ya no es compatible con el codificador Premium. Si anteriormente usaba el codificador Premium basado en flujos de trabajo para la codificación de HEVC, debe migrar al nuevo codificador estándar de v3, que es compatible con la codificación de HEVC.

Si necesita las características avanzadas de flujo de trabajo del codificador Premium, le recomendamos que empiece a usar una de las soluciones de codificación avanzadas de Azure de algún partner, como Imagine Communications, Telestream o Bitmovin.

Trabajos con entradas que se encuentran en direcciones URL hospedadas en HTTPS

Ahora puede enviar trabajos en v3 a partir de archivos almacenados en Azure Storage, localmente o en servidores web externos gracias a la compatibilidad con entradas de trabajo HTTP(S).

Si anteriormente usaba flujos de trabajo para copiar archivos desde los archivos de blobs de Azure a activos vacíos antes de enviar los trabajos, puede simplificar el proceso al pasar una URL de SAS del archivo en Azure Blob Storage directamente al trabajo.

Transcripción de audio del indizador v1 al nuevo "modo básico" de AudioAnalyzer

En el caso de los clientes que usan el procesador del indizador v1 en la API v2, debe crear una transformación que invoque el nuevo AudioAnalyzer en [modo básico] antes de enviar un trabajo.

Conceptos, tutoriales y guías de procedimientos sobre codificación, transformaciones y trabajos

Obtener ayuda y soporte técnico

Puede ponerse en contacto con Media Services con preguntas o seguir nuestras actualizaciones mediante uno de los métodos siguientes: