文档中心

WebRTC 传输网络

发布订阅 API 参考

理解发布资源和订阅资源

发布资源

你必须借助发布资源发起发布。

发布资源是 WTN 服务端分配指定流名的发布对象，通过调用创建发布资源接口进行创建。

发起一次发布任务时，服务端会生成一个发布对象，发布对象会包含本次发布的相关状态信息，如流 mute 状态等。

发布资源的生命周期

发布资源被销毁后，客户端无法与此发布资源建立连接，并且已建立的连接将会断开。

你可以主动销毁发布资源：

在以下情况下，发布资源会被 WTN 销毁：

订阅资源

你必须借助订阅资源发起订阅。

订阅资源是 WTN 服务端分配指定流名的订阅对象，通过调用创建订阅资源接口进行创建。

发起一次订阅任务时，服务端会生成一个订阅对象，其中包含本次订阅的相关状态信息，如流 mute 状态等。

订阅资源的生命周期

订阅资源被销毁后，客户端无法与此订阅资源建立连接，并且已建立的连接将会断开。

你可以主动销毁订阅资源：

在以下情况下，订阅资源会被 WTN 销毁：

发布资源和订阅资源的对应关系

发布资源和订阅资源可以是 1v0, 1v1, 或 1vN 的关系。

当发布资源被销毁时，对应的所有订阅资源都被销毁。

特殊场景下订阅端的表现

发布客户端的行为会影响对应的订阅客户端的行为。影响的情况如下：

场景	发布端行为	订阅端行为
1	未发布。	订阅返回 404。
2	发布过程中，销毁发布资源。	订阅连接被断开。重新订阅时返回 404。
3	发布过程中，因网络原因与 WTN 服务端连接断开，并在 30s 内恢复。	正在订阅的客户端：与 WTN 服务端的连接不断开，画面保持最后一帧。发布端连接恢复后，订阅端收到正常的媒体流。发布端网络断开期间发起订阅的客户端：与 WTN 服务端建连成功，收到黑帧。发布端连接恢复后，订阅端收到正常的媒体流。
4	发布过程中，因网络原因与 WTN 服务端连接断开，超过 30s 未恢复。	正在订阅的客户端：与 WTN 服务端的连接不断开。发布资源被销毁后，订阅连接断开。发布端网络断开期间发起订阅的客户端：与 WTN 服务端建连成功。发布资源被销毁后，订阅连接断开。
5	调用相同的参数，重复建立发布资源。	订阅的媒体流会发生切换。

最近更新时间：2026.01.13 20:18:09

这个页面对您有帮助吗？

有用

无用