播放音频

基本播放

要播放导入的音频波形，请使用与常规音频波形相同的函数。例如，使用 PlaySound2D 函数或从音频组件（如 Sound Cue）调用 Play 函数。

控制播放

回退播放时间

要回退音频波形的播放时间，请使用 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();

注意

除非您有特定的内存管理需求或已禁用垃圾收集器，否则不建议手动释放内存。