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

Чтобы воспроизвести импортированную звуковую волну, используйте те же функции, что и для обычной. Например, используйте функцию 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();

  </TabItem>
</Tabs>

***

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

<Tabs groupId="languages">
  <TabItem value="blueprint" label="Blueprint">
    ![Нода остановки воспроизведения](/img/runtime-audio-importer/stopplayback.jpg)
  </TabItem>
  <TabItem value="c++" label="C++">

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

---

Чтобы отслеживать окончание воспроизведения аудио, привяжитесь к делегату 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();