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

Успадковує: AudioStream < Resource < RefCounted < Object

Клас, що представляє аудіопотік Ogg Vorbis.

Опис

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.

Посібники

Властивості

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

{}

Методи

AudioStreamOggVorbis

load_from_buffer(stream_data: PackedByteArray) static

AudioStreamOggVorbis

load_from_file(path: String) static


Описи властивостей

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()

Час у секундах, коли потік починається після зациклення.


OggPacketSequence packet_sequence 🔗

  • void set_packet_sequence(value: OggPacketSequence)

  • OggPacketSequence get_packet_sequence()

Містить необроблені дані Ogg для цього потоку.


Dictionary tags = {} 🔗

Містить визначені користувачем теги, якщо вони знайдені в даних Ogg Vorbis.

Зазвичай використовуються такі теги: назва, виконавець, альбом, tracknumber, and date (date does not have a standard date format).

Примітка: Немає гарантованої присутності тегу в кожному файлі, тому обов’язково враховуйте, що ключі не завжди існують.


Описи методів

AudioStreamOggVorbis load_from_buffer(stream_data: PackedByteArray) static 🔗

Створює новий екземпляр AudioStreamOggVorbis із заданого буфера. Буфер має містити дані Ogg Vorbis.


AudioStreamOggVorbis load_from_file(path: String) static 🔗

Створює новий екземпляр AudioStreamOggVorbis із указаного шляху до файлу. Файл має бути у форматі Ogg Vorbis.