深度解析 J2ME MMAPI (JSR 135) 核心架構與三大核心類協作機制

概述

MMAPI (Mobile Media API, JSR 135) 是 Java ME 平台多媒體開發的基石。理解其核心架構——Manager、Player、Control 三大類的職責邊界與協作關係，是高效開發音視頻、錄製、播放功能的前提。本文從架構層面剖析三者交互模型，並解讀關鍵概念：Data Delivery Protocol、Content Types、Media Locator、Media Encoding Strings。

三大核心類職責與協作圖譜

1. Manager —— 多媒體數據源的統一入口

單一職責：管理多媒體數據源，根據數據源創建 Player 實例。

核心靜態方法：

• createPlayer(String locator) — 由 Media Locator 創建
• createPlayer(InputStream stream, String type) — 由流與 Content Type 創建
• getSupportedContentTypes(String protocol) — 查詢設備支持格式
• getSupportedProtocols(String contentType) — 反向查詢協議支持

2. Player —— 多媒體播放/控制的核心實體

生命週期五大狀態（狀態機模型）：

1. UNREALIZED — 創建後初始狀態，資源未分配
2. REALIZED — realize() 後，資源已就緒（編解碼器、緩衝區等）
3. PREFETCHED — prefetch() 後，數據預載完成，可即時啟動
4. STARTED — start() 後，正在播放/錄製
5. CLOSED — close() 後，資源釋放，不可逆

關鍵能力：狀態流轉控制、時間基線管理、事件通知（PlayerListener）、Control 獲取入口。

3. Control —— 具體功能控制的介面集合

設計模式：策略模式 + 介面隔離。Control 本身是空介面，具體功能由子介面實現：

• VideoControl — 視頻顯示模式、縮放、鏡頭參數
• VolumeControl — 音量調節、靜音
• ToneControl — 音序播放
• RecordControl — 錄音/錄像控制
• FramePositioningControl — 幀級定位（視頻）
• MetaDataControl — 元數據讀取（ID3 等）

獲取方式：player.getControl("VideoControl") 或 player.getControls() 遍歷。

四大核心概念深度解讀

Data Delivery Protocol（數據傳輸協議）

標識數據來源類型，決定 Manager 如何解析 Locator：

Content Types（內容類型/MIME 類型）

標識數據格式編碼，指導 Player 選擇解碼器：

• 音頻：audio/mpeg (MP3), audio/amr, audio/wav, audio/midi, audio/mp4
• 視頻：video/mpeg, video/3gpp, video/mp4, video/h263
• 圖像：image/gif, image/jpeg, image/png
• 複合：application/sdp (會話描述)

Media Locator（媒體定位符）

統一資源標識符，語法：<protocol>://<location>[?<params>]

示例：

• capture://video?encoding=video/3gpp&width=176&height=144 — 攝像頭捕獲配置
• file:///SDCard/video.mp4 — 本地文件絕對路徑
• https://example.com/stream.m3u8 — HLS 串流地址

Media Encoding Strings（媒體編碼字符串）

用於 RecordControl 指定錄製輸出格式，格式為 <content-type>[<params>]。例如：

• audio/amr — AMR 錄音
• video/3gpp?width=320&height=240&framerate=15 — 3GPP 錄像參數化

典型協作場景：攝像頭預覽與錄像

// 1. Manager 根據協議創建 Player
Player p = Manager.createPlayer("capture://video");

// 2. Player 實現化，分配硬件資源
p.realize();

// 3. 獲取 VideoControl 控制預覽顯示
VideoControl vc = (VideoControl) p.getControl("VideoControl");
if (vc != null) {
    vc.initDisplayMode(VideoControl.USE_GUI_PRIMITIVE, null);
    Form form = new Form("Camera");
    form.append((Item) vc.initDisplayMode(VideoControl.USE_GUI_PRIMITIVE, null));
    Display.getDisplay(this).setCurrent(form);
}

// 4. 啟動預覽
p.start();

// 5. 錄製時動態添加 RecordControl
RecordControl rc = (RecordControl) p.getControl("RecordControl");
rc.setRecordStream(outputStream);
rc.setRecordSizeLimit(maxBytes);
rc.startRecord();
// ...
rc.commit(); // 寫入文件頭

架構設計啟示

1. 分層解耦：Manager（工廠）→ Player（核心狀態機）→ Control（功能擴展點），符合單一職責原則。
2. 介面導向：Control 介面隔離使新增功能（如 DRM、字幕）無需修改 Player 核心。
3. 狀態驅動：Player 狀態機明確定義資源分配/釋放時機，避免資源洩漏與競態。
4. 協議無關性：Locator 抽象屏蔽底層傳輸差異，同一套代碼處理本地/網絡/捕獲多源。

總結

掌握 MMAPI 的「三類四概念」架構模型，能讓開發者從 API 調用者進化為架構設計者：在複雜多媒體場景（如邊下載邊播、多源切換、錄製編碼參數調優）中，能精準定位問題層級，做出最優技術決策。