キャプチャ可能なサウンドウェーブ
概要
キャプチャ可能なサウンドウェーブはストリーミングサウンドウェーブから派生しています。マイクなどの入力デバイスからオーディオデータをキャプチャし、再生することが可能で、インポートされたサウンドウェーブと同等の機能（巻き戻し、SoundCueでの使用など）を備えています。さらに、オーディオのキャプチャと再生を同時に行うこ とも制限なく可能です。
音声活動検出（VAD）についてはこのページを参照してください。
キャプチャ可能なサウンドウェーブは、iOSとAndroidでキャプチャを開始すると自動的にマイクの権限を要求します。
基本的な使用方法
キャプチャ可能なサウンドウェーブの作成
まずキャプチャ可能なサウンドウェーブを作成する必要があります。
- Blueprint
- C++
UCapturableSoundWave* CapturableSoundWave = UCapturableSoundWave::CreateCapturableSoundWave();
キャプチャ可能なサウンドウェーブは、早期破壊を防ぐために強参照として扱う必要があります（例：ブループリントで別の変数に割り当てるか、C++でUPROPERTY()を使用する）。
利用可能な入力デバイスの取得
この機能を使用するには、まずキャプチャに使用可能なすべてのオーディオ入力デバイスを取得する必要があります。
- Blueprint
- C++
UCapturableSoundWave::GetAvailableAudioInputDevices(FOnGetAvailableAudioInputDevicesResultNative::CreateWeakLambda(this, [](const TArray<FRuntimeAudioInputDeviceInfo>& AvailableDevices)
{
// Handle the result
}));
キャプチャの開始と停止
利用可能なデバイスを取得した後、入力デバイスからオーディオデータのキャプチャを開始し、必要に応じて停止することができます。
- Blueprint
- C++
// Assuming CapturableSoundWave is a UE reference to a UCapturableSoundWave object (or its derived type)
// Start capturing audio data from the input device with the specified device ID (0 in this case)
CapturableSoundWave->StartCapture(0);
// Stop capturing audio data
CapturableSoundWave->StopCapture();
DeviceIdは、前の手順で取得した利用可能なデバイスの配列におけるインデックスです。
キャプチャ状態の確認
現在サウンドウェーブがオーディオをキャプチャ中かどうかを確認できます:
- Blueprint
- C++
// Assuming CapturableSoundWave is a reference to a UCapturableSoundWave object
bool bIsCapturing = CapturableSoundWave->IsCapturing();
高度な機能
キャプチャのミュート/ミュート解除
キャプチャプロセスを中断することなく、音声データの蓄積を防ぐためにサウンドキャプチャをミュートまたはミュート解除できます。
- Blueprint
- C++
// Assuming CapturableSoundWave is a UE reference to a UCapturableSoundWave object (or its derived type)
CapturableSoundWave->ToggleMute(true);
StartCaptureを通じて録音を開始すると、エンジン側で軽微なヒッチが発生する可能性があるため、キャプチャの切り替えを頻繁に行う場合に有用です。まずキャプチャ自体を開始し、その後でミュート/ミュート解除を行うべきです。
わずかなフリーズを排除したい場合、そのフリーズが無視できるタイミングでキャプチャを開始することを検討できます。例えば、ゲームのローディング画面中にキャプチャを開始し、その後すぐにキャプチャ可能なサウンドウェー ブをミュートし、必要な時にキャプチャ可能なサウンドウェーブのミュートを解除することで、ヒッチなしでオーディオデータをキャプチャできます。
完全な例
キャプチャ可能なサウンドウェーブを使用した完全な実装例を以下に示します:
- Blueprint
- C++
これは入力デバイス（マイク）からオーディオデータをキャプチャする基本的なコード例です。キャプチャ可能なサウンドウェーブを使用しています。
この例では、EXAMPLEMODULEモジュール内のUCaptureAudioClassExampleクラスにあるCaptureAudioExample関数を使用しています。
この例を正常に実行するには、** .Build.cs ファイルのPublicDependencyModuleNamesまたはPrivateDependencyModuleNamesにRuntimeAudioImporterモジュールを追加し、プロジェクトの.uproject**ファイルにも追加する必要があります。
#pragma once
#include "CoreMinimal.h"
#include "UObject/Object.h"
#include "CaptureAudioClassExample.generated.h"
UCLASS(BlueprintType)
class EXAMPLEMODULE_API UCaptureAudioClassExample : public UObject
{
GENERATED_BODY()
public:
UFUNCTION(BlueprintCallable)
void CaptureAudioExample();
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 UCapturableSoundWave* CapturableSoundWave;
};
#include "CaptureAudioClassExample.h"
#include "Sound/StreamingSoundWave.h"
void UCaptureAudioClassExample::CaptureAudioExample()
{
// Create a capturable sound wave
CapturableSoundWave = UCapturableSoundWave::CreateCapturableSoundWave();
// Capture audio data from the input device with the specified device ID (0 in this case)
CapturableSoundWave->StartCapture(0);
// Delay for 5 seconds, just for demonstration purposes
FTimerHandle TimerHandle;
GetWorld()->GetTimerManager().SetTimer(TimerHandle, [this]()
{
// Stop capturing audio data
CapturableSoundWave->StopCapture();
// Play the sound wave
UGameplayStatics::PlaySound2D(GetWorld(), CapturableSoundWave);
}, 5, false);
}