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

背景信息

支持指定目标转推和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参数值时不能使用^或$字符，否则会导致转推失败。
    转推地址 转推域名列表。多个域名以半角逗号（,）隔开。示例值：

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

执行结果

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

操作步骤

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

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

    请求示例如下：

    http://example.aliyundoc.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://example.aliyundoc.com/live/testedge****"
        },
        {
            "name": "cdnB",
            "upstream_url": "rtmp://example.aliyundoc.com/live/testedge****"
        }
    ]
}

    参数

    描述

    示例

    name

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

    cdnA

    upstream_url

    要转推的推流地址。

    rtmp://example.aliyundoc.com/live/testedge****

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

执行结果

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

操作步骤

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

执行结果

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