Nokia 手機 J2ME 聲音播放方案：針對不同系列的實作差異

前言

Nokia 手機對聲音播放支援度不一，依系列採用不同 API。本文整理三大類機型實作方式。

1. S40 (7210, 3300) 與 S60 第 1 版 (3650, 7650)

不支援 MIDP 2.0 MMAPI，必須使用 Nokia 私有 API：com.nokia.mid.sound.Sound。

import com.nokia.mid.sound.*;

public class MyCanvas extends Canvas {
    private Sound sound = null;
    // MIDI 轉換而來的位元組陣列 (以 Nokia Audio Converter 產生)
    private byte[] toneData = { 0x02, 0x4a, 0x3a, 0x40, 0x04, 0x00, 0x0b, 0x28,
                                0x83, 0x28, 0x28, 0xd2, 0x28, 0x00 };

    private void playTone() {
        if (sound != null) { sound.stop(); sound = null; }
        sound = new Sound(toneData, Sound.FORMAT_TONE);
        sound.setGain(255);  // 音量最大
        sound.play(1);       // 播放一次
    }
}

關鍵步驟

1. 準備 MIDI 檔，用 Nokia Developers Suite for J2ME 內的 Audio Converter 轉為位元組陣列。
2. WTK 專案引用 Nokia SDK 的 class.zip，提取 com/nokia/mid/sound/Sound.class 打包進專案 lib，編譯後從 JAR 刪除該類別並更新 JAD 大小。

2. Nokia 7610 (支援 MIDP 2.0)

使用標準 javax.microedition.media.Manager 播放 MIDI。

import javax.microedition.media.*;

private Player player = null;

private void playSound(String name) {  // name 如 "kill.mid"
    try {
        if (player != null) { player.close(); player = null; }
        player = Manager.createPlayer(getClass().getResourceAsStream("/"+name), "audio/midi");
        player.addPlayerListener(this);
        player.setLoopCount(1);
        player.realize();
        player.start();
    } catch (Exception e) { e.printStackTrace(); }
}

public void playerUpdate(Player p, String event, Object data) {
    Display.getDisplay(midlet).callSerially(() -> updateEvent(p, event, data));
}

private void updateEvent(Player p, String event, Object data) {
    if (event.equals(PlayerListener.END_OF_MEDIA)) p.close();
    else if (event.equals(PlayerListener.CLOSED)) p = null;
}

3. 切換至背景時停止聲音

// Canvas 端
void stopTone() { if (sound != null) sound.stop(); }

// MIDlet 端
public void pauseApp() {
    if (canvas != null && soundEnabled) canvas.stopTone();
}

總結對照表

結語

針對不同 Nokia 平台採用對應 API，並妥善處理生命週期 (pauseApp 停止聲音)，可實現跨機型穩定播放。