LlRequestUserKey

来自人工智能助力教育知识百科
跳转至: 导航搜索

Template:Needs Translation/


函数名
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
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);
       }
   }
}
相关函数
llRequestUsername- 将键转换为名称

llName2Key- 按名称获取化身UUID。

相关事件