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

Ru/Env microphone: Difference between revisions

From Valve Developer Community
< Ru
Jump to navigation Jump to search
m (obsolete language category)
 
(20 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{otherlang2
{{lang|Env microphone|title=env_microphone}}{{toc-right}}
| en = Env_microphone
 
}}
{{this is a|point entity|name=env_microphone|engine=Source|sprite=1}}
{{totranslate:ru}}


{{base point|env_microphone}}
{{clr}}


==Описание Энтити==
== Описание сущности ==
[[File:env_microphone.png|left]]
Она играет роль микрофона.
It acts as a microphone.
Она выступает в одной из двух ролей:
It works in one of two modes:


; Speaker mode
; Режим Спикера
: If it has a "Speaker target" set, it picks up all sounds within the specified sound range and rebroadcasts them through that entity. It ignores the "Hears X" spawnflags and does not fire the SoundLevel output.
: Если она настроена в режиме спикера, Она собирает все звуки в определенном звуковом диапазоне и ретранслирует их через эту сущность. Она игнорирует флаги "Hears X" и не запускает аутпуты SoundLevel.
; Measuring mode
; Режим измерения
: If no speaker entity is set, it measures the sound level at "Measure target" and outputs the sound level as a value between 0 and 1. It only hears sounds that match the "Hears X" spawnflags.
: Если она НЕ настроена в режиме спикера, она замеряет уровень звука в "Measure target" и выводит его уровень как 0 или 1. Она слышит только звуки, имеющие флаги "Hears X".


== Параметры ==
== Параметры ==
{{KV|Measure target|targetname|If the speaker is in Measuring mode, this is the name of the entity where the sound level is to be measured. {{confirm|Optional?}}}}
{{KV:ru|Measure target|targetname|Если она в режиме измерения, здесь вводится имя сущности, уровень которой нужно измерить. {{Confirm|Необязательно?}}}}
{{KV|Speaker target|targetname|The name of an [[info_target]] at which to play any sounds heard by this microphone. If specified, the microphone will consider itself in Speaker mode. {{warning|Cannot be an [[env_speaker]]!}}}}
{{KV:ru|Speaker target|targetname|Наименование {{ent|info_target}}, через которую будут играться звуки, зарегистрированные в режиме микрофона. Возможно такое, что сущность может использовать себя в режиме спикера. {{Warning|Не должна быть {{ent|env_speaker}}!}}}}
{{KV|Listen Filter|filter|The name of an filter entity which specifies the only entities the microphone can hear. Sounds emitted by other entities will not be heard.}}
{{KV:ru|Listen Filter|filter|Наименование сущности-фильтра, определяющей, какие сущности должны быть услышаны микрофоном. Звуки, испускаемые другими сущностями не будут услышаны.}}
{{KV|Speaker DSP Preset|choices|Only useful in Speaker mode. If specified, sounds played back through speakers will be affected by the selected [[DSP]].
{{KV:ru|Speaker DSP Preset|choices|Используется только в режиме спикера. В частности, для звука, воспроизводимого через спикер, будет применён выбранный плагин {{L|DSP}}.
:* Use environment default
:* Use environment default (Использовать окружающую среду по умолчанию (без обработки)
:* ''(No effect)''
:* ''(No effect)''
:* ''(No effect)''
:* ''(No effect)''
Line 27: Line 25:
:* ''(No effect)''
:* ''(No effect)''
:* ''(No effect)''
:* ''(No effect)''
:* Loud speaker
:* Loud speaker (Громкий)
:* Very small speaker
:* Very small speaker (Очень маленький)
:* Echoing speaker
:* Echoing speaker (Эффект эха)
:* Small speaker
:* Small speaker (Маленький)
:* Tiny speaker
:* Tiny speaker (Крохотный)
}}
}}
{{KV|Sensitivity (0-10)|float|Sensitivity in measuring mode. 1 is normal, and anything between there and 10 is increasingly sensitive.}}
{{KV:ru|Sensitivity (0-10)|float|Чувствительность режима измерения. 1 - нормальная, и остальные значения до 10 увеличивают чувствительность.}}
{{KV|Smoothing (0-1)|float|How much to smooth the output value of measuring mode.}}
{{KV:ru|Smoothing (0-1)|float|Насколько плавно должно изменяться выходное значение после измерения.}}
{{KV|Maximum hearing range (0<nowiki>=</nowiki>infinite)|float|Sounds beyond this range won't be heard, irrelevant of [[attenuation]]. {{warning|setting this to 0 or >1024 when the microphone is in Speaker mode can be very bad for performance!}}}}
{{KV:ru|Maximum hearing range (0<nowiki>=</nowiki>infinite)|float|Звуки выше этого уровня не могут быть услышены, независимо от {{L|затухания}}. {{Warning|настройка этого значения ниже 0 или >1024 когда микрофон в режиме спикера плохо скажется на производительности!}}}}
{{KV EnableDisable}}
{{KV EnableDisable:ru}}
{{KV Parentname}}
{{KV Parentname:ru}}
{{KV Targetname}}
{{KV Targetname:ru}}


== Флаги ==
== Флаги ==
* Hears combat sounds
* Hears combat sounds (Слышать звуки боя)
* Hears world sounds
* Hears world sounds (Слышать звуки мира/окружения)
* Hears player sounds
* Hears player sounds (Слышать звуки игрока)
* Hears bullet impacts
* Hears bullet impacts (Слышать звуки выстрелов)
* Swallows sounds routed through speakers
* Swallows sounds routed through speakers (Поглощать звуки, направленные через спикеры)
* Hears explosions
* Hears explosions (Слышать взрывы)
* Ignores non-attenuated sounds
* Ignores non-attenuated sounds (Игнорировать не смягченные(резкие) звуки)


== Inputs ==
== Входы ==
{{IO|SetSpeakerName|param=targetname|Sets the [[info_target]] through which the microphone should emit what it hears.}}
{{IO:ru|SetSpeakerName|param=targetname|Устанавливает {{ent|info_target}}, через который микрофон должен воспроизводить то, что он слышит.}}
{{ScrollBox|
{{ScrollBox|
{{I EnableDisable}}
{{I EnableDisable:ru}}
{{I Parentname}}
{{I Parentname:ru}}
{{I Targetname}}
{{I Targetname:ru}}
}}
}}


== Outputs ==
== Выходы ==
{{IO|SoundLevel|param=float|Fired in Measuring mode whenever the sound level changes.}}
{{IO:ru|SoundLevel|param=float|Вызывается в режиме измерения при смене уровня звука.}}
{{IO|OnRoutedSound|Fired whenever a sound is routed out through the specified speaker (if any).}}
{{IO:ru|OnRoutedSound|Вызывается каждый раз, когда звук направляется через указанный спикер (или несколько).}}
{{IO|OnHeardSound|Fired whenever this microphone hears any sound it cares about.}}
{{IO:ru|OnHeardSound|Вызывается когда микрофон услышит любой звук, на который настроен.}}
{{O Targetname}}
{{O Targetname:ru}}


[[Category:Sound System]]
{{ACategory|Sound System}}

Latest revision as of 03:46, 22 August 2024

English (en)Русский (ru)中文 (zh)Translate (Translate)
Env microphone.png

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

Описание сущности

Она играет роль микрофона. Она выступает в одной из двух ролей:

Режим Спикера
Если она настроена в режиме спикера, Она собирает все звуки в определенном звуковом диапазоне и ретранслирует их через эту сущность. Она игнорирует флаги "Hears X" и не запускает аутпуты SoundLevel.
Режим измерения
Если она НЕ настроена в режиме спикера, она замеряет уровень звука в "Measure target" и выводит его уровень как 0 или 1. Она слышит только звуки, имеющие флаги "Hears X".

Параметры

Measure target ([todo internal name (i)]) <целевой объект(en)>
Если она в режиме измерения, здесь вводится имя сущности, уровень которой нужно измерить.
Подтвердить:Необязательно?
Speaker target ([todo internal name (i)]) <целевой объект(en)>
Наименование info_target, через которую будут играться звуки, зарегистрированные в режиме микрофона. Возможно такое, что сущность может использовать себя в режиме спикера.
Warning.pngПредупреждение:Не должна быть env_speaker!
Listen Filter ([todo internal name (i)]) <фильтр(en)>
Наименование сущности-фильтра, определяющей, какие сущности должны быть услышаны микрофоном. Звуки, испускаемые другими сущностями не будут услышаны.
Speaker DSP Preset ([todo internal name (i)]) <варианты выбора>
Используется только в режиме спикера. В частности, для звука, воспроизводимого через спикер, будет применён выбранный плагин DSP(en).
  • Use environment default (Использовать окружающую среду по умолчанию (без обработки)
  • (No effect)
  • (No effect)
  • (No effect)
  • (No effect)
  • (No effect)
  • Loud speaker (Громкий)
  • Very small speaker (Очень маленький)
  • Echoing speaker (Эффект эха)
  • Small speaker (Маленький)
  • Tiny speaker (Крохотный)
Sensitivity (0-10) ([todo internal name (i)]) <число с плавающей запятой(en)>
Чувствительность режима измерения. 1 - нормальная, и остальные значения до 10 увеличивают чувствительность.
Smoothing (0-1) ([todo internal name (i)]) <число с плавающей запятой(en)>
Насколько плавно должно изменяться выходное значение после измерения.
Maximum hearing range (0=infinite) ([todo internal name (i)]) <число с плавающей запятой(en)>
Звуки выше этого уровня не могут быть услышены, независимо от затухания(en).
Warning.pngПредупреждение:настройка этого значения ниже 0 или >1024 когда микрофон в режиме спикера плохо скажется на производительности!

EnableDisable:

Start Disabled (startdisabled) <булева переменная(en)>
Будет бездействовать до тех пор, пока его не активируют (вероятнее всего с вводом Enable).
Parentname:
Parent ([todo internal name (i)]) <целевой объект(en)>
Определяет родителя энтити. Энтити будет сохранять своё изначальное отделение от родителя.
Name(en) (targetname) <объект источник(en)>
Имя объекта, по которому другие объекты могут ссылаться на этот объект, через Входы/Выходы(en) или другие ключ-параметры(en) (например parentname или target).
Также отображаются на 2D-видах в Hammer и Отчёте об объектах (Entity Report)(en).
См. также:  Основные ключ-параметры, входы и выходы доступные для всех объектов

Флаги

  • Hears combat sounds (Слышать звуки боя)
  • Hears world sounds (Слышать звуки мира/окружения)
  • Hears player sounds (Слышать звуки игрока)
  • Hears bullet impacts (Слышать звуки выстрелов)
  • Swallows sounds routed through speakers (Поглощать звуки, направленные через спикеры)
  • Hears explosions (Слышать взрывы)
  • Ignores non-attenuated sounds (Игнорировать не смягченные(резкие) звуки)

Входы

SetSpeakerName <целевой объект(en)>
Устанавливает info_target, через который микрофон должен воспроизводить то, что он слышит.
EnableDisable:
Enable - разрешить
Disable - запретить
Включает/отключает работоспособность объекта. Также может пропасть из поля зрения.

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

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

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

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

Выходы

SoundLevel <число с плавающей запятой(en)>
Вызывается в режиме измерения при смене уровня звука.
OnRoutedSound
Вызывается каждый раз, когда звук направляется через указанный спикер (или несколько).
OnHeardSound
Вызывается когда микрофон услышит любой звук, на который настроен.
Targetname:
OnUser1 to OnUser4
Вызывается в ответ на входы FireUser; (см. Пользовательские вводы и выводы).
OnKilled  (Во всех играх начиная с Left 4 Dead)
Вызывается после уничтожения энтити и удаления её из игры.