转推为主播推流至阿里云直播后,由阿里云推送至您的源站或其他直播平台,满足您多平台分发的需求。本文提供通过控制台设置直播转推配置的操作指南。

背景信息

支持指定目标转推和HTTPDNS获取目标转推两种方式:
  • 指定目标转推:指定目标域名列表,向列表中指定的域名发起转推。
  • HTTPDNS获取目标转推:指定HTTPDNS接口,阿里云通过访问HTTPDNS接口来获取转推目标地址。
说明
  • 一个域名只能有一个转推配置。
  • 指定目标转推和HTTPDNS获取目标转推两种方式,仅支持同时存在一种。
  • 开启转推后,将会产生转推费用,详细计费规则请参考直播转推费用
  • 设置、修改和删除转推配置仅对新发起的推流生效。例如:用户在控制台设置直播转推配置之前已经发起的推流,由于发起推流时直播转推配置不存在,该推流不受正在进行的转推配置影响,即不会转推。

操作步骤

  1. 登录视频直播控制台
  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。
  3. 选择您要配置的推流域名,单击域名配置域名配置
  4. 选择转推配置,并打开转推配置开关。转推配置
  5. 在转推配置窗口,单击指定目标转推并配置相关参数,参数说明如下所示。
    目标转推
    参数 描述
    AppName AppName名称与推流地址中的AppName名称对应,转推才能生效。支持正则表达式配置,如test[1,2,3],表示允许test1,test2,test3三个App转推。
    注意 使用正则表达式配置AppName参数值时不能使用^或$字符,否则会导致转推失败。
    StreamName StreamName名称与推流地址中的StreamName名称对应,转推才能生效。支持正则表达式配置,如streamtest[1,2,3],表示允许streamtest1,streamtest2,streamtest3三个流转推。
    注意 使用正则表达式配置StreamName参数值时不能使用^或$字符,否则会导致转推失败。
    转推地址 转推域名列表。多个域名以半角逗号(,)隔开。示例值:

    push.example1.com,push.example2.com

    透传推流参数 是否透传推流URL中携带的参数。
  6. 单击确定完成对推流域名的指定目标转推配置。

执行结果

在进行下一次推流时,会按照设置的直播转推配置进行转推。

操作步骤

  1. 登录视频直播控制台
  2. 在视频直播控制台左侧导航栏,单击域名管理,进入域名管理页面。
  3. 选择您要配置的推流域名,单击域名配置域名配置
  4. 单击转推配置,并打开转推配置开关。转推配置
  5. 在转推配置窗口,单击配置HTTPDNS获取目标转推获取目标转推

    配置了HTTPDNS获取目标转推,直播转推时将访问通过HttpDns设置的HTTPDNS接口来获取转推目标地址。

    请求示例如下:

    http://example.httpdns.com/?host={<host>}&app={<app>}&name={<name>}{<_ali_user_args>}

    说明:在实际请求HTTPDNS接口时会把以下参数按推流URL中的信息进行替换:

    • {<host>}:推流域名。
    • {<app>}:直播流所属应用名称。
    • {<name>}:流名。
    • {<_ali_user_args>}:用户推流带的参数。

    直播转推对接口返回码和返回数据的要求如下:

    • 返回码为403表示访问失败,不需要转推。
    • 返回码为200表示访问成功,返回结果为JSON格式。结构和参数示例如下:
    
    {
        "cdn_types": [
            {
                "name": "cdnA",
                "upstream_url": "rtmp://cdna.example.com/live/testedge"
            },
            {
                "name": "cdnB",
                "upstream_url": "rtmp://cdnb.example.com/live/testedge"
            }
        ]
    }
                

    参数

    描述

    示例

    name

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

    cdnA

    upstream_url

    要转推的推流地址。

    rtmp://cdna.example.com/live/testedge

    说明
    • 转推域名从返回的JSON结果里面获取。如果返回多个转推域名,表示需要将原始流推到多路。
    • 返回数据结构不符合要求将导致转推失败。
  6. 单击确定完成对推流域名HTTPDNS获取目标转推配置。

执行结果

在进行下一次推流时,会按照设置的直播转推配置进行转推。

操作步骤

  1. 转推配置页面,可以查看已有的转推配置。
  2. 选择修改配置修改配置
  3. 在弹出的转推配置窗口中,修改转推配置,配置参数说明请参见上方步骤配置指定目标转推配置HTTPDNS获取目标转推
  4. 单击确定完成对已有转推配置的修改。

执行结果

在进行下一次推流时,会按照设置的直播转推配置进行转推。
说明 转推配置的修改对已经在转推的推流域名不生效,需要有新的推流开始时,修改后新的转推配置才会生效。