流媒体声波

有关语音活动检测（VAD），请参阅此页面。

流媒体声波是一种支持动态添加音频数据的导入声波类型，即使在播放过程中也是如此。它提供与导入声波相同的功能，例如倒带，并且可以在SoundCues中使用等。

创建流媒体声波

首先你应该创建一个流媒体声波。请注意，你应将其视为一个强引用，以防止过早销毁（例如，通过将其分配给Blueprints中的一个独立变量或在C++中使用UPROPERTY()）。

Blueprint

C++

UStreamingSoundWave* StreamingSoundWave = UStreamingSoundWave::CreateStreamingSoundWave();

播放声波

您可以播放该声波。不过，现在不一定要这样做，您可以稍后开始播放该声波。

预分配音频数据

可选地，您可以预分配音频数据（字节），以避免每次附加新音频数据时重新分配整个PCM缓冲区。

Blueprint

C++

// Assuming StreamingSoundWave is a UE reference to a UStreamingSoundWave object (or its derived type, such as UCapturableSoundWave)
StreamingSoundWave->PreAllocateAudioData(12582912, FOnPreAllocateAudioDataResultNative::CreateWeakLambda(this, [StreamingSoundWave](bool bSucceeded)
{
	// Handle the result
}));

追加音频数据

要将音频数据添加到现有缓冲区的末尾，请使用适当的函数来动态添加音频数据。播放将按照这些追加的队列顺序进行。

Blueprint

C++

 // Assuming StreamingSoundWave is a UE reference to a UStreamingSoundWave object (or its derived type, such as UCapturableSoundWave)

// Example of appending encoded audio data
TArray<uint8> AudioData = ...; // Fill with audio data
StreamingSoundWave->AppendAudioDataFromEncoded(AudioData, ERuntimeAudioFormat::Auto);

// Or, if you have raw audio data
TArray<uint8> RawAudioData = ...; // Fill with raw audio data
StreamingSoundWave->AppendAudioDataFromRAW(RawAudioData, ERuntimeRAWAudioFormat::Float32, 44100, 2);

避免音频加速播放

通常，当您需要流式传输音频数据并同时播放时，应在播放之前添加一个轻微的延迟，以避免由于缓冲区填充过快导致的音频加速。通常推荐大约半秒的延迟。

示例用法

最后，您的实现可能如下所示：

Blueprint

C++

这是一个将音频数据追加到流媒体声音波的基本代码示例。

该示例使用了位于 EXAMPLEMODULE 模块中 UAppendAudioClassExample 类的 AppendAudioExample 函数。

注意：要成功运行该示例，请确保在 .Build.cs 文件中将 RuntimeAudioImporter 模块添加到 PublicDependencyModuleNames 或 PrivateDependencyModuleNames，以及在您的项目 .uproject 文件中。

Header file (.h)

#pragma once

#include "CoreMinimal.h"
#include "UObject/Object.h"
#include "AppendAudioClassExample.generated.h"

UCLASS(BlueprintType)
class EXAMPLEMODULE_API UAppendAudioClassExample : public UObject
{
	GENERATED_BODY()

public:
	UFUNCTION(BlueprintCallable)
	void AppendAudioExample();

private:
	// Please pay attention to making the StreamingSoundWave a hard reference, such as using UPROPERTY(), to prevent it from being prematurely garbage collected
	UPROPERTY()
	class UStreamingSoundWave* StreamingSoundWave;
};

Source file (.cpp)

#include "AppendAudioClassExample.h"
#include "Sound/StreamingSoundWave.h"

void UAppendAudioClassExample::AppendAudioExample()
{
    // Create a streaming sound wave
	StreamingSoundWave = UStreamingSoundWave::CreateStreamingSoundWave();

    // Append audio data
    TArray<uint8> StreamedAudioDataToAdd = ...; // Fill with audio data
    StreamingSoundWave->AppendAudioDataFromEncoded(StreamedAudioDataToAdd, ERuntimeAudioFormat::Auto);

    // Play the sound wave
    UGameplayStatics::PlaySound2D(GetWorld(), StreamingSoundWave);
}