ResourceImporterOggVorbis

继承： ResourceImporter < RefCounted < Object

Imports an Ogg Vorbis audio file for playback.

描述

Ogg Vorbis is a lossy audio format, with better audio quality compared to ResourceImporterMP3 at a given bitrate.

In most cases, it's recommended to use Ogg Vorbis over MP3. However, if you're using an MP3 sound source with no higher quality source available, then it's recommended to use the MP3 file directly to avoid double lossy compression.

Ogg Vorbis requires more CPU to decode than ResourceImporterWAV. If you need to play a lot of simultaneous sounds, it's recommended to use WAV for those sounds instead, especially if targeting low-end devices.

属性
intbar_beats
intbeat_count
floatbpm
boolloop
floatloop_offset

方法
AudioStreamOggVorbisload_from_buffer ( buffer: PackedByteArray ) static1
AudioStreamOggVorbisload_from_file ( path: String ) static1

属性说明

int bar_beats = 4

The number of bars within a single beat in the audio track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for bar_beats is provided in the Advanced Import Settings dialog, as it lets you preview your changes without having to reimport the audio.

int beat_count = 0

The beat count of the audio track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for beat_count is provided in the Advanced Import Settings dialog, as it lets you preview your changes without having to reimport the audio.

float bpm = 0

The Beats Per Minute of the audio track. This should match the BPM measure that was used to compose the track. This is only relevant for music that wishes to make use of interactive music functionality (not implemented yet), not sound effects.

A more convenient editor for bpm is provided in the Advanced Import Settings dialog, as it lets you preview your changes without having to reimport the audio.

bool loop = false

If enabled, the audio will begin playing at the beginning after playback ends by reaching the end of the audio.

Note: In AudioStreamPlayer, the AudioStreamPlayer.finished signal won't be emitted for looping audio when it reaches the end of the audio file, as the audio will keep playing indefinitely.

float loop_offset = 0

Determines where audio will start to loop after playback reaches the end of the audio. This can be used to only loop a part of the audio file, which is useful for some ambient sounds or music. The value is determined in seconds relative to the beginning of the audio. A value of 0.0 will loop the entire audio file.

Only has an effect if loop is true.

A more convenient editor for loop_offset is provided in the Advanced Import Settings dialog, as it lets you preview your changes without having to reimport the audio.

方法说明

AudioStreamOggVorbis load_from_buffer ( buffer: PackedByteArray ) static1

This method loads audio data from a PackedByteArray buffer into an AudioStreamOggVorbis object.

AudioStreamOggVorbis load_from_file ( path: String ) static1

This method loads audio data from a file into an AudioStreamOggVorbis object. The file path is provided as a string.

2

本方法通常需要用户覆盖才能生效。

3

本方法无副作用，不会修改该实例的任何成员变量。

4

本方法除了能接受在此处描述的参数外，还能够继续接受任意数量的参数。

5

本方法用于构造某个类型。

1

调用本方法无需实例，可直接使用类名进行调用。

6

本方法描述的是使用本类型作为左操作数的有效运算符。

7

这个值是由下列位标志构成位掩码的整数。

8

无返回值。