Creación de filtros con la CLI

Artículo
06/30/2023

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.

Al entregar su contenido a los clientes (streaming de eventos en vivo o vídeo bajo demanda), es posible que el cliente necesite más flexibilidad que la descrita en el archivo de manifiesto del recurso predeterminado. Azure Media Services le permite definir filtros de cuenta y filtros de recurso para su contenido.

Para obtener una descripción detallada de esta característica y los escenarios donde se utiliza, vea Manifiestos dinámicos y Filtros.

En este tema se muestra cómo configurar un filtro para un recurso Vídeo bajo demanda y usar la CLI para Media Services v3 para crear Filtros de cuenta y Filtros de recurso.

Nota

No olvide revisar presentationTimeRange.

Prerrequisitos

Cree una cuenta de Media Services. Asegúrese de recordar el nombre del grupo de recursos y el nombre de la cuenta de Media Services.

Definición de un filtro

En el siguiente ejemplo se definen las condiciones de selección de seguimiento que se agregan al manifiesto final. Este filtro incluye las pistas de audio con EC-3 y las pistas de vídeo con velocidad de bits en el intervalo 0 a 1000000.

Sugerencia

Si va a definir Filtros en REST, tenga en cuenta que deberá incluir el objeto JSON de contenedor "Properties".

[
    {
        "trackSelections": [
            {
                "property": "Type",
                "value": "Audio",
                "operation": "Equal"
            },
            {
                "property": "FourCC",
                "value": "EC-3",
                "operation": "NotEqual"
            }
        ]
    },
    {
        "trackSelections": [
            {
                "property": "Type",
                "value": "Video",
                "operation": "Equal"
            },
            {
                "property": "Bitrate",
                "value": "0-1000000",
                "operation": "Equal"
            }
        ]
    }
]

Creación de filtros de cuenta

El siguiente comando az ams account-filter crea un filtro de cuenta con selecciones de seguimiento de filtro definidas anteriormente.

El comando permite pasar un parámetro --tracks opcional que contiene un valor JSON que representa las selecciones de seguimiento. Use @{file} para cargar el valor JSON desde un archivo. Si usa la CLI de Azure localmente, especifique la ruta de acceso completa al de archivo:

az ams account-filter create -a amsAccount -g resourceGroup -n filterName --tracks @tracks.json

Vea también la sección de ejemplos de JSON para los filtros.

Creación de filtros de recurso

El siguiente comando az ams asset-filter crea un filtro de recurso con selecciones de seguimiento de filtro definidas anteriormente.

az ams asset-filter create -a amsAccount -g resourceGroup -n filterName --asset-name assetName --tracks @tracks.json

Vea también la sección de ejemplos de JSON para los filtros.

Asociación de filtros con localizadores de streaming

Filtrar los manifiestos HLS o DASH al crear un localizador de streaming

Media Services permite crear un localizador de streaming que se filtre previamente pasando una colección de filtros en la propiedad filter en la entidad del localizador de streaming. Esto te permite filtrar previamente todos los manifiestos en el localizador de streaming. El manifiesto original ya no está disponible a través de este localizador de streaming y solo se podrá acceder a la respuesta filtrada para los clientes que solicitan las direcciones URL para DASH o HLS desde el localizador de streaming filtrado. Esto resulta útil en situaciones en las que solo desea publicar una parte de un recurso y evitar que los usuarios obtengan acceso al manifiesto original completo del recurso manipulando la cadena de consulta de la dirección URL del manifiesto HLS o DASH. Se recomienda usar esta característica si quieres aplicar filtros, pero no quieres exponer los nombres de filtro en la dirección URL para que los clientes los manipulen.

Ahora puede especificar una lista de los filtros de recursos o de cuentas en el localizador de streaming. El empaquetador dinámico se aplica a esta lista de filtros junto con los que el cliente especifica en la dirección URL. Esta combinación se genera un manifiesto dinámico, que se basa en los filtros de la dirección URL y en los filtros que especifique en el localizador de streaming.

Actualización de los filtros

Los filtros y los localizadores de streaming pueden ser actualizaciones sobre la marcha, pero ten en cuenta que puede tardar hasta 10 segundos en actualizarse en los servidores front-end web y puede haber problemas con el almacenamiento en caché de CDN de bajada del contenido si está actualizando el mismo localizador de streaming que se ha publicado y usado en producción ya.

No se recomienda actualizar la definición de los filtros asociados con un localizador de streaming publicado activamente, especialmente si la red CDN está habilitada. Las redes CDN y los servidores de streaming pueden tener cachés internas que pueden generar que se devuelvan datos en caché obsoletos.

Si es necesario modificar la definición de los filtros, considera crear un filtro y agregarlo a la dirección URL del localizador de streaming o publicar un nuevo Streaming Locator que haga referencia directamente al filtro.

Uso de la CLI para crear un localizador de streaming filtrado

El siguiente código de CLI muestra cómo crear un localizador de streaming y especificar filters. Esta es una propiedad opcional que toma una lista separada por espacios de nombres de filtro de recursos o de nombres de cuenta de filtro.

az ams streaming-locator create -a amsAccount -g resourceGroup -n streamingLocatorName \
                                --asset-name assetName \
                                --streaming-policy-name policyName \
                                --filters filterName1 filterName2

Streaming con filtros

Una vez que defina los filtros, los clientes podrán utilizarlos en la dirección URL de streaming. Se podrían aplicar filtros a protocolos de streaming con velocidad de bits adaptable: formatos Apple HTTP Live Streaming (HLS), MPEG-DASH y Smooth Streaming

En la tabla siguiente se muestran algunos ejemplos de direcciones URL con filtros:

Protocolo	Ejemplo
HLS	`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=m3u8-aapl,filter=myAccountFilter)`
MPEG DASH	`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=mpd-time-csf,filter=myAssetFilter)`
Smooth Streaming	`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(filter=myAssetFilter)`

Consulte también

CLI de Azure

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:

PREGUNTAS Y RESPUESTAS
Stack Overflow. Etiquete las preguntas con azure-media-services.
@MSFTAzureMedia o use @AzureSupport para solicitar soporte técnico.
Abra una incidencia de soporte técnico a través del Azure Portal.

Share via