低延迟直播 4.x 版本主播和 5.x 版本观众的兼容方案

4.x 版本的主播和 5.x 版本观众存在兼容的问题,需要 App 开发者自己去做兼容会给用户带来一定的工作量,所以现在 5.1.2 版本 sdk 提供新的接口去兼容,目的是让用户升级版本能够平滑过渡。
发布时间: 2021-04-29 19:30

回答:

观看直播(新版 5.1.2 sdk )

1.背景

  • 4.x 版本的的观众没有加房间的功能,只能通过订阅 liveUrl 来订阅合流;

  • 5.x 版本的观众会先加入房间,拿到房间内的合流来订阅;

假设 4.x 版本的主播和 5.x 版本的观众进行直播互动。

  • 5.x 观众只能事先知道是 4.x 主播在当前房间,使用订阅 liveUrl 的方式观看直播;

  • 5.x 观众如果事先知道是 5.x 主播在当前房间,应该加入房间去拿到直播合流订阅观看;

2.加入房间

连接 IM 服务成功后,观众端首先调用 RCRTCEnginejoinRoom:config:completion: 方法创建一个直播类型房间。加入房间成功后,调用 RCRTCRoom 新增的 getLiveStreams 拿到直播的合流进行订阅,如代码所示。

示例代码

- (void)joinLiveRoom {
    RCRTCRoomConfig *config = [[RCRTCRoomConfig alloc] init];
    config.roomType = RCRTCRoomTypeLive; //房间类型
    config.liveType = RCRTCLiveTypeAudioVideo; //直播类型
    config.roleType = RCRTCLiveRoleTypeAudience; //观众角色

    [[RCRTCEngine sharedInstance] joinRoom:@"房间号"
                                  config:config
                              completion:^(RCRTCRoom * _Nullable room, RCRTCCode code) {
        if (code != RCRTCCodeSuccess) {
            // 错误处理
            return;
        }
        // 设置房间事件代理
        self.room = room;
        self.room.delegate = self;

        // 加入房间时存在live合流,可以直接订阅
        NSArray *liveStreams = [room getLiveStreams];
        if (liveStreams.count) {
            // 从房间拿到合流去订阅
            [room.localUser subscribeStream:liveStreams tinyStreams:nil completion:^(BOOL isSuccess, RCRTCCode desc) {
                // to do something
            }];
        }else{
            // 拿不到合流,直接使用传递过来的 liveUrl 进行订阅
            [room.localUser subscribeLiveUrl:self.liveUrl streamType:RCRTCAVStreamTypeAudioVideo completion:^(RCRTCCode code, NSArray<RCRTCInputStream *> * _Nullable inputStreams) {
                // to do something
            }];
        }
    }];
}

3.订阅资源

假设上述操作的房间内只存在 4.x 主播,通过 getLiveStreams方法是拿不到主播合流的,这时候就可以使用新增 RCRTCLocalUsersubscribeLiveUrl:streamType:completion:进行订阅,代码如图所示。

示例代码

    if (liveStreams.count) {
        // 从房间拿到合流去订阅
        [room.localUser subscribeStream:liveStreams tinyStreams:nil completion:^(BOOL isSuccess, RCRTCCode desc) {
            // to do something
        }];
    }else{
        // 拿不到合流,直接使用传递过来的 liveUrl 进行订阅
        [room.localUser subscribeLiveUrl:self.liveUrl streamType:RCRTCAVStreamTypeAudioVideo completion:^(RCRTCCode code, NSArray<RCRTCInputStream *> * _Nullable inputStreams) {
            // to do something
        }];
    }
/*!
 观众订阅合流资源

 @param liveUrl 主播直播的 liveUrl (针对 4x版本的主播兼容方案)
 @param streamType 需要具体订阅的媒体类型
 @param completion  完成的回调, 会依次回调合流的 RCRTCInputStream, 根据 streamType 区分是音频流还是视频流, 如主播发布了音视频流, 此回调会回调两次, 分别为音频的 RCRTCInputStream,  和视频的 RCRTCInputStream 。
 @discussion
 仅直播模式可用,  作为观众, 直接观看主播的直播, 通过传入主播的 url, 仅观众端可用,此接口可具体订阅音频流或视频流或大小流
 Added from 5.1.2

 @remarks 媒体流操作
 */
- (void)subscribeLiveUrl:(nonnull NSString *)liveUrl
              streamType:(RCRTCAVStreamType)streamType
              completion:(nullable RCRTCLiveUrlCallback)completion;

4.关于 liveUrl

任何版本的主播在发布资源的时候会从回调的里面的RCRTCLiveInfo对象中获取liveUrl。推荐开发者可以通过 App server 或者融云的 IM 聊天室设置 kv 的方式给到观众端。

示例代码

@interface RCRTCLiveInfo : NSObject

/**
 当前的直播地址
 @discussion 新版观众加房间,直接可以拿到直播合流, 单个主播流,使用常规方式订阅即可
 */
@property (nonatomic, copy, readonly) NSString *liveUrl
 // 发布本地流到房间
    [self.room.localUser publishDefaultLiveStreams:^(BOOL isSuccess, RCRTCCode desc, RCRTCLiveInfo * _Nullable liveInfo) {
        if (desc == RCRTCCodeSuccess) {
            self.liveInfo = liveInfo; 
           //获取 liveUrl
            self.liveUrl = liveInfo.liveUrl;
        }else {
            [UIAlertController alertWithString:@"本地流发布失败" inCurrentVC:nil];
        }
    }];

附上兼容 Demo 地址

下载 quickdemo 项目,打开 workspace 找到项目 quickdemo-live-compatibility