WebRTC 传输网络（WTN）提供基于标准 RTMP 协议的推流接入能力。您可以通过 RTMP 协议将音视频流推送到 WTN 服务节点，WTN 会在传输网内自动将其转换为 WebRTC 协议，以便客户端进行低延迟拉流播放。本文介绍了如何构造 RTMP 推流地址并完成接入。

适用场景 #

RTMP 推流接入适用于无法集成 SDK，但支持标准 RTMP 协议推流的硬件设备或软件客户端。例如：

• IoT 设备接入：如抓娃娃机、无人机、智能机器人等嵌入式设备。
• 存量设备上云：如早期的安防摄像头、编码器等。
• 标准化推流：支持 RTMP 协议的第三方推流软件或自定义客户端。

准备工作 #

在开始接入前，请确保您已完成以下准备工作：

1. 开通服务：登录 WTN 控制台，创建 WTN 应用并获取 AppID。
2. （可选）生成鉴权 Token。
   在控制台的 功能配置 页面，确认您的应用是否开启了 推流鉴权。推流鉴权的状态会影响推流地址的构造方式。
   • 如果应用开启了推流鉴权，那么您在构造推流地址时需要提供鉴权 Token。只有携带合法 Token 的客户端才能成功发布音视频流。
     您可以基于 AppID、AppKey、StreamID 等，在您的应用服务端生成鉴权 Token。更多信息，请参见接口鉴权。
   • 如果应用未开启推流鉴权，则无需生成鉴权 Token，所有客户端都可以免鉴权发布音视频流。

   说明

   • 在生产环境中建议开启推流鉴权以保障安全。
   • 开启推流鉴权需要在 URL 中添加 Token，这会增加其总长度。如果您的推流设备或软件对 URL 长度有限制，可以关闭推流鉴权。
   

技术规格要求 #

为确保 RTMP 推流能被 WTN 节点正常处理，推流端的音视频编码必须符合以下要求：

构造推流地址 #

您需要按照以下规则手动构造 RTMP 推流地址。

URL 格式 #

rtmp://{your-prefix}.bytertcmedia.com/app/{streamID}?app_id={AppId}&vhost=rtmp_streaming&token={Token}

参数说明 #

URL 示例 #

假设您的配置如下：

• 自定义前缀：demo
• AppID：638****
• StreamID：room101_camera
• Token：Bearer+eyJ...（已编码）

开启鉴权时的 URL：

rtmp://demo.bytertcmedia.com/app/room101_camera?app_id=638****&vhost=rtmp_streaming&token=Bearer%2BeyJ...

关闭鉴权时的 URL：

rtmp://demo.bytertcmedia.com/app/room101_camera?app_id=638****&vhost=rtmp_streaming

播放验证 #

推流成功后，您可以通过以下任意一种方式进行拉流验证。请确保拉流时使用的 StreamID 与推流时设置的保持一致。

• 使用 WebRTC 协议拉流：
  1. 调用创建订阅资源接口，传入 StreamID 创建订阅资源。
  2. 参考5. 订阅端：订阅和播放音视频流，在订阅端实现 WTN 流播放。
• 使用 RTC SDK 拉流：
  如果您希望兼容 H5 浏览器并实现自动启播，建议集成 RTC SDK。
  集成 RTC SDK 后，您可以调用 subscribeWTNVideoStream /subscribeWTNAudioStream（Native） 或 startPlayWTN （Web）接口，填入 StreamID 来实现 WTN 流播放。