IEngineEvents

类型: interface

• API

onPlayerEvent()

播放器事件

• 类型

(event: PlayerEvent) => void

• 参数

• event

  类型: PlayerEvent

onUserJoined()

用户加入房间

• 类型

(event: onUserJoinedEvent) => void

• 参数

• event

  类型: onUserJoinedEvent

onUserLeave()

用户离开房间

• 类型

(event: onUserLeaveEvent) => void

• 参数

• event

  类型: onUserLeaveEvent

onConnectionStateChanged()

连接状态发生变化

• 类型

(event: ConnectionStateChangeEvent) => void

• 参数

• event

  类型: ConnectionStateChangeEvent

onStreamAdd()

房间内有新的媒体流发布

• 类型

(event: { stream: RTCStream;}) => void

• 参数

• event

  类型: { stream: RTCStream; }

  • 成员

  名称	类型	描述
  stream	RTCStream	stream 对象

onUserMuteAudio()

房间内用户暂停/恢复发送音频流时，房间内其他用户将收到此事件

• 类型

(event: UserMuteEvent) => void

• 参数

• event

  类型: UserMuteEvent

onUserMuteVideo()

房间内用户暂停/恢复发送视频流时，房间内其他用户将收到此事件

• 类型

(event: UserMuteEvent) => void

• 参数

• event

  类型: UserMuteEvent

onStreamRemove()

房间内有媒体流停止发送

• 类型

(event: { stream: RTCStream; reason: StreamRemoveReason;}) => void

• 参数

• event

  类型: { stream: RTCStream; reason: StreamRemoveReason; }

  • 成员

  名称	类型	描述
  stream	RTCStream	指定媒体流
  reason	StreamRemoveReason	原因

onVideoFirstFrameRendered()

视频首帧渲染

• 类型

(event: onVideoFirstFrameRenderedEvent) => void

• 参数

• event

  类型: onVideoFirstFrameRenderedEvent

onVideoFirstFrameDecoded()

视频首帧解码

• 类型

(event: onVideoFirstFrameDecodedEvent) => void

• 参数

• event

  类型: onVideoFirstFrameDecodedEvent

onAudioFirstFrameDecoded()

音频首帧解码

• 类型

(event: onAudioFirstFrameDecodedEvent) => void

• 参数

• event

  类型: onAudioFirstFrameDecodedEvent

onMediaDeviceStateChanged()

媒体设备状态改变

• 类型

(event: RTCDevice) => void

• 参数

• event

  类型: RTCDevice

  设备及状态

onAutoplayFailed()

自动播放失败

• 类型

(event: PlayerEvent) => void

• 参数

• event

  类型: PlayerEvent

onTrackEnded()

断流事件

• 类型

(event: { kind: string; isScreen: boolean;}) => void

• 参数

• event

  类型: { kind: string; isScreen: boolean; }

  • 成员

  名称	类型	描述
  kind	string	类型
  isScreen	boolean	是否屏幕流

onRoomMessageReceived()

接收到房间内广播消息的事件。

• 类型

(event: { userId: string; message: any;}) => void

• 参数

• event

  类型: { userId: string; message: any; }

  • 成员

  名称	类型	描述
  userId	string	发送消息用户的 userId
  message	any	消息内容

onRoomBinaryMessageReceived()

接收到房间内二进制广播消息的事件。

• 类型

(event: { userId: string; message: ArrayBuffer;}) => void

• 参数

• event

  类型: { userId: string; message: ArrayBuffer; }

  • 成员

  名称	类型	描述
  userId	string	发送消息用户的 userId
  message	ArrayBuffer	消息内容

onUserMessageReceived()

收到来自房间中其他用户通过 sendUserMessage 发来的点对点文本消息时，会收到此事件

• 类型

(event: UserMessageEvent) => void

• 参数

• event

  类型: UserMessageEvent

onUserBinaryMessageReceived()

收到来自房间中其他用户通过 sendUserBinaryMessage 发来的点对点二进制消息时，会收到此事件

• 类型

(event: UserBinaryMessageEvent) => void

• 参数

• event

  类型: UserBinaryMessageEvent

onRemoteStreamStats()

用户订阅的远端音/视频流统计信息以及网络状况，统计周期为 2s

• 类型

(stats: RemoteStreamStats) => void

• 参数

• stats

  类型: RemoteStreamStats

onLocalStreamStats()

本地音/视频流统计信息以及网络状况，统计周期为 2s

• 类型

(stats: LocalStreamStats) => void

• 参数

• stats

  类型: LocalStreamStats

onPublicStreamStats()

用户订阅的公共流统计信息以及网络状况，统计周期为 2s。

• 类型

(stats: PublicStreamStats) => void

• 参数

• stats

  类型: PublicStreamStats

onLocalAudioPropertiesReport()

调用 enableAudioPropertiesReport 后，根据设置的 interval 值，你会周期性地收到此回调，了解本地音频的相关信息。

本地音频包括使用 RTC SDK 内部机制采集的麦克风音频和屏幕音频。

• 类型

(event: LocalAudioPropertiesInfo[]) => void

• 参数

• event

  类型: LocalAudioPropertiesInfo[]

  本地音频信息。
  

onRemoteAudioPropertiesReport()

远端用户进房后，本地调用 enableAudioPropertiesReport，根据设置的 interval 值，本地会周期性地收到此回调，了解订阅的远端用户的音频信息。

远端用户的音频包括使用 RTC SDK 内部机制/自定义机制采集的麦克风音频和屏幕音频。

• 类型

(event: RemoteAudioPropertiesInfo[]) => void

• 参数

• event

  类型: RemoteAudioPropertiesInfo[]

  远端音频信息，其中包含音频流属性、房间 ID、用户 ID。
  

onAudioPlaybackDeviceChanged()

当使用 setAudioPlaybackDevice 时，会收到此事件

• 类型

(event: RTCDevice) => void

• 参数

• event

  类型: RTCDevice

  媒体设备信息，详见官方文档。

onUserStartAudioCapture()

房间内的可见用户调用 startAudioCapture 开启音频采集时，房间内其他用户会收到此事件。

• 类型

(event: { userId: string;}) => void

• 参数

• event

  类型: { userId: string; }

  • 成员

  名称	类型	描述
  userId	string	开启音频采集的远端用户 ID

onUserStopAudioCapture()

房间内的可见用户调用 stopAudioCapture 关闭音频采集时，房间内其他用户会收到此事件。

• 类型

(event: { userId: string;}) => void

• 参数

• event

  类型: { userId: string; }

  • 成员

  名称	类型	描述
  userId	string	关闭音频采集的远端用户 ID

onUserStartVideoCapture()

房间内的可见用户调用 startVideoCapture 开启内部视频采集时，房间内其他用户会收到此事件。

• 类型

(event: { userId: string;}) => void

• 参数

• event

  类型: { userId: string; }

  • 成员

  名称	类型	描述
  userId	string	开启视频采集的用户 ID

onUserStopVideoCapture()

房间内的可见用户调用 stopVideoCapture 关闭内部视频采集时，房间内其他用户会收到此事件。

• 类型

(event: { userId: string;}) => void

• 参数

• event

  类型: { userId: string; }

  • 成员

  名称	类型	描述
  userId	string	停止视频采集的用户的 ID

onSEIMessageReceived()

接收到包含 SEI 数据的视频帧事件

• 类型

(event: onSEIMessageEvent) => void

• 参数

• event

  类型: onSEIMessageEvent

  SEI 数据事件

onAutoSubscribeResult()

如果开启了自动订阅，订阅成功或者失败后可以收到此事件

• 类型

(event: { userId: string; isScreen: boolean; state: SubscribeState;}) => void

• 参数

• event

  类型: { userId: string; isScreen: boolean; state: SubscribeState; }

  • 成员

  名称	类型	描述
  userId	string	订阅用户的 userId
  isScreen	boolean	是否为屏幕流
  state	SubscribeState	订阅状态

onAutoPublishResult()

如果开启了自动发布，发布成功或者失败后可以收到此事件

• 类型

(event: { isScreen: boolean; state: PublishState;}) => void

• 参数

• event

  类型: { isScreen: boolean; state: PublishState; }

  • 成员

  名称	类型	描述
  isScreen	boolean	是否为屏幕流
  state	PublishState	发布状态

onAutoplayFailed()

自动播放失败

• 类型

(event: PlayerEvent) => void

• 参数

• event

  类型: PlayerEvent

  播放器事件

onLiveTranscodingResult()

转推直播结果事件

• 类型

(event: LiveTranscodingResultEvent) => void

• 参数

• event

  类型: LiveTranscodingResultEvent

onError()

当 SDK 内部发生不可逆转错误时触发该回调

• 类型

(event: { errorCode: ErrorCode.DUPLICATE_LOGIN | ErrorCode.RTM_DUPLICATE_LOGIN | ErrorCode.RTM_TOKEN_ERROR | ErrorCode.EXPIRED_TOKEN;}) => void

• 参数

• event

  类型: { errorCode: ErrorCode.DUPLICATE_LOGIN | ErrorCode.RTM_DUPLICATE_LOGIN | ErrorCode.RTM_TOKEN_ERROR | ErrorCode.EXPIRED_TOKEN; }

  • 成员

  名称	类型	描述
  errorCode	ErrorCode.EXPIRED_TOKEN | ErrorCode.DUPLICATE_LOGIN | ErrorCode.RTM_DUPLICATE_LOGIN | ErrorCode.RTM_TOKEN_ERROR	查看错误码和发生错误的原因

onAudioMixingStateChanged()

音频混音文件播放状态改变事件

• 类型

(event: AudioMixingStateChangedEvent) => void

• 参数

• event

  类型: AudioMixingStateChangedEvent

onUserMessageReceivedOutsideRoom()

接收到房间外消息的事件。

• 类型

(event: UserMessageEvent) => void

• 参数

• event

  类型: UserMessageEvent

onUserBinaryMessageReceivedOutsideRoom()

接收到房间外二进制消息的事件。

• 类型

(event: UserBinaryMessageEvent) => void

• 参数

• event

  类型: UserBinaryMessageEvent

onTokenWillExpire()

Token 过期前 30 秒将触发该回调。
调用 updateToken 更新 Token。否则 Token 过期后，用户将被移出房间无法继续进行音视频通话。

• 类型

() => void

onCloudProxyConnected()

调用 startCloudProxy 开启云代理，SDK 首次成功连接云代理服务器时，回调此事件。

• 类型

(event: CloudProxyConnectedEvent) => void

• 参数

• event

  类型: CloudProxyConnectedEvent

onPushPublicStreamResult()

公共流发布结果回调。
调用 startPushPublicStream 发布公共流后，结果通过此回调通知用户。

• 类型

(event: PublicStreamResultEvent) => void

• 参数

• event

  类型: PublicStreamResultEvent

onFirstPublicStreamVideoFrameDecoded()

公共流的视频首帧解码成功。
关于订阅公共流，参看 startPlayPublicStream。

• 类型

(event: PublicStreamVideoFirstFrameDecodedEvent) => void

• 参数

• event

  类型: PublicStreamVideoFirstFrameDecodedEvent

onFirstPublicStreamAudioFrameDecoded()

公共流的音频首帧解码成功。
关于订阅公共流，参看 startPlayPublicStream。

• 类型

(event: PublicStreamAudioFirstFrameDecodedEvent) => void

• 参数

• event

  类型: PublicStreamAudioFirstFrameDecodedEvent

onFirstPublicStreamVideoFrameRendered()

公共流的首帧视频渲染成功。

• 类型

(event: PublicStreamAudioFirstFrameDecodedEvent) => void

• 参数

• event

  类型: PublicStreamAudioFirstFrameDecodedEvent

onAudioPlaybackDeviceTestVolume()

回调音频设备测试时的播放音量

• 类型

(volume: number) => void

• 注意

调用 startAudioPlaybackDeviceTest 或 startAudioDeviceRecordTest，开始播放音频文件或录音时，将开启该回调。本回调为周期性回调，回调周期由上述接口的 interval 参数指定。

• 参数

• volume

  类型: number

  音频设备测试播放音量。单位：毫秒。推荐设置为 200 ms。范围：[0,255]