tencent cloud

文档反馈

推拉流 URL

最后更新时间:2024-01-13 15:53:49

    前提条件

    已注册腾讯云账号,并开通 腾讯云直播服务
    已在 域名注册 申请域名,并备案成功。
    已在云直播控制台 > 域名管理 中添加推流/播放域名,具体操作请参见 添加自有域名

    手动生成直播 URL

    1. 登录云直播控制台。
    2. 选择进入辅助工具 > 地址生成器,进入如下配置:
    1. 按需选择生成类型。
    2. 选择您已添加到域名管理里对应的域名。
    3. 按需编辑 AppName。AppName 为区分同一个域名下多个 App 的地址路径,默认为 live。
    4. 填写自定义的流名称 StreamName。
    5. 选择地址过期时间。
    6. 单击生成地址即可生成您需要的推流/播放地址。
    说明:
    AppName 可自定义,仅支持英文字母、数字和符号。
    除上述方法,您还可以在云直播控制台的 域名管理 中,选择推流域名单击管理,选择推流配置,输入推流地址的过期时间和自定义的流名称 StreamName,单击生成推流地址即可生成推流地址。

    查看推流地址示例代码

    进入云直播控制台 > 域名管理,选中事先配置的推流域名,管理 > 推流配置页面下半部分有推流地址示例代码(PHP 和 Java 两个版本)演示如何生成防盗链地址。更多详情操作请参见 推流配置

    自主拼装推流 URL

    实际产品中,当直播间较多时,您不可能为每一个主播手工创建推流和播放 URL,您可通过服务器自行拼装推流和播放地址,只要符合腾讯云标准规范的 URL 就可以用来推流,如下是一条标准的推流 URL,它由四个部分组成:
    
    
    Domain 推流域名,可使用腾讯云直播提供的默认推流域名,也可以用自有已备案且 CNAME 配置成功的推流域名。
    AppName 直播的应用名称,默认为 live,可自定义。
    StreamName(流 ID) 自定义的流名称,每路直播流的唯一标识符,推荐用随机数字或数字与字母组合。
    鉴权 Key(非必需) 包含 txSecret 和 txTime 两部分:txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)。 开启推流鉴权后需使用包含鉴权 Key 的 URL 进行推流。若未开启推流鉴权,则推流地址中无需 “?” 及其后内容。
    txTime(地址有效期) 表示何时该 URL 会过期,格式支持十六进制的 UNIX 时间戳。
    说明:
    例如5867D600代表2017年1月1日0时0点0分过期,我们的客户一般会将 txTime 设置为当前时间24小时以后过期,过期时间不要太短也不要太长,当主播在直播过程中遭遇网络闪断时会重新恢复推流,如果过期时间太短,主播会因为推流 URL 过期而无法恢复推流。
    txSecret(防盗链签名) 用以防止攻击者伪造您的后台生成推流 URL,计算方法参见 最佳实践-防盗链计算

    自主拼装播放 URL

    播放地址主要由播放前缀、播放域名(domain)、应用名称(AppName)、流名称(StreamName)、播放协议后缀、鉴权参数以及其他自定义参数组成。例如:
    webrtc://domain/AppName/StreamName?txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)
    http://domain/AppName/StreamName.flv?txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)
    rtmp://domain/AppName/StreamName?txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)
    http://domain/AppName/StreamName.m3u8?txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)
    播放前缀
    播放协议
    播放前缀
    备注
    WebRTC
    webrtc://
    强烈推荐,秒开效果最好,支持超高并发。
    HTTP-FLV
    http://https://
    推荐,秒开效果好,支持超高并发。
    RTMP
    rtmp://
    不推荐,秒开效果差,不支持高并发
    HLS(m3u8)
    http://https://
    手机端和 Mac safari 浏览器推荐的播放协议。
    Domain
    播放域名,自有已备案且 CNAME 配置成功的播放域名。
    AppName 直播的应用名称,用于区分直播流媒体文件存放路径,默认为 live,可自定义。
    StreamName(流名称) 自定义的流名称,每路直播流的唯一标识符,推荐用随机数字或数字与字母组合。
    鉴权参数(非必需) 包含 txSecret 和 txTime 两部分:txSecret=Md5(key+StreamName+hex(time))&txTime=hex(time)。 开启播放鉴权后需使用包含鉴权 Key 的 URL 进行播放。若未开启播放鉴权,则播放地址中无需 “?” 及其后内容。
    txTime(地址有效期): 表示何时该 URL 会过期,格式支持十六进制的 UNIX 时间戳。
    txSecret(防盗链签名):用以防止攻击者伪造您的后台生成播放 URL,计算方法参见 最佳实践-防盗链计算

    自主拼装 RTC 连麦/PK URL

    当您使用 RTC 连麦 或者 PK 时,需要拼接不同的推拉流 URL。
    
    推流 URL
    具体的推流 URL 字符串,需要开发者按照下方协议解析中的规则,在工程代码中自行拼接。URL 的示例如下:
    trtc://cloud.tencent.com/push/streamid?sdkappid=1400188888&userId=A&usersig=xxxxx
    在上述的 URL 中,存在一些关键字段,关于其中关键字段的含义信息,详见下表:
    字段名称
    字段含义
    trtc://
    互动直播推流 URL 的前缀字段
    cloud.tencent.com
    互动直播特定域名,请勿修改
    push
    标识位,表示推流
    streamid
    流 ID,需要由开发者自定义
    sdkappid
    对应 服务开通一节中生成的 SDKAppID
    userId
    主播 ID,需要由开发者自定义
    usersig
    由 服务开通 一节中获取的密钥计算得出
    拉流 URL 具体的拉流 URL 字符串,需要开发者按照下方协议解析中的规则,在工程代码中自行拼接。URL 的示例如下:
    trtc://cloud.tencent.com/play/streamid?sdkappid=1400188888&userId=A&usersig=xxxxx
    
    上述的 URL 中,存在一些关键字段,关于其中关键字段的含义信息,详见下表:
    字段名称
    字段含义
    trtc://
    互动直播拉流 URL 的前缀字段
    cloud.tencent.com
    互动直播特定域名,请勿修改
    play
    标识位,表示拉流
    streamid
    流 ID,需要由开发者自定义
    sdkappid
    对应 服务开通 一节中生成的 SDKAppID
    userId
    主播 ID,需要由开发者自定义
    usersig
    由 服务开通 一节中获取的密钥计算得出
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持