房间功能

joinRoom

- (int)joinRoom:(HWRtcJoinParam * _Nonnull)joinParam;

【功能说明】

加入房间。该方法让用户加入通话房间。如果已在通话中，用户必须调用leaveRoom退出当前通话，才能进入下一个房间。

【请求参数】

joinParam：用户信息，具体请参见HWRtcJoinParam。

会触发以下回调：

• onConnStateChange：连接状态发送改变。
• onJoinSuccess：加入房间成功。
• onRemoteUserOnline：远端用户加入。
• onJoinRoomFailure：加入房间失败。

changeUserRole

- (int)changeUserRole:(HWRtcRole)role signature:(NSString *)authorization ctime:(long long)ctime;

【功能说明】

设置用户在本房间内/指定房间的角色，角色切换时使用。

【请求参数】

• role：用户角色，具体请参见HWRtcRole。
• authorization：鉴权信息，当填写null时，则切换角色不鉴权，同时会忽略ctime值。
• ctime：生成鉴权时使用的时间戳，必需匹配对应。

【返回参数】

• 0：方法调用成功。
• > 0：方法调用失败。具体请参见HWRtcErrorCode。

• 加入房间后才可以切换角色，当前仅支持joiner和player角色切换。
• 切换成功触发onUserRoleChange回调。切换失败会触发onError回调，错误码HWRtcErrorCode：HWRtcErrorCodeUserRoleChangeFail。
• 同一时间不同房间最多只能有一个joiner，player切换joiner的时候，需要将joiner先切换成player，再将当前用户切换成joiner。

changeUserName

- (int)changeUserName:(NSString*)userName;

【功能说明】

修改用户昵称。

【请求参数】

userName：用户新的昵称。

getRoomId

- (NSString *)getRoomId;

【功能说明】

获取当前房间的roomId。

【请求参数】

无

disableRejoinRoom

- (int)disableRejoinRoom:(BOOL)disable;

leaveRoom

- (int)leaveRoom;

【功能说明】

离开房间。

【请求参数】

无

• 必须调用leaveRoom结束通话后才可以开始下一次通话。
• 会触发以下回调：
  • connection:onLeaveRoom：离开房间回调。
  • onConnStateChange：连接状态回调。