Difference between revisions of "LlRequestUsername"

From Second Life Wiki
Jump to navigation Jump to search
m (modify return_text)
m
Line 5: Line 5:
|func=llRequestUsername
|func=llRequestUsername
|return_type=key
|return_type=key
|return_subtype=handle
|return_text=that is used to identify the [[dataserver]] event when it is raised.
If {{LSLPT|id}} is not the UUID of an avatar, the [[dataserver]] event is not raised.
|p1_type=key|p1_name=id
|p1_type=key|p1_name=id
|func_footnote
|func_footnote
|func_desc=Requests the '''[[Usernames|Username]]''' of the agent identified by '''id'''. When '''[[Usernames|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.
|func_desc=Requests the '''[[Usernames|Username]]''' of the agent identified by {{LSLPT|id}}. When the '''[[Usernames|Username]]''' is available the [[dataserver]] event will be raised. The agent identified by {{LSLPT|id}} does not need to be in the same region or online at the time of the request.
|return_text=that is used to identify the [[dataserver]] event when it is raised.
If the key in parameter is not an avatar , the [[dataserver]] event is not raised.
|spec
|spec
|caveats=
|caveats=

Revision as of 19:25, 9 January 2014

Summary

Function: key llRequestUsername( key id );

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

  • 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.:<lsl>llSay(0, "secondlife:///app/agent/" + (string)id + "/username");</lsl>

Important Issues

~ All Issues ~ Search JIRA for related Bugs
   llRequestUsername dataserver event returns "???" while llGetUsername returns correct value

Examples

<lsl>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);
       }
   }
}</lsl>

See Also

Events

•  dataserver

Functions

•  llGetUsername

Deep Notes

All Issues

~ Search JIRA for related Issues
   llRequestUsername dataserver event returns "???" while llGetUsername returns correct value

Signature

function key llRequestUsername( key id );