Difference between revisions of "LlGetExperienceDetails"

From Second Life Wiki
Jump to navigation Jump to search
m
m
 
(11 intermediate revisions by 5 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_desc=of details about the experience.
|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=The returned list has 5 components: <code>[string experience_name, key owner_id, key group_id, key experience_id, string state, string state message]</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.
|return_type=list
|return_type=list
|p1_type=key|p1_name=experience_id|p1_desc=The ID of the experience to query. Can be [[NULL_KEY]] to request information on the script's experience.
|p1_type=key|p1_name=experience_id|p1_desc=The ID of the experience to query.  
|also_functions=
|also_functions=
*[[llAgentInExperience]]
*[[llAgentInExperience]]
*[[llGetExperienceDetails]]
|examples=<source lang="lsl2">default
*[[llGetExperienceList]]
|examples=<lsl>default
   {
   {
       touch_start(integer total_number)
       touch_start(integer total_number)
Line 24: 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
       }
       }
   }</lsl>
   }</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

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.
KBcaution.png 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 );