Difference between revisions of "LlGetExperienceDetails"
Jump to navigation
Jump to search
m (Updated return list contents) |
m |
||
| (6 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
[[Category:Experience Tools]] | [[Category:Experience Tools]] | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL Function/Experience|false}} | |||
|func=llGetExperienceDetails | |func=llGetExperienceDetails | ||
|return_text=of details about the experience. This list has | |return_text=of details about the experience. This list has 6 components: <code>[string experience_name, key owner_id, key experience_id, integer state, string state_message, key group_id]</code> | ||
|func_footnote=If {{LSLPT|experience_id}} is [[NULL_KEY]], then information about the script's experience is returned. In this situation, if the script isn't associated with an experience, an empty list is returned. | |func_footnote=If {{LSLPT|experience_id}} is [[NULL_KEY]], then information about the script's experience is returned. In this situation, if the script isn't associated with an experience, an empty list is returned. | ||
|return_type=list | |return_type=list | ||
| Line 8: | Line 9: | ||
|also_functions= | |also_functions= | ||
*[[llAgentInExperience]] | *[[llAgentInExperience]] | ||
|examples=<source lang="lsl2">default | |||
|examples=< | |||
{ | { | ||
touch_start(integer total_number) | touch_start(integer total_number) | ||
| Line 23: | Line 23: | ||
// Print nothing if not associated with an XP or info about the associated experience | // Print nothing if not associated with an XP or info about the associated experience | ||
} | } | ||
}</ | }</source> | ||
|cat1=Experience | |cat1=Experience | ||
|history=* {{JIRA|BUG-7048}} - [[llGetExperienceDetails]] returns 4 for {{LSLPT|state}} and "operation not permitted" for {{LSLPT|state_message}} while over mainland parcels that have the experience allowed. | |||
}} | }} | ||
Latest revision as of 15:07, 3 April 2016
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: list llGetExperienceDetails( key experience_id );Returns a list of details about the experience. This list has 6 components: [string experience_name, key owner_id, key experience_id, integer state, string state_message, key group_id]
| • key | experience_id | – | The ID of the experience to query. |
If experience_id is NULL_KEY, then information about the script's experience is returned. In this situation, if the script isn't associated with an experience, an empty list is returned.
Examples
default
{
touch_start(integer total_number)
{
key xp = "9170c22b-f445-ea5d-89fa-0f2f1e144f04";
llOwnerSay(llDumpList2String(llGetExperienceDetails(xp), "\n"));
// Prints:
// Linden Realms
// id
// status msg
llOwnerSay(llDumpList2String(llGetExperienceDetails(NULL_KEY), "\n"));
// Print nothing if not associated with an XP or info about the associated experience
}
}
Notes
Compiling
For a script to be associated with an Experience...
- It must be compiled with a client that is Experience aware,
- The "Use Experience" checkbox must be checked,
- And one of the users Experience keys selected.
 |
Important: Not all TPVs have this functionality. |
See Also
Deep Notes
History
- BUG-7048 - llGetExperienceDetails returns 4 for state and "operation not permitted" for state_message while over mainland parcels that have the experience allowed.
Signature |
|---|
function list llGetExperienceDetails( key experience_id ); |