Эта статья документации для всего, что использует платформу Source. Нажмите для получения дополнительной информации.

env_soundscape

From Valve Developer Community
< Ru
Jump to: navigation, search
English (en)Hrvatski (hr)Русский (ru)中文 (zh)Translate (Translate)
Env soundscape.png

env_soundscape - это точечная энтити(en), доступно для всех игр на движке Source Source. С помощью игроков она переключает активный саундскейп(en), и задает точки, откуда будут исходить позиционные звуки.

Игрок должен находиться в радиусе действия этой сущности и в прямой ее видимости. Саундскейп будет играть до тех пор, пока не будет задет следующий. Если за управление борются несколько саундскейпов, то побеждает ближайший.

env_soundscape_triggerable - это сущность, родственная с env_soundscape, но используется в сочетании с брашевой сущностью trigger_soundscape(en).

Tip.pngСовет:В некоторых модах, таких как TF2, саундскейпы не будут "видны" через воду, в этом поможет триггерный саундскейп.

Смотрите также

Ключевые значения

Radius ([todo internal name (i)]) <integer(en)>
Задает диаметр сферы саундскейпа. Также, чтобы включиться, он должен находиться в прямой видимости игроков. -1 означает бесконечную сферу.
Soundscape ([todo internal name (i)]) <string(en)>
Имя проигрываемого саундскейпа. Приведены некоторые примеры, но не весь список. Лучший способ прослушать саундскейп - использовать консольную команду playsoundscape.
Sound Position 0-7 ([todo internal name (i)]) <targetname(en)>
Задает точки на местности, где воспроизводятся позиционные звуки. Должны быть сущности, о которых клиент знает (например, info_target(en) или любые видимые).

Parentname:
Parent ([todo internal name (i)]) <targetname(en)>
Определяет родителя энтити. Энтити будет сохранять своё изначальное отделение от родителя.

EnableDisable:

Start Disabled (startdisabled) <boolean(en)>
Будет бездействовать до тех пор, пока его не активируют (вероятнее всего с вводом Enable).
См. также:  Generic Keyvalues, Inputs and Outputs available to all entities
Name(en) (targetname) <string(en)>
Название объекта по которому другие объекты могут ссылаться на этот объект.

Inputs

Enabled, Disabled
Включает/отключает саундскейп. Дублированные входы
ToggleEnabled
Переключает саундскейп вкл/выкл.

EnableDisable:
Enable - разрешить
Disable - запретить
Включает/отключает работоспособность объекта. Также может пропасть из поля зрения.

SetParent <целевая_энтити-родитель>

Меняет родителя энтити в её иерархии движения.
Присоединяет текущую энтити к специальной именованной точке её родителя, определяемой параметром <строка>
Note.pngПримечание:Сначала необходимо задать родителя в иерархии движения этой энтити перед отправкой этой команды.

SetParentAttachmentMaintainOffset <string> (во всех играх начиная с Half-Life 2: Episode One)

Заменить энтити, прикреплённую к указанной точки её родителя. Перед отправкой этого входа энтити должны быть дочерними в иерархии. Подаваемый параметр должен быть именем прикрепления. Энтити сохранит свою позицию относительно исходной точки и углов родителя при прикреплении.
Удаляет родителя из иерархии движения этой энтити.

Targetname:
Kill
Удаляет этот объект из мира.
KillHierarchy
Удаляет объект и его потомков из мира.
AddOutput  <string(en)>
Определяет ключ-параметр/выход этого объекта. Потенциально представляет большую опасность, используйте с осторожностью.
Формат: <ключ-параметр> <значение>
Формат: <имя выхода> <целевой объект>:<имя входа>:<параметр>:<пауза>:<макс. количество срабатываний, -1 - бесконечно>
FireUser1 до FireUser4
Срабатывание выходов OnUser; см. Пользовательские вводы и выводы.
Use  Отсутствует в FGD!
То же, что и при вызове +use игроком; может не всё. Можно вызвать, создав вывод, которому не указан ввод.
Этот ввод не указан в FGD-файле Valve.
RunScriptFile  <script(en)> (Во всех играх начиная с L4D2)
Выполнить файл игрового скрипта с диска.
RunScriptCode  <string(en)> (Во всех играх начиная с L4D2)
Выполнить строку исходного кода скрипта.
Warning.pngПредупреждение:Никогда не передавайте строковые параметры функции скрипта с помощью этого входа. Это повредит структуру VMF из-за вложения кавычек, которые потребуется удалять вручную в текстовом редакторе.

Outputs

OnPlay
Взводятся, когда этот саундскейп активируется.

Targetname:
OnUser1 до OnUser4
Вызывается в ответ на входы FireUser; (см. Пользовательские вводы и выводы).
OnKilled  (Во всех играх начиная с L4D)
Вызывается после уничтожения энтити и удаления её из игры.

Tutorials about env_soundscape (Russian)

Lessons created by Project-S