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.
Checking the stable version of the documentation...
ResourceImporterOggVorbis
繼承: ResourceImporter < RefCounted < Object
匯入 Ogg Vorbis 音訊檔案以供播放。
說明
Ogg Vorbis 為有損音訊格式,在相同位元率下相較於 ResourceImporterMP3 可提供更佳音質。
大多數情況下建議使用 Ogg Vorbis 而非 MP3。若僅有 MP3 音源且無更高品質來源,則應直接使用 MP3 以避免再次經過有損壓縮。
Ogg Vorbis 解碼所需的 CPU 資源多於 ResourceImporterWAV。若需同時播放大量聲音,特別是在低階裝置上,建議對那些聲音改用 WAV。
教學
屬性
|
||
|
||
|
||
|
||
|
方法
load_from_buffer(stream_data: PackedByteArray) static |
|
load_from_file(path: String) static |
屬性說明
音訊軌道中,單個小節(bar)內包含的節拍(beat)數量。這個設定僅對希望使用互動音樂(interactive music)功能的音樂有效,而不適用於音效。
在 進階匯入設定(Advanced Import Settings) 對話框中,為 bar_beats 提供了一個更方便的編輯器。因為它可以讓你在預覽更改效果的同時,免去反復重新匯入音訊的麻煩。
音訊軌道的總長度(以節拍數為單位)。音訊檔案的實際播放時長可能會比這個屬性所指示的時長要長。該設定僅對希望使用互動音樂(interactive music)功能的音樂有效,而不適用於音效。
在 進階匯入設定(Advanced Import Settings) 對話框中,為 beat_count 提供了一個更方便的編輯器。因為它可以讓你在預覽更改效果的同時,免去反復重新匯入音訊的麻煩。
音訊軌道的 tempo(節奏速度),以每分鐘的節拍數(BPM)為單位進行衡量。這裡填寫的數值應該與創作這首曲子時使用的 BPM 保持一致。這個設定僅對希望使用互動音樂(interactive music)功能的音樂有效,而不適用於音效。
在 進階匯入設定(Advanced Import Settings) 對話框中,為 bpm 提供了一個更方便的編輯器。因為它可以讓你在預覽更改效果的同時,免去反復重新匯入音訊的麻煩。
如果啟用,當音訊播放結束(無論是播放到了音訊檔案的末尾,還是根據 beat_count 中指定的數量播放到了最後一個節拍的末尾)後,音訊將會從開頭或者從 loop_offset 指定的位置重新開始播放。
注意: 在 AudioStreamPlayer 中,對於開啟了循環的音訊,當它播放到音訊檔案末尾時,不會觸發 AudioStreamPlayer.finished(播放完成)訊號,因為音訊會一直無限循環播放下去。
決定當播放到結尾後,音訊從何處開始迴圈。可僅重複音訊檔案的某一段,對部分環境音效或音樂十分實用。此值以秒為單位,從音訊開頭算起;0.0 代表整個檔案皆迴圈。
僅當 loop 為 true 時生效。
進階匯入設定 對話框提供了更方便的 loop_offset 編輯器,可讓你在不重新匯入音訊的情況下預覽變更。
方法說明
AudioStreamOggVorbis load_from_buffer(stream_data: PackedByteArray) static 🔗
已棄用: Use AudioStreamOggVorbis.load_from_buffer() instead.
從指定的緩衝區建立新的 AudioStreamOggVorbis 實例。緩衝區必須包含 Ogg Vorbis 資料。
AudioStreamOggVorbis load_from_file(path: String) static 🔗
已棄用: Use AudioStreamOggVorbis.load_from_file() instead.
從指定的檔案路徑建立新的 AudioStreamOggVorbis 實例。該檔案必須為 Ogg Vorbis 格式。