IZegoRangeSceneEventHandler

Declared in callback/IZegoRangeSceneEventHandler.java

方法

onSceneStateUpdate

public void onSceneStateUpdate(ZegoRangeScene rangeScene, ZegoSceneState state, int errorCode)

场景状态变化通知

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
state	ZegoSceneState	当前场景状态。
errorCode	int	错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

详情

场景状态变化通知。

通知时机：场景状态变化。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。

onEnterView

public void onEnterView(ZegoRangeScene rangeScene, ZegoUser user, ZegoPosition position)

其他用户进入当前用户视野范围回调。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
user	ZegoUser	用户对象。
position	ZegoPosition	用户位置。

详情

其他用户进入当前用户视野范围回调。

通知时机：其他用户进入当前用户视野范围。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。

onLeaveView

public void onLeaveView(ZegoRangeScene rangeScene, String userID)

其他用户离开当前用户视野范围回调通知。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
userID	String	用户 ID。

详情

其他用户离开当前用户视野范围回调通知。

通知时机：其他用户离开当前用户视野范围。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。

onUserStatusUpdate

public  void onUserStatusUpdate(ZegoRangeScene rangeScene, String userID, ZegoPosition position, int channel, byte[] status)

用户状态变更回调。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
userID	String	用户 ID。
position	ZegoPosition	用户当前位置。
channel	int	状态所属通道。
status	byte[]	用户当前状态数据。

详情

用户状态变更回调。

通知时机：用户状态变更。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。
注意事项：本回调为高频回调，请勿在本回调中做耗时操作。

onUserCommandUpdate

public  void onUserCommandUpdate(ZegoRangeScene rangeScene, String userID, ZegoPosition position, int channel, byte[] command)

用户指令变更回调。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
userID	String	用户 ID。
position	ZegoPosition	用户当前位置。
channel	int	指令所属通道。
command	byte[]	用户下一步命令数据。

详情

用户指令变更回调。

通知时机：用户指令变更。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。
注意事项：本回调为高频回调，请勿在本回调中做耗时操作。

onCustomCommandUpdate

public void onCustomCommandUpdate(ZegoRangeScene rangeScene, byte[] command)

用户自定义信令变更回调。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
command	byte[]	用户自定义信令。

详情

用户自定义信令变更回调。

通知时机：用户自定义信令变更。

支持版本：3.0.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。

onSceneTokenWillExpire

public void onSceneTokenWillExpire(ZegoRangeScene rangeScene, int remainTimeInSecond)

场景 Token 鉴权将要过期的回调通知。

Declared in callback/IZegoRangeSceneEventHandler.java

参数

名称	类型	描述
rangeScene	ZegoRangeScene	触发此次回调的范围场景实例。
remainTimeInSecond	int	token 过期前的剩余时间。

详情

场景 Token 鉴权将要过期的回调通知，请用户通过 [renewToken] 函数更新场景 Token 鉴权。

通知时机：在 Token 过期前 30 秒，SDK 会通过 [onSceneTokenWillExpire] 回调发出通知。
相关接口：当开发者收到此回调后，可通过 [renewToken] 来更新 Token 鉴权信息。

支持版本：3.1.0 及以上。
使用限制：请勿在回调线程中调用 SDK 接口。