跳到主要内容

订阅与取消

直播模式中主播发布的音视频资源,会在服务端另行合并生成一道音频合流和一道视频合流。 观众既可以直接订阅原始音视频资源(简称 分流)也可订阅 合流。下面将分别介绍这两种订阅方式的区别和适用场景。

提示

观众被定义为只能订阅不能发布,如需发布必须先转为主播身份,再进行资源的发布。

订阅分流

分流订阅跟会议模式的订阅一样,适合小众玩法灵活的直播业务场景。比如观众被分成多种角色,需要选择性观看或收听部分主播发布的资源;又或者不同观众的展示布局并不相同,甚至可以随时切换布局的情况,SDK 提供视频展示 View 的创建和与流绑定接口,开发者自行编写展示逻辑。

观众的订阅需要在收到主播刚刚发布资源的通知,即 setOnRemotePublishedListener 回调后订阅。可调用 RCRTCEngine 中的 subscribe 来订阅某个主播的音视频资源,如果主播发布的视频资源开启了大小流功能,可以通过 subscribetiny 参数,来选择订阅大流或小流(默认)。

  • 示例代码:

    engine.subscribe(userId, RCRTCMediaType.AudioVideo);

取消订阅分流

当需要取消订阅分流时,可调用 RCRTCEngine 中的 unsubscribe 方法来取消订阅指定的主播资源。取消订阅接口通常跟订阅接口配对使用,但如果是用户想要退出房间,则不需要调用取消订阅方法,在调用退出房间接口时,SDK 内部会自动进行取消处理。

  • 示例代码:

    engine.unsubscribe(userId, RCRTCMediaType.AudioVideo);

订阅合流

大部分直播场景,观众数量比较庞大,且所有观众看到和听到的内容完全一致。当有多个主播时,观众采用分流订阅的方式会造成大量带宽资源的浪费,客户成本也会较高。合流就是用来解决资源浪费问题的,它是由融云服务将所有主播发布的音视频资源,按客户提前指定的人选、布局方式和编码参数进行合并生成的一道音频和一道视频合流(纯音频模式仅有一道音频合流)。观众都去订阅这两道合流,则不管有多少名主播连麦/PK,观众都能用很少的资源得到一致的观看效果,从而为客户节省大量成本。下面介绍订阅合流的步骤:

  1. 监听合流发布回调:

    • 示例代码:

      engine.setOnRemoteLiveMixPublishedListener((type) => {
      // type 媒体类型
      });
  2. 订阅合流:

    监听到合流资源发布事件之后,调用 RCRTCEnginesubscribeLiveMix 即可订阅指定的合流资源。合流中的视频流是是区分大小流的,可以通过 subscribeLiveMix 方法中的 tiny 参数,来控制订阅大流或小流(默认)。

    • 示例代码:
    engine.subscribeLiveMix(RCRTCMediaType.AudioVideo);

取消订阅合流

当需要取消订阅合流时,可调用 RCRTCEngine 中的 unsubscribeLiveMix 方法来取消订阅指定的合流资源。取消订阅接口通常跟订阅接口配对使用,但如果是用户想要退出房间,则不需要调用取消订阅方法,在调用退出房间接口时,SDK 内部会自动进行取消处理。

  • 示例代码:

    engine.unsubscribeLiveMix(RCRTCMediaType.AudioVideo);