ZegoRangeSceneItem

Declared in ZegoRangeSceneItem.java

方法

setEventHandler

public boolean setEventHandler(IZegoRangeSceneItemEventHandler handler)

设置范围场景物品管理回调。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
handler	IZegoRangeSceneItemEventHandler	用于接收范围场景物品管理回调的对象。

详情

设置范围场景物品管理模块回调。

调用时机：通过 [getRangeSceneItem] 获取范围场景物品管理对象之后。

支持版本：3.1.0 及以上。

返回值

设置范围场景物品管理回调结果。true: 成功, false: 失败。

createItem

public int createItem(ZegoItemParam param, IZegoRangeSceneCreateItemCallback callback)

创建物品。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
param	ZegoItemParam	物品参数。
callback	IZegoRangeSceneCreateItemCallback	创建物品结果回调。

详情

创建物品。

业务场景：虚拟世界内物品竞争。
调用时机：登录场景成功之后，[logoutScene] 之前。
相关接口：可调用 [destroyItem] 销毁物品。

支持版本：3.1.0 及以上。
注意事项： 1. 物品属于范围场景，而不是某个用户，当某用户成功绑定某物品时，只是表示该用户拥有对该物品的暂时使用权。 2. 一个物品允许拥有1个或多个绑定用户，申请绑定物品时遵循先到先得的原则。 3. 当有多个用户同时绑定了某个物品时，他们对该物品的变更遵循cas原则。 4. 创建物品时允许指定是否在创建成功后绑定该物品。 5. 物品创建成功时，该物品范围内的用户会收到 [onItemEnterView] 回调通知。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

destroyItem

public int destroyItem(long itemID, IZegoRangeSceneDestroyItemCallback callback)

销毁物品。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
itemID	long	物品 ID。
callback	IZegoRangeSceneDestroyItemCallback	销毁物品结果回调。

详情

销毁物品。

业务场景：虚拟世界内物品竞争。
调用时机：登录场景成功之后，[logoutScene] 之前。
相关接口：可调用 [createItem] 创建物品。

支持版本：3.1.0 及以上。
注意事项：物品被销毁时，该物品范围内的用户会收到 [onItemLeaveView]回调通知。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

bindItem

public int bindItem(long itemID, IZegoRangeSceneBindItemCallback callback)

申请绑定物品。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
itemID	long	物品 ID。
callback	IZegoRangeSceneBindItemCallback	申请绑定物品结果回调。

详情

申请绑定物品。

业务场景：虚拟世界内物品竞争。
调用时机：登录场景成功之后，[logoutScene] 之前。
相关接口：可调用 [unbindItem] 申请解绑物品。

支持版本：3.1.0 及以上。
注意事项：成功绑定物品时，该物品范围内的用户会收到 [onItemBindUpdate] 回调通知。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

unbindItem

public int unbindItem(long itemID, IZegoRangeSceneUnbindItemCallback callback)

申请解绑物品。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
itemID	long	物品 ID。
callback	IZegoRangeSceneUnbindItemCallback	销毁物品结果回调。

详情

申请解绑物品。

业务场景：虚拟世界内物品竞争。
调用时机：[bindItem] 之后，[logoutScene] 之前。
相关接口：可调用 [bindItem] 申请绑定物品。

支持版本：3.1.0 及以上。
注意事项：成功解绑物品时，该物品范围内的用户会收到 [onItemUnbindUpdate] 回调通知。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

updateItemStatus

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

更新物品的状态。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
itemID	long	物品 ID。
position	ZegoPosition	物品当前位置。
channel	int	状态所属通道，从0开始，不能超过最大通道号。
status	byte[]	物品当前状态数据。
callback	IZegoRangeSceneUpdateItemStatusCallback	更新物品状态结果回调。

详情

开发者可以调用该接口更新物品的状态。

调用时机：[onBindItem] 之后，[unbindItem] 之前。

支持版本：3.1.0 及以上。
使用限制：无。
注意事项：无。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html

updateItemCommand

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

更新物品的指令。

Declared in ZegoRangeSceneItem.java

参数

名称	类型	描述
itemID	long	物品 ID。
position	ZegoPosition	物品当前位置。
channel	int	状态所属通道，从0开始，不能超过最大通道号。
command	byte[]	物品下一步命令数据。
callback	IZegoRangeSceneUpdateItemCommandCallback	更新物品下一步命令结果回调。

详情

开发者可以调用该接口更新物品的指令。

调用时机：[onBindItem] 之后，[unbindItem] 之前。

支持版本：3.1.0 及以上。
使用限制：无。
注意事项：无。

返回值

错误码，详情请参考常用错误码文档 https://doc-zh.zego.im/zh/4378.html