Difference between revisions of "LlGetUsername"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m |
|||
| (12 intermediate revisions by 6 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | |||
|inject- | |inject-2={{LSL_Function/avatar|id|sim=known}} | ||
|func_id= | |func_id=358|func_sleep=0.0|func_energy=10.0 | ||
|sort=GetUsername|func=llGetUsername | |sort=GetUsername|func=llGetUsername | ||
|return_type=string|p1_type=key|p1_name=id | |return_type=string|p1_type=key|p1_name=id | ||
|func_footnote='''id''' must specify a valid avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty string is returned. This function will still return a valid username 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). | |func_footnote='''id''' must specify a valid avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty string is returned. This function will still return a valid username 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). | ||
|func_desc | |func_desc | ||
|return_text=that is the unique username of the avatar specified by '''id'''. | |return_text=that is the unique [[Usernames|username]] of the avatar specified by '''id'''. | ||
|spec | |spec | ||
|caveats=* To get around the "avatar must be present" limitation, you can use the [[llRequestUsername]] function and the [[dataserver]] event to obtain the avatar's username from a key. | |caveats= | ||
* There is no opposite function ([[llUsername2Key]]) available. | * To get around the "avatar must be present" limitation, you can use the [[llRequestUsername]] function and the [[dataserver]] event to obtain the avatar's username from a key. | ||
* | * There is no opposite function ([[llUsername2Key]]) available. For Name2Key services see [[llKey2Name]]. | ||
|constants | * "" can be returned if the region is unable to resolve the username. This can happen even if the avatar is present and display names are enabled on the region. Do not rely on this function to verify avatar presence. | ||
|examples=< | *If you merely wish to show the agent username in the viewer window, it may be more straightforward to use [[Viewer URI Name Space]], e.g.:<source lang="lsl2">llSay(0, "secondlife:///app/agent/" + (string)id + "/username");</source>|constants | ||
|examples=<source lang="lsl2">// Best viewed in Chat History (ctrl-h) | |||
default | default | ||
{ | { | ||
| Line 25: | Line 26: | ||
"\nllGetUsername: " + llGetUsername(llDetectedKey(0))); | "\nllGetUsername: " + llGetUsername(llDetectedKey(0))); | ||
} | } | ||
}</ | }</source> | ||
|helpers | |helpers | ||
|also_functions= | |also_functions= | ||
| Line 38: | Line 39: | ||
|cat3=Key | |cat3=Key | ||
|cat4=Avatar/Name | |cat4=Avatar/Name | ||
|haiku={{Haiku|My name is Jerome.|No, really. It is. Don't ask.|I wasn't thinking.}} | |||
{{Haiku|Jerome Resident|Except sometimes it's different|Then it's just Jerome}} | |||
}} | }} | ||
Latest revision as of 17:46, 18 June 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: string llGetUsername( key id );| 358 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a string that is the unique username of the avatar specified by id.
| • key | id | – | avatar UUID that is in the same region or is otherwise known to the region |
id must specify a valid avatar key, present in or otherwise known to the sim in which the script is running, otherwise an empty string is returned. This function will still return a valid username 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).
Caveats
- To get around the "avatar must be present" limitation, you can use the llRequestUsername function and the dataserver event to obtain the avatar's username from a key.
- There is no opposite function (llUsername2Key) available. For Name2Key services see llKey2Name.
- "" can be returned if the region is unable to resolve the username. This can happen even if the avatar is present and display names are enabled on the region. Do not rely on this function to verify avatar presence.
- If you merely wish to show the agent username in the viewer window, it may be more straightforward to use Viewer URI Name Space, e.g.:
llSay(0, "secondlife:///app/agent/" + (string)id + "/username");
Examples
// Best viewed in Chat History (ctrl-h)
default
{
collision_start(integer a)//Announce who collided
{
llSay(0, "llGetDisplayName: " + llGetDisplayName(llDetectedKey(0)) +
"\nllGetUsername: " + llGetUsername(llDetectedKey(0)));
}
touch_start(integer a)
{
llSay(0,"llGetDisplayName: " + llGetDisplayName(llDetectedKey(0)) +
"\nllGetUsername: " + llGetUsername(llDetectedKey(0)));
}
}
See Also
Functions
| • | llGetDisplayName | |||
| • | llRequestUsername | – | Uses the dataserver to request avatar information |
Deep Notes
Search JIRA for related Issues
Signature |
|---|
function string llGetUsername( key id ); |
Haiku |
|---|
|
My name is Jerome.
Jerome Resident
|