This article's documentation is for anything that uses the Source engine. Click here for more information.

env_microphone

From Valve Developer Community
Jump to: navigation, search
English (en)русский (ru)中文 (zh)
... Icon-Important.png
Env microphone.png
class hierarchy
CEnvMicrophone defined in envmicrophone.cpp
CPointEntity
CBaseEntity

env_microphone is a point entity available in all Source Source games. It acts as a microphone. In "Speaker mode", it picks up sound and rebroadcasts it at a Speaker target. It ignores the Hears X spawnflags and does not fire the SoundLevel output. In "Measuring mode", it measures the sound level at a Measure target and outputs the sound level as a value between 0 and 1. It only hears sounds that match the Hears X spawnflags.


Flags

  •  [1] : Hears combat sounds
  •  [2] : Hears world sounds
  •  [4] : Hears player sounds
  •  [8] : Hears bullet impacts
  •  [16] : Swallows sounds routed through speakers
Note.pngNote:In speaker mode, sounds heard by the microphone will not play from their source, instead only being heard through this microphone's speaker.
  •  [32] : Hears explosions
  •  [64] : Ignores non-attenuated sounds

Keyvalues


Targetname:
Name (targetname) <string>
The targetname that other entities refer to this entity by.
Speaker target (SpeakerName) <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. This should not be an env_speaker.
Icon-Bug.pngBug:If the speaker entity is moving, sounds will start playing at the correct position, but they will not follow the speaker as they continue playing.
Note.pngNote: If multiple info_target with the same name are referenced only one will output sounds.
Measure target (target) <targetname>
If the speaker is in Measuring mode, this is the name of the entity where the sound level is to be measured.
Listen Filter (ListenFilter) <filter>
The name of a filter entity which specifies the only entities the microphone can hear. Sounds emitted by other entities will not be heard.

{{KV|Speaker DSP Preset|intn=speaker_dsp_preset|choices|Only useful in Speaker mode. If specified, sounds played back through speakers will be affected by the selected DSP.

Icon-Bug.pngBug:Having multiple env_microphones with different DSP presets active at the same time will cause only one of the DSP presets to work, even if the microphones are nowhere near each other. This is because this entity just sets a ConVar called dsp_speaker.
  • 0: Use environment default
  • 50: (No effect)
  • 51: (No effect)
  • 52: (No effect)
  • 53: (No effect)
  • 54: (No effect)
  • 55: Loud speaker
  • 56: Very small speaker
  • 57: Echoing speaker
  • 58: Small speaker
  • 59: Tiny speaker
Note.pngNote:This keyvalue can also use the settings seen on the DSP page.
Sensitivity (0-10) (Sensitivity) <float>
Sensitivity in measuring mode. 1 is normal, and anything between there and 10 is increasingly sensitive.
Smoothing (0-1) (SmoothFactor) <float>
How much to smooth the output value of measuring mode.

{{KV|Maximum hearing range (0=infinite)|intn=MaxRange|float|Sounds beyond this range won't be heard.

Warning.pngWarning:setting this to 0, or greater 1024 when the microphone is in Speaker mode can be very bad for performance!

{{KV|Sound Mask|intn=SoundMask|int|nofgd=1|

Blank image.pngTodo: Some kind of alternative to the Hears X spawnflags?

EnableDisable:

Start Disabled (StartDisabled) <boolean>
Stay dormant until activated (with theEnableinput).

Inputs

SetSpeakerName <targetname>
Sets the info_target through which the microphone should emit what it hears.

EnableDisable:

Enable
Disable
Enable/disable this entity from performing its task. It might also disappear from view.

Outputs

SoundLevel <float>
Fired in Measuring mode whenever the sound level changes.
OnRoutedSound
Fired whenever a sound is routed out through the specified speaker (if any).
OnHeardSound
Fired whenever this microphone hears any sound it cares about.