Difference between revisions of "LlGetInventoryKey/ja"

From Second Life Wiki
Jump to navigation Jump to search
m (Undo revision 849462 by Mako Nozaki (Talk))
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{LSL_Function/inventory/ja|name|uuid=false|type}}
{{Issues/SVC-3670}}{{Issues/SVC-4050}}{{LSL_Function/inventory/ja|name|uuid=false}}
{{LSL_Function/ja
{{LSL_Function/ja
|func_id=175|func_sleep=0.0|func_energy=10.0
|func_id=175|func_sleep=0.0|func_energy=10.0
|func=llGetInventoryKey|return_type=key|p1_type=string|p1_name=name
|func=llGetInventoryKey|return_type=key|p1_type=string|p1_name=name
|func_footnote='''item'''が[[llGetInventoryPermMask/ja|複製・編集・譲渡]]しない場合、{{LSL Const/ja|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=無効なキーのような状態で、falseと判定します。}}を返します。
|func_footnote='''item''' が {{LSLG/ja|llGetInventoryPermMask|コピー, 編集, 謙譲}} 可能でない場合は {{LSL Const/ja|NULL_KEY|key|&quot;00000000-0000-0000-0000-000000000000&quot;|c=条件文では、不正なキーの場合と同様、false と判定されます}} が返ります。<br/>この関数の代わりに {{LSLG/ja|llGetInventoryType}} を使って、インベントリに存在するか確認してください。
|func_desc
|func_desc
|sort=GetInventoryKey
|sort=GetInventoryKey
|return_text=インベントリ'''name'''の[[UUID/ja|UUID]]
|return_text='''name''' インベントリの {{LSLG/ja|UUID}}
|spec
|spec
|caveats
|caveats=*インベントリアイテムは通常はアセットを ''指し示す'' レコードですが、実際のアセットではありません。
**複数のインベントリアイテムが同じアセットを指すこともあり、その場合は同じキーを返します。
**新規作成されたインベントリ項目の中には、編集されて保存されるまでデフォルトのキーをもつこともあります。
***新規作成されたノートカード項目は、編集されて保存されるまで暫定的に {{LSLG/ja|NULL_KEY}} を使用します。
***新規作成されたスクリプト項目は、編集されて保存されるまで、"{{LSLG/ja|Hello Avatar}}" スクリプト (これを書いた当時では "d0d40b7c-e32b-3bcb-3346-2be8470093c0", これがデフォルトとして保証されているわけではありません) を指します。
***他のインベントリ項目は作成段階で一意のアセットキーを与えられますが、これはクライアントの作りに依存するもので、保証されるものではありません。
**アセットが「編集」されると、新しいアセットキーが編集したものに割り当てられます。アセットを編集のために開くのに使用したインベントリアイテムは新しいアセットキーに更新されます。
***元々のアセットを一緒に指していた他のインベントリアイテムで、新しいアセットキーに更新されるものはありません。
|constants
|constants
|examples
|examples=<source lang="lsl2">string item = "Default";
 
default
{
    state_entry()
    {
        llOwnerSay("Touch to get information about \"" + item + "\".");
    }
 
    touch_start(integer total_number)
    {
        integer type = llGetInventoryType(item);
        integer index = llListFindList([ INVENTORY_NONE,
            INVENTORY_TEXTURE, INVENTORY_SOUND, INVENTORY_LANDMARK, INVENTORY_CLOTHING,
            INVENTORY_OBJECT, INVENTORY_NOTECARD, INVENTORY_SCRIPT, INVENTORY_BODYPART,
            INVENTORY_ANIMATION, INVENTORY_GESTURE], [type]);
        string name = llList2String(["does not exist",
            "texture", "sound", "landmark", "clothing",
            "object", "notecard", "script", "body part",
            "animation", "gesture"], index);
 
        llOwnerSay("Type: " + name);
       
        if(type == INVENTORY_NONE)
            return;
       
        integer owner_perms = llGetInventoryPermMask(item, MASK_OWNER);
        list perms;
        if(owner_perms & PERM_COPY)
            perms += "Copy";
       
        if(owner_perms & PERM_MODIFY)
            perms += "Modify";
       
        if(owner_perms & PERM_TRANSFER)
            perms += "Transfer";
 
        if(owner_perms & PERM_MOVE)
            perms += "Move";
       
        llOwnerSay("Perms: " + llList2CSV(perms));
       
        integer temp = PERM_COPY | PERM_MODIFY | PERM_TRANSFER;
        if((owner_perms & temp) != temp)
            return;
 
        llOwnerSay("Key: " + (string)llGetInventoryKey(item));
    }
}
</source>
|helpers
|helpers
|also_functions=
|also_functions=
{{LSL DefineRow||[[llGetInventoryName/ja|llGetInventoryName]]|}}
{{LSL DefineRow||{{LSLG/ja|llGetInventoryName}}|インベントリアイテムの名前を返します}}
{{LSL DefineRow||[[llGetInventoryCreator/ja|llGetInventoryCreator]]|}}
{{LSL DefineRow||{{LSLG/ja|llGetInventoryType}}|インベントリアイテムが存在するか検査し、あればそのタイプを返します}}
{{LSL DefineRow||[[llGetInventoryType/ja|llGetInventoryType]]|}}
{{LSL DefineRow||{{LSLG/ja|llGetInventoryNumber}}|インベントリの中の特定のタイプのアイテムの数を返します}}
{{LSL DefineRow||[[llGetInventoryPermMask/ja|llGetInventoryPermMask]]|}}
{{LSL DefineRow||{{LSLG/ja|llGetInventoryPermMask}}|インベントリアイテムの権限を返します}}
{{LSL DefineRow||{{LSLG/ja|llGetInventoryCreator}}|インベントリアイテムのクリエーターを返します}}
|also_events
|also_events
|also_tests
|also_tests
|also_articles
|also_articles
|notes
|notes=返却された UUID はインベントリアイテムを指すアセットのもので、インベントリアイテムそのものの UUID ではありません。アセット自体は不変です (絶対に変更されることがなく、作成と削除だけができます) 。この仕組みで複数のインベントリが同じアセットを複写することなく処理することができます。アセットが編集されたように見えるときは、それは新しいアセットとして保存されています。この結果、インベントリの中の複数のアイテムのコピーが同じアセット UUID を共有することになります。
|history=
* 0.2 - 非公開のベータテストの間に導入
* 1.2 - フルパーミッションのインベントリアイテムだけに制限
* 1.24 - オブジェクトとスクリプトは実際の UUID を返さず、代わりにハッシュを返すようになる (例: オブジェクト・スクリプトと一致する見せかけの UUID) -- {{JIRA|SVC-3670}}
<sup>先頭のバージョン番号は推測です。</sup>
|cat1=Inventory
|cat1=Inventory
|cat2=Key
|cat2=Key

Latest revision as of 06:51, 25 February 2016

要約

関数: key llGetInventoryKey( string name );

name インベントリの UUIDを key で返します。

• string name プリムの インベントリ の中にあるアイテム

itemコピー, 編集, 謙譲 可能でない場合は NULL_KEY が返ります。
この関数の代わりに llGetInventoryType を使って、インベントリに存在するか確認してください。

警告

  • name がプリムの中で見つからない場合、エラーが DEBUG_CHANNEL 上で叫ばれます。
  • インベントリアイテムは通常はアセットを 指し示す レコードですが、実際のアセットではありません。
    • 複数のインベントリアイテムが同じアセットを指すこともあり、その場合は同じキーを返します。
    • 新規作成されたインベントリ項目の中には、編集されて保存されるまでデフォルトのキーをもつこともあります。
      • 新規作成されたノートカード項目は、編集されて保存されるまで暫定的に NULL_KEY を使用します。
      • 新規作成されたスクリプト項目は、編集されて保存されるまで、"Hello Avatar" スクリプト (これを書いた当時では "d0d40b7c-e32b-3bcb-3346-2be8470093c0", これがデフォルトとして保証されているわけではありません) を指します。
      • 他のインベントリ項目は作成段階で一意のアセットキーを与えられますが、これはクライアントの作りに依存するもので、保証されるものではありません。
    • アセットが「編集」されると、新しいアセットキーが編集したものに割り当てられます。アセットを編集のために開くのに使用したインベントリアイテムは新しいアセットキーに更新されます。
      • 元々のアセットを一緒に指していた他のインベントリアイテムで、新しいアセットキーに更新されるものはありません。

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   llGetInventoryKey() returns NULL_KEY when referencing a notecard that is empty

サンプル

string item = "Default";

default
{
    state_entry()
    {
        llOwnerSay("Touch to get information about \"" + item + "\".");
    }

    touch_start(integer total_number)
    {
        integer type = llGetInventoryType(item);
        integer index = llListFindList([ INVENTORY_NONE, 
            INVENTORY_TEXTURE, INVENTORY_SOUND, INVENTORY_LANDMARK, INVENTORY_CLOTHING, 
            INVENTORY_OBJECT, INVENTORY_NOTECARD, INVENTORY_SCRIPT, INVENTORY_BODYPART, 
            INVENTORY_ANIMATION, INVENTORY_GESTURE], [type]);
        string name = llList2String(["does not exist", 
            "texture", "sound", "landmark", "clothing",
            "object", "notecard", "script", "body part",
            "animation", "gesture"], index);

        llOwnerSay("Type: " + name);
        
        if(type == INVENTORY_NONE)
            return;
        
        integer owner_perms = llGetInventoryPermMask(item, MASK_OWNER);
        list perms;
        if(owner_perms & PERM_COPY)
            perms += "Copy";
        
        if(owner_perms & PERM_MODIFY)
            perms += "Modify";
        
        if(owner_perms & PERM_TRANSFER)
            perms += "Transfer";

        if(owner_perms & PERM_MOVE)
            perms += "Move";
        
        llOwnerSay("Perms: " + llList2CSV(perms));
        
        integer temp = PERM_COPY | PERM_MODIFY | PERM_TRANSFER;
        if((owner_perms & temp) != temp)
            return;

        llOwnerSay("Key: " + (string)llGetInventoryKey(item));
    }
}

注意点

返却された UUID はインベントリアイテムを指すアセットのもので、インベントリアイテムそのものの UUID ではありません。アセット自体は不変です (絶対に変更されることがなく、作成と削除だけができます) 。この仕組みで複数のインベントリが同じアセットを複写することなく処理することができます。アセットが編集されたように見えるときは、それは新しいアセットとして保存されています。この結果、インベントリの中の複数のアイテムのコピーが同じアセット UUID を共有することになります。

関連項目

関数

•  llGetInventoryName インベントリアイテムの名前を返します
•  llGetInventoryType インベントリアイテムが存在するか検査し、あればそのタイプを返します
•  llGetInventoryNumber インベントリの中の特定のタイプのアイテムの数を返します
•  llGetInventoryPermMask インベントリアイテムの権限を返します
•  llGetInventoryCreator インベントリアイテムのクリエーターを返します

特記事項

経緯

  • 0.2 - 非公開のベータテストの間に導入
  • 1.2 - フルパーミッションのインベントリアイテムだけに制限
  • 1.24 - オブジェクトとスクリプトは実際の UUID を返さず、代わりにハッシュを返すようになる (例: オブジェクト・スクリプトと一致する見せかけの UUID) -- SVC-3670

先頭のバージョン番号は推測です。

All Issues

~ Search JIRA for related Issues
   llGetInventoryKey() returns NULL_KEY when it shouldn't
   llGetInventoryKey() returns NULL_KEY when referencing a notecard that is empty

Signature

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