LlReturnObjectsByID

来自人工智能助力教育知识百科
跳转至: 导航搜索

Template:Needs Translation/


函数名
Function: integer llReturnObjectsByID( list objects );
参数:• list objects – 对象uuid(键)列表
返回值:如果脚本属于代理,则所有者可以授予PERMISSION_RETURN_OBJECTS。如果脚本属于某个组,则此权限可以由属于该组“所有者”角色的代理授予。

返回一个整数,该整数表示成功返回给其所有者的对象的数量或一个ERR_*标志。

要运行这个函数,脚本必须使用llRequestPermissions请求PERMISSION_RETURN_OBJECTS权限。

如果返回值为负,则表示错误标志。

 Specification
 脚本所有者和范围
 如果该脚本属于地产所有者或经理,则此函数适用于该区域中任何包裹上的对象。否则,脚本可以返回位于脚本所有者拥有的土地上的对象。
 作为一种安全措施,parcel owner、estate owner和estate managers不能通过此方法返回其对象,除非对象返回自身。
 Throttle
 在最大的地块陆地冲击能力范围内,每小时。
注意事项
权限
 不要依赖于权限的自动授予状态。始终使用run_time_permissions事件。
 如果脚本缺少权限PERMISSION_RETURN_OBJECTS,该脚本将在DEBUG_CHANNEL上大叫一个错误,操作失败(但脚本继续运行)。
 一旦PERMISSION_RETURN_OBJECTS权限被授予,除了从脚本内部(例如,使用一个新的llRequestPermissions调用)或者重置或删除脚本之外,就没有其他方法来撤销它。
 当任何人都可以授予PERMISSION_RETURN_OBJECTS时,这个函数只有在以下条件之一为真时才能正常工作:
   这片土地归正规化的所有人所有,该许可已由土地所有人批准。

该土地是组所有的,并且该许可由担任组“所有者”角色的组成员授予。

   如果对象是可转移的,其他组所拥有的对象将被返回给它们以前的所有者,否则将被删除。

如果对象是可转移的,其他组所拥有的对象将被返回给它们以前的所有者,否则将被删除。

示例
示例1

相关函数
llGetPermissions - 获得已授予的权限

llGetPermissionsKey - 获取授予权限的代理

llRequestPermissions - 请求的权限

llReturnObjectsByOwner

llGetParcelPrimOwners

llDie

相关事件
run_time_permissions - 允许接收事件

附录:(表格)

Error Flags Description
ERR_GENERIC -1 这是一个模糊的、无法解释的错误,对此一无所知。
ERR_MALFORMED_PARAMS -3 参数是畸形的。
ERR_PARCEL_PERMISSIONS -2 对特定的包裹执行任务缺乏许可。
ERR_RUNTIME_PERMISSIONS -4 脚本没有运行时权限来执行请求的任务。
ERR_THROTTLED -5 任务已被取消。稍后再试