Difference between revisions of "LlRequestUsername"
Jump to navigation
Jump to search
m (<lsl> tag to <source>) |
Lou Netizen (talk | contribs) (Clarified function is throttled and provided information about its general rate.) |
||
| Line 14: | Line 14: | ||
|caveats= | |caveats= | ||
*If you merely wish to show the agent username in the viewer window, it may be more straightforward to use [[Viewer URI Name Space]] and avoid a dataserver event, e.g.:<source lang="lsl2">llSay(0, "secondlife:///app/agent/" + (string)id + "/username");</source> | *If you merely wish to show the agent username in the viewer window, it may be more straightforward to use [[Viewer URI Name Space]] and avoid a dataserver event, e.g.:<source lang="lsl2">llSay(0, "secondlife:///app/agent/" + (string)id + "/username");</source> | ||
|constants | |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 llRequestUsername requests. Throttled until average falls." on DEBUG_CHANNEL.|constants | |||
|examples=<source lang="lsl2">key owner_name_query; | |examples=<source lang="lsl2">key owner_name_query; | ||
Revision as of 13:30, 2 October 2018
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: key llRequestUsername( key id );
| 0.0 | Forced Delay |
| 10.0 | Energy |
Requests the Username of the agent identified by id. When the Username is available the dataserver event will be raised. The agent identified by id does not need to be in the same region or online at the time of the request.
Returns a handle (a key) that is used to identify the dataserver event when it is raised.
If id is not the UUID of an avatar, the dataserver event is not raised.
| • key | id | – | avatar UUID |
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 llRequestUsername requests. Throttled until average falls." on DEBUG_CHANNEL.
Examples
key owner_name_query;
default
{
state_entry()
{
owner_name_query = llRequestUsername(llGetOwner());
}
dataserver(key queryid, string data)
{
if ( owner_name_query == queryid )
{
llSay(0, "The username of the owner of this script : " + data);
}
}
}
See Also
Deep Notes
Signature |
|---|
function key llRequestUsername( key id ); |