Difference between revisions of "LlRequestUsername"

From Second Life Wiki
Jump to navigation Jump to search
m
(link to Usernames article instead of Display Names; caveat re: updating of display names is not applicable here)
Line 6: Line 6:
|p1_type=key|p1_name=id|p1_hover=avatar UUID|p1_desc=avatar {{HoverLink|UUID|Universally Unique Identifier}}
|p1_type=key|p1_name=id|p1_hover=avatar UUID|p1_desc=avatar {{HoverLink|UUID|Universally Unique Identifier}}
|func_footnote
|func_footnote
|func_desc=Requests the '''[[Display_Names|Username]]''' of the agent identified by '''id'''. When '''[[Display_Names|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 '''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.
|return_text=that is used to identify the [[dataserver]] event when it is raised.
|return_text=that is used to identify the [[dataserver]] event when it is raised.
|spec
|spec
|caveats=* Display Name changes may take up to 72 hours to propagate. During this time scripts may report the old display name.
|caveats  
|constants
|constants
|examples=<lsl>key owner_key;
|examples=<lsl>key owner_key;

Revision as of 15:46, 8 November 2010

Emblem-important-red.png Pre-release Documentation Warning!

This function is not available yet. This documentation was written prior to its final release so it may not match the final implementation.It is slated for release in Server DisplayNames.

Summary

Function: key llRequestUsername( key id );

Requests the Username of the agent identified by id. When 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 key that is used to identify the dataserver event when it is raised.

• key id avatar UUID

Examples

<lsl>key owner_key; key owner_name_query; string owner_username;

default {

   state_entry()
   {
       owner_key = llGetOwner();
       owner_name_query = llRequestUsername(owner_key);
   }
   dataserver(key queryid, string data)
   {
       if ( owner_name_query == queryid )
       {
           owner_display_name = data;
           llSay(0, "The username of the owner of this script : " + owner_username );
       }
   }
}</lsl>

See Also

Events

•  dataserver

Functions

•  llGetUsername

Deep Notes

Search JIRA for related Issues

Signature

function key llRequestUsername( key id );