J2ME MMAPI 播放聲音完整教學：從 WAV 到 MIDI 的跨平台實作

簡介

Mobile Media API (MMAPI, JSR-135) 是 MIDP 1.0 選配包、MIDP 2.0 核心包。支援格式視裝置而定，常見有 WAV、MIDI、AMR、MP3（部分高階機）。本文以最通用的 JAR 內嵌 WAV 播放 為例。

播放流程三步驟

1. 取得輸入串流：InputStream is = getClass().getResourceAsStream("/sound.wav");
2. 建立 Player：Player player = Manager.createPlayer(is, "audio/x-wav");
3. 啟動播放：player.start();

完整 MIDlet 範例

package sound;
import javax.microedition.midlet.*;
import javax.microedition.lcdui.*;
import javax.microedition.media.*;
import java.io.*;

public class SoundMIDlet extends MIDlet {
    private Player player;

    public SoundMIDlet() {
        try {
            InputStream is = getClass().getResourceAsStream("/Autorun.wav");
            player = Manager.createPlayer(is, "audio/x-wav");
            player.prefetch(); // 預載緩衝，降低 start() 延遲
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public void startApp() {
        if (player != null) {
            try { player.start(); }
            catch (MediaException e) { e.printStackTrace(); }
        }
    }

    public void pauseApp() {
        if (player != null) player.stop(); // 釋放音訊資源
    }

    public void destroyApp(boolean unconditional) {
        if (player != null) { player.close(); player = null; }
    }
}

進階控制

• 循環播放：player.setLoopCount(3); 或 Player.LOOP_CONTINUOUSLY。
• 音量控制：VolumeControl vc = (VolumeControl)player.getControl("VolumeControl"); vc.setLevel(50);
• 播放進度監聽：實作 PlayerListener 處理 END_OF_MEDIA 事件實現自動切換曲目。

跨平台相容性提醒

常見問題排查

1. 無聲音：確認 prefetch() 成功、音量非靜音、檔案路徑大小寫正確（區分大小寫）。
2. MediaException：格式不支援或檔案損壞，嘗試降低採樣率/位深重新編碼。
3. 記憶體不足：大型音檔改用 HTTP 串流播放 Manager.createPlayer("https://host/sound.wav") 避免一次載入 JAR。

結語

掌握 MMAPI 基本播放流程與平台差異，即可為 J2ME 遊戲與應用加入豐富聲音回饋，提升使用者體驗。

1. 上一篇文章： J2ME 安全開發實戰：Bouncy Castle Crypto API 完整應用指南
2. 下一篇文章： J2ME 低階 UI 實作 Nokia S60 風格計算機完整原始碼

J2ME

手機遊戲炮彈軌跡模擬：拋物線數學原理與實現

拋物線軌跡的數學建模 已知發射點 (x1,y1)、射程 cs

J2ME 遊戲開發高階優化技巧（二）：繪圖函數效能測試與優化清單

針對動作遊戲 90% 時間消耗在 10% 繪圖代碼，使用 W

MIDP 1.0 經典小遊戲：五子棋 1.1 版完整原始碼解析

版本說明 1.1 版完善遊戲輸贏判斷邏輯。演算法雖未深度優化

Motorola iDEN J2ME 開發實戰（二）：MIDlet 結構、編譯預驗證與模擬器運行

MIDlet 程式結構：三大生命週期方法 所有 MIDlet