客户端事件通知（ClientEvent）

peer-join

【事件说明】

远端用户加入房间事件，远端用户加入房间后会收到该事件通知。

【回调参数】

peerJoinEvent：必选，PeerJoin类型，用户信息。

PeerJoin定义为：{

• userId：必选，string[64]类型，用户标识。
• userName：可选，string[256]类型，用户昵称。

}

peer-leave

【事件说明】

远端用户离开房间事件，远端用户离开房间后会收到该事件通知。

【回调参数】

peerLeaveEvent：必选，PeerLeaveInfo 类型，用户离开信息。

PeerLeaveInfo 定义为：{

• userId：必选，string[64]类型，用户标识。
• userName：可选，string[256]类型，用户昵称。
• reason：可选，HRTCLeaveReason类型。

}

HRTCLeaveReason定义为：{

• code：number类型, 离开原因枚举，取值如表2 离开房间原因所示。
• msg：string类型，原因描述。

stream-added

【事件说明】

远端流添加事件，当远端用户发流成功后会收到该事件通知。

【回调参数】

stream：必选，RemoteStream类型，远端流对象。

stream-removed

【事件说明】

远端流移除事件，当远端用户取消发流或者原来已经发布的远端用户退出房间后会收到该事件通知。

【回调参数】

stream：必选，RemoteStream类型，远端流对象。

stream-updated

【事件说明】

远端流更新事件，当远端用户的流发生变化，例如添加或者移除音视频轨，视频轨规格变化时会收到该事件通知。

【回调参数】

stream：必选，RemoteStream类型，远端流对象。

stream-subscribed

【事件说明】

远端流订阅成功事件，当订阅远端流成功后会收到该事件通知。

【回调参数】

stream：必选，RemoteStream类型，远端流对象。

client-banned

【事件说明】

用户被踢下线事件，当用户以相同的userId 在其他Client加入相同的房间后，被踢的Client会收到该事件通知。

【回调参数】

clientBannedEvent：必选，ClientBanInfo类型，

}

kick-room

【事件说明】

解散房间，由调用的服务端接口触发。

【回调参数】

roomId：必选，string[64]类型，房间Id。

Error

【事件说明】

客户端错误事件，当出现不可恢复的错误后，Client会上报该事件通知。

【回调参数】

errorInfo：必选，ErrorInfo类型，错误信息。

}

connection-state-changed

【事件说明】

Client连接状态变更事件，Client连接状态变更会收到该事件通知。

【回调参数】

• ConnectionStateInfoEvent：{
  • prevState：必选，ConnectionState类型，变更前状态。
  • curState：必选，ConnectionState类型，变更后状态。

}

mute-audio

【事件说明】

远端用户禁用音频通知事件，当远端用户禁用音频后，流接收端会收到该事件通知。

【回调参数】

mediaStatus：必选，MediaStatusNotifyInfo类型。

MediaStatusNotifyInfo包含如下属性：

• roomId：必选，string[64]类型。
• userId：必选，string[64]类型。
• status：必选，MediaStatusAction类型。MediaStatusAction枚举值定义如下所示：
  • 1：媒资状态可用。
  • 2：媒资状态不可用。
• reason：必选，MediaStatusReason类型。MediaStatusReason枚举值定义如下所示：
  • 0：媒体离线。
  • 1：媒体静音。
  • 2：媒体不静音。

unmute-audio

【事件说明】

远端用户启用音频通知事件，当远端用户启用音频后，流接收端会收到该事件通知。

【回调参数】

mediaStatus：必选，MediaStatusNotifyInfo类型。

mute-video

【事件说明】

远端用户禁用视频通知事件，当远端用户禁用视频后，流接收端会收到该事件通知。

【回调参数】

mediaStatus：必选，MediaStatusNotifyInfo类型。

unmute-video

【事件说明】

远端用户启用视频通知事件，当远端用户启用视频后，流接收端会收到该事件通知。

【回调参数】

mediaStatus：必选，MediaStatusNotifyInfo类型。

log-upload-result

【事件说明】

日志上传结果事件。

【回调参数】

status：必选，number类型，日志上传结果，200表示成功，其余表示失败。

signature-expired

【事件说明】

签名过期事件。

【回调参数】

errorInfo：错误信息。必选，ErrorInfo类型。

}

取值示例，如下所示：

• 签名过期：{

  errorCode: '90100030'

  errorMsg: 'signature expired'

  }

• 签名无效：{

  errorCode: '90100031'

  errorMsg: 'signature invalid'

  }

注意：

监听到签名过期事件后可通过错误码区分是签名无效还是签名过期，签名过期后可通过renewSignature接口更新签名。

camera-changed

【事件说明】

本地摄像头设备变更事件，当插、拔本地摄像头时触发。

【回调参数】

DeviceChangedEvent：必选，DeviceChangedInfo类型，设备变更详情。

}

注意：

视频采集设备，拔插后需要应用层进行相应的处理，如：拔除摄像头的时候是否切换其他视频采集设备重新采集；插入摄像头的时候是否使用新插入设备进行重新采集。

recording-device-changed

【事件说明】

本地录音设备变更事件，当本地录音设备变更时触发。

【回调参数】

DeviceChangedEvent：必选，DeviceChangedInfo类型，设备变更详情。DeviceChangedInfo定义参考camera-changed中的说明。

注意：

麦克风采集设备，拔插后需要应用层进行相应的处理，如：拔除麦克风的时候是否切换其他麦克风采集设备重新采集；插入麦克风的时候是否使用新插入设备进行重新采集。

playback-device-changed

【事件说明】

本地音频播放设备变更事件，当本地音频播放设备变更时触发。

【回调参数】

DeviceChangedEvent：必选，DeviceChangedInfo类型，设备变更详情。DeviceChangedInfo定义参考camera-changed中的说明。

network-quality

【事件说明】

网络上下行质量报告事件，用户加入房间后，SDK在网络质量变化的时候会触发一次该事件，报告用户的本地网络上下行质量情况。

【回调参数】

NetworkQualityEvent：必选， NetworkQualityInfo类型，网络上下行质量详情。

}

stream-interrupted

【事件说明】

远端流的码流中断事件。中断表示在 enableStreamStateDetection 接口参数 interval 设置的统计周期内未接收到有效视频帧。该事件为 1.4.0 版本新增。

【回调参数】

streamInterruptedEvent：必选，UserList[]类型，已订阅且无视频码流的用户列表。

}

stream-recovered

【事件说明】

远端流的码流恢复事件。

【回调参数】

streamRecoveredEvent：必选，UserList[]类型，已订阅且视频码流恢复的用户列表。UserList参考stream-interrupted中的定义。该事件为1.4.0版本新增。

volume-indicator

【事件说明】

音频TopN模式下，房间中当前音量最大的用户提示事件。

【回调参数】

userVolumeInfos：必选， UserVolumeInfo[]类型。

}

注意：

该事件仅在音频TopN模式下生效，1.5.0版本新增。

remote-user-name-changed

【事件说明】

远端用户昵称变更事件。该事件为1.5.0版本新增。

【回调参数】

userNameChangedEvent：必选， UserNameInfo类型。

}

live-streaming-updated

【事件说明】

旁路推流状态更新事件。该事件为2.0.1版本新增。

【回调参数】

urlStatus：UrlStatus[]类型，所有CDN推流状态更新。UrlStatus定义如下：

• url：必选，string类型，表示CDN推流URL
• status：必选，number类型，表示当前推流状态。
  • 0：初始化。
  • 1：链接正常且有流。
  • 2：链接正常但无流。
  • 3：异常重试。
  • 4：处理失败。
• errorCode：可选，number类型，表示详细的失败原因，支持的枚举值如下：
  • 0： 正常。
  • 1： 内部错误。
  • 2： 地址解析失败。
  • 3： 连接失败。
  • 4： RTMP握手失败。
  • 5： 内存错误。
  • 6： 参数错误。
  • 7： 重试失败。
  • 8： 响应超时失败。

rtc-stats

【^{事件说明】}

音视频流数据统计事件。该事件为2.0.3版本新增。

【回调参数】

rtcStatsInfo：必选， rtcStatsInfo[]类型。

}