Condividi tramite

Filtra

  • Articolo

Filters vengono usati per definire i filtri per i manifesti di streaming degli asset. I filtri definiti possono essere applicati a uno dei protocolli di streaming seguenti: HLS, MPEG-DASH, Smooth Streaming e HDS. Servizi multimediali genera dinamicamente manifesti in base ai filtri specificati. I filtri possono essere definiti a livello globale (Filter) o a livello di asset (AssetFilter). Usare Filter per applicare filtri a uno qualsiasi degli asset. Usare AssetFilter per applicare filtri a un asset specifico.

Per una panoramica dettagliata e esempi di codice di manifesti generati in modo dinamico, vedere Panoramica dei manifesti dinamici.

Questo argomento offre una panoramica dell'entità Filter (usata per definire filtri globali) e illustra anche come eseguire varie operazioni con l'API REST di Servizi multimediali.

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurare lo sviluppo di API REST di Servizi multimediali e connettersi a Servizi multimediali con l'API REST di Servizi multimediali.

Filtrare le proprietà

Proprietà Type Descrizione
Name Edm.String Nome descrittivo del filtro.
PresentationTimeRange PresentationTimeRange Il PresentationTimeRange gruppo di regole viene usato per filtrare i punti di inizio/fine del manifesto, la lunghezza della finestra di presentazione e la posizione iniziale attiva. Servizi multimediali usa intersezioni di più intervalli per definire la finestra di presentazione finale.
Tracks FilterTrackSelect Contiene una raccolta di FilterTrackPropertyConditionoggetti .
FirstQuality FirstQuality First Quality of Manifest Filter (Primo livello di qualità del filtro manifesto), indica la prima velocità in bit di qualità per HLS.

Creare un filtro

Creare un filtro usando la richiesta HTTP POST.

Metodo URI richiesta Versione HTTP
POST <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1

Richiesta di esempio

È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

Intestazioni della richiesta

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 della richiesta

{  
   "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"  
            }  
         ]  
      }  
   ]  
}

Risposta

HTTP/1.1 201 Created  
. . .

Elencare i filtri

I filtri possono essere recuperati usando una richiesta HTTP GET.

Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Metodo URI richiesta Versione HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Richiesta di esempio

È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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

Aggiornare un filtro

Usare PATCH, PUT o MERGE per aggiornare un filtro con nuovi valori di proprietà.

Nota

Se si aggiorna un filtro, l'endpoint di streaming può impiegare fino a due minuti per aggiornare le regole. Se il contenuto è stato trasmesso usando dei filtri (e memorizzato nelle cache dei proxy e delle reti CDN), l'aggiornamento del filtro può determinare un errore del lettore. È consigliabile quindi cancellare la cache dopo aver aggiornato il filtro. Se questa operazione non è consentita, prendere in considerazione la possibilità di usare un filtro diverso.

Metodo URI richiesta Versione HTTP
PATCH/PUT/MERGE

Per altre informazioni su queste operazioni, vedere PATCH/PUT/MERGE.		 <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Richiesta di esempio

È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

Intestazioni della richiesta:

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 della richiesta:

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

Eliminare un filtro

È possibile eliminare i filtri usando una richiesta HTTP DELETE.

Metodo URI richiesta Versione HTTP
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Richiesta di esempio

È possibile provare l'esempio seguente nella scheda Compositore di Fiddler.

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

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