Streaming Sound Wave

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

tip

वॉयस एक्टिविटी डिटेक्शन (VAD) के लिए, इस पृष्ठ का संदर्भ लें।

एक स्ट्रीमिंग साउंड वेव बनाना

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

त्वरित या विकृत ऑडियो प्लेबैक से बचना

जब साउंड वेव चल रहा हो तब ऑडियो डेटा स्ट्रीम करते समय, आप विशिष्ट परिदृश्यों में त्वरित या विकृत ऑडियो प्लेबैक का अनुभव कर सकते हैं। यह समस्या आमतौर पर तब होती है जब:

1. साउंड वेव प्लेबैक वर्तमान बफर के अंत के निकट/पर है
2. नया ऑडियो डेटा लगातार स्ट्रीमिंग साउंड वेव में कतारबद्ध किया जा रहा है
3. प्लेबैक आने वाले डेटा स्ट्रीम के साथ पकड़ बना लेता है

आप बिना किसी समस्या के किसी भी समय ऑडियो डेटा भरना बंद कर सकते हैं। हालाँकि, उन परिदृश्यों के लिए जहाँ आपको निरंतर स्ट्रीमिंग की आवश्यकता होती है (जैसे रीयल-टाइम ऑडियो स्ट्रीमिंग), आपके ऑडियो डेटा स्ट्रीमिंग की विश्वसनीयता के आधार पर दो दृष्टिकोण हैं:

विश्वसनीय, सुसंगत स्ट्रीमिंग के लिए: पहला चंक प्राप्त होने के तुरंत बाद प्लेबैक शुरू करने के लिए OnPopulateAudioState डेलिगेट का उपयोग करें।

अविश्वसनीय स्ट्रीमिंग (नेटवर्क समस्याएं, रुक-रुक कर डेटा) के लिए: प्लेबैक शुरू करने से पहले एक बड़ा बफर बनाने के लिए OnPopulateAudioState ट्रिगर होने के बाद भी एक अतिरिक्त देरी जोड़ें।

Blueprint

C++

// Approach 1: For reliable streaming - start immediately after first chunk
bool bHasStartedPlayback = false;

StreamingSoundWave->OnPopulateAudioStateNative.AddWeakLambda(this, [this, &bHasStartedPlayback]()
{
    if (!bHasStartedPlayback)
    {
        UGameplayStatics::PlaySound2D(GetWorld(), StreamingSoundWave);
        bHasStartedPlayback = true;
    }
});

// Approach 2: For unreliable streaming - add delay after first chunk
bool bHasStartedPlayback = false;

StreamingSoundWave->OnPopulateAudioStateNative.AddWeakLambda(this, [this, &bHasStartedPlayback]()
{
    if (!bHasStartedPlayback)
    {
        // Add delay to build up buffer for unreliable streaming
        GetWorld()->GetTimerManager().SetTimer(PlaybackDelayTimer, [this]()
        {
            UGameplayStatics::PlaySound2D(GetWorld(), StreamingSoundWave);
        }, 0.5f, false); // Half-second delay
        
        bHasStartedPlayback = true;
    }
});

नोट: आप किसी भी समय ऑडियो डेटा को पॉप्युलेट करना बंद कर सकते हैं, इससे प्लेबैक में कोई समस्या नहीं आएगी। सटीक दृष्टिकोण आपके ऑडियो डेटा स्ट्रीमिंग की विश्वसनीयता पर निर्भर करता है - सुसंगत स्ट्रीम के लिए तत्काल प्लेबैक का उपयोग करें, या अविश्वसनीय स्ट्रीम (जैसे, नेटवर्क कनेक्टिविटी समस्याएं) के लिए अतिरिक्त बफरिंग विलंब जोड़ें।

उदाहरण उपयोग

अंत में, आपका कार्यान्वयन कुछ इस तरह दिख सकता है:

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

On Populate Audio State

OnPopulateAudioState डेलीगेट OnPopulateAudioData के समान ही कार्य करता है लेकिन पॉप्युलेटेड ऑडियो डेटा को प्रसारित नहीं करता है। यह तब उपयोगी हो सकता है जब आप पॉप्युलेटेड ऑडियो डेटा की एक सरणी पास किए बिना यह ट्रैक करना चाहते हैं कि ऑडियो डेटा कब पॉप्युलेट हुआ है, जिससे प्रदर्शन में सुधार हो सकता है।

Blueprint

C++

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

StreamingSoundWave->OnPopulateAudioStateNative.AddWeakLambda(this, [this]()
{
    // Handle the result
});

PCM डेटा के साथ कार्य करना

प्लेबैक के दौरान PCM डेटा तक रीयल-टाइम पहुंच के लिए, PCM डेटा हैंडलिंग देखें।