查看“LlRequestUserKey”的源代码

{{LSL Header|ml=*}}{{LSLC|Keywords}}{{LSLC|Flow Control}}{{LSLC|}}


{{函数详情
|函数名 = Function: key llRequestUserKey( string username );
|参数= 参数：• string username – 要检索的UUID的化身的用户名。
|返回值= 返回值：从数据服务器请求由名称标识的代理的代理ID。所给的名字可以是当前角色的名字，也可以是过去使用过的历史名字。如果没有找到具有所提供名称的代理，该函数将返回值[[NULL_KEY]]。

返回一个handle (a key)，该句柄可用于在引发dataserver事件时识别请求。

使用此功能搜索的代理不需要在Second Life上签名。

返回一个键

|注意事项=这个函数是节流的。这个节流还没有正式记录，但截至2018年10月，该功能似乎支持最多20个请求的突发，每个所有者、每个地区平均每秒1.9个请求的持续使用。(这意味着该节流应用于该区域中具有相同所有者的所有对象。)一旦被绊倒，该函数就会失败并表示“llRequestUserKey请求太多了”在[[DEBUG_CHANNEL]]上. 

对于尚未登录到使用该函数的网格的任何代理，该函数将返回一个NULL_KEY。

|示例=
示例1
<pre>
key name_key_query;
default
{
   state_entry()
   {
       name_key_query = llRequestUserKey("rider.linden");
   }
 
   dataserver(key queryid, string data) 
   {
       if ( name_key_query == queryid )
       {
           llSay(0, "The key for this user is : " + data);
       }
   }
}
</pre>

|相关函数=
[[llRequestUsername]]- 将键转换为名称

[[llName2Key]]- 按名称获取化身UUID。

}}