拉流转推功能支持拉取直播流或点播视频，并转推到您指定的目标地址，例如，您可以通过拉流转推在多个平台同步直播，或将点播视频按直播方式播出。本文介绍如何通过视频直播控制台使用拉流转推功能。

计费说明 #

拉流转推功能支持按拉流转推时长计费。当转推到第三方地址（例如其他云厂商或抖音等直播平台的地址）时，会产生第三方转推带宽费用。详见拉流转推计费。

工作流程 #

拉流转推的完整工作流程如下所示。

1. 拉取直播流或点播视频。
   • 直播流：通过拉流地址拉取直播流。
   • 点播视频：通过视频点播等可通过公网访问的有效视频播放地址拉取点播视频。
2. 转推。
   拉流转推任务将拉取的直播流或点播视频推送至推流地址。您可以通过视频直播、其他云厂商或抖音等直播平台的推流地址，推送拉取的直播或点播内容。
3. 直播观看。
   观众通过播放器，拉取直播流进行观看。

前提条件 #

• 已完成火山引擎账号注册和实名认证，并开通视频直播服务。
• 准备直播流拉流地址或点播地址。
  • 拉流地址：获取有效的直播拉流地址，用于拉取直播流。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。
    如使用视频直播的拉流地址，请使用相同的 AppName 和 StreamName，通过地址生成器生成一对地址，即拉流转推任务的拉流地址和将直播流推送到视频直播的推流地址（可根据实际推流方式选择对应协议）。
  • 点播地址：视频点播等可通过公网访问的有效视频播放地址，用于拉取点播视频。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。
• 准备推流地址，用于推送拉取的直播或点播内容。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。
  • 如使用视频直播的推流地址，请使用相同的 AppName 和 StreamName，通过地址生成器生成一对地址，即拉流转推任务的推流地址和用于观看转推后直播内容的拉流地址（可根据实际拉流方式选择对应协议）。
  • 如使用其他云厂商或抖音等直播平台的推流地址，请查看对应官网文档或联系官方客服获取有效的推流地址。

注意事项 #

• 拉流转推中使用的地址，均不可直接包含多字节编码字符（如中文字符）。如需包含，必须对这些字符进行 URL 编码（URL-encode）。
• 单个拉流转推任务的转推时间范围最长不超过 7 天。
• 如果使用视频直播推流地址作为拉流转推任务的推流地址，您可对转推后的内容配置录制、转码等功能。详见功能配置。

（可选）步骤一：创建拉流转推任务群组 #

拉流转推任务群组会关联项目。您可以通过对子账号进行项目授权，实现对项目内群组和拉流转推任务的管理。

1. 登录视频直播控制台。
2. 在左侧导航栏，选择直播工具 > 拉流转推，进入拉流转推页面。
3. 单击页面右上方的群组管理，在弹出的群组管理对话框中添加、编辑或删除群组。

   说明

   • 视频直播预置关联 default 项目的 default 群组，预置群组不支持删除。
   • 群组新建后仅支持修改项目标签，不支持修改群组名和所属项目。
   

步骤二：创建拉流转推任务 #

1. 登录视频直播控制台。

2. 在左侧导航栏，选择直播工具 > 拉流转推，进入拉流转推页面。

3. 单击创建拉流转推。
   

4. 根据页面提示，完成以下配置并单击确定。
   

   配置项	说明
   标题	拉流转推任务的标题。默认为拉流转推。 长度不超过 20 个字符，支持以下字符： 中文 英文（A-Z，a-z） 数字（0-9）
   来源类型	选择拉取内容的来源。 直播：拉取直播流。 点播：拉取点播视频。
   群组	选择拉流转推任务群组。群组属于项目，您可以通过设置群组实现基于项目的子账号权限细分。
   转推时间	设置任务的开始和结束时间。在该时间范围内，视频直播会执行拉流转推任务。 说明 结束时间必须大于当前时间。 转推时间跨度最长不可超过 7 天。
   拉流地址	从该地址拉取直播流。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。 说明 该字段仅在来源类型为直播时出现。 地址中不可直接包含多字节编码字符（如中文字符）。如需包含，必须对这些字符进行 URL 编码（URL-encode）。
   点播地址	视频点播等可通过公网访问的有效视频播放地址，用于拉取点播视频。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。最多支持添加 30 个地址。 说明 该字段仅在来源类型为点播时出现。 地址中不可直接包含多字节编码字符（如中文字符）。如需包含，必须对这些字符进行 URL 编码（URL-encode）。
   循环方式	点播视频的循环方式。 无限循环：点播视频会无限循环播放。 指定次数：点播视频会循环播放指定次数。支持设置的次数范围为 1-100。 说明 该字段仅在来源类型为点播时出现。
   推流地址	用于推送拉取的直播或点播内容。支持 HTTP、HTTPS、HLS、RTMP、RTMPS、SRT、RTSP 协议。 说明 地址中不可直接包含多字节编码字符（如中文字符）。如需包含，必须对这些字符进行 URL 编码（URL-encode）。 如需转推至抖音等第三方平台，请确保使用的是第三方平台的推流地址。关于如何获取推流地址，请查看第三方平台的官网文档或联系其官方客服。
   水印配置	添加水印配置。 添加水印：上传 PNG 或 JPG 格式的水印图片，大小不超过 2 MB。 水平偏移：水印距画面左侧的比例。取值范围为 0% - 100%。 垂直偏移：水印距画面上侧的比例。取值范围为 0% - 100%。 宽缩比例：水印图片宽度相对实际画面宽度的比例。取值范围为 1% - 100%。 预览效果：根据宽高设置，查看预览效果。您也可以在预览效果下方，拖动水印图片，调整水印的水平偏移、垂直偏移和宽缩比例。
   回调地址	用于接收拉流转推事件的回调地址。有关拉流转推回调消息，详见拉流转推回调消息。

步骤三：管理拉流转推任务 #

在拉流转推页面，您可以对拉流转推任务进行以下操作。

• 修改拉流转推任务：如果您需要调整任务的转推时间、拉流地址、点播地址、推流地址等，可单击任务右侧的编辑进行修改。其中，来源类型和群组不支持修改。
• 启用或停用拉流转推任务：如果您需要开启或停止某个任务，可单击任务右侧的启用或停用。停用后，任务将停止执行。启用后，任务会按当前配置在设定的转推时间内运行。
• 重启拉流转推任务：如果任务当前处于停用或生效中状态，可单击任务右侧的重启。重启后，系统会按当前配置重新发起拉流转推，任务将在设定的转推时间内运行。
• 删除拉流转推任务：如果您确认不再需要某个任务，可单击任务右侧的更多（...）图标，并选择删除。删除后，该任务将无法继续使用。
• 复制拉流转推任务：如果您希望基于现有任务快速创建一个配置相近的新任务，可单击任务右侧的更多（...）图标，并选择复制。

常见问题 #

拉流转推过程中出现断流怎么办？ #

如果拉流转推过程中出现中断，建议优先检查直播拉流地址或点播地址对应的内容是否正常。对于直播流，当出现帧异常等情况时，拉流转推系统会自动重试，但如果直播流持续异常或中断时间较长，则仍可能导致转推中断。
建议您重点排查以下内容：

• 直播拉流地址或点播地址是否有效，且能够正常拉取直播流或点播内容
• 直播流本身是否存在卡顿、断流或帧异常
• 点播视频本身是否存在异常
• 目标推流地址是否有效

点播地址支持哪些来源？ #

拉取点播视频时，支持输入视频点播等可通过公网访问的有效视频播放地址作为点播地址。
建议使用视频点播的播放地址，以便排查视频或播放地址是否存在问题。
拉流转推的稳定性主要取决于点播地址是否有效，以及视频本身是否存在异常。

拉流转推对直播流或点播视频的分辨率、码率等有要求吗？ #

没有要求。但您必须保证直播拉流地址或点播地址有效，且直播流或点播视频本身无异常。

我想录制其他平台的直播流，能通过拉流转推实现吗？ #

可以。
如果您已获取其他平台有效的直播拉流地址，则可通过以下步骤录制该直播流：

1. 在同一域名空间下，至少添加 1 个推流域名和 1 个拉流域名，并完成域名归属权校验和 CNAME 配置。详见添加域名。
2. 使用视频直播控制台的地址生成器，生成推流地址。详见地址生成器。

   说明

   如需观看转推后的直播内容或录制该直播流的转码流，可使用推流地址的 AppName 和 StreamName 生成拉流地址。

3. 在推流域名所属的域名空间下，使用推流地址的 AppName 和 StreamName，添加录制配置。详见录制配置。
4. 创建拉流转推任务，其中：
   • 来源类型：选择直播。
   • 拉流地址：填写您获取的其他平台有效的直播拉流地址。
   • 推流地址：填写步骤 2 生成的推流地址。

完成上述配置后，拉流转推会将直播内容转推到视频直播，与该流匹配的录制配置会对转推后的直播流生效，从而实现录制保存。

拉流转推任务会随着直播流中断或点播内容结束而自动结束吗？ #

不会。拉流转推任务会按照您设置的转推时间运行，不会随着直播流中断或点播内容结束而自动结束。
如果您确认后续不再需要该任务，建议手动停止任务，以免直播流恢复或点播视频继续播放时，任务继续执行并产生相应费用。
建议您在创建拉流转推任务时，按照预计转推时长设置结束时间。如果后续转推时长不够，还可根据实际情况编辑任务调整结束时间。

更新拉流转推任务会导致任务重启或已录制内容丢失吗？ #

不会。更新拉流转推任务不会导致任务重启。如果当前任务已将拉取的直播流或点播视频转推到视频直播地址，并为转推后的直播流添加录制配置，则更新任务时，已生成的录制内容不会丢失。

如果直播预计结束时间晚于任务原定结束时间，怎么办？ #

您可以在任务结束前编辑拉流转推任务，延长任务结束时间，以确保任务持续转推。