Partilhar via

Filtro

  • Artigo

Filtersão utilizados para definir filtros para manifestos de transmissão em fluxo de recursos. Os filtros definidos podem ser aplicados a qualquer um dos seguintes protocolos de transmissão em fluxo: HLS, MPEG-DASH, Smooth Streaming e HDS. Os Serviços de Multimédia geram dinamicamente manifestos com base em filtros especificados. Os filtros podem ser definidos a nível global (Filter) ou ativo (AssetFilter). Utilize Filter para aplicar filtros a qualquer um dos seus recursos. Utilize AssetFilter para aplicar filtros a um recurso específico.

Para obter uma descrição geral detalhada e exemplos de código de manifestos gerados dinamicamente, veja Descrição geral dos manifestos dinâmicos.

Este tópico fornece uma descrição geral da Filter entidade (utilizada para definir filtros globais) e também demonstra como executar várias operações com a API REST dos Serviços de Multimédia.

Importante

Ao aceder a entidades nos Serviços de Multimédia, tem de definir campos e valores de cabeçalho específicos nos seus pedidos HTTP.
Para obter mais informações, veja Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Configurar o Desenvolvimento da API REST dos Serviços de Multimédia e Ligar aos Serviços de Multimédia com a API REST dos Serviços de Multimédia).

Propriedades do filtro

Propriedade Tipo Description
Name Edm.String Nome amigável do filtro.
PresentationTimeRange PresentationTimeRange O PresentationTimeRange grupo de regras é utilizado para filtrar os pontos de início/fim do manifesto, o comprimento da janela da apresentação e a posição de início dinâmico. Os Serviços de Multimédia utilizam intersecções de múltiplos intervalos para definir a janela final da apresentação.
Tracks FilterTrackSelect Contém uma coleção de FilterTrackPropertyConditions.
FirstQuality Primeira Igualdade Primeiro Filtro de Qualidade do Manifesto, indica a primeira velocidade de transmissão de qualidade para HLS.

Criar um filtro

Crie um filtro com o pedido HTTP POST.

Método URI do pedido Versão HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

Cabeçalhos do pedido

POST https://<accountname>.restv2.<location>.media.azure.net/api/Filters HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Content-Type: application/json  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net

Corpo do pedido

{  
   "Name":"Mobile",  
   "PresentationTimeRange":{    
      "StartTimestamp":"0",  
      "EndTimestamp":"9223372036854775807",  
      "PresentationWindowDuration":"12000000000",  
      "LiveBackoffDuration":"0",  
      "Timescale":"10000000"  
   },  
   "Tracks":[    
      {    
         "PropertyConditions":[    
            {    
               "Property":"Type",  
               "Value":"video",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"550000-1350000",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}

Resposta

HTTP/1.1 201 Created  
. . .

Filtros de lista

Os filtros podem ser obtidos com um pedido HTTP GET.

Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Método URI do pedido Versão HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Filters HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: media.windows.net

Atualizar um filtro

Utilize PATCH, PUT ou MERGE para atualizar um Filtro com novos valores de propriedade.

Nota

Se atualizar um filtro, pode demorar até 2 minutos para que o ponto final de transmissão em fluxo atualize as regras. Se o conteúdo tiver sido servido com este filtro (e colocado em cache em proxies e caches de CDN), a atualização deste filtro poderá resultar em falhas do leitor. Recomenda-se limpar a cache depois de atualizar o filtro. Se esta opção não for possível, considere utilizar um filtro diferente.

Método URI do pedido Versão HTTP
PATCH/PUT/MERGE

Para obter mais informações sobre estas operações, consulte PATCH/PUT/MERGE.		 <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

Cabeçalhos de pedido:

PATCH https://<accountname>.restv2.<location>.media.azure.net/api/Filters('filterName') HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Content-Type: application/json  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net

Corpo do pedido:

{  
   "Tracks":[    
      {    
         "PropertyConditions":  
         [    
            {    
               "Property":"Type",  
               "Value":"audio",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"0-2147483647",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}

Eliminar um filtro

Os filtros podem ser eliminados através de um pedido HTTP DELETE.

Método URI do pedido Versão HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Pedido de Amostra

Pode experimentar o seguinte exemplo no separador Compositor do Fiddler.

Para obter a versão mais recente x-ms-version:, consulte REST dos Serviços de Multimédia.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Filters('Mobile') HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: media.windows.net