Reproducir Audio

Reproducción Básica

Para reproducir una onda de sonido importada, utiliza 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 las 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 primero. 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();

Comprobación del Estado de Reproducción

Está Reproduciéndose 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 lecture est-elle terminée

Pour vérifier si la forme d'onde sonore a fini de jouer, vous pouvez utiliser la fonction 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();

Arrêt de la lecture

Vous pouvez arrêter la lecture de l'onde sonore en utilisant la fonction StopPlayback.

Blueprint

C++

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

info

Se recomienda generalmente detener la reproducción de la onda sonora 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

Liberar Memoria

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

Blueprint

C++

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

aviso

La libération manuelle de la mémoire n'est pas recommandée, sauf si vous avez des exigences spécifiques de gestion de la mémoire ou si vous avez désactivé le ramasse-miettes.