ZegoRangeSceneItem

Declared in ZegoRangeSceneItem.java

Methods

setEventHandler

public boolean setEventHandler(IZegoRangeSceneItemEventHandler handler)

set range scene item event handler.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
handler	IZegoRangeSceneItemEventHandler	The object used to receive range scene item callbacks.

Details

Set the callback function of the range scene item module.

When to call: After getting range scene item instance by [getRangeSceneItem].

Available since: 3.1.0

Return

The result of set range scene item event handler, true: success, false: fail.

createItem

public int createItem(ZegoItemParam param, IZegoRangeSceneCreateItemCallback callback)

Create item.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
param	ZegoItemParam	Item param.
callback	IZegoRangeSceneCreateItemCallback	The callback of create item.

Details

Create item.

Use cases: Item competition in the meta world.
When to call: After receive login Scene success, before [logoutScene].
Caution: 1. Items belong to range scene, not a certain user. When a user successfully binds an item, it only means that the user has the temporary right to use the item. 2. An item is allowed to have one or more bound users, and the principle of first-come, first-served is followed when applying for bound items.

When multiple users bind an item at the same time, their changes to the item follow the cas principle.
When creating an item, it is allowed to specify whether to bind the item after the creation is successful.
When the item is created successfully, users within the range of the item will receive the [onItemEnterView] callback notification.

Related APIs: Users can call [destroyItem] to destroy item.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.

destroyItem

public int destroyItem(long itemID, IZegoRangeSceneDestroyItemCallback callback)

Destroy item.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
itemID	long	Item ID.
callback	IZegoRangeSceneDestroyItemCallback	The callback of destroy item.

Details

Destroy item.

Use cases: Item competition in the meta world.
When to call: After receive after login Scene success , before [logoutScene].
Caution: When an item is destroyed, users within the range of the item will be notified by the [onItemLeaveView] callback.
Related APIs: Users can call [createItem] to create item.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.

bindItem

public int bindItem(long itemID, IZegoRangeSceneBindItemCallback callback)

Bind item.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
itemID	long	Item ID.
callback	IZegoRangeSceneBindItemCallback	The callback of bind item.

Details

Bind item.

Use cases: Item competition in the meta world.
When to call: After receive after login Scene success, before [logoutScene].
Caution: When an item is successfully bound, users within the range of the item will be notified by the [onItemBindUpdate] callback.
Related APIs: Users can call [unbindItem] to unbind item.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.

unbindItem

public int unbindItem(long itemID, IZegoRangeSceneUnbindItemCallback callback)

Unbind item.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
itemID	long	Item ID.
callback	IZegoRangeSceneUnbindItemCallback	The callback of unbind item.

Details

Unbind item.

Use cases: Item competition in the meta world.
When to call: After receive [bindItem], before [logoutScene].
Caution: When an item is successfully unbound, users within the scope of the item will be notified by the [onItemUnbindUpdate] callback.
Related APIs: Users can call [bindItem] to bind item.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.

updateItemStatus

public  int updateItemStatus(long itemID, ZegoPosition position, int channel, byte[] status, IZegoRangeSceneUpdateItemStatusCallback callback)

Update item status.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
itemID	long	Item ID.
position	ZegoPosition	Item's current location.
channel	int	The channel to which the status belongs, starting from 0, cannot exceed the maximum channel number.
status	byte[]	Current status data.
callback	IZegoRangeSceneUpdateItemStatusCallback	The callback of update item status.

Details

Developers can call this function to update the item status.

When to call: After [onBindItem], before [unbindItem].
Caution: None.

Restrictions: None.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.

updateItemCommand

public  int updateItemCommand(long itemID, ZegoPosition position, int channel, byte[] command, IZegoRangeSceneUpdateItemCommandCallback callback)

Update item status.

Declared in ZegoRangeSceneItem.java

Parameters

Name	Type	Description
itemID	long	Item ID.
position	ZegoPosition	Item's current location.
channel	int	The channel to which the status belongs, starting from 0, cannot exceed the maximum channel number.
command	byte[]	Next command data.
callback	IZegoRangeSceneUpdateItemCommandCallback	The callback of update item next command.

Details

Developers can call this function to update the item command.

When to call: After [onBindItem], before [unbindItem].
Caution: None.

Restrictions: None.

Return

Error code, please refer to the error codes document https://doc-en.zego.im/en/5548.html for details.