提交工单
咨询集成、功能及报价等问题
初始化 SDK 之后,使用推拉流功能前,需要先登录房间。
在登录房间之前,必须要提前设置用户信息, userID
与 userName
不能为空、空字符串,否则会导致 loginRoom 返回 NO。
userID
还能便于 ZEGO 技术支持帮忙查找定位问题,所以一定要设置成一个有意义的值,开发者还能与自己的业务账号系统进行关联。
注意: 每个 userID
必须唯一,userID
只支持长度不超过 64 字节的数字、下划线、字母, userName
支持长度不超过 256 字节的任意格式字符串。
[ZegoLiveRoomApi setUserID:@"YOUR_USER_ID" userName:@"YOUR_USER_NAME"];
登录房间之前需要设置房间相关的回调监听,以在成功登录房间后接收房间相关的事件通知,比如处理因网络中断退出房间等问题。
[api setRoomDelegate:self];
建议处理 ZegoRoomDelegate 中的以下回调接口:
onDisconnect:roomID:
房间与 ZEGO 服务器断开连接的通知;SDK默认在断网后重试300秒,之后依旧没有恢复网络时会收到这个回调,此时推流/拉流都会断开;App 端需要检测网络,在正常联网时重新登录房间,重新推流/拉流。开发者可通过在initSDK前调用setConfig的setConfig:@"room_retry_time=xxx"
和setConfig:@"av_retry_time=xxx"
来自定义重试时间,单位为秒。onKickOut:roomID:
该用户被踢出房间的通知;有另外的设备用同样的 userID 登录了相同的房间,造成前面登录的用户被踢出房间,或者后台调用踢人接口将此用户踢出房间;App 应提示用户被踢出房间。
onStreamUpdated:streams:roomID:
:房间内有流新增、流删除的通知,在类似视频通话、直播等场景下收到房间流新增通知时拉取此新增流,在收到房间流删除通知时停止拉取此删除流。 其余回调接口请根据业务实际情况进行选择处理,完整的房间回调接口请查看ZegoRoomDelegate
调用 loginRoom
登录房间。
注意:roomID 需保证房间 ID 信息的全局唯一,只支持长度不超过 128 字节的数字、下划线、字母。
[api loginRoom:roomID role:role withCompletionBlock:^(int errorCode, NSArray<ZegoStream *> *streamList) {
// streamList,内部封装了 userID、userName、streamID 和 extraInfo。
// 登录房间成功后,开发者可通过 streamList 获取到当前房间推流信息,便于后续的拉流操作。
// 当 streamList 为空时说明当前房间没有人推流
if (errorCode == 0) {
//登录房间成功
}
else {
//登录房间失败
}
}];
调用 logoutRoom
退出房间。
[api logoutRoom];
方法 | 描述 |
---|---|
+ setUserID:userName: | 设置 UserID 与 UserName |
– setRoomDelegate: | 设置房间代理 |
– loginRoom:role:withCompletionBlock: | 登录房间 |
– logoutRoom | 退出房间 |
完成了登录房间后,可以使用 ZEGO SDK 依次完成如下功能来实现基础的通话或者直播。
联系我们
文档反馈