Android - JetPlayer

---

---

Android 平臺包含一個 JET 引擎，允許您在應用程式中新增 JET 音訊內容的互動式播放。Android 提供 JetPlayer 類來處理這些內容。

為了建立 Jet 內容，您需要使用 JetCreator 工具，該工具隨 AndroidSDK 提供。JetCreator 的使用方法已在示例中進行了討論。為了播放 JetCreator 建立的內容，您需要 Android 支援的 JetPlayer 類。

為了使用 JetPlayer，您需要例項化一個 JetPlayer 類的物件。其語法如下所示：

JetPlayer jetPlayer = JetPlayer.getJetPlayer();

接下來您需要做的就是呼叫 loadJetFile 方法並傳入 Jet 檔案的路徑。之後您需要將其新增到 JetPlayer 的佇列中。其語法如下所示：

jetPlayer.loadJetFile("/sdcard/level1.jet");
byte segmentId = 0;

// queue segment 5, repeat once, use General MIDI, transpose by -1 octave
jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++);

queueJetSegment 方法將指定的片段排隊到 JET 佇列中。您最後需要做的是呼叫 play 方法開始播放音樂。其語法如下所示：

jetPlayer.play();

除了這些方法之外，JetPlayer 類中還定義了其他方法。它們定義如下：

示例

以下示例演示瞭如何使用 JetCreator 工具建立 Jet 內容。建立該內容後，您可以透過 JetPlayer 播放它。

要體驗此示例，您需要在實際裝置或模擬器上執行它。

使用 JetCreator

安裝 Python

使用 JetCreator 時，您需要執行的第一步是安裝 Python。Python 可以從其官方網站 這裡 或網際網路上的其他任何地方安裝。

請記住，Python 的版本號應為 2.6 或 2.7，因為此示例遵循該版本。

下載 Python 後，安裝它。安裝後，您需要設定 Python 的路徑。開啟命令提示符並鍵入以下命令。如下面的圖片所示：

路徑設定完成後，您可以透過鍵入 python 並按 Enter 鍵來驗證它。如下所示：

安裝 WxPython

接下來您需要做的是安裝 wxPython。它可以從 這裡 下載。下載完成後，您將安裝它。它將自動安裝到 Python 目錄中。

執行 JetCreator

接下來您需要做的是移動到 JetCreator 所在的路徑。它位於 Android 的 tools、SDK 資料夾中。如下所示：

進入資料夾後，鍵入此命令並按 Enter 鍵。

python JetCreator.py

如下面的圖片所示：

按下 Enter 鍵後，Jet Creator 視窗將開啟。它看起來會像這樣。

建立 Jet 內容

在上面的 Jet 視窗中，點選匯入按鈕。然後從 Jet 資料夾中的演示內容資料夾中選擇 JetCreator_demo_1 或 2。如下面的圖片所示

匯入內容後，您將在 JetCreator 視窗中看到該內容。如下所示：

現在，您可以透過訪問 JetCreator 連結 這裡 來探索 JetCreator 的不同選項。最後，為了建立 .jet 檔案，您需要從檔案選單中儲存內容。

驗證結果

獲得 jet 檔案後，您可以使用 jet player 播放它。播放它的主要程式碼如下所示：

JetPlayer jetPlayer = JetPlayer.getJetPlayer();
jetPlayer.loadJetFile("/sdcard/level1.jet");
byte segmentId = 0;

// queue segment 5, repeat once, use General MIDI, transpose by -1 octave
jetPlayer.queueJetSegment(5, -1, 1, -1, 0, segmentId++);
jetPlayer.play();