AssetFilter

  • Makale

AssetFilterbunlar, varlığınızın akış bildirimleri için filtre tanımlamak için kullanılır. Tanımlanan filtreler aşağıdaki akış protokollerinden herhangi birine uygulanabilir: HLS, MPEG-DASH, Kesintisiz Akış ve HDS. Media Services, belirtilen filtreleri temel alan bildirimleri dinamik olarak oluşturur. Filtreler genel düzeyde (Filtre) veya varlık düzeyinde (AssetFilter ) tanımlanabilir. Belirli bir varlığa filtre uygulamak için kullanın AssetFilter . Varlıklarınızdan herhangi birine filtre uygulamak için kullanın Filter .

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ış AssetFilter sağlar (yerel 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.

Ö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'e Bağlanma.

AssetFilter özellikleri

Özellik Tür Description
Id

Salt okunur. Media Services tarafından oluşturma zamanında ayarlanır.		 Edm.String Benzersiz tanımlayıcı.
ParentAssetId Edm.String Bu filtrelerin koleksiyonunu içeren bir üst Varlığın kimliği.
Name Edm.String AssetFilter için 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 Kalitesi Filtresi, 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/AssetFilters> 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/AssetFilters 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":"TestFilter",  
   "ParentAssetId":"nb:cid:UUID:536e555d-1500-80c3-92dc-f1e4fdc6c592",  
   "PresentationTimeRange":{    
      "StartTimestamp":"0",  
      "EndTimestamp":"9223372036854775807",  
      "PresentationWindowDuration":"12000000000",  
      "LiveBackoffDuration":"0",  
      "Timescale":"10000000"  
   },  
   "Tracks":[    
      {    
         "PropertyConditions":  
              [    
            {    
               "Property":"Type",  
               "Value":"audio",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"0-2147483647",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}

Yanıt

HTTP/1.1 201 Created  
. . .

Liste filtreleri

Bir varlıkla ilişkili tüm AssetFilter'ları iade edin.

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

Varlık oluşturulduğunda döndürülen AssetFilter Kimliğini belirterek belirli bir AssetFilters döndürür.

Yöntem İstek URI'si HTTP Sürümü
GET <https:// accountname.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID') 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.

Bir varlıkla ilişkili tüm AssetFilter'ları alın.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592')/AssetFilters 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  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net

Kimliğine göre bir AssetFilter alın.

GET https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter') 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  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net

Filtreyi güncelleştirme

AssetFilter'ı 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 yürütü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:

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter')  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/AssetFilters>('assetFilterId') 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/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter') 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