使用媒体服务 REST API 创建筛选器

将内容传送到客户（直播流活动或点播视频）时，客户端所需的灵活性可能比默认资产的清单文件中描述的灵活性更高。 使用 Azure 媒体服务可为内容定义帐户筛选器和资产筛选器。

有关此功能及其使用方案的详细说明，请参阅动态清单和筛选器。

本主题展示了如何为点播视频资产定义筛选器，以及如何使用 REST API 创建帐户筛选器和资产筛选器。

必备条件

若要完成本主题中所述的步骤，必须：

• 查看筛选器和动态清单。

• 配置 Postman 以便进行 Azure 媒体服务 REST API 调用。

  确保遵循获取 Azure AD 令牌主题中的最后一步。

定义筛选器

下面是请求正文示例，其中定义了添加到清单的曲目择条件。 此筛选器包括属于 EC-3 的任何音频曲目和比特率在 0-1000000 范围内的任何视频曲目。

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

创建帐户筛选器

在下载的 Postman 集合中，选择 "帐户筛选器"- 创建或更新帐户筛选器。

PUT HTTP 请求方法类似于：

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

选择“正文” 选项卡并粘贴你之前定义的 json 代码。

选择“发送”。

筛选器已创建。

有关详细信息，请参阅创建或更新。 此外，请参阅筛选器的 JSON 示例。

创建资产筛选器

在下载的 "媒体服务 v3" Postman 集合中，选择 "资产- 创建或更新资产筛选器"。

PUT HTTP 请求方法类似于：

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

选择“正文” 选项卡并粘贴你之前定义的 json 代码。

选择“发送”。

资产筛选器已创建。

有关如何创建或更新资产筛选器的详细信息，请参阅创建或更新。 此外，请参阅筛选器的 JSON 示例。

将筛选器与流定位器关联

可以指定资产或帐户筛选器的列表，这些筛选器将应用于流定位器。 动态打包程序（流式处理终结点）将此筛选器列表与客户端在 URL 中指定的筛选器一起应用。 此组合将生成动态清单，该清单基于你在流定位器上指定的“URL + 筛选器”中的筛选器。 如果要应用筛选器，但不希望在 URL 中公开筛选器名称，建议使用此功能。

若要使用 REST 创建筛选器并将其与流式处理定位符相关联，请使用 流式处理 定位符创建 API 并 在 请求正文中指定。

使用筛选器的流

定义筛选器后，客户端可以在流式 URL 中使用它们。 筛选器可应用到自适应比特率流式处理协议：Apple HTTP Live Streaming (HLS)、MPEG-DASH 和平滑流式处理。

下表显示了一些包含筛选器的 URL 示例：

后续步骤

流视频