Воспроизведение аудио

Базовое воспроизведение

Чтобы воспроизвести импортированный звуковой файл (Sound Wave), используйте те же функции, что и для обычного. Например, используйте функцию PlaySound2D или функцию Play из аудиокомпонента, такого как Sound Cue.

Управление воспроизведением

Перемотка времени воспроизведения

Чтобы перемотать время воспроизведения звукового файла, используйте функцию RewindPlaybackTime.

Blueprint

C++

// Assuming ImportedSoundWave is a UE reference to a UImportedSoundWave object
// Rewind playback time of the sound wave for 12.5 seconds
ImportedSoundWave->RewindPlaybackTime(12.5f);

примечание

В версиях UE до 4.27, если вы хотите начать воспроизведение с определенного времени, большего 0, вам может потребоваться предварительно использовать функцию RewindPlaybackTime. В противном случае звук может воспроизводиться некорректно из-за внутренних проблем движка с обработкой процедурных волн. Эта проблема была устранена в движке, начиная с версии 5.0.

Получение информации о воспроизведении

Чтобы получить текущее время воспроизведения звуковой волны, используйте функции GetPlaybackTime или GetPlaybackPercentage. Вы также можете получить длительность звуковой волны, используя функцию GetDuration.

Blueprint

C++

// Assuming ImportedSoundWave is a UE reference to a UImportedSoundWave object

// Get the current playback time of the sound wave
float PlaybackTime = ImportedSoundWave->GetPlaybackTime();

// Get the current playback percentage of the sound wave
float PlaybackPercentage = ImportedSoundWave->GetPlaybackPercentage();

// Get the duration of the sound wave
float Duration = ImportedSoundWave->GetDuration();

Проверка статуса воспроизведения

Воспроизведение в данный момент

Чтобы определить, воспроизводится ли звуковая волна в данный момент, вы можете использовать функцию IsPlaying.

Blueprint

C++

// Assuming ImportedSoundWave is a UE reference to a UImportedSoundWave object
// Check if the sound wave is currently playing
bool bIsPlaying = ImportedSoundWave->IsPlaying();

Завершено ли воспроизведение

Чтобы проверить, завершилось ли воспроизведение звуковой волны, вы можете использовать функцию IsPlaybackFinished.

Blueprint

C++

// Assuming ImportedSoundWave is a UE reference to a UImportedSoundWave object
// Check if the sound wave has finished playback
bool bIsFinished = ImportedSoundWave->IsPlaybackFinished();

Остановка воспроизведения

Вы можете остановить воспроизведение звуковой волны, используя функцию StopPlayback.

Blueprint

C++

// Assuming ImportedSoundWave is a UE reference to a UImportedSoundWave object
// Stop the playback of the sound wave
ImportedSoundWave->StopPlayback();

к сведению

Обычно рекомендуется останавливать воспроизведение звуковой волны с помощью внешних средств (например, вызвав Stop на аудиокомпоненте), и использовать эту функцию, если внешние средства недоступны. Также обратите внимание, что эта функция не работает для воспроизведения из MetaSounds.

Обработка событий

Отслеживание завершения воспроизведения

Чтобы отследить окончание воспроизведения аудио, привяжитесь к делегату OnAudioPlaybackFinished.

Blueprint

C++

UCLASS()
class AMyAudioPlayer : public AActor
{
    GENERATED_BODY()

public:
    UFUNCTION()
    void OnAudioFinished()
    {
        // Handle the end of audio playback
    }

    void BindAudioDelegate(UImportedSoundWave* ImportedSoundWave)
    {
        // Bind to the OnAudioPlaybackFinished delegate
        ImportedSoundWave->OnAudioPlaybackFinished.AddDynamic(this, &AMyAudioPlayer::OnAudioFinished);
    }
};

Управление памятью

Освобождение памяти

Вы можете вручную очистить аудиоданные с помощью функции ReleaseMemory.

Blueprint

C++

// Release memory of the sound wave
ImportedSoundWave->ReleaseMemory();

warning

Ручное освобождение памяти не рекомендуется, если у вас нет особых требований к управлению памятью или вы отключили сборщик мусора.