Szűrők létrehozása Media Services REST API

media services embléma v3


V2 Media Services dokumentációt keres?

Amikor az ügyfeleknek kézbesíti a tartalmakat (élő események streamelése vagy Igény szerinti videó), az ügyfélnek nagyobb rugalmasságra lehet szüksége, mint amit az alapértelmezett adateszköz jegyzékfájlja ismertet. Azure Media Services segítségével fiókszűrőket és eszközszűrőket határozhat meg a tartalomhoz.

Figyelmeztetés

It is not advised to attempt to wrap the REST API for Media Services directly into your own library code, as doing so properly for production purposes would require you to implement the full Azure Resource Management retry logic and understand how to manage long running operations in Azure Resource Management APIs. This is handled by the client SDKs for various language - .NET, Java, Typescript, Python, Ruby, etc. - for you automatically and reduces the chances of you having issues with rety logic or failed API calls. The client SDKs all handle this for you already. The Postman collection is provided more as a teaching tool, and to show you what the client SDKs are actually doing on the wire during your development with the various client SDKs.

A szolgáltatás részletes leírását és a felhasználási forgatókönyveket a Dinamikus jegyzékek és szűrők részben láthatja.

Ez a témakör bemutatja, hogyan definiálhat szűrőt egy Igény szerinti videó adateszközhöz, és hogyan használhat REST API-kat fiókszűrők és adateszközszűrők létrehozásához.

Megjegyzés

Mindenképpen tekintse át a presentationTimeRange et.

Előfeltételek

Az ebben a témakörben leírt lépések befejezéséhez a következőket kell végrehajtania:

Szűrő meghatározása

Az alábbiakban a Kérelem törzse példa van megadva, amely meghatározza a jegyzékfájlhoz hozzáadott sávválasztási feltételeket. Ez a szűrő tartalmazza az EC-3 hangsávokat, valamint a 0–1000000 tartományba esik bitre ható videósávokat.

{
    "properties": {
        "tracks": [
          {
                "trackSelections": [
                    {
                        "property": "Type",
                        "value": "Audio",
                        "operation": "Equal"
                    },
                    {
                        "property": "FourCC",
                        "value": "EC-3",
                        "operation": "Equal"
                    }
                ]
            },
            {
                "trackSelections": [
                    {
                        "property": "Type",
                        "value": "Video",
                        "operation": "Equal"
                    },
                    {
                        "property": "Bitrate",
                        "value": "0-1000000",
                        "operation": "Equal"
                    }
                ]
            }
        ]
     }
}

Fiókszűrők létrehozása

A letöltött Postman-gyűjteményben válassza a Fiókszűrők Fiókszűrő létrehozása vagy -> frissítése lehetőséget.

A PUT HTTP-kérési metódus az alábbihoz hasonló:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/accountFilters/{filterName}?api-version=2018-07-01

Válassza a Törzs lapot, és illessze be a korábban definiált JSON-kódot.

Kattintson a Küldés gombra.

A szűrő létrejött.

További információ: Létrehozás vagy frissítés. Lásd még a szűrők JSON-példáit.

Adateszközszűrők létrehozása

A letöltött "Media Services v3" Postman-gyűjteményben válassza az Assets Create or update Asset Filter (Eszközök létrehozása vagy -> frissítése) lehetőséget.

A PUT HTTP-kérési metódus az alábbihoz hasonló:

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/assets/{assetName}/assetFilters/{filterName}?api-version=2018-07-01

Válassza a Törzs lapot, és illessze be a korábban definiált JSON-kódot.

Kattintson a Küldés gombra.

Létrejött az eszközszűrő.

Az adateszközszűrők létrehozásáról és frissítésről további információt a Létrehozás vagy frissítés oldalon talál. Lásd még a szűrők JSON-példáit.

Szűrők társítása a streamelési lokátorhoz

Megadhatja az eszköz- vagy fiókszűrők listáját, amelyek a streamelési lokátorra vonatkoznak. A dinamikus csomagozó (streamvégpont) ezt a szűrőlistát az ügyfél által az URL-címben megadott szűrőkkel együtt alkalmazza. Ez a kombináció dinamikus jegyzékfájlt hozlétre, amely a Streamelési lokátorban megadott URL-cím + szűrők szűrői alapján van létrehozva. Javasoljuk, hogy ezt a funkciót használja, ha szűrőket szeretne alkalmazni, de nem szeretné elérhetővé tenni a szűrőneveket az URL-címben.

Ha a REST használatával szűrőket hoz létre és társít egy streamelési lokátorhoz, használja a Streamelési lokátorok – API létrehozása api-t, és adja meg a kérés properties.filters törzsében.

Streamelés szűrőkkel

Miután meghatározta a szűrőket, az ügyfelek felhasználhatja őket a streamelési URL-címben. Szűrők alkalmazhatók adaptív átviteli átvitelű streamelési protokollokra: Apple HTTP Live Streaming (HLS), MPEG-DASH és Smooth Streaming.

Az alábbi táblázat néhány példát mutat be a szűrőkkel együtt használható URL-címekre:

Protokoll Példa
HLS https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=m3u8-aapl,filter=myAccountFilter)
MPEG DASH https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=mpd-time-csf,filter=myAssetFilter)
Smooth Streaming https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(filter=myAssetFilter)

Következő lépések

Videók streamelése