Difference between revisions of "LlGetPermissionsKey"

From Second Life Wiki
Jump to navigation Jump to search
(added example)
m (not sure about this yet... will see.)
 
(3 intermediate revisions by 3 users not shown)
Line 2: Line 2:
|func_id=137|func_sleep=0.0|func_energy=10.0
|func_id=137|func_sleep=0.0|func_energy=10.0
|func=llGetPermissionsKey|sort=GetPermissionsKey
|func=llGetPermissionsKey|sort=GetPermissionsKey
|return_type=key
|return_type=key|return_subtype=avatar
|func_footnote=Returns {{LSL Const|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=Evaluates to false in conditionals just like invalid keys.}} if permissions were never granted or declined.
|func_footnote=Returns {{LSL Const|NULL_KEY|key|"00000000-0000-0000-0000-000000000000"|c=Evaluates to false in conditionals just like invalid keys.}} if permissions were neither granted nor declined (e.g., the permissions dialog was cancelled or otherwise ignored).
|func_desc
|func_desc
|Return_text=of the avatar that last granted or declined permissions to the script.
|Return_text=of the avatar that last granted or declined permissions to the script.
Line 10: Line 10:
|constants
|constants
|examples=
|examples=
<lsl>
<source lang="lsl2">
// 1. rez a cube
// 1. rez a cube
// 2. create a new script and paste this
// 2. create a new script and paste this
Line 21: Line 21:
     key permissionsKey = llGetPermissionsKey();
     key permissionsKey = llGetPermissionsKey();


    // PUBLIC_CHANNEL has the integer value 0
     llSay(0, "key llGetPermissionsKey() = '" + (string)permissionsKey + "'");
     llSay(PUBLIC_CHANNEL,
        "key llGetPermissionsKey() = '" + (string)permissionsKey + "'");
}
}


Line 47: Line 45:
                 llDetachFromAvatar();
                 llDetachFromAvatar();
             else
             else
                 llSay(PUBLIC_CHANNEL, "Can't detach from you, you have not granted ATTACH perms.");
                 llSay(0, "Can't detach from you, you have not granted ATTACH perms.");
         }
         }
         else
         else
             llSay(PUBLIC_CHANNEL, "Sorry, you're not the owner!");
             llSay(0, "Sorry, you're not the owner!");
     }
     }


Line 59: Line 57:
     }
     }
}
}
</lsl>
</source>
|helpers
|helpers
|also_functions={{LSL DefineRow||[[llGetPermissions]]|}}
|also_functions={{LSL DefineRow||[[llGetPermissions]]|}}

Latest revision as of 13:54, 23 September 2015

Summary

Function: key llGetPermissionsKey( );
0.0 Forced Delay
10.0 Energy

Returns the avatar (a key) of the avatar that last granted or declined permissions to the script.

Returns NULL_KEY if permissions were neither granted nor declined (e.g., the permissions dialog was cancelled or otherwise ignored).

Examples

// 1. rez a cube
// 2. create a new script and paste this
// 3. save script
// 4. right-click the prim and choose attach
// 5. touch the prim

announce_permissions_key()
{
    key permissionsKey = llGetPermissionsKey();

    llSay(0, "key llGetPermissionsKey() = '" + (string)permissionsKey + "'");
}

default
{
    state_entry()
    {
        announce_permissions_key();

        key owner = llGetOwner();
        llRequestPermissions(owner, PERMISSION_ATTACH);
    }

    touch_start(integer num_detected)
    {
        key id = llDetectedKey(0);
        key owner = llGetOwner();
        key permissionsKey = llGetPermissionsKey();

        if (id == owner)
        {
            if (permissionsKey == owner)
                llDetachFromAvatar();
            else
                llSay(0, "Can't detach from you, you have not granted ATTACH perms.");
        }
        else
            llSay(0, "Sorry, you're not the owner!");
    }

    run_time_permissions(integer perm)
    {
        if (perm & PERMISSION_ATTACH)
            announce_permissions_key();
    }
}

See Also

Events

•  run_time_permissions

Functions

•  llGetPermissions
•  llRequestPermissions

Deep Notes

Signature

function key llGetPermissionsKey();