Compartir a través de

API de pistas de 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.

Un recurso de Media Services contiene archivos multimedia en la cuenta de almacenamiento de Azure asociada. Estos archivos contienen los datos de las pistas de audio, vídeo y texto. La API de pistas permite comprender y administrar las pistas que se encuentran en el recurso. Las pistas las usa un reproductor de vídeo DASH o HLS para presentar el audio, el vídeo y los subtítulos o subtítulos (texto) a la audiencia. Un punto de conexión de streaming de Media Services comunica información sobre las pistas a un reproductor a través de manifiestos DASH o listas de reproducción HLS cuando se solicitan.

Con la API de pistas puede:

  • Obtener la lista de pistas de audio, vídeo y texto en un recurso.
  • Agregue o quite pistas de texto.
  • Agregue o quite pistas de audio.
  • Especifique los atributos de accesibilidad de las pistas de texto o audio.
  • Edite la pista en el Azure Portal o descárguelo y cárguelo de nuevo en el recurso.
  • Muestra u oculta una pista de texto en un reproductor de vídeo.

Nota

Solo puede agregar o actualizar una pista de texto en un recurso de vídeo a petición (VOD). Además, el enlace en tiempo de ejecución de audio no es compatible con los recursos de streaming en vivo.

Pistas de texto

Uso de pistas de texto con medios generados localmente

Después de generar un vídeo localmente y exportar los subtítulos, puede cargar esos subtítulos en el recurso que contiene los medios a petición.

Flujo de trabajo general para usar pistas de texto con texto generado localmente:

  1. Cree un vídeo y exporte subtítulos a un archivo que esté en formato VTT o TTML.
  2. Traduzca o edite el archivo VTT o TTML y guarde las copias para:
    1. Un seguimiento de un idioma adicional con texto descriptivo para cumplir los requisitos de accesibilidad.
    2. Pista de texto adicional para el comentario del director.
  3. IMPORTANTE: Debe agregar el designador de idioma al encabezado VTT para que se muestre el idioma correcto en el reproductor cliente. Por ejemplo:
    WEBVTT
Language: en-us
  4. Cargue el vídeo en Media Services.
  5. Cree una transformación y un trabajo para codificar el vídeo.
  6. Cargue las pistas de texto adicionales.

Uso de pistas de texto con transcripción en directo

Cuando la transcripción en directo está activada para un evento en directo, se crea una pista de texto webVTT adicional además de la pista de transcripción en vivo en tiempo real que ven los espectadores en el reproductor de vídeo en directo. Este archivo WebVTT contiene la mejor versión de la transcripción en directo que contiene oraciones completas en lugar de los resultados parciales y en tiempo real. Puede descargar el archivo .vtt después de que toda la transcripción esté disponible y se elimine la salida en directo.

Advertencia

Los archivos VTT finales de la transcripción en directo generados automáticamente se retrasan para su procesamiento. A menos que espere varios minutos para eliminar una salida en directo, el contenido del archivo se truncará. Además, la transcripción en directo no está disponible para su uso con varias secuencias de entrada de un evento en directo.

Flujo de trabajo general para usar pistas de texto de transcripción en directo:

  1. Cree un evento en directo con la transcripción en directo habilitada y con el idioma de origen seleccionado.
  2. Cuando finalice el evento en directo, espere varios minutos y, a continuación, elimine la salida en directo. El recurso archivado estará disponible para el streaming a petición. Las direcciones URL de streaming válidas seguirán siendo accesibles para los espectadores.
  3. Enumere las pistas en el recurso archivado o visualícelas en el portal. Habrá un archivo WebVTT que contenga la transcripción NBest. Tendrá una extensión .vtt. El archivo se denomina auto-generated-best_XXX.vtt.
  4. Edite el archivo VTT en el Azure Portal o descárguelo y edítelo.
  5. Para presentar la pista de texto en varios idiomas, traduzca la pista de texto de origen a esos idiomas y guárdelas como archivos independientes para cada idioma mediante la extensión .vtt.
  6. Cargue la pista de idioma de origen y las pistas de texto de cada idioma.
  7. Si no usa el Azure Portal para cargar el archivo, edite (o actualice) el archivo .ism para indicar al reproductor qué pistas de texto usar, así como su etiquetado y visibilidad por:
    1. Uso de la API de pistas para actualizar el manifiesto mediante programación mediante uno de los SDK o la CLI:
      1. Node.JS
      2. Python
      3. .Red
      4. CLI

Importante

Al actualizar el archivo .ism, asegúrese de ocultar la pista de texto de transcripción en directo y muestre la pista de texto en el idioma adecuado para el visor.

Pistas de audio

Puede agregar pistas de audio adicionales a un recurso para proporcionar a los espectadores audio en distintos idiomas, agregar audio descriptivo para accesibilidad o agregar comentarios del director.

Flujo de trabajo general para pistas de audio

  1. Cree pistas de audio adicionales para el evento en directo. Pueden ser audio en diferentes idiomas o audio descriptivo que se usa para la accesibilidad. También puede usar una pista de audio para el comentario del director.
  2. Cargue las pistas de audio en el recurso archivado.
  3. Actualice los datos de seguimiento editando el archivo de manifiesto en el portal o actualizando los datos de pista mediante REST o un SDK.

Nota

Cuando se quita una pista de audio o texto, el archivo subyacente no se quita del contenedor de almacenamiento. Media Services establece el empaquetador dinámico (punto de conexión de streaming) para que no muestre la información sobre la pista en el manifiesto o la lista de reproducción solicitada por el reproductor de vídeo.

Para obtener los pasos de la API de pistas, consulte los ejemplos siguientes.

Ejemplos

Procedimientos, tutoriales y guías de inicio rápido

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: