RTMP推流地址及签名

本文介绍RTMP推流地址及其签名规则。

重要

仅当Bucket ACL为非public-read-write时，推流地址需要签名后才可以使用。签名方法与OSS的URL签名类似。

RTMP推流地址

RTMP推流地址格式为rtmp://${bucket}.${host}/live/${channel}?${params}，例如rtmp://examplebucket.oss-cn-hangzhou.aliyuncs.com/live/test-channel。

bucket：Bucket名称，例如examplebucket。关于Bucket命名规范的更多信息，请参见存储空间（Bucket）。
host：填写地域节点Endpoint，例如oss-cn-hangzhou.aliyuncs.com。关于Endpoint的更多信息，请参见OSS地域和访问域名。
live：RTMP协议的App名称，OSS固定使用live。
channel：channel名称。例如test-channel。关于channel命名规范的更多信息，请参见PutLiveChannel。
params：推流参数，与HTTP请求的query string相同，格式为varA=valueA&varB=valueB。

RTMP推流支持的URL参数及描述如下表所示。

名称	描述
playlistName	指定生成的m3u8文件名称。说明生成的m3u8文件名称仍被添加`${channel_name}/`前缀。

带签名的推流地址格式为rtmp://${bucket}.${host}/live/${channel}?OSSAccessKeyId=xxx&Expires=yyy&Signature=zzz&${params}。

推流地址的签名规则中包含的参数及描述如下表所示。

Signature的计算规则如下。

base64(hmac-sha1(AccessKeySecret,
    + Expires + "\n"
    + CanonicalizedParams
    + CanonicalizedResource))

Signature计算规则中涉及的参数及描述如下表所示。

名称	描述
CanonicalizedParams	按照param key字典序拼接所有参数，格式为`key:value\n`。说明如果参数个数为0，则此项为空。参数中不包含SecurityToken、OSSAccessKeyId、Expire以及Signature。每个param key只能出现一次。
CanonicalizedResource	格式为`/BucketName/ChannelName`，例如`/examplebucket/test-channel`。