Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

AudioStreamOggVorbis

Hereda: AudioStream < Resource < RefCounted < Object

Una clase que representa una secuencia de audio Ogg Vorbis.

Descripción

The AudioStreamOggVorbis class is a specialized AudioStream for handling Ogg Vorbis file formats. It offers functionality for loading and playing back Ogg Vorbis files, as well as managing looping and other playback properties. More info can be found in ResourceImporterOggVorbis.

This class is part of the audio stream system, which also supports WAV files through the AudioStreamWAV class, and MP3 files through the AudioStreamMP3 class.

Tutoriales

Propiedades

int

bar_beats

4

int

beat_count

0

float

bpm

0.0

bool

loop

false

float

loop_offset

0.0

OggPacketSequence

packet_sequence

Dictionary

tags

{}

Métodos

AudioStreamOggVorbis

load_from_buffer(stream_data: PackedByteArray) static

AudioStreamOggVorbis

load_from_file(path: String) static


Descripciones de Propiedades

int bar_beats = 4 🔗

  • void set_bar_beats(value: int)

  • int get_bar_beats()

The number of beats within a single bar in the audio track.


int beat_count = 0 🔗

  • void set_beat_count(value: int)

  • int get_beat_count()

The length of the audio track, in beats. The actual duration of the audio file might be longer than what is indicated by this property. It defines the end of the audio for looping, AudioStreamPlaylist, and AudioStreamInteractive.


float bpm = 0.0 🔗

The tempo of the audio track, measured in beats per minute.


bool loop = false 🔗

  • void set_loop(value: bool)

  • bool has_loop()

If true, the stream will play again from the specified loop_offset once it reaches the end of the audio track, or once it reaches the end of the last beat according to the amount specified in beat_count. Useful for ambient sounds and background music.


float loop_offset = 0.0 🔗

  • void set_loop_offset(value: float)

  • float get_loop_offset()

Tiempo en segundos en el que el stream comienza después de ser enlazada.


OggPacketSequence packet_sequence 🔗

Contiene los datos Ogg sin procesar para esta transmisión.


Dictionary tags = {} 🔗

Contiene etiquetas definidas por el usuario si se encuentran en los datos de Ogg Vorbis.

Las etiquetas utilizadas habitualmente incluyen title, artist, album, tracknumber y date (date no tiene un formato de fecha estándar).

Nota: No se garantiza que todas las etiquetas estén presentes en cada archivo, así que asegúrate de tener en cuenta que las claves no siempre existen.


Descripciones de Métodos

AudioStreamOggVorbis load_from_buffer(stream_data: PackedByteArray) static 🔗

Crea una nueva instancia de AudioStreamOggVorbis a partir del búfer especificado. El búfer debe contener datos Ogg Vorbis.


AudioStreamOggVorbis load_from_file(path: String) static 🔗

Crea una nueva instancia de AudioStreamOggVorbis a partir de la ruta de archivo indicada. El archivo debe estar en formato Ogg Vorbis.