Ru/Ambient generic

GoldSrc

Source Engine

ambient_generic - это точечная энтити(en), доступно для всех игр на движке Source.

This translated page needs to be updated.
You can help by updating the translation.
Also, please make sure the article complies with the alternate languages guide.(en)

Классовая структура
CAmbientGeneric ↳CPointEntity ↳CBaseEntity
sound.cpp

Воспроизводит звук однократно или циклично, из определённой точки или на всём пространстве карты.

ambient_generic
Тип	Точечный объект мира
Платформа
Доступность	Во всех играх

Используйте его для воспроизведения звука или контроля

• звучания звуковых скриптов(en),
• файла с расширением .wav
• или scripted_sentence(en).

В отличие от текстур и моделей, вы должны перезапустить редактор Hammer(en) для того, чтобы браузер звуков мог показать добавленные файлы.

Важно:The majority of sound properties that can be set with this entity are intended to only apply to raw sounds. Since soundscripts are defined in text files where their desired sound properties are specified, soundscripts ignore this entity's settings by design. Note that this also means that soundscripts have the advantage of being able to change sound files and properties in a map without having to recompile it. The same applies to soundscapes.

Ошибки и предупреждения

Важно:Parenting is not supported (entity can be parented but the position of the sound it emits isn't updated). Proper way to have a sound follow an entity is achieved by using SourceEntityName Template:V with targetname of an entity that is networked to client for example info_target with flag Transmit to client ticked.

Баг:ambient_generics используется для воспроизведения циклических звуков в Counter-Strike Source(en), для этого они должны быть активированы logic_auto(en) в противном случае, они перестанут воспроизводится после начала раунда.  [нужно проверить в ?]

Баг:Killing this entity while a looped sound is playing will make it play forever for the entire map duration. This also may cause looping sounds to stack up and eventually overflow the sound limit (detailed below), even if they aren't audible.

Баг:Можно избежать проблемы с беспрерывным воспроизведением звуков. Устраняется с помощью добавления вот этого кода C++(en).  [нужно проверить в ?]

Баг:Looping sounds might become attached to certain players when they are not supposed to. E.g., if you are away from a sound, and a player near the sound dies and then spectates you, the sound may become attached to you. The exact consistency/behavior of this bug is still unknown.  [нужно проверить в ?]

Баг:Too many ambient_generics playing at once will cause the sound engine to become corrupted globally and potentially cause extreme lag! This occurs if the internal entity sound limit of 64 (32 in ) is hit. Due to another bug, ambient_generics still "play" when outside the maximum distance, even if not audible to the client. Use snd_show 1 to visualize sounds considered "active". Too many yellow-colored sound names is a bad sign.  [нужно проверить в ?]

Обходной приём:Use env_soundscapes (which count towards a different static limit of 64) where possible and forcefully disable any sounds that aren't necessary to play yet. The amount of sounds currently playing can be visualized with the snd_show command.

Баг:Looping sounds using LFO cannot be stopped via the StopSound input.  [нужно проверить в ?]

Примечание:The behavior of sound is different for mono and stereo. Stereo sounds only fade in and out (they are already using surrounding information built into them). Mono sounds are processed by the audio engine to sound like they are coming from a specific position. These behaviors can be overridden by using Sound Characters.

Примечание:In Half-Life 2, since November 26, 2024 update (post-20th anniversary), ambient_generic (used for music) will continue to play on the next map. This can be enabled/disabled through save_transition_music console variable.

Ключ-параметры

Name(en) (targetname) <объект источник(en)>

Имя объекта, по которому другие объекты могут ссылаться на этот объект, через Входы/Выходы(en) или другие ключ-параметры(en) (например parentname или target).
Также отображаются на 2D-видах в Hammer и Отчёте об объектах (Entity Report)(en).

См. также:  Основные ключ-параметры, входы и выходы доступные для всех объектов

Sound Name (message) <sound(en)>

Воспроизводит звук. Может быть представлен как:"

• название звукового скрипта(en).
• исходный файл, который нужно воспроизвести. Путь к файлу указывается относительно <moddir>/sounds/. Direct paths to a sound file can be prefixed with sound characters.
• для scripted_sentence(en), введите !, а после него название предложения. (Пример: !COMBINE_THROW_GRENADE4)

Max Audible Distance (radius) <число с плавающей запятой(en)>

Максимальная дистанция в единицах(en), при которой для клиента воспроизводится звук.

Примечание:Звук затихает по мере того, как игрок отдаляется, поэтому иногда может показаться что звук перестал воспроизводится слишком резко.

SourceEntityName (SourceEntityName) <целевой объект(en)>

Если название указано, звук будет воспроизводится непосредственно из этого объекта, вместо ambient_generic. Если указанное имя - имя NPC, с поддержкой "lipsynch" (синхронизации губ), и информация о фонетике находится вместе с файлом звука, цель будет "говорить в такт" звуку.

Баг:После разрушения объекта, звук будет воспроизведен на карте по координатам (0,0,0).  [нужно проверить в ?]

Volume (health) <целое число(en) 0–10>

Громкость. 0 - тихо, 10 - нормально. Стандартно - 10.

Start Volume (volstart) <целое число(en) 0–10>

Fade in time in seconds (fadeinsecs) <целое число(en) 0–100>

Fade out time in seconds (fadeoutsecs) <целое число(en) 0–100>

Количество времени которое должно пройти перед/после затихания, и при какой громкости начинать. Стандартно, затихания нет.

Pitch (pitch) <целое число(en) 0–255>

Тональность звучания. 1 - низкая, 100 - нормальная, 255 - высокая.

Start pitch (pitchstart) <целое число(en) 0–255>

Spin up time (spinup) <целое число(en) 0–100>

Spin down time (spindown) <целое число(en) 0–100>

Скорость изменения тональности вниз/вверх в начале/конце воспроизведения, и с какой тональности начинать. По умолчанию отключена - 0.

Dynamic Presets (preset) <варианты выбора>

Разнообразные эффекты DSP(en), которые могут быть активированы.

LFO type (lfotype) <целое число(en)>

Тип вибраций Генератора низких частот(en), который нужно задействовать.

0. Off (Отключено) Значение по умолчанию.

1. Square Wave (Меандр) Частота меняется между низкой и высокой.

2. Triangle Wave (Пилообразные импульсы) Резкие переходы.

3. Random (Случайно)

LFO rate (lforate) <целое число(en) 0–1000>

Частота с которой эффект вибрации повторяется (в секунду?).

LFO modulation - pitch (lfomodpitch) <целое число(en) 0–100>

Влияет на тональность звука или вибрато. Большие значения увеличивают тональность. (Например: У певцов в голосе преобладают низкие частоты, а в звучании сирены - высокие)

LFO modulation - volume (lfomodvol) <целое число(en) 0–100>

Влияет на громкость звука, создавая эффект его "пульсации". Соответственно к тремоло.

Incremental Spinup Count (cspinup) <целое число(en)>

Шаг изменения тональности, с помощью входа ToggleSound, но:

Баг:Не работает  [нужно проверить в ?]

m_bDontModifyPitchVolOnSpawn (m_bDontModifyPitchVolOnSpawn) <булева переменная(en)> (только в )

When the 'Start Silent' flag is left unchecked, a SOUNDSCRIPTED ambient_generic will first pull its pitch & volume values from inside the entity itself upon map load/spawn, and NOT from what's dictated in the actual soundscript. This option, when enabled, will prevent this from happening and ensure no discontinuity occurs when toggling the sound off and on again. (Set to Disabled by default)

Признаки (Flags)

Звучать везде : [1]

Звук воспроизводится из всех колонок с выставленной громкостью. Не преодолевает эффекты DSP, тем не менее:

Баг:Этот флаг поломан на уровне движка' для звуковых скриптов(en). Будет работать, только если звуковой файл ни разу не был переименован.  [нужно проверить в ?]

Вначале тишина : [16]

Карта запустится без воспроизведения этого звука. Стандартно, режим включён.

Баг:Зацикливание звуков которые не начинаются в этом режиме - не могут быть контролированы!  [нужно проверить в ?]

Не повторять : [32]

Меняет то, как ambient_generic будет останавливать и начинать воспроизведение. Не остановит звук который зациклен с помощью соответствующего значения, тем не менее, очень важно выставить правильные значения.

Баг:При установке этого признака для зацикленного звука, не будет возможности его контролировать!  [нужно проверить в ?]

Не останавливать при остановке игры : [64] (только в )

Не останавливает воспроизведение при остановке игры.

Входы

Pitch <целое число(en)>

100 - начальная тональность

Баг:Pitch будет проигрывать звук не "информируя" объект. Это приводит к тому, что зацикленные звуки будут воспроизводится бесконечно!  [нужно проверить в ?]

Примечание:Doesn't change the pitch keyvalue. Any PlaySound inputs used after this will play the sound with value set in pitch keyvalue which can be changed via AddOutput.

Баг:If used to start playing a looping sound then in order to stop it the PlaySound must be sent before StopSound otherwise StopSound will have no effect.  (подтверждено в: Half-Life 2)

PlaySound

Начинает воспроизведение.

StopSound

Прекращает воспроизведение зацикленного звука. Не остановит не-зацикленные звуки: это сделано намерено, и может быть изменено с помощью кода C++(en).

ToggleSound

Переключает зацикленный звук между воспроизведением и остановкой. Ведёт себя как PlaySound если звук не-зациклен.

Volume <число с плавающей запятой(en)>

Баг:Volume будет проигрывать звук не "информируя" объекта. Зацикленный звук будет воспроизводится бесконечно!  [нужно проверить в ?]

Баг:Выставляя значение громкости на 0, поставит звук на паузу, а не будет проигрывать его беззвучно  [нужно проверить в ?]

FadeIn <целое число(en)>

Fades the sound up to full volume over a specified number of seconds, with a range from 0 to 100 seconds.

Примечание:In Portal 2 it is necessary for the sound to get faded out at least once before this input has any effect.

FadeOut <целое число(en)>

Затихание звука от/до полной тишины на протяжении определенного времени (в секундах).

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

• Adjust ambient_generic volume higher than 10 (Advanced Mapping Tutorial)
• env_soundscape(en) - used to play many ambient/background sounds from a single entity via a script(en)
• Looping a Sound(en) - which requires modifying the actual WAV file
• Setting up ambient_generics in Counter-Strike: Source using logic_auto - a substitute for creating a proper env_soundscape.