Tutorial: Codificación de un archivo remoto según una dirección URL y transmisión del vídeo: .NET
¿Busca la documentación de Media Services, versión 2?
En este tutorial se muestra lo fácil que es codificar vídeos y comenzar a transmitirlos en streaming en una amplia variedad de exploradores y dispositivos con Azure Media Services. Se puede especificar contenido de entrada con direcciones URL de HTTPS, direcciones URL de SAS o rutas de acceso a archivos ubicados en Azure Blob Storage. El ejemplo de este tema permite codificar contenido que se hace accesible a través de una dirección URL HTTPS. Tenga en cuenta que, actualmente, AMS v3 no admite la codificación de transferencia fragmentada a través de direcciones URL de HTTPS.
Al final del tutorial, podrá transmitir un vídeo en streaming.
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
Requisitos previos
- Instale Visual Studio Code para Windows, macOS o Linux o Visual Studio 2019 para Windows o Mac.
- Instale el SDK para .NET 5.0.
- Cree una cuenta de Media Services. Asegúrese de copiar los detalles de acceso a la API en formato JSON o de almacenar los valores necesarios para conectarse a la cuenta de Media Services en el formato de archivo .env que se usa en este ejemplo.
- Siga los pasos que se indican en Acceso a la API de Azure Media Services con la CLI de Azure. Asegúrese de guardar las credenciales. Las necesitará para acceder a la API de este ejemplo, o bien deberá especificarlas en el formato de archivo .env.
Descarga y configuración del ejemplo
Clone un repositorio GitHub que contenga el ejemplo de .NET de streaming en la máquina con el siguiente comando:
git clone https://github.com/Azure-Samples/media-services-v3-dotnet-quickstarts.git
El ejemplo se encuentra en la carpeta EncodeAndStreamFiles, en EncodeAndStreamFiles.
Abra appsettings.json en el proyecto que ha descargado. Sustituya los valores por las credenciales que obtuvo de acceder a las API.
Nota
También puede usar el formato de archivo .env en la raíz del proyecto para establecer las variables de entorno solo una vez para todos los proyectos del repositorio de ejemplos de .NET. Solo tiene que copiar el archivo sample.env y rellenar la información que obtuvo de la página Acceso de API de Media Services en Azure Portal o la CLI de Azure. Cambie el nombre del archivo sample.env a solo .env para usarlo en todos los proyectos.
El archivo .gitignore ya está configurado para evitar su publicación en el repositorio bifurcado.
Este ejemplo realiza las acciones siguientes:
- Crea una transformación (antes comprueba si existe la transformación especificada).
- Crea un recurso de salida que se utiliza como salida del trabajo de codificación.
- Crea la entrada del trabajo, que se basa en una dirección URL HTTPS.
- Envía el trabajo de codificación mediante la entrada y salida que se creó previamente.
- Comprueba el estado del trabajo.
- Crea un objeto StreamingLocator.
- Crea direcciones URL de streaming.
Para obtener una explicación sobre qué hace cada función en el ejemplo, examine el código y observe los comentarios en este archivo de origen.
Ejecutar la aplicación de ejemplo
Al ejecutar la aplicación, se muestran las direcciones URL que se pueden usar para reproducir el vídeo con diferentes protocolos.
- Abra AMSV3Quickstarts en VSCode.
- Presione Control + F5 para ejecutar la aplicación EncodeAndStreamFiles con .NET. Esta operación puede tardar unos minutos.
- La aplicación mostrará tres direcciones URL. Usará estas direcciones URL para probar la secuencia en el paso siguiente.
En el código fuente del ejemplo, puede ver cómo se compila la dirección URL. Para compilarla, debe concatenar el nombre de host del punto de conexión del streaming y la ruta de acceso del localizador del streaming.
Prueba con Azure Media Player
Para probar el streaming, este artículo usa Azure Media Player.
Nota
Si el reproductor está hospedado en un sitio https, asegúrese de actualizar la dirección URL a "https".
Abra un explorador web y vaya a https://aka.ms/azuremediaplayer/.
En el cuadro Dirección URL: , pegue uno de los valores de la dirección URL de streaming que se obtuvo al ejecutar la aplicación.
Puede pegar la dirección URL en formato HLS, Dash o Smooth y Azure Media Player cambiará automáticamente a un protocolo de streaming adecuado en su dispositivo.
Presione Actualizar Player. Esto debería empezar a reproducir el archivo de vídeo en el repositorio.
Azure Media Player puede usarse para realizar pruebas, pero no debe usarse en un entorno de producción.
Limpieza de recursos
Si ya no necesita ninguno de los recursos del grupo de recursos, como las cuentas de almacenamiento y de Media Services que creó en este tutorial, elimine el grupo de recursos.
Ejecute el siguiente comando de la CLI:
az group delete --name amsResourceGroup
Examen del código
Para obtener una explicación sobre qué hace cada función en el ejemplo, examine el código y observe los comentarios en este archivo de origen.
El tutorial Carga, codificación y streaming de archivos proporciona un ejemplo de streaming más avanzado con explicaciones detalladas.
Códigos de error de trabajo
Consulte Códigos de error.
Subprocesamiento múltiple
Los SDK de Azure Media Services v3 no son seguros para subprocesos. Al trabajar con una aplicación que admite multithreading, debe generar un nuevo objeto AzureMediaServicesClient por subproceso.