Reproducir Audio

Reproducción Básica

Para reproducir una onda de sonido importada, usa las mismas funciones que usarías para una normal. Por ejemplo, usa la función PlaySound2D o Play desde un componente de audio como un Sound Cue.

Controlar la Reproducción

Rebobinar el Tiempo de Reproducción

Para rebobinar el tiempo de reproducción de la onda de sonido, usa la función 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);

nota

En versiones de UE hasta la 4.27, si deseas iniciar la reproducción desde un tiempo específico mayor que 0, es posible que necesites usar la función RewindPlaybackTime previamente. De lo contrario, el sonido podría no reproducirse correctamente debido a problemas internos del motor al manejar ondas procedurales. Este problema se ha resuelto en el motor desde la versión 5.0.

Obteniendo Información de Reproducción

Para obtener el tiempo de reproducción actual de la onda de sonido, usa las funciones GetPlaybackTime o GetPlaybackPercentage. También puedes obtener la duración de la onda de sonido usando la función 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();

Verificación del Estado de Reproducción

Está Reproduciendo Actualmente

Para determinar si la onda de sonido se está reproduciendo actualmente, puedes usar la función 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();

¿La Reproducción Ha Terminado?

Para verificar si la onda de sonido ha terminado de reproducirse, puedes usar la función 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();

Detener la Reproducción

Puedes detener la reproducción de la onda de sonido utilizando la función StopPlayback.

Blueprint

C++

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

info

Generalmente se recomienda detener la reproducción de la onda de sonido usando medios externos (por ejemplo, llamando a Stop en el componente de audio) y usar esta función si los medios externos no están disponibles. También, ten en cuenta que esta función no funciona para la reproducción desde MetaSounds.

Manejo de Eventos

Seguimiento de la Finalización de la Reproducción

Para rastrear el final de la reproducción de audio, enlaza al delegado 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);
    }
};

Gestión de Memoria

Liberando Memoria

Puedes borrar manualmente los datos de audio usando la función ReleaseMemory.

Blueprint

C++

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

aviso

No se recomienda la liberación manual de memoria a menos que tenga requisitos específicos de gestión de memoria o haya deshabilitado el recolector de basura.