边缘转推配置

如果需要将直播流分发至其他多个平台,且直播源区域较广、直播流数较多,您可以在推流域名上进行边缘转推配置,从而满足直播流多平台分发的需求。

使用说明

开启、修改和删除边缘转推配置仅对新发起的推流生效。例如:您在控制台开启边缘转推配置之前已经发起推流,由于发起推流时边缘转推配置不存在,该推流不受正在进行的转推配置影响,即不会转推。

费用说明

开启边缘转推后,将会产生转推费用,计费规则请参见边缘转推费用

配置边缘转推

  1. 登录视频直播控制台

  2. 在左侧导航栏单击推/播流域名管理,进入域名管理页面。

  3. 单击指定推流域名操作列的域名配置,在域名配置页左侧直播管理 > 边缘转推配置

    image

  4. 单击边缘转推配置开关,添加边缘转推配置。

    目标转推

    参数

    描述

    边缘转推类型

    • 指定目标转推:指定目标域名列表,向列表中指定的域名发起转推。

    • HTTPDNS获取目标转推:指定HTTPDNS接口,阿里云通过访问HTTPDNS接口来获取转推目标地址。

    指定目标转推

    AppName

    直播源的应用名称。支持正则表达式(除^和$),例如test[1,2,3],表示允许将test1、test2、test3三个App的流转推。

    StreamName

    直播源的流名称。支持正则表达式(除^和$),例如test[1,2,3],表示允许将test1、test2、test3三个Stream的流转推。

    边缘转推地址

    目标转推域名列表。多个域名以半角逗号(,)隔开。示例值:

    example1.aliyundoc.com,example2.aliyundoc.com

    透传推流参数

    是否透传推流URL中携带的参数。

    HTTPDNS获取目标转推

    HTTPDNS接口

    访问目标转推地址的HTTPDNS接口。示例值:http://example.aliyundoc.com/?host={<host>}&app={<app>}&name={<name>}{<_ali_user_args>},在实际访问HTTPDNS接口时会把以下参数按推流URL中的信息进行替换:

    • {<host>}:推流域名。

    • {<app>}:直播流应用名称。

    • {<name>}:直播流名。

    • {<_ali_user_args>}:用户推流带的参数。

    返回值说明:

    • 200:表示成功,转推域名从返回的JSON结果里面获取,如果返回多个转推域名,表示需要将原始流转推到多路。返回的JSON示例见下文。

    • 403:表示失败。不需要转推。

    透传推流参数

    是否透传推流URL中携带的参数。

    JSON示例:

    {
        "cdn_types": [
            {
                "name": "cdnA",
                "upstream_url": "rtmp://example1.aliyundoc.com/live/testedge****"
            },
            {
                "name": "cdnB",
                "upstream_url": "rtmp://example2.aliyundoc.com/live/testedge****"
            }
        ]
    }          

    参数

    描述

    name

    CDN名称,可自定义但不能重复。

    upstream_url

    目标转推地址。

  5. 单击确定,完成边缘转推配置。

API参考

边缘转推相关接口