Ambient generic

这个实体同样适用于金源引擎中的 Zh/Ambient generic (GoldSource Engine)。

 ambient_generic是一个存在于所有的 起源 游戏的点实体。

实体描述

此实体用于播放声音，可以设置单次或循环。同样可以设置从某坐标点或者全局可听见。 其可以播放和控制声音脚本的声音，一段.wav实例或者scripted sentence（实体）。不像贴图或者模型那样，你必须重启 Hammer 才能看到变化，声音不需要，只需要点 browser 即可。 Template:Tip:zh-cn Template:Bug:zh-cn Template:Bug:zh-cn Template:Bug:zh-cn Template:Bug:zh-cn Template:Bug:zh-cn

键值

Sound Name (message) <字符串(en)>

声音脚本的名字，或者需要播放的声音的路径。对于scripted_sentence,需要在此实体名字前加上一个“!”。 (例如: !COMBINE_THROW_GRENADE4) Template:Note:zh-cn

Max Audible Distance (radius) <浮点型(en)>

最大播放距离 unit （hammer 单位）对于客户端来说。Template:Bug:zh-cnTemplate:Bug:zh-cnTemplate:Note:zh-cn

SourceEntityName (SourceEntityName) <目标名(en)>

如果指定，声音将从此实体上播放而不是ambient_generic实体。如果目标是能够口型同步的 NPC ，并且能找到因素信息。那么目标能与声音口型同步。Template:Bug:zh-cnTemplate:Bug:zh-cn

Volume (health) <整数 0-10 (en)>

声音的音量大小。0是静音，10是正常，默认为10。Template:Tip:zh-cnTemplate:Bug:zh-cn

Start Volume/初始音量 (volstart) <整数 0-10 (en)>

Fade in time in seconds/淡入时间/秒 (fadeinsecs) <整数 0-100 (en)>

Fade out time in seconds/淡出时间/秒 (fadeoutsecs) <整数 0-100 (en)>

淡入淡出时间以及开始时的音量大小，默认不淡入淡出。

Pitch (pitch) <整数 0-255 (en)>

音高，1为低，100为正常，255为高。Template:Bug:zh-cn

Start pitch/初始音高 (pitchstart) <整数 0-255 (en)>

Spin up time/升速时间 (spinup) <整数 0-100 (en)>

Spin down time/降速时间 (spindown) <整数 0-100 (en)>

播放开始/结束消耗多少时间升速或降低音高，以及从多少音高开始。默认不执行。

Dynamic Presets (preset) <choices>

可以应用各种 DSP 效果。

LFO type (lfotype) <整数(en)>

低频振荡种类的采用。

• Off (default)/关（默认）
• Square Wave (alternate between low and high)/矩形波（高低交替）
• Triangle Wave (crossfade between high and low)/三角波（高低之间淡入淡出）
• Random/随机

LFO rate (lforate) <整数 0-1000 (en)>

LFO 效果重复频率。

LFO modulation - pitch (lfomodpitch) <整数 0-100 (en)>

影响音高或者颤音。更高的数字会改变更多音高—颤声歌手很少使用，警笛常用。

LFO modulation - volume (lfomodvol) <整数 0-100 (en)>

影响声音的音量大小，让其“跳动”。类似于震声*和颤声很类似。非常高的频率，类似于对着旋转的风扇叶说话。

Incremental Spinup Count (cspinup) <整数(en)>

似乎为了增加音高在指定时间内与ToggleSound的输入。 但是…Template:Bug:zh-cn

Flags/标签

•  [1] : Play everywhere
     无论接受者与音源多远，都以恒定的音量播放。Template:Todo:zh-cnTemplate:Bug:zh-cn

Start Silent : [16]

此声音将不会播放。默认启用。Template:Bug:zh-cn

Is NOT Looped : [32]

改变ambient_generic如何处理停止和开始播放。它不会使一个在循环的声音停止循环，但是设置正确的值依然十分重要。如果不是，难以控制停止或者启用声音？Template:Bug:zh-cn

Inputs/输入

Pitch <整数(en)>

设置声音音高，范围从1~255，100是原始音高。Template:Bug:zh-cn

PlaySound

开始播放声音。

StopSound

停止播放循环声音。不会停止非循环声音！ 这是故意的， 并且能够改变，修复文章：C++ 修复大法于您的 mod 。然而非循环声音可以通过 Volume 输入，设置值为0来实现。

ToggleSound

开关循环声音的按钮功能。表现类似于PlaySound输入。

Volume <浮点型(en)>

以0~10的音量设置一个声音大小。10为最大声。Template:Bug:zh-cnTemplate:Bug:zh-cn

FadeIn <整数(en)>

指定秒数内将声音调整为最大声。范围0~100/秒。Template:Bug:zh-cn

FadeOut <整数(en)>

指定秒数内将声音调整为最小声。范围0~100/秒。Template:Bug:zh-cn

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！

设置该实体的角度。

Outputs/输出

Base/基础:

OnUser1 to OnUser4

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

OnKilled  (仅存在于 之中)

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

参见

• 超越实体极限，将声音调整至10以上。（通用地图教程）
• env_soundscape- 用单个实体播放多个声音通过脚本
• Looping a Sound - which requires modifying the actual WAV file
• 用logic_auto在css设置此实体。 - 创建env_soundscape的替代方案。