AudioStreamGenerator¶

继承： AudioStream < Resource < RefCounted < Object

带有程序声音生成实用程序的音频流。

描述¶

AudioStreamGenerator是一种音频流，它不会自行播放声音，而是需要一个脚本为其生成音频数据。另请参阅AudioStreamGeneratorPlayback。

以下是使用它生成正弦波的示例：

var playback # 将执行 AudioStreamGeneratorPlayback。
@onready var sample_hz = $AudioStreamPlayer.stream.mix_rate
var pulse_hz = 440.0 # 声波的频率。
var phase = 0.0

func _ready():
    $AudioStreamPlayer.play()
    playback = $AudioStreamPlayer.get_stream_playback()
    fill_buffer()

func fill_buffer():
    var increment = pulse_hz / sample_hz
    var frames_available = playback.get_frames_available()

    for i in range(frames_available):
        playback.push_frame(Vector2.ONE * sin(phase * TAU))
        phase = fmod(phase + increment, 1.0)

[Export] public AudioStreamPlayer Player { get; set; }

private AudioStreamGeneratorPlayback _playback; // 将执行 AudioStreamGeneratorPlayback.
private float _sampleHz;
private float _pulseHz = 440.0f; // 声波的频率。
private double phase = 0.0;

public override void _Ready()
{
    if (Player.Stream is AudioStreamGenerator generator) // Type as a generator to access MixRate.
    {
        _sampleHz = generator.MixRate;
        Player.Play();
        _playback = (AudioStreamGeneratorPlayback)Player.GetStreamPlayback();
        FillBuffer();
    }
}

public void FillBuffer()
{
    float increment = _pulseHz / _sampleHz;
    int framesAvailable = _playback.GetFramesAvailable();

    for (int i = 0; i < framesAvailable; i++)
    {
        _playback.PushFrame(Vector2.One * (float)Mathf.Sin(phase * Mathf.Tau));
        phase = Mathf.PosMod(phase + increment, 1.0);
    }
}

在上述示例中，“AudioStreamPlayer”节点必须使用AudioStreamGenerator作为其流。fill_buffer函数提供音频数据来近似正弦波。另请参阅AudioEffectSpectrumAnalyzer进行实时音频频谱分析。注意：由于性能限制，该类最好从C#或通过S3Extension从编译语言使用。如果您仍然想从S3Script使用此类，请考虑使用较低的mix_rate，例如11,025 Hz或22,050 Hz。