Experience

Work with experience permissions, information, and persistent data.

Feature: Experience

What do you want to do?

llRequestExperiencePermissions(key agent, string name)Requests permission from the specified agent to participate in the experience. These permissions are persistent and apply grid-wide across all scripts in the experience, automatically triggering experience_permissions or experience_permissions_denied.list llGetExperienceDetails(key experience_id)Returns a list of details for the specified experience_id, formatted as [string experience_name, key owner_id, key experience_id, integer state, string state_message, key group_id].key llCreateKeyValue(string k, string v)Starts an asynchronous transaction to create a key-value pair (k and v) associated with the script's experience. Returns a key query handle for the dataserver event. Fails with XP_ERROR_STORAGE_EXCEPTION if the key already exists.

Reference

Find topic entries

16 topic entries

• integer llAgentInExperience(key agent)function

  Returns TRUE if the specified agent is in the experience and the experience can run in the current region/location; returns FALSE otherwise.

• key llCreateKeyValue(string k, string v)function

  Starts an asynchronous transaction to create a key-value pair (k and v) associated with the script's experience. Returns a key query handle for the dataserver event. Fails with XP_ERROR_STORAGE_EXCEPTION if the key already exists.

• key llDataSizeKeyValue()function

  Starts an asynchronous transaction to request the used and total data storage allocated for the experience. Returns a key query handle for the dataserver event.

• key llDeleteKeyValue(string k)function

  Starts an asynchronous transaction to delete the key-value pair associated with key k in the experience. Returns a key query handle for the dataserver event.

• list llGetExperienceDetails(key experience_id)function

  Returns a list of details for the specified experience_id, formatted as [string experience_name, key owner_id, key experience_id, integer state, string state_message, key group_id].

• string llGetExperienceErrorMessage(integer error)function

  Returns a text description of the specified experience error code, or a description of XP_ERROR_UNKNOWN_ERROR if the error is invalid.

• key llKeyCountKeyValue()function

  Starts an asynchronous transaction requesting the total count of keys in the experience data store. Returns a key query handle for the dataserver event.

• key llKeysKeyValue(integer first, integer count)function

  Starts an asynchronous transaction to retrieve count keys from the experience data store starting at the zero-based index first. Returns a key query handle for the dataserver event. Fails with XP_ERROR_KEY_NOT_FOUND if out of bounds.

• key llReadKeyValue(string k)function

  Starts an asynchronous transaction to read the value associated with key k in the experience. Returns a key query handle for the dataserver event. Fails with XP_ERROR_KEY_NOT_FOUND if the key does not exist.

• integer llReplaceAgentEnvironment(key agent_id, float transition, string environment)function

  Replaces the region and parcel environment seen by the specified agent_id as part of an experience, transitioning the settings over transition seconds. Passing NULL_KEY or an empty string for environment restores defaults.

• llRequestExperiencePermissions(key agent, string name)function

  Requests permission from the specified agent to participate in the experience. These permissions are persistent and apply grid-wide across all scripts in the experience, automatically triggering experience_permissions or experience_permissions_denied.

• integer llSetAgentEnvironment(key agent_id, float transition, list params)function

  Sets an individual agent's environmental settings using the attributes in params over a duration of transition seconds. Must be used as part of an experience; passing an empty list removes overrides.

• integer llSitOnLink(key agent_id, integer link)function

  Forces the avatar specified by agent_id (who must be participating in the experience) to sit on the sit target of the prim indicated by link. If occupied, searches down the linkset for an available sit target. Returns an integer.

• key llUpdateKeyValue(string k, string v, integer checked, string original_value)function

  Starts an asynchronous transaction to update the key k to value v inside the experience datastore. If checked is TRUE, the update fails with XP_ERROR_RETRY_UPDATE unless the existing value matches original_value.

• experience_permissions(key agent_id)event

  Triggered when the agent specified by agent_id approves an experience permissions request (interactively or automatically if previously approved).

• experience_permissions_denied(key agent_id, integer reason)event

  Triggered when the agent specified by agent_id denies experience permissions, or when permission is blocked for other reasons (specified by the error code reason).