View source for LlAttachToAvatarTemp/ja

{{LSL_Function/ja
|inject-2=
{{LSL_Function/permission/ja|PERMISSION_ATTACH|temp=*}}
|func = llAttachToAvatarTemp
|func_desc = ユーザーに新しい持ち物を作らないという点を除けば、[[llAttachToAvatar/ja|llAttachToAvatar]]と同じ規則に従います。デタッチしたり接続を切ったりした場合にはオブジェクトは消滅します。
|func_footnote = ユーザーは一時的に装着されたオブジェクトを '取る' や '下に落とす' ことが出来ない点に注意してください。  
* オブジェクトをアタッチしたユーザーが、そのオブジェクトの所有者でないかもしれません。実際、オブジェクトを贈与したり、所有権を移すためにユーザーにオブジェクトを取らせることに使うには、この関数はほとんど役に立ちません。
|p1_type = integer
|p1_name = attach_point
|p1_desc = ATTACH_* 定数または適当な値 (下表参照)
|constants = {{LSL_Constants_Attachment/ja}}
|caveats =
*この方法により装着が成功したとき、装着する以前に与えられた権限が、PERMISSION_ATTACHも含めてダンプされます。(可能なセキュリティ対策)
**この方法により装着が成功するまで、それまでに許可された権限は正常のまま保持されます。
*あなたが譲渡の権限を持っていないオブジェクトの中で llAttachToAvatarTemp を使うと、たとえあなた自身へ装着しようとしていたとしても、関数は ''No permission to transfer'' エラーで失敗します。
*装着ポイントには複数のアタッチメントを装着できます。{{Footnote|{{Jira|SCR-277}}により1つの装着ポイントに複数装着できるようになりました|SCR-277により1つの装着ポイントに複数装着できるようになりました}}
**以前は'''attach_point''' がふさがっている場合、2つのオブジェクトを同時に同じ装着ポイントに装着することはできず、既にあるオブジェクトが取り外され、新しいアタッチメントが乗っ取りました。 
*頭に (首から上の全ての装着ポイント) 装着されたオブジェクトは、"show attachments in mouselook" が無効になっている場合、一人称視点 (別名 [[Mouselook|マウスルック]]) では表示されません。
*'''attach_point''' がゼロだがオブジェクトが装着されたことがない場合、デフォルトで右手に装着されます ({{LSL Const/ja|ATTACH_RHAND|integer|6|c=右手}})。
*オブジェクトが既に装着されていると、'''attach_point''' が異なる {{LSLG/ja|llGetAttached|装着ポイント}} かどうかに関わらず、関数がエラーを出さずに失敗します。
|examples = <source lang="lsl2">//-- rez object on ground, drop in this script, it will request permissions to attach,
//-- and then attach to the left hand if permission is granted. if permission is denied,
//-- then the script complains.
default
{
    state_entry()
    {
        llRequestPermissions( llGetOwner(), PERMISSION_ATTACH );
    }

    run_time_permissions( integer vBitPermissions )
    {
        if( vBitPermissions & PERMISSION_ATTACH )
        {
            llAttachToAvatarTemp( ATTACH_LHAND );
        }
        else
        {
            llOwnerSay( "Permission to attach denied" );
        }
    }

    on_rez(integer rez)
    {
        if(!llGetAttached())
        { //reset the script if it's not attached.
            llResetScript();
        }
    }

    attach(key AvatarKey)
    {
        if(AvatarKey)
        {//event is called on both attach and detach, but Key is only valid on attach
            integer test = llGetAttached();
            if (test) {
                llOwnerSay( "The object is attached" );
            } else {
                llOwnerSay( "The object is not attached");
            }
        }
    }
}</source>

<source lang="lsl2">//-- This example can demonstrate ownership transfer of an object on a temporary basis using llAttachToAvatarTemp()
//-- Whoever touches will be asked for permission to attach, and upon granting permission will have the item attach,
//-- But not appear in Inventory.
default
{
    touch_start(integer num_touches)
    {
        llRequestPermissions( llDetectedKey(0), PERMISSION_ATTACH );
    }

    run_time_permissions( integer vBitPermissions )
    {
        if( vBitPermissions & PERMISSION_ATTACH )
        {
            llAttachToAvatarTemp( ATTACH_LHAND );
        }
        else
        {
            llOwnerSay( "Permission to attach denied" );
        }
    }

    on_rez(integer rez)
    {
        if(!llGetAttached())
        { //reset the script if it's not attached.
            llResetScript();
        }
    }
}</source>

|also_functions = {{LSL DefineRow||{{LSLG/ja|llDetachFromAvatar}}|アバターからオブジェクトを外します}}
{{LSL DefineRow||{{LSLG/ja|llGetAttached}}|装着ポイント番号を取得します}}
|cat1 = Attachment
|cat2 = Avatar
}}