ZegoRangeSceneItemEventHandler

Declared in ZegoExpressEventHandler.h

Methods

rangeScene:itemEnterView:capacity:position:userList

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemEnterView:(long long)itemID capacity:(unsigned int)capacity position:(ZegoPosition *)position userList:(NSArray<NSString *> *)userList;

Callback notification when item enters the current user's field of view.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.
capacity	unsigned int	The number of users allowed to bind the item.
position	ZegoPosition *	Item position.
userList	NSArray<NSString >	List of users the item is currently bound to.

Details

Callback notification when item enters the current user's field of view. When to trigger: Item enters the current user's field of view.

Restrictions: Do not call the SDK interface in the callback thread.

rangeScene:itemLeaveView

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemLeaveView:(long long)itemID;

Callback notification when item leave the current user's field of view.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.

Details

Callback notification when item leave the current user's field of view. When to trigger: Item leave the current user's field of view.

Restrictions: Do not call the SDK interface in the callback thread.

rangeScene:itemBindUpdate:userID

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemBindUpdate:(long long)itemID userID:(NSString *)userID;

Item binding user change callback notification.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.
userID	NSString *	The user ID of the item binding.

Details

Item binding user change callback notification. When to trigger: Item binding user change.

Restrictions: Do not call the SDK interface in the callback thread.

rangeScene:itemUnbindUpdate:userList

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemUnbindUpdate:(long long)itemID userList:(NSArray<NSString *> *)userList;

Item unbind user change callback notification.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.
userList	NSArray<NSString >	List of users the item unbind.

Details

Item unbind user change callback notification. When to trigger: Item unbind user change.

Restrictions: Do not call the SDK interface in the callback thread.

rangeScene:itemStatusUpdate:position:channel:status

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemStatusUpdate:(long long)itemID position:(ZegoPosition *)position channel:(unsigned int)channel status:(NSData *)status;

Item state update callback.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.
position	ZegoPosition *	Item's current position.
channel	unsigned int	The channel to which the status belongs.
status	NSData *	Current status data.

Details

Item state update callback. When to trigger: Item state update.

Caution: This callback is a high-frequency callback, please do not perform time-consuming operations in this callback.

Restrictions: Do not call the SDK interface in the callback thread.

rangeScene:itemCommandUpdate:position:channel:command

- (void)rangeScene:(ZegoRangeScene *)rangeScene itemCommandUpdate:(long long)itemID position:(ZegoPosition *)position channel:(unsigned int)channel command:(NSData *)command;

Item command update callback.

Declared in ZegoExpressEventHandler.h

Parameters

Name	Type	Description
rangeScene	ZegoRangeScene *	Range scene instance that triggers this callback.
itemID	long long	Item ID.
position	ZegoPosition *	Item's current position.
channel	unsigned int	The channel to which the command belongs.
command	NSData *	Next command data.

Details

Item command update callback. When to trigger: Item command update.

Caution: This callback is a high-frequency callback, please do not perform time-consuming operations in this callback.

Restrictions: Do not call the SDK interface in the callback thread.