env_soundscape

env_soundscape是一个点实体(en)，可在所有的 起源 游戏中使用。它改变了玩家的活动音景(en)，并定义了其中播放的定位声音。玩家必须在实体的半径内并且能够看到它才能发生变化。然后该实体的音景将播放，直到另一个接管。如果不止一个音景实体在争夺控制权，则由最近的接管。

注意:在 中，这是一个保留实体(preserved entity)(en)。

• 在新一轮中，它不会故意将自己重置为其默认属性(包括位置)。
  解决方案:如果这是一个问题，你可以采用 logic_auto 实体模拟重置它。
• 通过Kill(en)杀死它会永远移除它，因为它不会在新一轮重生。
• 它不能用 point_template 生成。
• 把这个实体与非保留实体绑定可能会导致不良影响。

env_soundscape_triggerable 是一个与 env_soundscape 相同的相关实体，但与笔刷实体 trigger_soundscape(en) 结合使用。

提示:在某些游戏（例如军团要塞 2）中，无法通过水“看到”音景实体，在这种情况下，可触发的音景(en)是一种有用的解决方法。

待完善: This template is currently using deprecated suf or {{Lang}}-based translations. Please use the main {{Code class}} instead, which uses {{Autolang}}.

在源代码中，它由 class CEnvSoundscape 代表，定义于 soundscape.cpp。

键值

Radius (radius) ([todo internal name (i)]) <整数(en)>

定义实体的影响范围。玩家还必须拥有 LOS(en) 实体才能触发。 -1 表示无限范围。

Soundscape (soundscape) ([todo internal name (i)]) <字符串(en)>

要播放的音景的名称。提供了一些示例，但没有提供实际列表。浏览音景的最佳方式是在游戏中使用playsoundscape控制台命令。

Sound Position 0 (position0) ([todo internal name (i)]) to Sound Position 7 (position7) <目标名(en)>

定义任何定位声音播放位置的实体。必须是客户端(en)知道的实体（例如info_target或任何可见的东西）。

EnableDisable/启动禁用:

Start Disabled (StartDisabled) <布尔值(en)>

保持休眠状态，直到被唤醒。(利用Enable输入)。

输入

ToggleEnabled

打开/关闭音景。

EnableDisable/启动禁用:

Enable

Disable

启动/禁用此实体所具备的效果。同样会使实体消失。

Base:

AddContext <字符串(en)>

添加到实体的 Response Contexts/响应上下文列表。格式是<key>:<value>。

AddOutput <字符串(en)>

在此实体上分配新的键值/输出。对于键值，有些依赖于额外的必要代码来运行，如果它只是通过这个输入改变就行不通。必须遵循严格的格式：

语法:

// 更改键值的格式： "AddOutput [键] [值]"
//// 原始文本：
"OnUser1" "!self,AddOutput,targetname new_name"

// 添加输出的格式： "AddOutput {目标名称}:{输入名称}:{参数}:{延迟}:{最大触发次数，-1 代表无限}"
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:SetParent:!activator:0.0:-1"
// 参数可以留空，但仍应包含空的空白。
//// 原始文本：
"OnUser1" "!self,AddOutput,OnUser1:ClearParent::0.0:-1"

ClearContext

从此实体的列表中删除所有上下文。

ClearParent

从移动层次结构中删除该实体，使其可以自由移动。

FireUser1 to FireUser4

触发相应的OnUser输出；详见 User Inputs and Outputs。

Kill

从这个世界中删除此实体。

KillHierarchy

功能类似Kill，尽管此实体与其父实体都被删除了，但比Kill快一点。

RemoveContext

从实体列表删除一个上下文。名字应与现有上下文进行匹配。

SetParent <字符串(en)>

跟随此实体移动，详见 实体层级（依赖关系)。

SetParentAttachment <字符串(en)>

更改此实体到其父级上的特定附属点。实体将传送，以至于其骨骼方位与附属匹配。在使用此输入前必须设置好实体的父实体。

SetParentAttachmentMaintainOffset <字符串(en)>

同上，但没有传送。在接收到输入时，实体保持其相对于附件的位置。

Use  不存在于FGD！

与调用 +use 的玩家相同［玩家按 +use（使用，默认E按钮)]；大多数情况下没有影响。

DispatchResponse <字符串(en)> 不存在于FGD！

向实体发送一个上下文。 详见 Response 和 Concept.

DispatchEffect <字符串(en)> (被移除于 以来) 不存在于FGD！

在实体的原点坐标设置一个特定效果；参见 List of Client Effects。自从 求生之路后由粒子系统取代。

RunScriptFile <脚本(en)> (存在于自 以来)

从硬盘执行一个 VScript 脚本文件，不带文件后缀名。会合并接收实体的脚本域。

RunScriptCode <字符串(en)> (存在于自 以来)

在接收输入的实体范围内执行一串 VScript 源代码。通过控制台触发时可能需要字符串引用。

错误:在 Hammer 中，使用带有字符串的参数会破坏 VMF 文件的结构，使下一个 Hammer 会话无法查看该文件。  [todo tested in ?]

修复:使用文本编辑器手动删除带有字符串的参数。

CallScriptFunction <字符串(en)> (存在于自 以来) 不存在于FGD！

在接受实体脚本域上执行一段 VScript 函数。

SetLocalOrigin <coordinates(en)> (存在于自 以来) 不存在于FGD！

将此实体设置到地图中的某个位置。如果此实体是某实体父级，那么它的子级也会随着移动。

SetLocalAngles <angles(en)> (存在于自 以来) 不存在于FGD！

设置该实体的角度。

输出

OnPlay

当此音景变为活动音景时触发。

Base/基础:

OnUser1 to OnUser4

这些输出将分别响应于 FireUser1 到 FireUser4 输入。 详见 User Inputs and Outputs。

OnKilled  (仅存在于 之中)

当实体被Kill输入时响应此输出。

另请参见

• env_soundscape_proxy
• 音景列表(en)