Difference between revisions of "LlKey2Name"
Cenji Neutra (talk | contribs) (Added reference to bugs causing incorrect results to alert developers) |
m |
||
Line 1: | Line 1: | ||
{{LSL_Function/ | {{LSL_Function/uuid|id|sim=*}}{{LSL_Function | ||
|func_id=210|func_sleep=0.0|func_energy=10.0 | |func_id=210|func_sleep=0.0|func_energy=10.0 | ||
|sort=Key2Name|func=llKey2Name | |sort=Key2Name|func=llKey2Name |
Revision as of 17:37, 3 May 2009
LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llKey2Name( key id );210 | Function ID |
0.0 | Forced Delay |
10.0 | Energy |
Returns a string that is the name of the prim or avatar specified by id.
• key | id | – | group, avatar or prim UUID that is in the same region |
id must specify a valid rezzed prim or avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty string is returned. In the case of an avatar, this function will still return a valid name if the avatar is a child agent of the sim (i.e., in an adjacent sim, but presently able to see into the one the script is in), or for a short period after the avatar leaves the sim (specifically, when the client completely disconnects from the sim, either as a main or child agent).
Keys of inventory items will not work; in the case of these, use llGetInventoryName instead.
Caveats
- It is difficult to tell the difference between a prim that has a name that is an empty string and a prim that is not in the sim, or because an invalid key was specified.
- To get around the "avatar must be present" limitation, you can use the llRequestAgentData function and the dataserver event to obtain the avatar's name from a key.
- There is no opposite function (llName2Key) available. However, there are third-party websites which can be queried using the llHTTPRequest function and the http_response event.
- Due to bugs (SVC-4170 and SVC-3935) the function sometimes erroneously returns the string "(Loading...)" and sometimes the avatar name with two spaces between the first and last names.
Examples
<lsl>// Best viewed in Chat History (ctrl-h) default {
collision_start(integer a)//Announce who collided { llSay(0, "llKey2Name: " + llKey2Name(llDetectedKey(0)) + "\nllDetectedName: " + llDetectedName(0)); } touch_start(integer a) { llSay(0,"llKey2Name: " + llKey2Name(llDetectedKey(0)) + "\nllDetectedName: " + llDetectedName(0)); }}</lsl>
Notes
Active Name2Key Databases:
- http://w-hat.com/name2key
- http://kdc.ethernia.net/sys/name2key.php
- http://wiki.apez.biz/Development (web-service API functions getAvatarKey and getAvatarName)
Dead Name2Key Databases:
http://www.libsecondlife.org/protocol/index.php/Name2key(Appears to be gone as of Apr 2008, but search for name2key on that site for more information)http://www.ulrikasheim.org/tools/name2key.html(Appears to be gone as of Apr 2008)
Name2Key Libraries:
See Also
Functions
• | llGetObjectDetails | |||
• | llRequestAgentData | – | Uses the dataserver to request avatar information |
Articles
• | Prim Attribute Overloading |