Skapa filter med Media Services REST APICreating filters with Media Services REST API

Media Services-logotyp v3media services logo v3


När du levererar ditt innehåll till kunder (strömma live-händelser eller video på begäran) kan din klient behöva större flexibilitet än vad som beskrivs i standard till gångens manifest fil.When delivering your content to customers (streaming Live events or Video on Demand) your client might need more flexibility than what's described in the default asset's manifest file. Med Azure Media Services kan du definiera konto filter och till gångs filter för ditt innehåll.Azure Media Services enables you to define account filters and asset filters for your content.

Detaljerad beskrivning av den här funktionen och scenarier där den används finns i dynamiska manifest och filter.For detailed description of this feature and scenarios where it is used, see Dynamic Manifests and Filters.

Det här avsnittet visar hur du definierar ett filter för en video på begäran till gång och använder REST-API: er för att skapa konto filter och filter för till gångar.This topic shows how to define a filter for a Video on Demand asset and use REST APIs to create Account Filters and Asset Filters.

Anteckning

Se till att granska presentationTimeRange.Make sure to review presentationTimeRange.

FörutsättningarPrerequisites

För att slutföra stegen som beskrivs i det här avsnittet måste du:To complete the steps described in this topic, you have to:

Definiera ett filterDefine a filter

Följande är exempel på begär ande text som definierar de villkor för spårnings val som läggs till i manifestet.The following is the Request body example that defines the track selection conditions that are added to the manifest. Det här filtret innehåller alla ljud spår som är EC-3 och alla video spår som har bit hastighet i intervallet 0-1000000.This filter includes any audio tracks that are EC-3 and any video tracks that have bitrate in the 0-1000000 range.

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

Skapa konto filterCreate account filters

I Postman-samlingen som du laddade ned väljer du konto filter -> skapa eller uppdatera ett konto filter.In the Postman's collection that you downloaded, select Account Filters->Create or update an Account Filter.

Metoden för att Skicka http-begäran liknar:The PUT HTTP request method is similar to:

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

Välj fliken brödtext och klistra in den JSON-kod som du definierade tidigare.Select the Body tab and paste the json code you defined earlier.

Välj Skicka.Select Send.

Filtret har skapats.The filter has been created.

Mer information finns i skapa eller uppdatera.For more information, see Create or update. Se även JSON-exempel för filter.Also, see JSON examples for filters.

Skapa till gångs filterCreate asset filters

I Postman-samlingen "Media Services v3" som du laddade ned väljer du till gångar -> skapa eller uppdatera till gångs filter.In the "Media Services v3" Postman collection that you downloaded, select Assets->Create or update Asset Filter.

Metoden för att Skicka http-begäran liknar:The PUT HTTP request method is similar to:

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

Välj fliken brödtext och klistra in den JSON-kod som du definierade tidigare.Select the Body tab and paste the json code you defined earlier.

Välj Skicka.Select Send.

Till gångs filtret har skapats.The asset filter has been created.

Mer information om hur du skapar eller uppdaterar till gångs filter finns i skapa eller uppdatera.For details on how to create or update asset filters, see Create or update. Se även JSON-exempel för filter.Also, see JSON examples for filters.

Associera filter med streaming LocatorAssociate filters with Streaming Locator

Du kan ange en lista över till gångs-eller konto filter, som gäller för din strömmande positionerare.You can specify a list of asset or account filters, which would apply to your Streaming Locator. Den dynamiska Paketeraren (slut punkt för direkt uppspelning) använder den här listan med filter tillsammans med de som klienten anger i URL: en.The Dynamic Packager (Streaming Endpoint) applies this list of filters together with those your client specifies in the URL. Den här kombinationen genererar ett dynamiskt manifest, som baseras på filter i de URL: er som du anger på en strömmande positionerare.This combination generates a Dynamic Manifest, which is based on filters in the URL + filters you specify on Streaming Locator. Vi rekommenderar att du använder den här funktionen om du vill tillämpa filter men inte vill visa filter namnen i URL: en.We recommend that you use this feature if you want to apply filters but do not want to expose the filter names in the URL.

Om du vill skapa och associera filter med en strömmande positionerare med hjälp av REST använder du strömmande positionerare-skapa API och anger properties.filters i begär ande texten.To create and associate filters with a Streaming Locator using REST, use the Streaming Locators - Create API and specify properties.filters in the Request Body.

Data ström med filterStream using filters

När du har definierat filter kan klienterna använda dem i strömnings-URL: en.Once you define filters, your clients could use them in the streaming URL. Filter kan tillämpas på strömnings protokoll med anpassningsbar bit hastighet: Apple HTTP Live Streaming (HLS), MPEG-streck och Smooth Streaming.Filters could be applied to adaptive bitrate streaming protocols: Apple HTTP Live Streaming (HLS), MPEG-DASH, and Smooth Streaming.

I följande tabell visas några exempel på URL: er med filter:The following table shows some examples of URLs with filters:

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

Nästa stegNext steps

Strömma videorStream videos