ZegoRangeSceneEventHandler

Declared in ZegoExpressEventHandler.h

方法

rangeScene:sceneStateUpdate:errorCode

- (void)rangeScene:(ZegoRangeScene *)rangeScene sceneStateUpdate:(ZegoSceneState)state errorCode:(int)errorCode;

场景状态变化通知

Declared in ZegoExpressEventHandler.h

参数

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

详情

场景状态变化通知。

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

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

rangeScene:enterView:position

- (void)rangeScene:(ZegoRangeScene *)rangeScene enterView:(ZegoUser *)user position:(ZegoPosition *)position;

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

Declared in ZegoExpressEventHandler.h

参数

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

详情

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

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

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

rangeScene:leaveView

- (void)rangeScene:(ZegoRangeScene *)rangeScene leaveView:(NSString *)userID;

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

Declared in ZegoExpressEventHandler.h

参数

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

详情

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

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

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

rangeScene:userStatusUpdate:position:channel:status

- (void)rangeScene:(ZegoRangeScene *)rangeScene userStatusUpdate:(NSString *)userID position:(ZegoPosition *)position channel:(unsigned int)channel status:(NSData *)status;

用户状态变更回调。

Declared in ZegoExpressEventHandler.h

参数

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

详情

用户状态变更回调。

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

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

rangeScene:userCommandUpdate:position:channel:command

- (void)rangeScene:(ZegoRangeScene *)rangeScene userCommandUpdate:(NSString *)userID position:(ZegoPosition *)position channel:(unsigned int)channel command:(NSData *)command;

用户指令变更回调。

Declared in ZegoExpressEventHandler.h

参数

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

详情

用户指令变更回调。

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

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

rangeScene:customCommandUpdate

- (void)rangeScene:(ZegoRangeScene *)rangeScene customCommandUpdate:(NSData *)command;

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

Declared in ZegoExpressEventHandler.h

参数

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

详情

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

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

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

rangeScene:tokenWillExpire

- (void)rangeScene:(ZegoRangeScene *)rangeScene tokenWillExpire:(int)remainTimeInSecond;

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

Declared in ZegoExpressEventHandler.h

参数

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

详情

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

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

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