ResourceImporterOggVorbis

继承： ResourceImporter < RefCounted < Object

导入 Ogg Vorbis 音频文件进行播放。

描述

Ogg Vorbis 是一种有损音频格式，在给定比特率下，与 ResourceImporterMP3 相比具有更好的音频质量。

在大多数情况下，建议使用 Ogg Vorbis 而不是 MP3。但是，如果你使用的 MP3 音源没有更高质量的可用音源，则建议直接使用 MP3 文件以避免两次有损压缩。

Ogg Vorbis 比 ResourceImporterWAV 需要更多的 CPU 来解码。如果你需要同时播放很多声音，建议对这些声音使用 WAV，特别是针对低端设备。

教程

• 导入音频样本

属性

方法

属性说明

int bar_beats = 4 🔗

音轨中单个节拍内的小节数。这仅与希望利用交互式音乐功能（尚未实现）的音乐相关，与声音效果无关。

高级导入设置对话框中为 bar_beats 提供了更方便的编辑器，因为它可以让你预览更改，且无需重新导入音频。

int beat_count = 0 🔗

该音轨的节拍数。这仅与希望利用交互式音乐功能（尚未实现）的音乐相关，与声音效果无关。

高级导入设置对话框中为 beat_count 提供了更方便的编辑器，因为它可以让你预览更改，且无需重新导入音频。

float bpm = 0 🔗

音轨的每分钟节拍数。这应该与用于创作曲目的 BPM 测量相匹配。这仅与希望利用交互式音乐功能（尚未实现）的音乐相关，与声音效果无关。

高级导入设置对话框中为 bpm 提供了更方便的编辑器，因为它可以让你预览更改，且无需重新导入音频。

bool loop = false 🔗

如果启用，音频将在播放因到达音频末尾而结束后从头开始播放。

注意：在 AudioStreamPlayer 中，当循环音频到达音频文件末尾时，不会发出 AudioStreamPlayer.finished 信号，因为音频将无限期地继续播放。

float loop_offset = 0 🔗

确定播放到达音频结尾后音频将开始循环的位置。这可用于仅循环音频文件的一部分，这对于某些环境音或音乐很有用。该值以相对于音频开头的秒数确定。值为 0.0 将循环整个音频文件。

仅当 loop 为 true 时才有效。

高级导入设置对话框中为 loop_offset 提供了更方便的编辑器，因为它可以让你预览更改，且无需重新导入音频。

方法说明

AudioStreamOggVorbis load_from_buffer(buffer: PackedByteArray) static 🔗

该方法将音频数据从 PackedByteArray 缓冲区加载到 AudioStreamOggVorbis 对象中。

AudioStreamOggVorbis load_from_file(path: String) static 🔗

该方法将音频数据从文件加载到 AudioStreamOggVorbis 对象中。文件路径以字符串形式提供。