生成已签名的 HMAC 令牌

(SSAI) 的直播活动。

如果未使用提前插播广告通知，则使用分段重定向广告连播投放的每个分段请求都必须包含用于身份验证的 HMAC 签名令牌。

此令牌可针对每个广告插播时间点计算一次，并可在所有视频流会话中共享。

收集令牌参数

从当前广告插播时段收集以下信息，以填充令牌正文。

令牌参数
custom_asset_key 必需 Google Ad Manager 中的自定义直播素材资源键。
cust_params 可选 自定义定位参数。请参阅 cust_params。
exp 必需 相应令牌的到期时间戳（以秒为单位）。
network_code 必需 相应广告联盟的 Ad Manager 360 广告资源网代码。
pod_id 必需 广告插播的标识符。应为从 1 开始的整数，每个广告插播时间点递增 1。

在当前活动中，观看同一广告插播的所有用户必须具有相同的值。

pd 必需，但启用了无时长广告插播的活动除外。 广告插播时段的时长（以毫秒为单位）。上文中称为 ad_pod_duration。
scte35 可选 采用 Base64 编码的 SCTE-35 信号。客户有责任确保信号正确无误。如果值不正确，系统会在响应中向 X-Ad-Manager-Dai-Warning HTTP 标头发送一条消息，并且信号仍会传播以创建广告插播时间。如需详细了解 DAI 如何使用 SCTE-35 信号，请参阅支持的广告标记。

创建令牌字符串

按字母顺序列出每个参数，格式为 name=value，每个名称-值对之间以波浪号 (~) 分隔。

对于没有值的可选参数，您可以将其保留在原位，并将值设为空字符串，也可以将其完全移除。

令牌字符串格式

custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}

生成 HMAC 签名

HMAC 签名是令牌字符串的 SHA-256 哈希（采用十六进制格式）。密钥是与 Google Ad Manager 中的直播活动关联的 HMAC 身份验证密钥。

签名令牌字符串

生成后，请按以下格式将 HMAC 签名附加到令牌字符串中

~hmac={HMAC signature}

网址编码令牌字符串

此令牌会作为网址参数传递，因此必须进行网址编码以确保安全。

示例 1

以下示例中包含未使用的可选参数，这些参数以空字符串的形式呈现。

令牌字符串

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=

密钥

A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F

HMAC 签名

86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

已签名的令牌

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

经过网址编码的签名令牌：

custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88

示例 2

以下示例完全省略了未填充的可选变量。

令牌字符串

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
密钥
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
HMAC 签名
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9

已签名的令牌

custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9

网址编码格式的签名令牌

custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9