AudioStreamMP3

继承： AudioStream < Resource < RefCounted < Object

MP3 音频流驱动程序。

描述

MP3音频流驱动程序。如果要在运行时加载MP3文件，请参见data。

属性

int	bar_beats	4
int	beat_count	0
float	bpm	0.0
PackedByteArray	data	PackedByteArray()
bool	loop	false
float	loop_offset	0.0

方法

AudioStreamMP3	load_from_buffer(stream_data: PackedByteArray) static
AudioStreamMP3	load_from_file(path: String) static

---

属性说明

int bar_beats = 4 🔗

• void set_bar_beats(value: int)

• int get_bar_beats()

---

int beat_count = 0 🔗

• void set_beat_count(value: int)

• int get_beat_count()

---

float bpm = 0.0 🔗

• void set_bpm(value: float)

• float get_bpm()

---

PackedByteArray data = PackedByteArray() 🔗

• void set_data(value: PackedByteArray)

• PackedByteArray get_data()

包含以字节形式存储的音频数据。

您可以使用以下代码片段加载文件，而无需事先进行导入操作。请注意，此代码片段会将整个文件加载到内存中，对于超大文件（数百兆字节或更多）而言可能并不理想。

S3ScriptC#

func load_mp3(path):
    var file = FileAccess.open(path, FileAccess.READ)
    var sound = AudioStreamMP3.new()
    sound.data = file.get_buffer(file.get_length())
    return sound

注意: 返回的数组是被 复制 的，对它的任何修改都不会更新原始属性的值。有关更多详细信息，请参阅 PackedByteArray 。

---

bool loop = false 🔗

• void set_loop(value: bool)

• bool has_loop()

如果为 true，当流到达末尾时将自动循环。

---

float loop_offset = 0.0 🔗

• void set_loop_offset(value: float)

• float get_loop_offset()

循环时，流开始的时间，单位为秒。

---

方法说明

AudioStreamMP3 load_from_buffer(stream_data: PackedByteArray) static 🔗

从给定缓冲区新建 AudioStreamMP3 实例。缓冲区中必须包含 MP3 数据。

---

AudioStreamMP3 load_from_file(path: String) static 🔗

从给定的文件路径新建 AudioStreamMP3 实例。文件必须为 MP3 格式。