Filtre

Filters, varlıkların akış bildirimlerine yönelik filtreleri tanımlamak için kullanılır. Tanımlı filtreler aşağıdaki akış protokollerinden herhangi birine uygulanabilir: HLS, MPEG-DASH, Kesintisiz Akış ve HDS. Media Services, belirtilen filtrelere göre dinamik olarak bildirimler oluşturur. Filtreler genel düzeyde (Filter) veya varlık düzeyinde (AssetFilter) tanımlanabilir. Varlıklarınızdan herhangi birine filtre uygulamak için kullanın Filter . Belirli bir varlığa filtre uygulamak için kullanın AssetFilter .

Dinamik olarak oluşturulan bildirimlerin ayrıntılı bir genel bakışı ve kod örnekleri için bkz . Dinamik bildirimlere genel bakış.

Bu konu, varlığa genel bir bakış Filter sağlar (genel filtreleri tanımlamak için kullanılır) ve ayrıca Media Services REST API'siyle çeşitli işlemlerin nasıl yürütüleceklerini gösterir.

• Filtre Özellikleri

• Filtre Oluşturma

• Liste Filtreleri

• Filtreyi Güncelleştirme

• Filtre Silme

Önemli

Media Services'teki varlıklara erişirken, HTTP isteklerinizde belirli üst bilgi alanlarını ve değerlerini ayarlamanız gerekir.
Daha fazla bilgi için bkz. Media Services REST API Geliştirme kurulumu ve Media Services REST API ile Media Services'a Bağlanma.

Filtre özellikleri

Özellik	Tür	Description
Name	Edm.String	Filtrenin kolay adı.
PresentationTimeRange	PresentationTimeRange	Kural PresentationTimeRange grubu bildirim başlangıç/bitiş noktalarını, sunu penceresi uzunluğunu ve canlı başlangıç konumunu filtrelemek için kullanılır. Media Services, son sunu penceresini tanımlamak için birden çok aralığın kesişimlerini kullanır.
Tracks	FilterTrackSelect	Bir s koleksiyonu FilterTrackPropertyConditioniçerir.
FirstQuality	FirstQuality	İlk Bildirim Filtresi Kalitesi, HLS için ilk kalite bit hızını gösterir.

Filtre oluşturma

HTTP POST isteğini kullanarak bir filtre oluşturun.

Yöntem	İstek URI'si	HTTP Sürümü
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri

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  
  

İstek gövdesi

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

Yanıt

HTTP/1.1 201 Created  
. . .  
  

Liste filtreleri

Filtreler bir HTTP GET isteği kullanılarak alınabilir.

Yöntem	İstek URI'si	HTTP Sürümü
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>	HTTP/1.1

Yöntem	İstek URI'si	HTTP Sürümü
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services 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  
  

Filtreyi güncelleştirme

Filtreyi yeni özellik değerleriyle güncelleştirmek için PATCH, PUT veya MERGE kullanın.

Not

Bir filtreyi güncelleştirirseniz akış uç noktasının kuralları yenilemesi 2 dakika kadar sürebilir. İçerik bu filtre kullanılarak sunulursa (ve proxy'lerde ve CDN önbelleklerinde önbelleğe alınmışsa), bu filtrenin güncelleştirilmesi oynatıcı hatalarına neden olabilir. Filtre güncelleştirildikten sonra önbelleğin temizlenmesi önerilir. Bu seçenek mümkün değilse farklı bir filtre kullanmayı göz önünde bulundurun.

Yöntem	İstek URI'si	HTTP Sürümü
PATCH/PUT/MERGE Bu işlemler hakkında daha fazla bilgi için bkz. PATCH/PUT/MERGE.	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services REST.

İstek üst bilgileri:

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  
  

İstek gövdesi:

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

Filtre silme

Filtreler HTTP DELETE isteği kullanılarak silinebilir.

Yöntem	İstek URI'si	HTTP Sürümü
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName')	HTTP/1.1

Örnek İstek

Fiddler'ın Oluşturucu sekmesinde aşağıdaki örneği deneyebilirsiniz.

En son x-ms-version:sürümü edinmek için bkz. Media Services 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