筛选器

将内容传送到客户（实时传送视频流事件或点播视频）时，客户端所需的灵活性可能比默认资产的清单文件中描述的灵活性更高。 Azure 媒体服务根据预定义的筛选器提供动态清单。

筛选器是服务器端的规则，可让客户执行以下操作：

• 仅播放视频的某个部分（而不是整个视频）。 例如：
  • 缩小清单以显示直播活动的子剪辑（“子剪辑筛选”），或
  • 修剪视频开头（“修剪视频”）。
• 只传送内容播放设备所支持的指定再现内容和/或指定的语言轨道（“再现内容筛选”）。
• 调整演播窗口，以便在播放器中提供长度有限的 DVR 窗口（“调整演播窗口”）。

使用媒体服务可为内容创建帐户筛选器和资产筛选器。 此外，可将预先创建的筛选器关联到流定位符。

筛选器类型

有两种类型的筛选器：

• 帐户筛选器（全局）- 可应用到 Azure 媒体服务帐户中所有的资产，生存期与帐户相同。
• 资产筛选器（本地）- 在创建后只能应用到与筛选器关联的资产，生存期与资产相同。

帐户筛选器和资产筛选器类型的用于定义/描述筛选器的属性完全相同。 需要指定要与筛选器关联的资产名称，但创建资产筛选器时除外。

根据具体的方案确定哪种类型的筛选器更合适（资产筛选器或帐户筛选器）。 帐户筛选器适用于设备配置文件（再现内容筛选），而资产筛选器可用于修剪特定的资产。

使用以下属性来描述筛选器。

presentationTimeRange

请将此属性用于资产筛选器。 不建议对帐户筛选器设置该属性。

轨迹

指定筛选器轨迹属性条件 (FilterTrackPropertyConditions) 的列表，应该根据该列表将流（实时传送视频流或点播视频）的轨迹包含到动态创建的清单中。 使用逻辑 AND 和 OR 运算来组合筛选器。

筛选器轨迹属性条件描述轨迹类型、值（如下表所述）和运算（Equal、NotEqual）。

示例

以下示例定义实时传送视频流筛选器：

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854776000,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

在创建流式处理定位符时筛选 HLS 或 DASH 清单

媒体服务允许你创建一个流式处理定位符，该定位符是通过传入到流式处理定位符实体上筛选器属性中的筛选器集合来预先筛选的。 这样，就可以在流式处理定位符上预筛选所有清单。 此流式处理定位符不再提供原始清单，从筛选的流式处理定位符请求 DASH 或 HLS 的 URL 的客户端只能访问筛选后的响应。 如果只想发布一部分资产，并且通过操作 HLS 或 DASH 清单 URL 的查询字符串，防止用户访问资产的完整原始清单，则这会很有用。

可以在流定位符中指定资产或帐户筛选器列表。 动态打包器将此筛选器列表与客户端在 URL 中指定的筛选器一起应用。 此组合将生成动态清单，该清单基于你在流定位符上指定的“URL + 筛选器”中的筛选器。

更新筛选器

筛选器和流式处理定位符可以实时更新，但请记住，在前端 Web 服务器上进行的任何更新可能需要长达 10 秒的时间，如果更新已发布并已在生产中使用的同一流式处理定位符，则可能会出现问题。

不建议更新与实际发布的流定位符关联的筛选器的定义。 流式处理服务器可能有内部缓存，这可能会导致返回过时的缓存数据。

如果需要更改筛选器定义，请考虑创建一个新的筛选器，并将其添加到流定位符 URL，或发布直接引用已更新筛选器的唯一新流定位符。