userJoined property
read / write
远端用户(通信场景)/主播(直播场景)加入当前频道回调。
- 通信场景下,该回调提示有远端用户加入了频道,并返回新加入用户的 ID;如果加入之前,已经有其他用户在频道中了,新加入的用户也会收到这些已有用户加入频道的回调
- 直播场景下,该回调提示有主播加入了频道,并返回该主播的用户 ID。如果在加入之前,已经有主播在频道中了,新加入的用户也会收到已有主播加入频道的回调。Agora 建议连麦主播不超过 17 人
该回调在如下情况下会被触发:
- 远端用户/主播调用 RtcChannel.joinChannel 方法加入频道。
- 远端用户加入频道后调用 RtcChannel.setClientRole 将用户角色改变为主播。
- 远端用户/主播网络中断后重新加入频道。
- 主播通过调用 RtcChannel.addInjectStreamUrl 方法成功输入在线媒体流。
Note 直播场景下:
- 主播间能相互收到新主播加入频道的回调,并能获得该主播的用户 ID。
- 观众也能收到新主播加入频道的回调,并能获得该主播的用户 ID。
- 当 Web 端加入直播频道时,只要 Web 端有推流,SDK 会默认该 Web 端为主播,并触发该回调。
UidWithElapsedCallback
包含如下参数:
- int
uid
:新加入频道的远端用户/主播 ID。 - int
elapsed
:从本地用户调用 RtcEngine.joinChannel 或 RtcEngine.setClientRole 到触发该回调的延迟(毫秒)。
Implementation
UidWithElapsedCallback userJoined