Filters maken met Media Services REST API

media services logo v3


Bij het leveren van uw inhoud aan klanten (het streamen van Live-gebeurtenissen of video op aanvraag), heeft uw client mogelijk meer flexibiliteit nodig dan is beschreven in het manifest bestand van het standaard activum. Met Azure Media Services kunt u account filters en activa filters definiƫren voor uw inhoud.

Zie dynamische manifesten en filtersvoor een gedetailleerde beschrijving van deze functie en scenario's waarin deze wordt gebruikt.

In dit onderwerp wordt uitgelegd hoe u een filter definieert voor een video op aanvraag-Asset en REST-Api's gebruikt om account filters en- activa filterste maken.

Notitie

Zorg ervoor dat u de presentationTimeRangecontroleert.

Vereisten

Voor het uitvoeren van de stappen die in dit onderwerp worden beschreven, moet u het volgende doen:

Een filter definiƫren

Hieronder ziet u het voor beeld van een aanvraag tekst waarin de selectie voorwaarden voor het volgen worden gedefinieerd die worden toegevoegd aan het manifest. Dit filter bevat audio tracks die EC-3 zijn en video tracks met bitsnelheid in het 0-1000000-bereik.

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

Account filters maken

Selecteer in de verzameling die u hebt gedownload van de Postman, account filters -> een account filter maken of bijwerken.

De methode voor het opnemen van HTTP-aanvragen is vergelijkbaar met:

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

Selecteer het tabblad hoofd tekst en plak de JSON-code die u eerder hebt gedefinieerd.

Selecteer Verzenden.

Het filter is gemaakt.

Zie maken of bijwerkenvoor meer informatie. Zie ook JSON-voor beelden voor filters.

Activa filters maken

Selecteer in de Postman-verzameling Media Services v3 die u hebt gedownload, activa -> filter maken of bijwerken.

De methode voor het opnemen van HTTP-aanvragen is vergelijkbaar met:

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

Selecteer het tabblad hoofd tekst en plak de JSON-code die u eerder hebt gedefinieerd.

Selecteer Verzenden.

Het activa filter is gemaakt.

Zie maken of bijwerkenvoor meer informatie over het maken of bijwerken van Asset-filters. Zie ook JSON-voor beelden voor filters.

Filters koppelen aan streaming-Locator

U kunt een lijst opgeven met activa of account filters die van toepassing zijn op uw streaming-Locator. Met de dynamische pakket (streaming-eind punt) wordt deze lijst met filters toegepast, samen met de gegevens die door uw client zijn opgegeven in de URL. Deze combi natie genereert een dynamisch manifestdat is gebaseerd op filters in de URL + filters die u opgeeft in de streaming-Locator. U wordt aangeraden deze functie te gebruiken als u filters wilt Toep assen, maar niet de filter namen in de URL wilt weer geven.

Als u filters met een streaming-Locator wilt maken en koppelen met behulp van REST, gebruikt u de streams voor het maken van een API en geeft u properties.filters in de aanvraag tekstop.

Streamen met filters

Zodra u filters hebt gedefinieerd, kunnen uw clients deze gebruiken in de streaming-URL. Filters kunnen worden toegepast op Adaptive Bitrate Streaming protocollen: Apple HTTP Live Streaming (HLS), MPEG-DASH en Smooth Streaming.

In de volgende tabel ziet u enkele voor beelden van Url's met filters:

Protocol Voorbeeld
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)

Volgende stappen

Video streamen