Difference between revisions of "Template:LSL Function/permission"

From Second Life Wiki
Jump to navigation Jump to search
m
m
 
(11 intermediate revisions by the same user not shown)
Line 3: Line 3:
{{{{#if:{{#var:DEBUG_CHANNEL}}||:DEBUG_CHANNEL}}|}}
{{{{#if:{{#var:DEBUG_CHANNEL}}||:DEBUG_CHANNEL}}|}}


{{#vardefine:header_footnote|{{#var:header_footnote}}{{#if: {{{1|<noinclude>*</noinclude>}}}|To run this function the script must request the [[{{{1}}}]] permission with [[llRequestPermissions]]{{#ifeq:{{{grant|anyone}}}|anyone||&#32;and it must be granted by {{{grant|anyone}}}}}.}}}}
{{#vardefine:header_footnote|{{#var:header_footnote}}{{#if:{{{1|<noinclude>*</noinclude>}}}|To run this function the script must request the [[{{{1}}}]] {{#if:{{{2|}}}|or [[{{{2}}}]]}} permission with [[llRequestPermissions]]{{#ifeq:{{{grant|anyone}}}|anyone||&#32;and it must be granted by {{{grant|anyone}}}}}.}}}}
{{#vardefine:caveats|{{#var:caveats}}{{#if: {{{1|<noinclude>*</noinclude>}}}|
 
{{#vardefine:caveats|{{#var:caveats}}{{#if:{{{1|<noinclude>*</noinclude>}}}|{{PBR}}
<div style="border: 1px dotted rgba(0,0,0,0.5);">{{Collapsible_Table/Simple|title=<h5 style="margin:0;">Permissions</h5>|table-style=width:100%;|autocollapse=*|content={{!}}<div>
* Do not depend upon the auto-grant status of permissions. '''Always''' use the [[run_time_permissions]] event.
* Do not depend upon the auto-grant status of permissions. '''Always''' use the [[run_time_permissions]] event.
* If the script lacks the permission [[{{{1}}}]], the script will shout an error on {{#var:DEBUG_CHANNEL}} and the operation fails (but the script continues to run).{{#ifeq:{{{grant|anyone<noinclude>*</noinclude>}}}|anyone||
* If the script lacks {{#if:{{{2|}}}|both the permissions [[{{{1}}}]] and [[{{{2}}}]]|the permission [[{{{1}}}]]}}, the script will shout an error on {{#var:DEBUG_CHANNEL}} and the operation fails (but the script continues to run).{{#ifeq:{{{grant|anyone<noinclude>*</noinclude>}}}|anyone||
* If [[{{{1}}}]] is granted by anyone other than {{{grant|anyone}}}, then when the function is called an error will be shouted on {{#var:DEBUG_CHANNEL}}.}}}}
* If [[{{{1}}}]] {{#if:{{{2|}}}|or [[{{{2}}}]]}} is granted by anyone other than {{{grant|anyone}}}, then when the function is called an error will be shouted on {{#var:DEBUG_CHANNEL}}.}}
{{#switch:{{{1}}}
{{{caveats|}}}{{LSL Function/permission/caveat switch|{{{1}}}}}{{#if:{{{2|}}}|{{LSL Function/permission/caveat switch|{{{2}}}}}}}</div>}}</div>}}}}
|PERMISSION_TAKE_CONTROLS=* Once the [[{{{1}}}]] permission is granted, it can be revoked from inside the script (with [[llReleaseControls]] or a new [[llRequestPermissions]] call), or if the user chooses Release Keys from the viewer. Otherwise, the script will only lose the permission if it is reset or the object derezzed (deleted, detached, or taken).
|PERMISSION_CONTROL_CAMERA=*The [[{{{1}}}]] permission is automatically revoked when the avatar stands up from or detaches the object, and any scripted camera parameters are automatically cleared.
|#default=* Once the [[{{{1}}}]] permission is granted there is no way to revoke it except from inside the script (for example, with a new [[llRequestPermissions]] call). The script will only lose the permission if it is reset or the object is derezzed (deleted, detached, or taken).
}} }}


{{#vardefine:also_events|{{#var:also_events}}
{{#vardefine:also_events|{{#var:also_events}}

Latest revision as of 18:37, 11 May 2016

#var value
header_footnote To run this function the script must request the [[{{{1}}}]] permission with llRequestPermissions.
caveats
Permissions
  • Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
  • If the script lacks the permission [[{{{1}}}]], the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
  • If [[{{{1}}}]] is granted by anyone other than anyone, then when the function is called an error will be shouted on DEBUG_CHANNEL.
  • Once the [[{{{1}}}]] permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call) or the script is reset or deleted.
also_events
•  run_time_permissions Permission receiving event
also_functions
•  llGetPermissions Get the permissions granted
•  llGetPermissionsKey Get the agent who granted permissions
•  llRequestPermissions Request permissions
also_articles
•  Script permissions