LlReturnObjectsByID/ja

From Second Life Wiki
Jump to navigation Jump to search

要約

関数: integer llReturnObjectsByID( list objects );

スクリプトがエージェントによって所有されている場合、PERMISSION_RETURN_OBJECTS は所有者によって許可されるかもしれません。スクリプトがグループによって所有されている場合、この許可はグループの "Owners" ロールに所属するエージェントによって許可されるかもしれません。
成功裏に所有者に戻されたオブジェクトの数または ERR_* フラグです。を integer で返します。

• list objects オブジェクトの UUID (キー) のリスト

実行するには、llRequestPermissions による PERMISSION_RETURN_OBJECTS 権限が必要です。 返り値が負の場合、エラー フラグを表します。

仕様

スクリプト所有者とスコープ

スクリプトが地域所有者または管理者によって所有されている場合、この関数は地域内の任意のパーセルにあるオブジェクトに対して機能します。それ以外の場合、スクリプトはスクリプトの所有者が所有する土地上にあるオブジェクトを返すことができます。

セキュリティ対策として、パーセルの所有者、地域の所有者、および地域マネージャはこのメソッドによって自分のオブジェクトを返すことはできません(オブジェクトが自分自身を返す場合を除く)。

スロットル

リージョン全体で1時間あたりの最大パーセルランドインパクト容量で制限されます。

エラーフラグ 説明
ERR_GENERIC -1 曖昧で説明できないエラー。何もわかっていません。
ERR_PARCEL_PERMISSIONS -2 指定されたパーセルでタスクを実行するための権限がありません。
ERR_MALFORMED_PARAMS -3 パラメータが不正形式です。
ERR_RUNTIME_PERMISSIONS -4 スクリプトには要求されたタスクを実行するためのランタイム権限がありません。
ERR_THROTTLED -5 タスクは制限されています。後でもう一度試してください。

警告

  • 権限の自動付与に頼らないようにしましょう。常に run_time_permissions イベントを使用しましょう。
  • スクリプトに PERMISSION_RETURN_OBJECTS の権限が不足していると、スクリプトはエラーを DEBUG_CHANNEL で叫び、操作に失敗します (しかしスクリプトは処理を続けます)。
  • いったん PERMISSION_RETURN_OBJECTS 権限が付与されると、スクリプトの中で (例えば、新しい llRequestPermissions 呼び出しなどにより) 権限をはく奪することができません。スクリプトはオブジェクトが derez (削除、取り外し、取り込み) されない限り権限が失われません。
  • 他のグループが所有するオブジェクトは、オブジェクトが譲渡可能な場合は以前の所有者に戻り、それ以外の場合は削除されます。

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   Shared group inventory

サンプル

関連項目

イベント

•  run_time_permissions 権限取得イベント

関数

•  llGetPermissions 付与されている権限を取得します
•  llGetPermissionsKey 権限を許可したエージェントを取得します
•  llRequestPermissions 権限を要求します
•  llReturnObjectsByOwner/ja
•  llGetParcelPrimOwners/ja
•  llDie/ja

記事

•  権限/スクリプト

特記事項

経緯

Date of Release 18/06/2013

All Issues

~ Search JIRA for related Issues
   Shared group inventory

Signature

function integer llReturnObjectsByID( list objects );
この翻訳は 原文 と比べて古いですか?間違いがありますか?読みにくいですか?みんなで 修正 していきましょう! (手順はこちら)
この項目はあなたにとって参考にならない項目ですか?もしかしたらLSL Wikiの関連した項目が参考になるかもしれません。