Difference between revisions of "LlGetPermissionsKey"

From Second Life Wiki
Jump to navigation Jump to search
m (Clarified the return value description to remove ambiguous language.)
m (not sure about this yet... will see.)
 
(One intermediate revision by one other user 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 neither granted nor declined (e.g., the permissions dialog was cancelled or otherwise ignored).
|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
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!");
     }
     }



Latest revision as of 14:54, 23 September 2015

Summary

Function: key llGetPermissionsKey( );

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).

Caveats

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   llGetPermissionsKey() doesn't return NULL_KEY when permissions are declined

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

All Issues

~ Search JIRA for related Issues
   llGetPermissionsKey() doesn't return NULL_KEY when permissions are declined

Signature

function key llGetPermissionsKey();