You need to enable JavaScript to run this app.
导航

发布资源和订阅资源

最近更新时间2023.02.06 11:18:14

首次发布时间2022.08.30 14:30:08

发布资源

你必须借助发布资源发起发布。
发布资源是 WTN 服务端分配指定流名的发布对象,通过调用 创建发布资源 接口进行创建。

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

发布资源的生命周期

发布资源被销毁后,客户端无法与此发布资源建立连接,并且已建立的连接将会断开。
你可以主动销毁发布资源:

  • 调用接口销毁发布资源;
  • 调用接口重复发布。此时,原发布资源会被销毁。

在以下情况下,发布资源会被 WTN 销毁:

  • 创建发布资源后,超过 30 秒未与发布资源建立连接;
  • 已开始发布,但发布客户端因网络异常断开与 WTN 的连接,并超过 30 秒未能重建连接。

订阅资源

你必须借助订阅资源发起订阅。
订阅资源是 WTN 服务端分配指定流名的订阅对象,通过调用 创建订阅资源 接口进行创建。

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

订阅资源的生命周期

订阅资源被销毁后,客户端无法与此订阅资源建立连接,并且已建立的连接将会断开。
你可以主动销毁订阅资源:

在以下情况下,订阅资源会被 WTN 销毁:

  • 对应的发布资源被销毁;
  • 创建订阅资源后,未在 15s 内与订阅资源建立连接;
  • 已开始订阅,但订阅客户端因网络异常断开与 WTN 的连接。

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

发布资源和订阅资源可以是 1v0, 1v1, 或 1vN 的关系。
当发布资源被销毁时,对应的所有订阅资源都被销毁。

特殊场景下订阅端的表现

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

场景发布端行为订阅端行为
1未发布。订阅返回 404
2发布过程中,销毁发布资源。订阅连接被断开。重新订阅时返回 404

3

发布过程中,因网络原因与 WTN 服务端连接断开,并在 30s 内恢复。

  • 正在订阅的客户端:与 WTN 服务端的连接不断开,画面保持最后一帧。发布端连接恢复后,订阅端收到正常的媒体流。
  • 发布端网络断开期间发起订阅的客户端:与 WTN 服务端建连成功,收到黑帧。发布端连接恢复后,订阅端收到正常的媒体流。

4

发布过程中,因网络原因与 WTN 服务端连接断开,超过 30s 未恢复。

  • 正在订阅的客户端:与 WTN 服务端的连接不断开。发布资源被销毁后,订阅连接断开。
  • 发布端网络断开期间发起订阅的客户端:与 WTN 服务端建连成功。发布资源被销毁后,订阅连接断开。
5调用相同的参数,重复建立发布资源。订阅的媒体流会发生切换。