99416a21fb
The `AudioEffectRecord` effect has no microphone capture-specific functionality--it can be used with any audio bus.
This patch attempts to clarify this fact (so people like me who want to capture audio output know they're in the right place) while still providing a pointer use of the effect with `AudioStreamMicrophone` for microphone capture.
(cherry picked from commit 022f49437b)
44 lines
1.8 KiB
XML
44 lines
1.8 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="AudioEffectRecord" inherits="AudioEffect" version="3.5">
|
|
<brief_description>
|
|
Audio effect used for recording the sound from an audio bus.
|
|
</brief_description>
|
|
<description>
|
|
Allows the user to record the sound from an audio bus. This can include all audio output by Godot when used on the "Master" audio bus.
|
|
Can be used (with an [AudioStreamMicrophone]) to record from a microphone.
|
|
It sets and gets the format in which the audio file will be recorded (8-bit, 16-bit, or compressed). It checks whether or not the recording is active, and if it is, records the sound. It then returns the recorded sample.
|
|
</description>
|
|
<tutorials>
|
|
<link title="Recording with microphone">$DOCS_URL/tutorials/audio/recording_with_microphone.html</link>
|
|
<link title="Audio Mic Record Demo">https://godotengine.org/asset-library/asset/527</link>
|
|
</tutorials>
|
|
<methods>
|
|
<method name="get_recording" qualifiers="const">
|
|
<return type="AudioStreamSample" />
|
|
<description>
|
|
Returns the recorded sample.
|
|
</description>
|
|
</method>
|
|
<method name="is_recording_active" qualifiers="const">
|
|
<return type="bool" />
|
|
<description>
|
|
Returns whether the recording is active or not.
|
|
</description>
|
|
</method>
|
|
<method name="set_recording_active">
|
|
<return type="void" />
|
|
<argument index="0" name="record" type="bool" />
|
|
<description>
|
|
If [code]true[/code], the sound will be recorded. Note that restarting the recording will remove the previously recorded sample.
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="format" type="int" setter="set_format" getter="get_format" enum="AudioStreamSample.Format" default="1">
|
|
Specifies the format in which the sample will be recorded. See [enum AudioStreamSample.Format] for available formats.
|
|
</member>
|
|
</members>
|
|
<constants>
|
|
</constants>
|
|
</class>
|