You need to enable JavaScript to run this app.
文档中心
视频直播

视频直播

复制全文
下载 pdf
常见问题
功能咨询问题
复制全文
下载 pdf
功能咨询问题

视频直播服务支持哪些加速区域?

添加推流域名或拉流域名时支持为域名设置加速区域,您可以根据域名使用者所在区域为域名设置加速区域,实现内容传输或分发的加速。

支持设置的加速区域有:

  • 中国内地
  • 全球加速
  • 海外及港澳台

通过视频直播控制台添加域名并设置加速区域请参见添加域名,通过视频直播服务端 API 添加域名并设置加速区域请参见添加域名接口批量添加域名接口

通过视频直播控制台修改加速区域请参见域名配置-修改域名的加速区域

推流域名和拉流域名应该如何选择加速区域?

选择加速区域时,建议根据主播的实际推流区域和观众的实际观看区域进行选择。

说明

如果域名的加速区域与主播推流区域或观众观看区域不一致,在部分情况下仍可正常推流或播放,但稳定性无法保证,通常更容易出现延迟升高、卡顿或播放不稳定等问题。

  • 对于推流域名:
    • 当主播在中国内地时,建议选择中国内地
    • 当主播在海外(不含中国内地)及中国香港、中国澳门、中国台湾时,建议选择海外及港澳台
    • 当主播分布同时覆盖中国内地、中国香港、中国澳门、中国台湾以及其他国家和地区时,建议选择全球加速
  • 对于拉流域名:
    • 当观众在中国内地时,建议选择中国内地
    • 当观众在海外(不含中国内地)及中国香港、中国澳门、中国台湾时,建议选择海外及港澳台
    • 当观众分布同时覆盖中国内地、中国香港、中国澳门、中国台湾以及其他国家和地区时,建议选择全球加速

视频直播服务支持哪些推流协议?

视频直播支持 RTM、RTMP、RTMPS、SRT、WebTransport 等推流协议。您可通过地址生成器,生成推流地址。详见地址生成器

说明

如需生成 RTMPS 推流地址,可将生成的 RTMP 地址的 rtmp:// 替换为 rtmps://

推流协议说明
RTM超低延时直播(Real Time Media),通过链路传输协议改造为 UDP 等底层技术优化,解决 TCP 协议自身局限和网络抖动引起延迟累加,配合字节播放端 SDK,可以支持千万级并发场景下的毫秒级延时视频直播,有效解决 FLV、HLS 等 TCP 协议直播 3~10 秒延时的问题。
RTMP实时信息传输协议(Real Time Message Protocol)是用来在 Flash 播放器和服务器之间进行流媒体音视频传输的网络协议。RTMP 工作在 TCP 之上,默认使用 1935 端口,是一个标准的、未加密的实时消息传递协议。
RTMPSRTMPS 为 RTMP 的一个变种,是工作于 TLS/SSL 之上的 RTMP,它利用 SSL 在传输层对网络连接进行加密,默认端口为 443。RTMPS 很好地解决了 RTMP 的安全问题。详情请参考 RTMPS 推流
SRT安全可靠传输协议(Secure Reliable Transport)简称 SRT,是一种基于 UDP 协议的开源互联网传输协议,具有较好的丢包重传能力,解决了复杂的传输时序问题并且可以减少延迟。详情请参考 SRT 协议推流
WebTransport是一个 Web API,使用 HTTP/3 协议作为双向传输。它用于 Web 客户端和 HTTP/3 服务器之间的双向通信。它支持通过其数据报 API 以不可靠方式发送数据,以及通过其流 API 以可靠方式发送数据。相比 WebRTC 有更好的直播音视频编码兼容性,同时可以提供低延迟通道。

视频直播服务支持哪些拉流协议?

视频直播支持 RTM、RTMP、RTMPS、FLV 和 HLS 等拉流协议,暂不支持 WHEP、SRT 拉流协议。您可通过地址生成器,生成拉流地址。详见地址生成器

说明

如需生成 RTMPS 拉流地址,可将生成的 RTMP 地址的 rtmp:// 替换为 rtmps://

拉流协议延迟优点缺点

RTM

<1s

超低延时

需要集成 SDK 或按协议标准接入。如需在 Web 端进行超低延时播放,请使用 RTM 协议的拉流地址。

说明

在浏览器环境下播放 RTM 流时,请确保浏览器支持 WebRTC。

RTMP1-3s低延时跨平台支持较差,需要 Flash 支持
RTMPS1-3s低延时,相比 RTMP 更安全跨平台支持较差,需要 Flash 支持
FLV2-3s低延时跨平台支持较差,需要 Flash 支持
HLS>10s移动端,H5 原生支持延迟高

视频直播是否支持不转码直接播放?

支持。如无需转码,您可以使用源流拉流地址播放直播流。有关如何获取源流拉流地址,详见如何获取推拉流地址?

如需将直播流推送到第三方平台,可使用拉流转推功能。

视频直播拉流域名是否支持超低延时直播?

支持。超低延时直播功能无需单独开通,添加域名后系统默认支持该功能。使用 RTM 协议拉流地址即可实现超低延时播放。

为保证在浏览器环境下可以正常播放 RTM 流,请先为拉流域名开启 HTTPS 安全加密,并确保浏览器支持 WebRTC。有关如何开启 HTTPS 安全加密,详见配置 HTTPS 安全加密

RTM 协议拉流地址格式为 http(s)://{拉流域名}/{AppName}/{StreamName}.sdp?{鉴权信息},详见直播地址组成规则。您可通过控制台的地址生成器生成 RTM 协议拉流地址,详见地址生成器

说明

如需进一步降低直播延时,可结合 RTM 推流使用。

使用视频直播服务时是否还需要开通 CDN 服务?

不需要,视频直播服务自身支持为域名进行 CDN 加速,只使用视频直播服务无需额外开通 CDN 服务。

URL 鉴权过期会影响当前正在进行的推拉流吗?

  • 对于 RTMP、FLV 等用于长时间直播推流或拉流的协议,当用户发起推流或拉流请求时,视频直播服务端会对鉴权参数进行校验。一旦校验通过,用户可以持续推流或拉流,不受签名失效时间的影响。因此,只要在签名失效前已经发起请求,推流或拉流就不会因签名失效而中止。仅新发起的推流或拉流请求会因签名失效而失败。
  • HLS 和 DASH 协议用于分段视频播放,用户会不断地发起新的拉流请求,以获取后续分段内容。用户每次发起拉流请求时,视频直播服务端均会对鉴权参数进行校验。因此,一旦签名失效,请求将被拒绝,导致播放中断。由于直播播放过程中需要持续请求后续分段内容,因此建议设置较长的签名失效时间,以避免直播中途播放失败。

一个拉流域名同时可进行多少路拉流?

并发直播拉流数量无限制。

如您有业务增长活动突发场景,请至少提前 3 个工作日联系客户经理或创建工单联系技术获取帮助。大规模突发增长包含以下两种场景。

  • 日峰值带宽突发增长量大于 500Gbps 的场景。
  • 日峰值带宽突发增长量超过近一个月日峰值带宽月均值的 100%,且增量数值超过 200Gbps 的场景。

直播推流失败如何排查?

以下问题可能导致推流失败,请逐一进行检查:

  1. 检查推流端网络。
    您可以通过以下任一方式检查推流端的网络环境。如有异常,请更换网络后,再重新推流。
    • 在线带宽测试:使用在线带宽测试工具初步检查推流端网络环境。
      在线测速工具显示的峰值上行速率,不等同于直播过程中持续稳定可用的上行带宽。判断推流网络是否满足要求时,建议关注推流过程中的实时码率、帧率是否稳定。如果实时码率或帧率频繁波动,可能会导致观众侧播放卡顿,严重时可能播放中断。
    • 推流端网络测试:使用 ping 命令初步检查推流设备到推流域名的连通性、延迟和丢包情况。
      1. 在推流设备的命令行工具中执行以下命令,将 push.example.com 替换为您推流地址中的推流域名。例如,推流地址为 rtmp://push.example.com/live/test,则推流域名为 push.example.com
        • macOS 或 Linux:ping -c 100 -i 1 push.example.com
        • Windows:ping -n 100 push.example.com
      2. 测试完成后,查看丢包率和延迟情况。
        • packet loss 或“丢失”:表示未收到响应的测试包比例。0% 表示未发现丢包。如持续出现丢包,或连续多次显示“请求超时”(Request timeout),建议更换网络后重试。
        • avg 或“平均”:表示平均延迟。单位为毫秒。
        • max 或“最长”:表示最高延迟。单位为毫秒。如该数值明显高于平均延迟,说明网络可能存在突发波动。例如,平均延迟为几十毫秒、最高延迟达到数百毫秒以上。
        • mdevstddev:表示延迟波动程度。数值越大,说明延迟波动越明显。

    说明

    • ping 结果仅用于初步排查网络连通性、延迟和丢包,不完全等同于实际推流质量。请结合推流工具中显示的输出码率、帧率、网络丢帧和重连记录综合判断。
    • 推流码率越高,对推流端设备性能、网络上行带宽和网络稳定性的要求越高。建议优先使用稳定的网络环境进行推流,如有条件可优先使用有线网络,尽量避免在网络抖动较大的 Wi-Fi 或移动网络环境下长时间推流。
    • 视频直播不会针对不同运营商做限制或区别处理。只要推流端网络的上行带宽和稳定性满足要求,不同运营商的网络均可正常推流。
    • 如果您在控制台的 Web 推流页面推流时出现 3007, message: connect lost 等报错,通常也是推流端网络异常导致,建议更换网络后重试。
  2. 检查域名状态及 CNAME 是否生效。
    1. 登录视频直播控制台,左侧导航栏选择功能管理 > 域名管理
    2. 在域名列表中,检查推流域名状态是否为正常和 CNAME 解析是否成功。
      Image
  3. 推流地址是否正确。
    1. 登录视频直播控制台,左侧导航栏选择直播工具 > 地址生成器
    2. 使用地址生成器生成推流地址,以检查您的推流地址是否正确。

    说明

    • 若推流域名已开启 URL 鉴权,请使用包含鉴权信息的推流地址。
    • 如 RTM 推流出现 RTM signaling HTTP 403 错误,表示 RTM 信令鉴权失败。若当前推流域名已开启 URL 鉴权,请优先通过地址生成器或调用 GeneratePushURL 接口获取包含鉴权信息的 RTM 推流地址。如手动拼接 RTM 推流地址,请参考 B 类鉴权方式检查鉴权参数和时间戳参数的名称及取值是否正确。如刚关闭或修改 URL 鉴权配置,请等待约 5 分钟后,使用新生成的推流地址再次推流。
  4. 推流地址是否被占用。
    1. 登录视频直播控制台,左侧导航栏选择直播管理 > 流管理 > 在线流
    2. 通过对比在线流的 StreamName、域名、AppName,检查您的推流地址是否被占用。
      Image
    3. 如您的推流地址被占用,您可以更换新的流名称(StreamName)重新进行推流。
  5. 直播流是否禁推。
    1. 登录视频直播控制台,左侧导航栏选择直播管理 > 流管理 > 禁推流
    2. 检查您的直播流是否被禁推。
      Image
    3. 如您的直播流被禁推,请选择启用解禁该直播流或更换新的流名称(StreamName)重新进行推流。
  6. 如通过以上检查仍无法解决问题,请创建工单联系技术支持获取帮助。

如何获取推拉流地址?

如需使用拉流地址播放指定推流地址的直播内容,请先确认推流域名和拉流域名属于同一域名空间,并在生成推流地址和拉流地址时使用相同的 AppNameStreamName。例如推流地址为 rtmp://push.example.com/live/test,则使用同一域名空间下的拉流域名,以及 AppName liveStreamName test 生成拉流地址。

确认以上信息后,您可通过以下任一方式获取推拉流地址。

说明

若无需转码,请获取源流拉流地址。如需播放转码流,请先创建转码配置,再使用对应的转码流后缀获取转码流拉流地址。

  • 地址生成器:视频直播控制台提供地址生成器工具,您可以直接在地址生成器中生成推拉流地址用于简单测试。
  • 手动拼接:您可以参考推拉流地址拼接规则,手动拼接推拉流地址。详见最佳实践-生成直播地址
  • 调用 API 接口获取:视频直播提供生成推拉流地址的 API,您可以调用 GeneratePushURLGeneratePlayURL 接口,或使用服务端 SDK 生成推拉流地址。

直播录制和直播截图是否支持存储到对象存储服务(TOS)中?

支持,请创建工单联系技术支持开通 TOS 使用授权。

一次直播录制会生成几个录制文件?

新增录制配置时需要设置录制周期(即单个文件时长),直播录制过程中会根据直播时长、录制周期等配置生成录制文件,详细参考录制配置

  • 实时录制,录制格式为 HLS、MP4 和 FLV 时支持实时录制。实时录制生成录制文件有以下规则:
    • 当直播时长小于录制周期,且直播过程中未出现断流,将生成一个录制文件;
    • 当直播时长大于录制周期,且直播过程中未出现断流,每达到一个录制周期,生成一个新的录制文件;
    • 当直播过程中有出现断流,每次中断都将生成一个新的录制文件。
  • 断流录制,录制格式为 HLS 时支持断流录制。断流录制生成录制文件有以下规则:
    • 当直播过程中未出现断流,将生成一个录制文件;
    • 当直播过程中出现断流,且断流时长超过设置的拼接时长时,将生成新的录制文件;
    • 当直播过程中出现断流,且断流时长未超过设置的拼接时长时,不会生成新的录制文件。

如何使用直播时移?

直播时移将 HLS(HTTP Live Streaming)视频直播推流切分为 TS(Transport Stream)分片,并进行保存。配置时移后,观众可以任意回放精彩视频内容。

请参考以下操作实现:

  1. 创建时移配置。
    1. 登录视频直播控制台,左侧导航栏选择功能管理 > 功能配置 > 时移配置
    2. 单击添加配置按钮,参考时移配置新增时移配置。
  2. 生成时移地址:参考拼接直播时移播放地址,生成时移地址。
  3. 使用时移地址播放视频直播流。

在使用视频直播控制台的用量统计时,每 5 min 的用量统计是指前 5 min 还是后 5 min?

5 min 粒度的用量统计使用的是后 5 min 的数据。控制台用量统计每个数据切片都是向后取值,即 15:00 的用量统计的是 15:00:00-15:04:59 的计量。

Image

如何创建子账号以及系统预设策略支持的直播服务的权限是哪些?

创建子账号的流程如下:

  1. 登录火山引擎控制台视频直播控制台
  2. 在顶部导航栏中选择头像 > 访问控制,默认进入访问控制的用户列表页面。
  3. 单击新建用户,根据提示填写基本信息、选择视频直播产品的权限策略,完成子账号的创建。
  4. 进入控制台登录页面,选择使用账号登录。

直播服务的系统预设权限策略说明如下:

策略名策略类型备注
LIVEReadOnlyAccess系统预设策略视频直播服务只读访问权限。
LIVEFullAccess系统预设策略视频直播服务全部管理权限。

如何同时录制多个格式视频,如 HLS、MP4?

录制配置支持创建同时录制多个视频格式的配置,您可以通过以下方式创建该配置:

  • 使用 API 接口创建录制配置,同时传入 HlsParam、Mp4Param 和 FlvParam,详细请参见添加录制配置接口。
  • 在视频直播控制台中添加录制配置,同时选中要录制的录制格式并配置录制参数。
    Image

我想用 OBS 直播,让观众在指定页面观看直播,应该怎么做?

您可以按以下步骤实现使用 OBS 进行直播推流,并在指定页面播放直播内容:

  1. 在同一域名空间下,添加 1 个推流域名和 1 个拉流域名,并完成域名归属校验和 CNAME 配置。详见添加域名
  2. 使用视频直播控制台的地址生成器,为相同 AppNameStreamName 生成推流地址和拉流地址。详见地址生成器
  3. 使用 OBS 推流。详见使用 OBS 推流
  4. 在您的页面中集成 Web 拉流 SDK,并使用拉流地址播放直播内容。详见集成 SDK

视频直播支持弹幕、评论、聊天等互动功能吗?

视频直播产品本身主要提供直播推流、拉流及相关直播处理能力,例如转码、录制、截图等。弹幕、评论、聊天等互动功能不属于视频直播直接提供的能力,通常需要结合其他产品实现。

如何设置竖屏直播?

直播画面的横竖方向,取决于推流输出的视频分辨率。例如,使用 OBS 推流时,可单击设置,并在视频页签下,将基础(画布)分辨率输出(缩放)分辨率调整为竖屏分辨率,例如 720 × 1280。有关如何通过 OBS 推流,详见使用 OBS 推流

Image

直播画面出现绿屏怎么办?

直播画面出现绿屏,通常与视频流中包含 B 帧有关。

请完成以下步骤,解决绿屏问题:

  1. 创建转码配置。

    1. 登录视频直播控制台,左侧导航栏选择功能配置
    2. 在页面上方的域名空间下拉列表中,选择拉流域名所在的域名空间。
    3. 转码配置页签下,单击添加配置,新增转码配置。具体配置,详见转码配置。其中,B 帧(帧间隔)​设置为 0

    Image
    4. 单击确定

  2. 生成转码流地址。

    1. 地址生成器页面,选择您的拉流域名、与推流地址相同的 AppNameStreamName,并单击生成拉流地址。例如推流地址为 rtmp://push.example.com/live/test,则使用 AppName liveStreamName test 生成拉流地址。
    2. 在页面右侧的转码流地址页签下,选择您配置的转码流后缀,并获取转码流地址。

    Image

  3. 使用获取的转码流地址重新播放。

使用视频直播服务,是否必须通过 SDK 或 API 接入?

不是。视频直播服务既支持通过 SDK 或 API 进行开发接入,也支持通过控制台和第三方工具直接使用,无需自行开发代码即可完成基础推拉流。

例如,您可以通过控制台添加推流域名和拉流域名,生成推流地址和拉流地址后,使用 OBS 等第三方工具推流,并将拉流地址用于播放器或网页播放直播内容。如需将直播内容转推到抖音等第三方平台,还可以使用拉流转推等功能。

如需实现自定义播放器界面、业务交互逻辑或更复杂的直播能力,再按需结合 SDK 或 API 进行开发接入。

能否通过 API 让指定推流地址或拉流地址立即失效?

目前不支持直接通过 API 使某个推流地址或拉流地址立即失效。您可以按需通过以下方式实现相近效果:

  • 如需让地址在一段时间后失效,请先为对应域名开启 URL 鉴权。您可以通过控制台配置,也可以调用 UpdateAuthKey 进行配置。完成配置后,再调用 GeneratePushURLGeneratePlayURL,通过 ValidDurationExpiredTime 控制地址有效期。地址过期后,仅新发起的推流或拉流请求会失败。
    • 对于 RTMP、FLV 等协议,如果在地址过期前已发起推流或拉流,则可继续推流或拉流。
    • 对于 HLS 和 DASH 协议,由于观众会不断地发起新的拉流请求,以获取后续分段内容,地址过期后可能会在拉流过程中中止。
  • 如需立即断开当前正在进行的推流或拉流,请调用 KillStream。该接口仅对当前推流或拉流连接生效,断开后推流端仍可重新推流,拉流端仍可重新发起拉流,适用于需要立即中断当前推流或拉流、但允许后续重新连接的场景。
  • 如需在一段时间内禁止直播流继续推送或播放,请调用 ForbidStream

直播过程中可以插入提前录制的视频吗?

可以。通过以下任一方式,您可以在直播过程中插入提前录制的视频,再切回直播画面。

  • 控制台:通过云导播功能,将直播流和提前录制的视频(MP4 格式)分别作为不同视频源,在直播过程中通过切播操作插入录播视频,再切回直播画面。
  • 服务端 API:调用 CreateCloudMixTask 创建云端混流任务,将直播流和提前录制的视频(MP4 或 FLV 格式)作为不同输入源进行混流输出。

如何防止推流地址被他人盗用?

如果您担心推流地址泄露后被他人盗用,建议采取以下措施:

  1. 为推流域名开启 URL 鉴权。开启后,只有通过鉴权的推流地址才能发起新的推流请求。详见配置 URL 鉴权
  2. 在生成推流地址时,设置推流地址的过期时间。推流地址过期后,仅新发起的推流请求会因地址过期而失败(如果在地址过期前已经发起推流,则可继续推流)。这样即使地址泄露,也可以降低被继续使用的风险。在开启 URL 鉴权后,您可以按需选择以下任一方式生成带鉴权信息和过期时间的推流地址:
  3. 妥善保管带鉴权信息的推流地址以及用于调用服务端 API 的访问凭证,避免泄露。
  4. 如果您的推流设备或服务器使用固定公网 IP,可进一步配置 IP 白名单,仅允许指定 IP 地址发起推流。详见配置 IP 黑白名单
  5. 如果发现某一路直播流已被异常推送,可以调用 ForbidStream,在一段时间内禁止继续推流。

为什么播放 HLS 流没有声音?

请按以下步骤排查:

  1. 检查源流是否包含音频轨。
  2. 检查播放器配置是否正确,例如播放器未静音、音量不为 0。如通过浏览器自动播放,请确认是否因浏览器限制自动播放音频而导致无声。
  3. 检查播放流的音频编码格式。HLS 支持多种音频编码格式,但不同播放器和终端的支持范围存在差异。使用非 AAC 音频编码格式时,部分播放器或终端可能无法正常解码,导致无声。您可通过转码配置将音频编码格式设置为 AAC。添加或更新转码配置 3-5 分钟后,重新推流,并使用对应转码流后缀的 HLS(m3u8)拉流地址进行播放。
最近更新时间:2026.09.13 02:36:07
这个页面对您有帮助吗?
有用
有用
无用
无用