Skip to content

Commit 20a2653

Browse files
authored
Merge pull request #79550 from Juliako/patch-89
Update filters-dynamic-manifest-rest-howto.md
2 parents 3d14dd9 + 508842b commit 20a2653

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

articles/media-services/latest/filters-dynamic-manifest-rest-howto.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ ms.workload: media
1212
ms.tgt_pltfrm: na
1313
ms.devlang: ne
1414
ms.topic: article
15-
ms.date: 06/03/2019
15+
ms.date: 06/13/2019
1616
ms.author: juliako
1717

1818
---
@@ -113,6 +113,24 @@ The asset filter has been created.
113113

114114
For details on how to create or update asset filters, see [Create or update](https://docs.microsoft.com/rest/api/media/assetfilters/createorupdate). Also, see [JSON examples for filters](https://docs.microsoft.com/rest/api/media/assetfilters/createorupdate#create_an_asset_filter).
115115

116+
## Associate filters with Streaming Locator
117+
118+
You can specify a list of asset or account filters, which would apply to your Streaming Locator. The [Dynamic Packager (Streaming Endpoint)](dynamic-packaging-overview.md) applies this list of filters together with those your client specifies in the URL. This combination generates a [Dynamic Manifest](filters-dynamic-manifest-overview.md), which is based on filters in the URL + filters you specify on Streaming Locator. 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.
119+
120+
To create and associate filters with a Streaming Locator using REST, use the [Streaming Locators - Create](https://docs.microsoft.com/rest/api/media/streaminglocators/create) API and specify `properties.filters` in the [Request Body](https://docs.microsoft.com/rest/api/media/streaminglocators/create#request-body).
121+
122+
## Stream using filters
123+
124+
Once you define filters, your clients could use them in the streaming URL. Filters could be applied to adaptive bitrate streaming protocols: Apple HTTP Live Streaming (HLS), MPEG-DASH, and Smooth Streaming.
125+
126+
The following table shows some examples of URLs with filters:
127+
128+
|Protocol|Example|
129+
|---|---|
130+
|HLS|`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=m3u8-aapl,filter=myAccountFilter)`|
131+
|MPEG DASH|`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(format=mpd-time-csf,filter=myAssetFilter)`|
132+
|Smooth Streaming|`https://amsv3account-usw22.streaming.media.azure.net/fecebb23-46f6-490d-8b70-203e86b0df58/bigbuckbunny.ism/manifest(filter=myAssetFilter)`|
133+
116134
## Next steps
117135

118136
[Stream videos](stream-files-tutorial-with-rest.md)

0 commit comments

Comments
 (0)