Category:Experience Tools
Revision as of 07:44, 30 August 2014 by Toy Wylie (talk | contribs) (→Experience Persistent Storage: fixed arguments for llUpdateKeyValue)
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Experience Tools provide a way to request persistent permissions across multiple logins and with multiple objects and scripts. In order to use these functions, you must have an experience key. For further information, see Experiences in Second Life in the Second Life Knowledge Base.
The Experience Tools API fall into three categories:
Experience Information
• integer | llAgentInExperience(key agent) | |||
• list | llGetExperienceDetails(key experience_id) |
Experience Permissions
• event | experience_permissions(key agent) | |||
• event | experience_permissions_denied(key agent, integer reason) | |||
• void | llRequestExperiencePermissions(key agent, string name) |
Experience Persistent Storage
These are all asynchronous functions, they all return a handle that corresponds to a dataserver event.
• key | llReadKeyValue(string k) | |||
• key | llCreateKeyValue(string k, string v) | |||
• key | llUpdateKeyValue(string k, string v, integer checked, string original_value) | |||
• key | llDeleteKeyValue(string k) |
Debugging
• key | llDataSizeKeyValue() | – | Gets the number of bytes used by the experience along with the experience's byte quote | |
• key | llKeysKeyValue(integer start, integer count) | – | Gets the names of the keys | |
• key | llKeyCountKeyValue() | – | Gets the number of keys | |
• string | llGetExperienceErrorMessage(integer value) | – | Converts an integer error code to a wordy string representation |
LSL Constant | Message returned via llGetExperienceErrorMessage | Description | |
---|---|---|---|
XP_ERROR_NONE | 0 | no error | No error was detected. |
XP_ERROR_THROTTLED | 1 | exceeded throttle | The call failed due to too many recent calls. |
XP_ERROR_EXPERIENCES_DISABLED | 2 | experiences are disabled | The region currently has experiences disabled. |
XP_ERROR_INVALID_PARAMETERS | 3 | invalid parameters | One of the string arguments was too big to fit in the key-value store. |
XP_ERROR_NOT_PERMITTED | 4 | operation not permitted | Experience permissions were denied by the user. |
XP_ERROR_NO_EXPERIENCE | 5 | script not associated with an experience | This script is not associated with an experience. |
XP_ERROR_NOT_FOUND | 6 | not found | The sim was unable to verify the validity of the experience. Retrying after a short wait is advised. |
XP_ERROR_INVALID_EXPERIENCE | 7 | invalid experience | The script is associated with an experience that no longer exists. |
XP_ERROR_EXPERIENCE_DISABLED | 8 | experience is disabled | The experience owner has temporarily disabled the experience. |
XP_ERROR_EXPERIENCE_SUSPENDED | 9 | experience is suspended | The experience has been suspended by Linden Lab customer support. |
XP_ERROR_UNKNOWN_ERROR | 10 | unknown error | An unknown error not covered by any of the other predetermined error states. |
XP_ERROR_QUOTA_EXCEEDED | 11 | experience data quota exceeded | An attempt to write data to the key-value store failed due to the data quota being met. |
XP_ERROR_STORE_DISABLED | 12 | key-value store is disabled | They key-value store is currently disabled on this region. |
XP_ERROR_STORAGE_EXCEPTION | 13 | key-value store communication failed | Unable to communicate with the key-value store. |
XP_ERROR_KEY_NOT_FOUND | 14 | key doesn't exist | They requested key does not exist. |
XP_ERROR_RETRY_UPDATE | 15 | retry update | A checked update failed due to an out of date request. |
XP_ERROR_MATURITY_EXCEEDED | 16 | experience content rating too high | The content rating of the experience exceeds that of the region. |
XP_ERROR_NOT_PERMITTED_LAND | 17 | not allowed to run on this land | The experience is blocked or not enabled for this land. |
XP_ERROR_REQUEST_PERM_TIMEOUT | 18 | experience permissions request timed out | The request for experience permissions was ignored. |
Subcategories
This category has the following 3 subcategories, out of 3 total.
Pages in category "Experience Tools"
The following 21 pages are in this category, out of 21 total.