Transformaciones y trabajos en Media Services

  • Artículo

Logotipo de Media Services v3

Advertencia

Azure Media Services se retirará el 30 de junio de 2024. Para obtener más información, consulte la Guía de retirada de AMS.

Sugerencia

¿Quieres generar miniaturas, unir dos vídeos, crear un subclip de vídeo o girarlo (entre otras cosas)? Puede encontrar códigos de ejemplo de Media Services en la página Ejemplos.

En este tema se proporcionan detalles sobre las transformaciones y los trabajos y se explica la relación entre estas entidades.

Flujo de trabajo típico

Una transformación es como una receta. Ayuda a crear la receta una vez (paso 1), y enviar trabajos mediante esa receta (paso 2).

  1. Crear una transformación.
  2. Enviar trabajos en esa transformación.
  3. Enumerar las transformaciones.
  4. Eliminar una transformación si no se planea usarla en el futuro.

Ejemplo

Imagine que desea extraer el primer fotograma de todos los vídeos como una imagen en miniatura; los pasos que debería seguir son:

  1. Definir la receta o regla para el procesamiento de los vídeos: "usar el primer fotograma del vídeo como la miniatura".
  2. Para cada vídeo, debería indicar lo siguiente al servicio:
    1. Dónde encontrar ese vídeo.
    2. Dónde escribir la imagen en miniatura de salida.

Nota

Las propiedades de Transformación y Trabajo del tipo Datetime siempre están en formato UTC.

Transformaciones

Use transformaciones para configurar tareas comunes para codificar o analizar vídeos. Cada Transformación describe una receta, o un flujo de trabajo simple de tareas para procesar los archivos de vídeo o audio. Una única transformación puede aplicar más de una regla. Por ejemplo, una transformación podría especificar que cada vídeo se codifique como un archivo MP4 con una velocidad de bits determinada, y que se genere una imagen en miniatura a partir del primer fotograma del vídeo. Tendría que agregar una entrada TransformOutput para cada regla que quiera incluir en la transformación. Para indicar a la transformación cómo se deben procesar los archivos multimedia de entrada, use los valores preestablecidos.

Visualización del esquema

En Media Services v3, los valores preestablecidos son entidades fuertemente tipadas en la propia API. Encontrará la definición de "esquema" de estos objetos en la especificación de Open API (o Swagger). También puede ver las definiciones preestablecidas (como StandardEncoderPreset) en la API REST y el SDK de .NET o en otra documentación de referencia del SDK de Media Services v3.

Creación de transformaciones

Puede crear transformaciones mediante REST, la CLI o cualquiera de los SDK publicados. Azure Resource Manager controla la API v3 de Media Services, por lo que también se pueden usar plantillas de Resource Manager para crear e implementar las transformaciones en la cuenta de Media Services. El control de acceso basado en roles de Azure se puede usar para bloquear el acceso a las transformaciones.

Actualización de transformaciones

Si necesita actualizar su transformación, use la operación de actualización. Está diseñada para realizar cambios en la descripción o las prioridades del elemento TransformOutputs subyacente. Debes completar las actualizaciones cuando finalicen todos los trabajos en curso. Si piensa volver a escribir la receta, deberá crear una nueva transformación.

Trabajos

Un trabajo es la solicitud real a Media Services de aplicar la transformación a un contenido de vídeo o audio de entrada determinado. Una vez creada la transformación, puede enviar trabajos mediante las API de Media Services o cualquiera de los SDK publicados. El trabajo especifica información como la ubicación del vídeo de entrada y la ubicación de la salida. Puede especificar la ubicación del vídeo de entrada mediante: direcciones URL HTTPS, direcciones URL SAS o recursos.

Entrada de trabajo desde HTTPS

Use una entrada de trabajo desde HTTPS si el contenido ya es accesible a través de una dirección URL y no necesita almacenar el archivo de código fuente en Azure (por ejemplo, importación de S3). Este método también es adecuado si tiene el contenido en Azure Blob Storage, pero no necesita que el archivo se encuentre en un recurso. Actualmente, este método solo admite un único archivo de entrada.

Recurso como entrada de trabajo

Use un recurso como entrada de trabajo si el contenido de entrada ya se encuentra en un recurso o si está almacenado en un archivo local. También es una buena opción si va a publicar el recurso de entrada para el streaming o la descarga (imagine que quiere publicar los mp4 para su descarga, pero también le interesa realizar conversión de voz en texto o detección de caras). Este método es compatible con varios recursos de archivos (por ejemplo, conjuntos de streaming de MBR codificados localmente).

Comprobación del progreso del trabajo

El progreso y estado de los trabajos se pueden obtener mediante la supervisión de eventos con Event Grid. Para obtener más información, vea Supervisión de eventos mediante EventGrid.

Actualización de los trabajos

La operación de actualización en la entidad Trabajo puede usarse para modificar las propiedades description y priority después de enviar el trabajo. Un cambio en la propiedad priority es eficaz solo si el trabajo todavía está en un estado en cola. Si el trabajo ha comenzado a procesarse o ha finalizado, cambiar la prioridad no tiene ningún efecto.

Ejemplos de codificación

Consulte la amplia lista de ejemplos de codificación para obtener una codificación.

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: