跳到主要内容

房间事件回调

应用程序可以通过 RCRTCRoom 对象的 delegate 属性设置注册 RCRTCRoomEventDelegate 代理委托。

设置代理后，App 可以监听房间的的状态及资源变化。在会议模式下，参会的远端用户的状态变化都会触发通知。直播模式下，仅主播角色的远端用户会触发通知。

提示

RCRTCRoomEventDelegate 代理不会返回直播模式下观众相关的事件。原因如下：第一，观众只可订阅主播资源，不能发布资源，其操作对直播并无任何影响。第二，观众数量通常较多，如果应用针对观众进出直播间及订阅事件都进行处理，对应用程序的性能造成严重负面影响。

状态相关​

  1. 远端参会用户（或远端主播用户）加入通知：

    当有远端参会用户（或远端主播用户）加入时触发。因主播加入房间后才能发布资源，该回调代表远端参会用户（或远端主播用户）刚刚加入，此时并无任何资源发布，所以当前也订阅不到该用户的任何媒体流。

    - (void)didJoinUser:(RCRTCRemoteUser *)user;

  2. 远端参会用户（或远端主播用户）离开通知：

    当有远端参会用户（或远端主播用户）离开房间时触发，此时 SDK 会自动取消订阅该用户已发布的流，无需手动调用 unsubscribeStream。

    - (void)didLeaveUser:(RCRTCRemoteUser *)user;

  3. 远端参会用户（或远端主播用户）掉线通知：

    当有远端参会用户（或远端主播用户）掉线时触发，代表该用户意外与融云服务断连超过 1 分钟。网络不好、App 意外崩溃或用户主动杀进程等情况，都会造成客户端与融云服务断连。如 1 分钟内没有恢复，则会被服务判定掉线，此时 SDK 会自动取消订阅该用户的所有资源，无需手动调用 unsubscribeStream。

    - (void)didOfflineUser:(RCRTCRemoteUser *)user;

  4. 远端参会用户（或远端主播用户）音频静默状态变更通知：

    当远端参会用户（或远端主播用户）调用了音频流的 isMute 方法时触发。通过 stream 对象能拿到该用户 userId，参数 mute 为远端参会用户（或远端主播用户）更新后的值，YES 代表音频静默，NO 代表恢复正常。

    - (void)stream:(RCRTCInputStream *)stream didAudioMute:(BOOL)mute;

  5. 远端参会用户（或远端主播用户）视频静默状态变更通知：

    当远端参会用户（或远端主播用户）调用了视频流的 isMute 方法时触发。参数 mute 为远端参会用户（或远端主播用户）更新后的值，YES 代表视频静默，NO 代表恢复正常。

    - (void)stream:(RCRTCInputStream *)stream didVideoEnable:(BOOL)enable;

资源相关​

  1. 远端参会用户（或远端主播用户）资源发布通知：

    当远端参会用户（或远端主播用户）发布资源时触发，streams 为该用户当前发布流的集合。从中可以获取发送人（userId），流标签（tag），媒体类型（type），当前状态（state）等信息，也可以调用 subscribeStream 接口，订阅其中的流。

    - (void)didPublishStreams:(NSArray <RCRTCInputStream *> *)streams;

  2. 远端参会用户（或远端主播用户）资源取消发布通知：

    当远端参会用户（或远端主播用户）取消发布资源时触发，接收到后 SDK 会自动取消订阅这些流。开发者也可以根据这些流中的信息，来给用户做出相应的提示。

    - (void)didUnpublishStreams:(NSArray<RCRTCInputStream *> *)streams;

数据相关​

  1. 第一个音视频关键帧到达通知：

     - (void)didReportFirstFrame:(RCRTCInputStream *)stream mediaType:(RCRTCMediaType)mediaType;

  2. 房间自定义消息到达通知：

    - (void)didReceiveMessage:(RCMessage *)message;
最后于 更新