查看“LlReplaceAgentEnvironment”的源代码

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


{{函数详情
|函数名 = Function: Integer llReplaceAgentEnvironment( key agent_id, float transition, string environment );
|参数= 参数：
• key agent_id – 该地区代理商的钥匙。代理必须在该地区，必须参与到体验中。 

• float transition – 转换到新设置的秒数。

• string environment – 对象目录中环境设置的名称或环境的资产ID。 
|返回值= 返回值：llReplaceAgentEnvironment函数覆盖代理看到的当前区域和包裹环境。新环境持续存在，直到代理跨到新的区域，或者使用特定代理的环境参数中的NULL_KEY或空字符串调用该函数，这样做将删除作为体验的一部分应用于该代理的所有环境设置。这个功能必须作为体验的一部分来执行。

返回一个整数

|注意事项=代理的查看器可以选择忽略此命令。

在查看器上本地设置的环境将覆盖从该函数设置的任何环境。

如果UUID作为环境参数传递，并且该UUID没有指定环境设置，则查看器将忽略该指令。

|示例=
示例1
<pre>
string gEnvironment = "A-12AM"; // Can be asset's name in object's inventory or the asset ID
float gTransitionTime = 3.0;
 
default
{
    touch_start(integer total_number)
    {
        key person = llDetectedKey(0);
        if (llGetAgentSize(person) != ZERO_VECTOR)
        {
            llRequestExperiencePermissions(person, "");
        }
        else
        {
            llInstantMessage(person, "You need to be in the same region to change environment");
        }
    }
 
    experience_permissions(key agent_id)
    {
        integer envTest = llReplaceAgentEnvironment(agent_id, gTransitionTime, gEnvironment);
        if (envTest == 1)
        {
            llRegionSayTo(agent_id, 0, "Applying environment for " + (string)agent_id);
        }
        else
        {
            llRegionSayTo(agent_id, 0, "Cannot apply environment for " + (string)agent_id + " due to reason id: " + (string)envTest);
        }
    }
 
    experience_permissions_denied(key agent_id, integer reason)
    {
        llRegionSayTo(agent_id, 0, "Denied experience permissions for " + (string)agent_id + " due to reason id: " + (string)reason);
    }
}
</pre>

|相关函数=
[[llSetAgentEnvironment ]]

[[llGetEnvironment]]

}}
附录：（表格）
{| class="wikitable" border="1"
|-
! Value
! Constant
! Description
|-
| 
| 1
| 代理已经被指示改变他们的环境。
|-
| ENV_INVALID_AGENT
| -4
| 无法找到指定的代理。
|-
| ENV_NO_ENVIRONMENT 
| -3
| 找不到环境目录对象。
|-
| ENV_NO_EXPERIENCE_LAND 
| -7
| 经验没有被启用或不能在土地上运行。
|-
| ENV_NO_EXPERIENCE_PERMISSION 
| -2
| 代理没有给予许可。
|-
| ENV_NOT_EXPERIENCE 
| -1
| 脚本没有作为具有有效体验键的体验的一部分运行。
|-
| ENV_THROTTLE 
| -8
| 脚本已经超出了油门。等待并重试请求。
|}