订阅与取消
直播模式中主播发布的音视频资源,会在服务端另行合并生成一道音频合流和一道视频合流。
观众既可以直接订阅原始音视频资源(简称 分流
)也可订阅 合流
。下面将分别介绍这两种订阅方式的区别和适用场景。
观众被定义为只能订阅不能发布,如需发布必须 先转为主播身份,再进行资源的发布。
订阅分流
分流订阅跟会议模式的订阅一样,适合小众玩法灵活的直播业务场景。比如观众被分成多种角色,需要选择性观看或收听部分主播发布的资源;又或者不同观众的展示布局并不相同,甚至可以随时切换布局的情况,SDK 提供视频展示 View 的创建和与流绑定接口,开发者自行编写展示逻辑。
观众的订阅需要在收到主播刚刚发布资源的通知,即 setOnRemotePublishedListener
回调后订阅。可调用 RCRTCEngine
中的 subscribe
来订阅某个主播的音视频资源,如果主播发布的视频资源开启了大小流功能,可以通过 subscribe
的 tiny
参数,来选择订阅大流或小流(默认)。
-
示例代码:
rtcEngine.subscribe(userId, RCRTCMediaType.AudioVideo);
取消订阅分流
当需要取消订阅分流时,可调用 RCRTCEngine
中的 unsubscribe
方法来取消订阅指定的主播资源。取消订阅接口通常跟订阅接口配对使用,但如果是用户想要退出房间,则不需要调用取消订阅方法,在调用退出房间接口时,SDK 内部会自动进行取消处理。
-
示例代码:
rtcEngine.unsubscribe(userId, RCRTCMediaType.AudioVideo);
订阅合流
大部分直播场景,观众数量比较庞大,且所有观众看到和听到的内容完全一致。当有多个主播时,观众采用分流订阅的方式会造成大量带宽资源的浪费,客户成本也会较高。合流就是用来解决资源浪费问题的,它是由融云服务将所有主播发布的音视频资源,按客户提前指定的人选、布局方式和编码参数进行合并生成的一道音频和一道视频合流(纯音频模式仅有一道音频合流)。观众都去订阅这两道合流,则不管有多少名主播连麦/PK,观众都能用很少的资源得到一致的观看效果,从而为客户节省大量成本。下面介绍订阅合流的步骤:
-
监听合流发布回调:
-
示例代码:
rtcEngine.setOnRemoteLiveMixPublishedListener((type: RCRTCMediaType) => {
// type 媒体类型
});
-
-
订阅合流:
监听到合流资源发布事件之后,调用
RCRTCEngine
的subscribeLiveMix
即可订阅指定的合流资源。合流中的视频流是是区分大小流的,可以通过subscribeLiveMix
方法中的tiny
参数,来控制订阅大流或小流(默认)。- 示例代码:
rtcEngine.subscribeLiveMix(RCRTCMediaType.AudioVideo);
取消订阅合流
当需要取消订阅合流时,可调用 RCRTCEngine
中的 unsubscribeLiveMix
方法来取消订阅指定的合流资源。取消订阅接口通常跟订阅接口配对使用,但如果是用户想要退出房间,则不需要调用取消订阅方法,在调用退出房间接口时,SDK 内部会自动进行取消处理。
-
示例代码:
rtcEngine.unsubscribeLiveMix(RCRTCMediaType.AudioVideo);