Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

AudioEffectCapture

继承： AudioEffect < Resource < RefCounted < Object

从音频总线上实时捕捉音频。

描述

AudioEffectCapture 是一种 AudioEffect，可将所有音频帧从附加的音频效果总线复制到其内部的环形缓冲区中。

应用程序代码应使用 get_buffer() 从该环形缓冲区中消耗这些音频帧，并根据需要对其进行处理，例如从 AudioStreamMicrophone 捕获数据，实现应用程序定义的效果，或通过网络传输音频。从麦克风捕获音频数据时，样本格式将为立体声 32 位浮点 PCM。

与 AudioEffectRecord 不同，该效果仅返回原始音频样本，而不是将它们编码到 AudioStream 中。

教程

属性

float

buffer_length

0.1

方法

bool

can_get_buffer(frames: int) const

void

clear_buffer()

PackedVector2Array

get_buffer(frames: int)

int

get_buffer_length_frames() const

int

get_discarded_frames() const

int

get_frames_available() const

int

get_pushed_frames() const

属性说明

float buffer_length = 0.1 🔗

  • void set_buffer_length(value: float)

  • float get_buffer_length()

内部环形缓冲区的长度，单位为秒。如果已经初始化，设置缓冲区长度将没有效果。

方法说明

bool can_get_buffer(frames: int) const 🔗

如果内部环形缓冲区中至少有 frames 个音频帧可供读取，则返回 true。

void clear_buffer() 🔗

清空内部环形缓冲。

注意：捕获时调用这个方法可能造成样本的丢失，导致播放时产生噪音。

PackedVector2Array get_buffer(frames: int) 🔗

从内部环形缓冲区获取后续 frames 个音频样本。

如果足够的话，则返回一个恰好包含 frames 个音频样本的 PackedVector2Array；如果可用数据不足，则返回一个空的 PackedVector2Array。

样本是有符号浮点 PCM，在 -1 和 1 之间。如果想要作为 8 位或 16 位整型样本使用则需要进行缩放。（v = 0x7fff * samples[0].x）

int get_buffer_length_frames() const 🔗

返回内部环形缓冲区的总大小，以帧为单位。

int get_discarded_frames() const 🔗

返回由于缓冲区满而从音频总线上丢弃的音频帧的数量。

int get_frames_available() const 🔗

返回可使用 get_buffer() 读取的帧数。

int get_pushed_frames() const 🔗

返回从音频总线插入的音频帧的数量。