Difference between revisions of "LlRequestUserKey"

From Second Life Wiki
Jump to navigation Jump to search
(Clarified function is throttled and provided information about its general rate.)
m
Line 12: Line 12:
|spec
|spec
|caveats=
|caveats=
* This function is throttled. The throttle is undocumented, but as of October 2018 the function appears to support bursts of up to 20 requests and sustained use at an average rate of 1.9 requests per second. Once tripped, the function fails and says "Too many llRequestUserKey requests.  Throttled until average falls." on DEBUG_CHANNEL.
* This function is throttled. The throttle is undocumented, but as of October 2018 the function appears to support bursts of up to 20 requests and sustained use at an average rate of 1.9 requests per second. Once tripped, the function fails and says "Too many llRequestUserKey requests.  Throttled until average falls." on [[DEBUG_CHANNEL]].
|examples=<source lang="lsl2">key name_key_query;
|examples=<source lang="lsl2">key name_key_query;
default
default

Revision as of 14:34, 2 October 2018

Summary

Function: key llRequestUserKey( string username );

Requests the Agent ID for the agent identified by name from the dataserver. The name given may be either the current name of an avatar or a historical name that has been used in the past. If no agent can be found with the supplied name this function returns the value NULL_KEY.

Returns a handle (a key) that can be used to identify the request when the dataserver event is raised.

The agent being searched for with this function does not need to be signed on to Second Life.
Returns a key

• string username the username of the avatar to retrieve the UUID of.

Caveats

  • This function is throttled. The throttle is undocumented, but as of October 2018 the function appears to support bursts of up to 20 requests and sustained use at an average rate of 1.9 requests per second. Once tripped, the function fails and says "Too many llRequestUserKey requests. Throttled until average falls." on DEBUG_CHANNEL.
All Issues ~ Search JIRA for related Bugs

Examples

key name_key_query;
default
{
   state_entry()
   {
       name_key_query = llRequestUserKey("rider.linden");
   }

   dataserver(key queryid, string data) 
   {
       if ( name_key_query == queryid )
       {
           llSay(0, "The key for this user is : " + data);
       }
   }
}

Notes

Names are always provided in the form "First[ Last]" or "first[.last]" (first name with an optional last name.) If the last name is omitted a last name of "Resident" is assumed. Case is not considered when resolving agent names.

See Also

Functions

•  llName2Key to fetch avatar UUID by name.

Deep Notes

Search JIRA for related Issues

Signature

function key llRequestUserKey( string username );