发布和订阅

本文详细介绍如何使用百家云WebSDK 发布和取消发布本地音视频，以及订阅和取消订阅远端音视频

发布音视频

完成本地流的创建和初始化，并且成功加入房间后，就可以调用 Client.publish 将本地的音视频数据发布到当前房间，以供房间中的其他用户订阅。

this.client.publish(this.publishStream)
.then(() => {
  //发布流成功处理逻辑
})
.catch((error) => {
  //发布流失败处理逻辑
})

关于发布，注意事项如下：

• 同一时间只能发布一个音视频轨道。若想发布另外一个本地流,可先通过 unpublish 取消发布当前本地流后再发布新的本地流。
• 在发布本地流后,可通过 removeTrack、addTrack、replaceTrack 来更新本地流中的某个音频或视频流
• 发布本地流后远端会收到 ‘stream-added’ 事件通知
• 该方法为异步方法，使用时需要配合 Promise 或 async/await。

错误处理

在发布过程中，可能因为网络环境或者 SDK 使用不当抛出以下错误：

• INVALID_OPERATION: 非法操作，message 中的错误信息如下：
  • client 未 join，请先执行 join
  • audience（观众）不支持推流，请先执行 switchRole 切换角色为 anchor（主播）
  • LocalStream 未初始化
  • LocalStream 至少需要一个媒体轨道
  • 当前已在推流，请先执行 unpublish 取消之前的 localstream 推流再推新的 localstream
• INVALID_PARAMETER: stream 参数错误。
• PERMISSION_DENY_AUDIO: 没有音频推送权限。
• PERMISSION_DENY_VIDEO: 没有视频推送权限。
• MEDIA_PUBLISH_ERROR : 发布流失败，message中的错误信息如下：
  • 没有加入房间
  • 发布的流对象已经被释放

取消发布音视频流

成功发布本地轨道后，如果想取消发布，可以调用 client.unpublish。

this.client.unpublish(this.publishStream)
this.publishStream.destroy()
this.publishStream = null

关于取消发布，注意事项如下：

• 取消发布本地流后远端会收到 'stream-removed' 事件通知。
• 请在 leave() 退房前取消已经发布的本地流。
• 该方法可以多次调用。你可以使用 publish 和 unpublish 实现发布和取消发布某个本地轨道。
• 该方法为异步方法，使用时需要配合 Promise 或 async/await。

错误处理

在发布过程中，可能因为网络环境或者 SDK 使用不当抛出以下错误：

• INVALID_OPERATION: 非法操作，message 中的错误信息如下：
  • client 未 join，请先执行 join
  • stream 未发布
• INVALID_PARAMETER: stream 参数错误。

订阅音视频

当远端用户成功发布音视频之后，SDK 会触发 stream-added 事件。可以调用 client.subscribe() 发起订阅。 该方法为异步方法，使用时需要配合 Promise 或者 async/await。

client.on('stream-added', (data) => {
  //远端推流
  let remoteStream = data.stream
  this.client.subscribe(remoteStream, {
    video: true,
    audio: true,
    streamType: 'small'
  }).then(
    () => {
      //订阅流成功
    },
    (error) => {
      //订阅流失败,重新订阅
      setTimeout(() => {
        this.client.subscribe(remoteStream).then(() => {
          //重新订阅成功
        })
      })
    }
  )
})

可通过该订阅接口指明需要订阅音频、视频或者音视频流。

错误处理

在订阅过程中，因为网络环境等因素 SDK 可能抛出如下错误：

• INVALID_OPERATION: 非法操作，message 中的错误信息如下：
  • client 未 join，请先执行 join
  • 当前 client 已被设置为只能 publish 流
  • stream 已被销毁
  • 音频和视频至少需要订阅一个
  • stream 已不存在，无法订阅
• INVALID_PARAMETER: stream 参数错误。
• SUBSCRIPTION_TIMEOUT：订阅流超时。
• STREAM_ALREADY_DESTROYED_ERROR: stream 已被销毁

取消订阅音视频

可以通过 client.unsubscribe 取消订阅远端的音视频。

this.client.unsubscribe(remoteStream).then(() => {
  //取消订阅成功
}).catch(error => {
  //取消订阅失败
})

关于取消订阅，注意事项如下：

• 取消订阅成功后，SDK 会释放相应的 RemoteStream 对象。一旦远端流对象被释放，SDK 会自动移除音视频的播放元素，音视频播放也会停止。
• 如果远端用户主动取消发布，本地会收到 stream-removed 回调，收到该回调时 SDK 会自动释放相应的 RemoteStream 对象，无需再调用 unsubscribe 。
• 该方法为异步方法，使用时需要配合 Promise 或 async/await。

错误处理

在订阅过程中，因为网络环境等因素 SDK 可能抛出如下错误：

• INVALID_OPERATION: 非法操作，message 中的错误信息如下：
  • client 未 join，请先执行 join
  • 当前 client 已被设置为只能 publish 流
  • stream 已被销毁
• INVALID_PARAMETER: stream 参数错误。