ストリーミング音声波形

音声活動検出 (VAD) については、こちらのページを参照してください。

ストリーミング音声波形は、再生中でもオーディオデータを動的に追加できるインポートされた音声波形の一種です。通常のインポートされた音声波形と同じ機能を提供し、SoundCuesなどで使用できます。

ストリーミング音声波形の作成

まず、ストリーミング音声波形を作成する必要があります。この波形は、早期に破棄されないように強い参照として扱う必要があります（例: Blueprintで別の変数に割り当てる、または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);

オーディオ再生の加速を避ける

しばしば、オーディオデータをストリーミングして同時に再生する必要がある場合、バッファの過剰な速度での蓄積によるオーディオの加速を避けるために、再生前にわずかな遅延を追加する必要があります。通常、約0.5秒の遅延が推奨されます。

使用例

最後に、あなたの実装は次のように見えるかもしれません。

Blueprint

C++

これはストリーミングサウンドウェーブにオーディオデータを追加する基本的なコード例です。

この例では、EXAMPLEMODULEモジュール内のUAppendAudioClassExampleクラスにあるAppendAudioExample関数を使用します。

注意: この例を正常に実行するには、RuntimeAudioImporterモジュールを**.Build.csファイルの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);
}