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
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!");
     }
     }



Revision as of 09:30, 6 February 2015

Summary

Function: key llGetPermissionsKey( );

Returns the 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();