Difference between revisions of "LlRequestDisplayName"

From Second Life Wiki
Jump to navigation Jump to search
(spreading the terror :))
(suggest use of ///app/agent/ if you just want to display avatar name info in the viewer window)
Line 11: Line 11:
|spec
|spec
|caveats=*If the request fails for any reason, there will be no error notice or dataserver event. You may use a timer to check for stale requests.
|caveats=*If the request fails for any reason, there will be no error notice or dataserver event. You may use a timer to check for stale requests.
*If you merely wish to show avatar name information in the viewer window, it may be more straightforward to avoid a dataserver event and simply output: <lsl>llSay(0, "secondlife:///app/agent/" + (string)id + "/about");</lsl>
|constants
|constants
|examples=<lsl>key owner_key;
|examples=<lsl>key owner_key;

Revision as of 15:01, 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.

Emblem-important-red.png Security Warning!

It is a terrible idea to tie any security measures to display names. Don't do it.

Summary

Function: key llRequestDisplayName( key id );
0.0 Forced Delay
10.0 Energy

Requests the Display Name of the agent identified by id. When Display Name 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

Caveats

  • If the request fails for any reason, there will be no error notice or dataserver event. You may use a timer to check for stale requests.
  • If you merely wish to show avatar name information in the viewer window, it may be more straightforward to avoid a dataserver event and simply output: <lsl>llSay(0, "secondlife:///app/agent/" + (string)id + "/about");</lsl>

Examples

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

default {

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

See Also

Events

•  dataserver

Functions

•  llGetDisplayName
•  llRequestUsername

Deep Notes

Signature

function key llRequestDisplayName( key id );