次の方法で共有

Assert

  • [アーティクル]

Filter は資産のストリーミング マニフェストのフィルターを定義するために使用されます。 定義したフィルターはストリーミング プロトコルの HLS、MPEG-DASH、Smooth Streaming、HDS のいずれかに適用できます。 Media Services は、指定されたフィルターに基づいてマニフェストを動的に生成します。 フィルターは、グローバル レベル () または資産レベル (FilterAssetFilter) で定義できます。 任意のアセットにフィルターを適用するには、Filter を使用します。 特定のアセットにフィルターを適用するには、AssetFilter を使用します。

動的に生成されるマニフェストの詳細な概要とコード サンプルについては、「 動的マニフェストの概要」を参照してください。

このトピックは、Filter エンティティ (グローバル フィルターの定義に使用されます) を概説し、また Media Services REST API でさまざまな操作を実行する方法を示します。

重要

Media Services でエンティティにアクセスするときは、HTTP 要求で特定のヘッダー フィールドと値を設定する必要があります。
詳細については、「 Media Services REST API 開発のセットアップ」および「Media Services REST APIを使用した Media Services への接続」を参照してください。

フィルターのプロパティ

プロパティ Type 説明
Name Edm.String フィルターのフレンドリ名。
PresentationTimeRange PresentationTimeRange PresentationTimeRange ルール グループは、マニフェストの開始/終了ポイント、プレゼンテーションのウィンドウ長、ライブの開始位置をフィルター処理するために使用されます。 Media Services は複数の範囲の共通部分を利用し、最終的なプレゼンテーション ウィンドウを定義します。
Tracks FilterTrackSelect FilterTrackPropertyCondition のコレクションが含まれます。
FirstQuality FirstQuality マニフェスト フィルターの最初の品質は、HLS の最初の品質ビットレートを示します。

フィルターを作成する

HTTP POST 要求を使用してフィルターを作成します。

Method 要求 URI HTTP バージョン
POST <https:// accountname.restv2>。<location.media.azure.net/api/Filters> HTTP/1.1

要求のサンプル

Fiddler の [Composer] タブで次の例を試すことができます。

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

要求ヘッダー

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

要求本文

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

Response

HTTP/1.1 201 Created  
. . .

フィルターの一覧

フィルターは HTTP GET 要求を使用して取得できます。

Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/Filters> HTTP/1.1
Method 要求 URI HTTP バージョン
GET <https:// accountname.restv2>。<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

要求のサンプル

Fiddler の [Composer] タブで次の例を試すことができます。

最新 x-ms-version:の を取得するには、「 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

フィルターの更新

PATCH、PUT、MERGE を利用し、新しいプロパティ値でフィルターを更新します。

注意

フィルターを更新する場合、ストリーミング エンドポイントでルールを更新するのに最大 2 分かかります。 このフィルターを使用してコンテンツが処理された場合 (また、プロキシと CDN にキャッシュされている場合)、このフィルターを更新するとプレイヤーでエラーが発生します。 フィルターを更新した後にキャッシュをクリアすることをお勧めします。 このオプションが利用できない場合は、別のフィルターを使用することを検討してください。

Method 要求 URI HTTP バージョン
PATCH/PUT/MERGE

これらの操作の詳細については、「 PATCH/PUT/MERGE」を参照してください。		 <https:// accountname.restv2>。<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

要求のサンプル

Fiddler の [Composer] タブで次の例を試すことができます。

最新 x-ms-version:の を取得するには、「 Media Services REST」を参照してください。

要求ヘッダー:

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

要求本文:

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

フィルターの削除

フィルターは、HTTP DELETE 要求を使用して削除できます。

Method 要求 URI HTTP バージョン
DELETE <https:// accountname.restv2>。<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

要求のサンプル

Fiddler の [Composer] タブで次の例を試すことができます。

最新 x-ms-version:の を取得するには、「 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