AudioStreamMP3

繼承： AudioStream < Resource < RefCounted < Object

MP3 音訊串流驅動程式。

說明

MP3 音訊串流驅動程式。如果想在執行時載入 MP3 檔案，請參考 data。

注意： 只要在編譯引擎時加入 minimp3_extra_formats=yes 這個 SCons 參數，本類別便能選擇性地支援舊式的 MP1 及 MP2 格式；這些額外格式預設為停用。

屬性

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

There is currently no description for this property. Please help us by contributing one!

---

int beat_count = 0 🔗

• void set_beat_count(value: int)

• int get_beat_count()

There is currently no description for this property. Please help us by contributing one!

---

float bpm = 0.0 🔗

• void set_bpm(value: float)

• float get_bpm()

There is currently no description for this property. Please help us by contributing one!

---

PackedByteArray data = PackedByteArray() 🔗

• void set_data(value: PackedByteArray)

• PackedByteArray get_data()

包含以位元組為單位的音訊資料。

你可以使用下列程式碼片段在執行時載入檔案，而無須事先匯入。請注意，此程式碼會將整個檔案一次載入至記憶體，對於超大檔案（數百 MB 以上）並不合適。

GDScriptC#

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

Note: The returned array is copied and any changes to it will not update the original property value. See PackedByteArray for more details.

---

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 格式。