कैप्चर करने योग्य ध्वनि तरंग

अवलोकन

एक कैप्चर करने योग्य ध्वनि तरंग स्ट्रीमिंग ध्वनि तरंग से प्राप्त की जाती है। यह माइक्रोफोन जैसे इनपुट डिवाइस से ऑडियो डेटा कैप्चर करने और उसे प्ले बैक करने का समर्थन करती है, जिसमें आयातित ध्वनि तरंग के समान क्षमताएं शामिल हैं (रिवाइंडिंग, SoundCues में उपयोग, आदि)। आप बिना किसी सीमा के एक साथ ऑडियो कैप्चर और प्ले भी कर सकते हैं।

tip

वॉइस एक्टिविटी डिटेक्शन (VAD) के लिए, इस पेज को देखें।

note

कैप्चर करने योग्य ध्वनि तरंग iOS और Android पर कैप्चर शुरू होते ही स्वचालित रूप से माइक्रोफोन अनुमतियाँ मांगती है।

बेसिक उपयोग

कैप्चर करने योग्य ध्वनि तरंग बनाना

सबसे पहले आपको एक कैप्चर करने योग्य ध्वनि तरंग बनानी चाहिए।

Blueprint

C++

UCapturableSoundWave* CapturableSoundWave = UCapturableSoundWave::CreateCapturableSoundWave();

warning

आपको कैप्चर करने योग्य साउंड वेव को एक स्ट्रॉंग रेफरेंस के रूप में ट्रीट करना चाहिए ताकि समय से पहले डिस्ट्रक्शन को रोका जा सके (उदाहरण के लिए, ब्लूप्रिंट्स में इसे एक अलग वेरिएबल असाइन करके या 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();

info

डिवाइसआईडी पिछले चरण से प्राप्त उपलब्ध डिवाइसों की सरणी में डिवाइस का सूचकांक है।

कैप्चर स्थिति की जाँच करना

आप जांच सकते हैं कि क्या ध्वनि तरंग वर्तमान में ऑडियो कैप्चर कर रही है:

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 फंक्शन का उपयोग करता है।

note

उदाहरण को सफलतापूर्वक चलाने के लिए, सुनिश्चित करें कि आपने RuntimeAudioImporter मॉड्यूल को या तो PublicDependencyModuleNames या PrivateDependencyModuleNames में .Build.cs फाइल में, साथ ही अपने प्रोजेक्ट की .uproject फाइल में जोड़ा है।

Header file (.h)

#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;
};

Source file (.cpp)

#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);
}