Sun Java Wireless Toolkit for CLDC 使用者指南

本附錄描述 Sun Java^TM Wireless Toolkit for CLDC 所附帶的應用程式示範。

---

A.1 簡介

Sun Java^TM Wireless Toolkit for CLDC 包含一些示範應用程式，以特別介紹模擬器所支援的一些技術與 API。這些示範的目的是要讓您大致瞭解一下模擬器的一些 API 功能與整個工具組的增強功能。

表格 A-1 列出此發行版本包含的所有示範應用程式。

大部分示範應用程式的執行方式都很簡單。 第 A.2 節 一般指示包含執行大部分示範的說明。表格 A-1 中列出了包含其他文件的示範的連結。如果沒有連結，代表這個示範很簡單 (或有自己的說明)，一般說明已足夠。

每個示範應用程式的原始碼位於 toolkit/apps 目錄中。子目錄內包含專案，而且每個專案各有一個內含 Java 程式設計語言原始碼的 src 目錄。例如，在 Windows 中，如果工具組安裝在 $$$C:\WTK2.5.2 中，則 WMADemo 中 SMS 寄件者 MIDlet (example.sms.SMSSend) 的原始碼就位於 $$$C:\WTK2.5.2\apps\WMADemo\src\example\sms\SMSSend.java 中。如第 1.1.2 節 工作目錄 檔案中所討論，當您開啟某個專案時會將其複製到您的 workdir/apps 目錄。

---

A.2 一般指示

大部分示範應用程式可在執行後無需特殊準備便可啟動。但是，某些示範需要變更工具組偏好或設定。這一節描述一般程序。

第一個步驟是執行工具組。若要執行此動作，請移至 Microsoft Windows 的 [開始] 功能表，選擇 [開始] > [所有程式] > [Sun Java Wireless Toolkit 2.5.2 for CLDC] > [Wireless Toolkit 2.5.2]。將顯示使用者介面，如圖 A-1 中所示。

圖 A-1 Wireless Toolkit 使用者介面

按一下 [開啟專案] 按鈕，開啟示範應用程式。會顯示所有可用應用程式的清單。如第 1.1.2 節 工作目錄檔案中所討論，安裝目錄中的專案為斜體，而您工作目錄中的專案以粗體顯示 (圖1-1 )。當您開啟安裝目錄中的某個專案時，會在您的工作目錄中建立一個副本，然後開啟。

開啟應用程式後，您可以按工具列上的 [執行] 按鈕；或者如果需要在模擬器上安裝，則請按一下 [專案] > [經由 OTA 執行]。

開啟裝置模擬器視窗，顯示執行中的示範應用程式。如果有 MIDlet 的功能表，請使用導覽箭頭選擇一個項目，然後選擇 [選取]。示範進行時，您可能需要按下左側或右側螢幕下的軟鍵之一。使用軟鍵可以安裝或啟動應用程式、開啟功能表、結束或執行某些其他動作。某些範例包含這些指令。

有些示範需要特定設定與指示。例如，如果某個範例使用 Web 服務並且您在防火牆後方，則您必須配置模擬器的代理伺服器設定，否則示範將失敗：

• 選擇 [編輯] > [偏好]
• 選取 [網路配置] 圖示。
• 核取 [使用代理伺服器]。
• 填入代理伺服器位址欄位以及連接埠號。

如需更多操作指示，請閱讀每個示範的說明。

---

A.3 Advanced Multimedia Supplements

此 MIDlet 套裝軟體示範了 JSR 234 Advanced Multimedia Supplements (AMMS) 的功能。它包含以下 MIDlet：

• 影像效果 － 展示標準影像處理作業。從功能表中選擇一種效果。處理過的影像顯示在來源影像後面。請注意，某些項目 (例如設定轉換) 可以執行數項作業。按一下 [完成] 軟式按鈕以套用每種效果。

圖 A-2 在 MIDlet 中處理影像

• 收音機選台器 － 透過工具組的內建 HTTP 伺服器從專案目錄讀取音效檔案，可模擬收音機選台器。
• 相機 － 展示 Advanced Multimedia Supplements 如何控制裝置的相機。此螢幕顯示相機的取景器 (使用動態影像模擬)。您可以使用功能表中的指令變更相機設定，以及拍攝並管理快照。
• 移動直升機 － 模擬直升機在固定觀察者周圍飛行的場景。請使用耳機，以取得最佳效果。您可以控制許多模擬參數 (包括直升機的大小)、是否使用都卜勒效果，以及觀賞者的方位 (例如是直立還是趴著)。
• 音樂效果 － 展示 Advanced Multimedia Supplements 的進階音效功能。音效檔案連續循環播放時，您可以調整音量、聲像、等化器設定、迴聲和合聲設定。

---

A.4 藍芽示範

此應用程式包含示範如何使用 JSR 82 藍芽 API 的 MIDlet。

BluetoothDemo 專案展示如何在兩個使用藍芽的裝置之間傳輸影像。您必須執行兩個模擬器實例，才能瞭解此示範的運作方式。

在第一個模擬器中，啟動 [藍芽示範]，然後選擇 [伺服器]。模擬器會詢問您是否允許藍芽連線。選擇「是」。伺服器會啟動，並顯示影像清單。一開始，藍芽網路上沒有任何可用的影像。若要使影像可用，請選取這些影像，然後從功能表選擇 [發佈影像] (或鍵入或按一下 1)。圖示顏色會從紫色變為綠色，表示已經發佈。

圖 A-3 執行藍芽示範伺服器

在第二個模擬器上，啟動 [藍芽示範]，然後選取 [用戶端]。MIDlet 會告訴您，已準備好搜尋影像。按一下 [尋找] 軟式按鈕。MIDlet 會尋找其他模擬器，並從中取得影像清單。從清單中選取一個影像，並選擇 [載入]。模擬器會詢問您是否允許連線。選擇「是」。

• 如果您正於信任的保護網域中執行示範，則影像會使用模擬的藍芽傳輸，並且會顯示在用戶端模擬器上。
• 如果您未於信任的保護網域中執行，則第一個模擬器 (伺服器) 會顯示一則提示，詢問您是否要授權來自該用戶端的連線。選擇「是」。影像會顯示於用戶端模擬器中。

圖 A-4 使用模擬藍芽傳輸的影像

---

A.5 CHAPIDemo

CHAPIDemo 是一個內容瀏覽器 (請參閱 JSR 211)， 裡面保留一個我的最愛清單，並可讓您選取與檢視各種內容。

本示範使用內容處理器註冊表，因此您使用 [執行] 按鈕時無法看到其所有功能。請改用 [專案] > [經由 OTA 執行] 將應用程式安裝至模擬器。如果不知道如何執行，請查閱第 2.3.2 節 安裝。

安裝完 CHAPIDemo 後，會在 [文字檢視器] 中顯示為應用程式清單。它是純文字的 MIDlet 內容處理器。選取 [文字檢視器]，然後從軟式按鈕功能表中選擇 [啟動]。會顯示我的最愛連結清單。

圖 A-5 檢視 CHAPIDemo 中的我的最愛連結

使用導覽鍵高亮度顯示 CHAPIDemo，然後按下模擬器上的 [選取]。應用程式會詢問是否可以使用通話時間。按下 [是] 軟式按鈕。會顯示各種類型內容的清單 (圖 A-6)。

圖 A-6 內容清單

嘗試選取一個 Duke.png。使用箭頭高亮度顯示該連結，然後按下 [選取] 以檢視此檔案。使用 CHAPI 啟動 ImageViewer MIDlet，並會顯示內容。

圖 A-7 檢視 PNG 影像

其他類型的內容需要另一個內容處理器 MIDlet 套裝軟體︰MediaHandler。若要從 CHAPIDemo 安裝此套裝軟體，請選取 MediaHandler.jad 連結 (圖 A-6 中所示清單中的第一個項目)。會呼叫 AMS，並引導您完成整個安裝。

安裝完 MIDlet 套裝軟體之後，您可以檢視 [文字檢視器] 中列出的其他類型內容。例如，選取 http:video/test-mpeg.mpg 以查看一系列影像 (包括圖 A-8 中顯示的影像)。

圖 A-8 使用 MediaHandler 檢視 MPEG 電影

若要檢視 TextViewer 和 ImageViewer MIDlet 的內容處理器設定，請按一下 [設定]，然後按一下 [內容處理器] 圖示。您可能還希望檢查 MediaHandler 專案。

---

A.6 CityGuide

CityGuide 會示範如何使用位置 API (JSR 179)。它可在市區地圖上顯示行人的目前位置。行人會在市區內移動，行人接近地標時，地標也會高亮度顯示並註明。在此示範中，我們透過名稱為 citywalk.xml (事件檔案) 的 XML 程序檔取得行人的位置，該程序檔可提交裝置位置資訊。請參閱第 13 章以獲得完整說明。

由於位置提示會經常出現，因此最佳方法是以製造商 (可信任) 模式執行此示範，如第 6.2.1 節 MSA 保護網域中的解釋。在使用者介面中，選取 [編輯] > [偏好]，然後選取 [安全]。為安全網域選擇 [製造商]。

開啟並執行 CityGuide 專案。在模擬器中，啟動 CityGuide MIDlet。按 [下一步] 以檢視地圖頁面。

圖 A-9 您在城市中的位置

從模擬器視窗功能表中選擇 [MIDlet] > [外部事件]。在 [位置] 標籤上，按一下 [瀏覽] 按鈕。選取 workdir\apps\CityGuide\citywalk.xml 中的以下事件檔案。

視窗底部的播放器按鈕現在正在使用中。請參閱圖 13-1。按下綠色播放按鈕 (向右指的三角形) 以執行程序檔。

顯示螢幕出現四種類型的地標： 餐廳、博物館、商店和電影院。若要調整地標顯示，請開啟軟式功能表並選擇 [設定] 指令。請參閱圖 A-10。使用導覽鍵高亮度顯示某個種類，然後使用 [選取] 核取或取消核取某個項目。

當您在某個地標 (如地圖上高亮度顯示的地標所示) 附近時，請開啟軟式功能表並選擇 [詳細資訊] 指令，以查看更多資訊。如需有關位置程序檔的更多資訊，請參閱 第 13 章。

圖 A-10 位置設定

圖 A-11 地標詳細資訊

---

A.7 示範

本示範包含幾個 MIDlet，強調不同的 MIDP 功能。

A.7.1 色彩

此應用程式會顯示一個大塊橫向矩形，跨越整個螢幕寬度。下面有十個小塊縱向矩形，橫跨整個螢幕。最後有三條水平色棒，分別顯示藍、綠和紅色 (RGB) 的值。系統會根據第一個功能表的選取，以十進位 (0-255) 或十六進制 (00-ff) 數字表示值。

• 若要選取垂直色棒以進行變更，請使用向上導覽箭頭移動到色棒。使用向右導覽箭頭高亮度顯示色棒。大塊矩形會變成所選色棒的顏色。
• 使用向上或向下選取箭頭選擇要變更的值 (紅、綠或藍)。使用向左或向右箭頭增加或減小所選值。第二個功能表項目可讓您以 4 (微調) 或 32 (粗調) 為增減單位。
• 您可以變更任意或所有垂直色棒上的顏色。

A.7.2 特性

此 MIDlet 會顯示特性值。例如，請參考圖 A-12：

圖 A-12 系統特性

A.7.3 Http

此測試應用程式使用 HTTP 連線請求網頁。請求是透過 HTTP 協定 GET 或 POST 方法發佈的。如果已使用 HEAD 方法，則會從請求讀取 HEAD 特性。

準備執行示範

開始之前，請按以下程序檢查您的設定。

• 移至 [偏好] > [安全]。將策略設定為 JTWI，並將網域設定為最大值。
• 在 [偏好] > [網路配置] 中，HTTP 版本必須為 1.1。
• 如果您在防火牆後方，請移至 [偏好] > [網路配置]，並指定代理伺服器資訊。
• 如果您正在執行防毒軟體，則可能需要建立允許此 MIDlet 的規則，以允許連線至特定的網站或從特定的網站進行連線。

執行示範

啟動 Http MIDlet。依預設，MIDlet 嘗試聯絡 http://www.yahoo.com。若要進行測試，請選擇 [功能表] 軟鍵並選擇 1、2 或 3 測試所選 URL。

[Http 測試] 會傳回自己能取得的資訊。如果資訊填滿螢幕，請使用向下箭頭捲動到結尾。資訊量取決於請求類型和此頁面提供的 META 資訊量。若要提供內文資訊或內容，此頁面必須依 RFC 2616 中的描述宣告 CONTENT-LENGTH。

使用功能表選項

使用 [功能表] 軟鍵進行以下動作。

• 選擇 1 從所選頁面中 GET (獲得) 資訊。
• 選擇 2 從所選頁面中獲得 POST 資訊。
• 選擇 3 顯示此頁面的 HEAD 屬性。
• 選擇 4 開啟目前的網頁清單。您可以選擇新頁面，或將您自己的頁面增加到清單中。若要指定新的 URL，請選擇 [功能表] 軟鍵並選擇 4。螢幕會顯示 [http://]。鍵入 URL 的其餘部分，確定以斜線 (/) 結尾。例如 http://www.internetnews.com/。按下 [確定] 軟式按鈕。[Http 測試] 螢幕會顯示新的 URL 以及動作的提示。

A.7.4 FontTestlet

此 MIDlet 展示各種可用字型： Proportional、Regular、Regular Italic、Bold Plain 和 Bold Italic。從功能表中選擇 1 或 2，以在系統字型 (細明體) 和固定間距字型間切換。

A.7.5 股票

正如 Http 示範，此範例使用 HTTP 連線獲得資訊。使用與第 A.7.3 節 Http 相同的準備步驟。

執行示範專案並啟動 Stock MIDlet。

依預設，畫面會在頂部顯示空的快訊列。快訊下方的功能表清單會顯示四個應用程式： 「Stock Tracker (股票追蹤器)」、「What If?」、 「Alerts (警報)」和「Settings (設定)」。使用前三個應用程式之前，您必須增加股票代號。

A.7.5.1 使用設定

若要使用此應用程式的功能，您必須為應用程式提供一些股票代號才能使其運作。

將股票代號增加到快訊

若要將股票代號增加到快訊，請使用導覽箭頭選取 [設定]。

選取 [新增股票]。

螢幕會提示您輸入股票代號。鍵入 SUNW 並選取 [完成] 軟鍵。您增加的股票和目前價格會顯示在快訊中。增加更多代號，例如 IBM 和 HPQ。

變更更新間隔

依預設，更新間隔為 15 分鐘。選取 [更新] 以變更時間間隔。使用導覽箭頭選取[連續]、[15 分鐘]、[30 分鐘]、[1 小時] 或 [3 小時] 中的一個選項。選取 [完成] 軟鍵。

移除股票

選取 [移除股票]。可以看到您已增加的股票清單。使用導覽鍵選取一個或多個要移除的股票。選擇 [完成] 軟鍵。

A.7.5.2 股票追蹤器

股票追蹤器可顯示您已增加的股票及其現值清單。股票追蹤器可顯示有關已選取股票的其他資訊，例如，最後成交價和最高價與最低價。

選擇一種股票並按下 [選取]。

A.7.5.3 What If?

What If? 是一個應用程式，會詢問您擁有股票的原始購買價格和股數。它可根據目前價格計算損益。

選取股票代號。

輸入購買價格和股份，然後按下 [計算]。

A.7.5.4 警報

當價格變更為您指定的值時，此應用程式會傳送給您一則通知。

從主功能表中選取 [警報]。

選取 [增加]。

選取 [股票]。螢幕會顯示提示 [股票到達以下價格時發出警報]。輸入一個整數。

警報位於 [目前的警報] 清單中。若要移除某個警報，請按下 [移除] 並選取該警報。選擇 [完成] 軟鍵。

達到您指定的價格時，您會聽到鈴聲並收到一則訊息。例如，Symbol 已達到您的價格點 $value 並且目前正以 $current_value 價格成交。此警報觸發之後，便會從 [目前的警報] 清單中消失。

A.7.6 購票

示範線上購票拍賣應用程式的可能運作方式。主螢幕會在頂部顯示購票快訊。依預設，[選擇樂團] 欄位會顯示 [艾拉妮絲莫莉塞特]。

若要選擇樂團，反白顯示樂團名稱並按下 [選取]。使用向下箭頭反白顯示不同的樂團 (例如「魔比」)，然後按下 [選取]。會顯示可用的拍賣。

若要投標，請選取 [功能表] 軟鍵並選擇 [2]。使用方向鍵在欄位間移動。填妥每個欄位。選取 [下一步] 軟鍵。應用程式會要求您確認您的投標。使用方向鍵反白顯示 [提交]，然後按下 [選取]。您會收到一個確認碼。按一下 [樂團] 以返回到歡迎頁面。

若要設定警報，請選取 [功能表] 軟鍵並選擇 3。使用導覽箭頭移動到此欄位並鍵入一個高於目前投標價的值。選取 [儲存] 軟鍵。會返回到歡迎頁面。只要以超過警報值的價格投標，就會觸發警報。您的設定決定了應用程式檢查變更的頻率，因此可能要過幾分鐘才能聽到警報。

若要加入樂團，請選取 [功能表] 軟鍵並選擇 4。鍵入樂團名稱或用逗號隔開的名稱清單。選擇 [儲存] 軟鍵。確認後便會返回到歡迎頁面。增加的樂團顯示在 [選擇樂團] 下拉式清單中。

若要移除樂團，請選取 [功能表] 軟鍵並選擇 5。導覽至某個樂團，然後選擇 [選取] 以標記核取方塊。您可以選擇多個樂團。選擇 [儲存] 軟鍵。

若要顯示快訊顯示、更新、警報音量和日期的目前設定，請選取 [功能表] 軟鍵並選擇 6。如果需要，請使用方向鍵和選取鍵變更這些值。選擇 [儲存] 軟鍵。

A.7.7 ManyBalls

此 MIDlet 一開始是一個球在螢幕中移動。使用向上、向下箭頭提高或降低球速 (fps)。使用向左、向右鍵增加或減少球數。

---

A.8 Demo3D

此應用程式包含三個 MIDlet，以顯示模擬器的 JSR 184 (Mobile 3D Graphics API) 支援。

A.8.1 Life3D

Life3D 以三度空間實作流行的生命之旅 (Game of Life)。活的細胞以立方體表示。每個細胞可能有 26 個鄰居 (包含對角)。在動畫的每個步驟中，少於四個鄰居的細胞會因為太寂寞而死掉，而多於五個鄰居的細胞則因為太擁擠而死掉。剛好四個鄰居的空細胞將會變成新的活細胞。

遊戲板的圖形會慢慢旋轉，讓您可以從各種角度看到遊戲板。

圖 A-13 三度空間的生命之旅

使用表格 A-2 中的小鍵盤按鈕控制遊戲。

本範例的原始碼有非常完善的說明記錄。請參閱 toolkit\apps\Demo3D\src\com\superscape\m3g\wtksamples\life3d\Life3D.java。

A.8.2 PogoRoo

PogoRoo 展示一隻袋鼠用彈簧單高蹻上、下彈跳。若要掌控袋鼠，請使用方向鍵。向上可以往前跳，向下往後跳，向左、向右則可以改變方向。您必須按住按鍵才能看到效果。

圖 A-14 彈跳中的袋鼠

A.8.3 retainedmode

retainedmode MIDlet 會播放一個場景的檔案，顯示一個永不疲倦的滑板選手，無止盡地繞圈圈。

圖 A-15 永不疲倦的滑板選手

---

A.9 GoSIP

GoSIP 是一個聊天應用程式，以 SIP (JSR 180) 設定使用 SIP 代理伺服器和代理登錄的通訊。

由執行 SIP 伺服器開始。選擇 [檔案] > [公用程式]。選取 [啟動 SIP 伺服器]，然後按下 [啟動]。會顯示 SIP 代理伺服器視窗。按一下 [啟動] 以執行此伺服器。

接著使用 GoSIP 應用程式執行兩個模擬器的範例。

圖 A-16 SIP 代理伺服器和代理登錄

在第一個模擬器中，啟動 Sippy A。系統提示您輸入代理主機時，請輸入您的本地機器名稱或 IP 位址並選擇 [下一步]，然後選擇 [註冊]。SIP 伺服器視窗會顯示模擬器的 SIP 訊息。在已註冊使用者的清單中會顯示 [Sippy A]。模擬器會建議您邀請您的朋友 Sippy B 交談。但現在還不要執行。

在第二個模擬器中，啟動 Sippy B。和之前一樣，輸入 SIP 代理伺服器的位址、選擇 [下一步]，然後選擇 [註冊]。[Sippy B] 使用者會顯示在 SIP 伺服器視窗中。

在第一個模擬器中選擇 [邀請]。第二個模擬器會指示其正在響鈴。選擇 [接聽] 開始聊天。兩個模擬器現在均顯示 [聊天中] 螢幕。您可以使用 [傳送] 指令來回傳送訊息。

完成後，選擇 [再見] 結束聊天。

---

A.10 i18nDemo

此 MIDlet 套裝軟體展示 JSR 238 Mobile Internationalization API。MIDlets String Comparator 和 Formatter 展示如何排序字串以及針對不同的語言環境適當地顯示數字。第三個 MIDlet (MicroLexicon) 是一個小型片語翻譯程式，如果您需要在布拉格、赫茲利雅、北京、米蘭或幾個其他地方點杯啤酒，便可派上用場。

若要執行 MIDlet，請使用 [選取] 反白顯示此 MIDlet，然後使用右下按鈕啟動此 MIDlet。

String Comparator MIDlet 可示範每個語言環境的字串 (城市名稱) 排序之區別。啟動 MIDlet。使用右下按鈕檢視功能表。按一下或鍵入 2 以選取 [排序 - 預設]，清單即會按字母順序排序。按一下或鍵入 3 以選取 [排序 - 斯洛伐克語]。不管頂部有沒有標記，都很容易看出以字母 Z 開頭的城市差別。按一下 [結束] 以返回到 MIDlet 的清單。

第二個 MIDlet (Formatter) 只是針對不同語言環境的格式顯示時間和數字。按一下 [下一步] 以檢視所有四個螢幕。按一下 [結束] 以返回到 MIDlet 的清單。

最後一個 MIDlet (MicroLexicon) 將片語從一種語言翻譯為另一種語言。若要從清單中選取目標語言，請使用導覽箭頭反白顯示 [選擇語言]。按一下 [選取] 以檢視語言下拉清單。使用導覽箭頭選擇一種語言 (請參考圖 A-17)，然後按一下 [選取]。

圖 A-17 選擇目標語言

MicroLexicon 顯示片語的清單。反白顯示一個片語，然後按下模擬器上的 [選取] 按鈕。您可以看到目標語言的旗標和已翻譯的片語。

若要變更來源語言，請選擇 [編輯] > [偏好]。按一下 [國際化] 標籤，然後輸入有效的語言環境字串。下次執行模擬器和 MicroLexicon 時，如果支援，指示文字就會以指定的語言環境顯示。例如，cs-CZ 就可行。

MicroLexicon 採用 MIDlet 資源。若要瞭解如何使用工具組來本地化應用程式，請選擇 [專案] > [國際化資源管理員]。會顯示所有資源，包括文字和影像 (由 MicroLexicon 使用)。您可以編輯資源，然後再次執行 MicroLexicon，看看有什麼變化。您無需再次生成應用程式，因為資源已經在執行階段載入。

圖 A-18 國際化資源管理員

$$$這些資源本身儲存於 workdir\apps\i18nDemo\res\global。

---

A.11 JBricks

JBricks 是一個遊戲，示範了 JSR 229 Payment API 的使用。此遊戲類似 Breakout 或 Arkanoid (打磚塊)。在 JBricks 中，您可以購買生命或新的遊戲等級。Payment API 在背景處理細節。

若要使用 JBricks 的支付款項功能，請使用 [專案] > [經由 OTA 執行] 將 JBricks 安裝至模擬器。如果不知道如何執行，請查閱第 2.3.2 節 安裝。

若要查看 JBricks 如何使用 Payment API，請從遊戲主功能表中選擇 [購買生命] 或 [購買等級]。接著選擇要購買一條生命，還是以優惠價格一次購買三條生命。下一個螢幕讓您選擇支付款項類型。

圖 A-19 選擇支付款項類型

使用導覽箭頭選取以 [透過以下方式支付] 開頭的行。按一下 [選取] 按鈕以查看下拉式功能表中可能的信用卡介面。使用導覽箭頭選取 [VISA 介面]，然後按一下 [選取]。按一下右下方的 [是] 以繼續進行。

然後，您便可以輸入信用卡資訊。使用任一有效的 VISA 號碼 (例如，4111111111111111) 和有效的過期日期。

圖 A-20 提供支付款項資訊

若要檢視目前模擬器實例的作業事件，請選擇 [MIDlet] > [外部事件]，然後按一下[支付款項作業事件] 標籤。會顯示此特定模擬器實例的作業事件。

圖 A-21 檢視作業事件

此外，您可以檢視通過工具組的支付款項系統的所有作業事件。選擇 [檔案] > [公用程式]，然後選取 [支付款項主控台]。主控台中的作業事件如下：

PSP Console running, using phone number +5550001.

PSP Server running at https://localhost:-1

Received Payment Request from 127.0.0.1

   Credit card issued by: VISA

   Credit Card type: 0

   Credit Card Number: 4111111111111111

   Credit Card Holder: Jonathan Knudsen

   Feature ID: 3_lives

   Credit Card Verification Number (CCV): 123

   Payload: null

Response to 127.0.0.1

HTTP/1.1 200 OK

Content-Length: 0

Pay-Response: SUCCESSFUL

Pay-Timestamp: 1156282954734

---

A.12 JSR172Demo

JSR172Demo 展示如何從 MIDlet 存取 Web 服務。Web 服務已經在網際網路伺服器上執行。如果您在防火牆後方，您必須配置模擬器的代理伺服器設定。選擇 [編輯] > [偏好]，然後選取 [網路配置]。填入代理伺服器位址檔案以及連接埠號。生成並執行範例。

JSR172Demo 包含一個 MIDlet，名稱為 Server Script。請啟動它，並依照提示執行。您可以瀏覽模擬的新聞提要，所有這些資料都是從 Web 服務擷取下來的。

若要瞭解背景運作方式，請使用網路監視器。

---

A.13 MobileMediaAPI

MobileMediaAPI 應用程式包含四個展示工具組多媒體功能的 MIDlet。這一節描述這些 MIDlet，並包含從您的應用程式使用多媒體的其他資訊。

A.13.1 Simple Tones

Simple Tones 範例示範如何使用互動合成鈴聲。選取一個範例，然後按一下右下方的 [播放]。

• Short Single Tone 和 Long Single Tone 使用 Manager.playTone() 播放不同音高的鈴聲。
• [短 MIDI] 事件在互動式 MIDI 裝置 (定位器 "device://midi") 上播放一段和弦。MIDIControl 的 shortMidiEvent() 方法用來觸發和弦的音符。
• 若要執行 MMAPI Drummer 示範，請按一下或鍵入數字鍵 (0-9)。各數字鍵所播放的聲音不同。

A.13.2 Simple Player

Simple Player 應用程式會示範模擬器的音效與視訊功能範圍。它包含各種不同格式的範例檔，而且可以從模擬器的永久性儲存裝置或從 HTTP URL 播放檔案。

播放器部分使用通用的 javax.microedition.media.Player 介面。播放器會顯示長度、媒體時間和執行媒體檔的控制項。如果檔案提供中介資料，此播放器可讓您檢視這些資訊，例如作者與標題。對於 MIDI 檔案，如果檔案提供卡拉 OK 文字，則播放時螢幕上會顯示文字。如果提供圖形使用者介面控制項，也可在顯示螢幕上進行檢視。若要存取這些控制項，請在 [Simple Player] 中選取其中一個媒體範例，然後按下 [功能表] 按鈕，以檢視並選取需要的指令。

選取 [Simple Player]，然後按一下 [啟動]。示範包含下列媒體範例：

• Bong 會播放一個短 WAV 檔案。您可以依照本文件稍後描述的方式，調整某些播放功能。顯示上會顯示聲音的長度，格式為「分:秒:十分之一秒」，例如 00:17:5。此音效範例是 MIDlet 套裝軟體 JAR 檔案中的一個資源檔案。
• MIDI Scale 會播放音階範例。顯示上會顯示所選音樂檔的標題、歌曲長度、已播放時間及目前的音樂速度 (以每分鐘節拍數 (bpm) 為單位)。此 MIDI 檔存放於 MIDlet 套裝軟體 JAR 檔案中。
• Simple Ring Tone 會播放一小段貝多芬第五號交響曲。顯示上會顯示所選音樂檔的標題、歌曲長度、已播放的秒和十分之一秒數、以及目前的音樂速度 (以每分鐘節拍數 (bpm) 為單位)。此 ringtone 檔 (.jts 格式) 存放於 MIDlet 套裝軟體 JAR 檔案中。
• WAV Music 會播放簡短的音效檔。顯示上會顯示音效檔的標題、音效長度、已播放的時間以及播放速率百分比。此 WAV 檔從 HTTP 伺服器擷取得來。
• MIDI Scale 會播放從 HTTP 伺服器擷取來的 MIDI 檔。
• Animated GIF 範例會展示從 1 數到 5 的 GIF 動畫。檔案存放於 MIDlet 套裝軟體 JAR 檔案中。
• Audio Capture (從預設裝置) 可讓您從麥克風或連接的裝置擷取音效。聲音會擷取下來，並從喇叭播放出來。若要避免回音，請使用耳機。
• Video Capture Simulation 會模擬檢視輸入視訊，例如使用配備相機的裝置。
• MPEG1 Video [http]。可播放位於 http://java.sun.com/products/java-media/mma/media/test-mpeg.mpg 的 MPEG 視訊。
• [enter URL] 可讓您播放來自任意 HTTP 伺服器的媒體檔。在插入點處鍵入有效的 URL (例如， http://java.sun.com/products/java-media/mma/media/test-wav.mpg)，然後按一下 [確定] 以播放檔案。如果要開啟 HTTP 目錄，從中選取媒體，請務必確定在 URL 末端加上斜線。

此外，Simple Player 會剖析鈴聲文字傳輸語言 (RTTTL) 格式的鈴聲。如需 RTTTL 的詳細資訊，請參閱 http://www.convertyourtone.com/rtttl.html。

[Simple Player] 包含控制媒體播放的通用指令集。這些指令列在 [Simple Player] 功能表上，而且有些指令有相關的小鍵盤按鈕。下表描述這些指令。

依 [Simple Player] 所播放的媒體類型而定，有些指令可能不適用。此外，有些指令可以用小鍵盤按鈕呼叫。下表描述可用的指令、其小鍵盤對等按鍵和 MMAPI 中相關的類別。

請注意，Simple Player 應用程式本身提供一份簡短的指令清單，和對應的小鍵盤按鈕。只要從功能表選擇 [快速說明] 指令即可取得。

A.13.3 Video

Video 應用程式演示模擬器如何播放 GIF 動畫檔與擷取視訊。在配備相機的實際裝置上，視訊擷取可用來告訴使用者，透過相機所能看到的內容。

使用 Form Item 或 Canvas 即可實作 GIF 動畫與視訊擷取。Video 示範包含所有可能性。Animated GIF - Form [jar] 會以 Form Item 方式顯示 GIF 動畫。表單也包含有關播放的一些資訊，包括目前時間。選擇 [快照] 指令可拍下執行中動畫的快照。快照將存放於跟在 GIF 動畫後面的表單中。

• Animated GIF - Canvas [jar] 會以 Canvas 格式顯示 GIF 動畫。簡單的快訊會顯示動畫的進度。選擇 [快照] 可取得目前外觀的靜態影像。顯示上會短暫顯示快照，然後回到動畫。
• Video Capture - Form 會模擬從相機或其他來源擷取視訊，並以 Form 中的 Item 方式顯示。選擇 [快照] 指令可拍下擷取視訊的快照。快照將存放於跟在視訊擷取後面的表單中。
• Video Capture - Canvas 會模擬從相機或其他來源擷取視訊，並以 Canvas 方式顯示。選擇 [快照] 可取得目前外觀的靜態影像。顯示幕上會短暫顯示快照，然後回到視訊擷取。
• MPEG1 Video - Form；MPEG1 Video - Canvas

MPEG1 應用程式從 Web 獲得 MPEG，因此如果您在防火牆後方，則必須配置模擬器的代理伺服器設定。

選擇 [編輯] > [偏好]，然後選取 [網路配置]。核取 [使用代理伺服器]。填入代理伺服器位址欄位以及連接埠號。對於此示範，請選取 [HTTP/1.0]。

當您播放此示範時，必須等幾秒鐘讓 WTK 獲得資料。MPEG1 示範分別與 Video Capture - Form 和 Video Capture - Canvas 具有相同的運作方式。

A.13.4 暫停音效測試

此 MIDlet 用於示範暫停的 MIDlet 未停止執行中的播放器時，Sun Java^TM Wireless Toolkit for CLDC 要如何向您發出警告。啟動 MIDlet 之後，請選擇 [播放] 指令以開始播放某些音效。螢幕會顯示狀態「正常」或「不正常」。

從模擬器視窗的功能表中選擇 [MIDlet] > [暫停]。就如預期的，MIDlet 會暫停且工具組主控台上不會顯示訊息。從模擬器視窗的功能表中選擇 [MIDlet] > [重新繼續]。

接著選擇 [不正常] 指令。再次暫停 MIDlet。在工具組主控台中，您會看到以下警告： An active media (subtype Player) resource was detected while the MIDlet is paused. (MIDlet 處於暫停狀態時偵測到使用中的媒體 [子類型播放器] 資源。) Well-behaved MIDlets release their resources in pauseApp(). (正常 MIDlet 釋放在 pauseApp() 中的資源。)

A.13.5 MobileMediaAPI 的屬性

MobileMediaAPI 應用程式有下列屬性，是您在專案設定對話方塊的 [用戶定義的] 標籤中可以修改的項目：

---

A.14 網路示範

此示範有兩個 MIDlet： Socket Demo 和 Datagram Demo。每個示範都需要執行兩個模擬器實例，以便模擬伺服器和用戶端的關係。

A.14.1 Socket Demo

執行兩個模擬器實例。一個作為通訊端伺服器，另一個作為通訊端用戶端。

在第一個模擬器中，啟動應用程式，然後選取對等的伺服器。選擇 [啟動]。此模擬器說明此示範要透過網路傳送和接收資料，並詢問「Is it OK to use network? (是否可以使用網路？)」 選擇「是」。通訊端伺服器會顯示螢幕，表示正在等待連線。

在第二個模擬器中啟動應用程式、選取對等的用戶端，然後選擇 [啟動]。此模擬器說明此示範要透過網路傳送和接收資料，並詢問「Is it OK to use network? (是否可以使用網路？)」 選擇「是」。通訊端用戶端會顯示螢幕，表示已連接到伺服器。使用下導覽箭頭反白顯示 [傳送] 方塊。在 [傳送] 方塊中鍵入訊息，然後選擇 [傳送] 軟鍵。

例如在用戶端的 [傳送] 方塊中鍵入 [Hello Server] (請參考圖 A-22)。選擇 [傳送] 軟鍵。傳送期間模擬器會啟動藍燈。

圖 A-22 從通訊端用戶端傳送訊息

在執行通訊端伺服器的模擬器上，狀態為： Message received - Hello Server (訊息已收到 － 您好，伺服器)。您可以使用向下箭頭移動到 [傳送] 方塊並鍵入回覆。例如，Hello Client, I heard you (您好，用戶端，我已收到您的訊息)。選取 [傳送]。請參閱圖 A-23。

圖 A-23 伺服器顯示已收到的訊息和要傳送的訊息

回到通訊端用戶端，狀態顯示伺服器傳送的訊息。在傳送新訊息之前，[傳送] 方塊內都會包含您之前傳送的訊息。

A.14.2 Datagram Demo

此示範類似 Socket Demo。

執行兩個模擬器實例。一個作為資料封包伺服器，另一個作為資料封包用戶端。

在第一個模擬器中，啟動 Datagram Demo，然後選取對等的伺服器。選擇 [啟動]。此模擬器說明此示範要透過網路傳送和接收資料，並詢問「Is it OK to use network? (是否可以使用網路？)」 選擇「是」。最初，資料封包伺服器狀態為 [等待連線]，並且 [傳送] 為空。

在第二個模擬器中，啟動 Datagram Demo，選取對等的用戶端，然後選擇 [啟動]。此模擬器說明此示範要透過網路傳送和接收資料，並詢問「Is it OK to use network? (是否可以使用網路？)」 選擇「是」。資料封包用戶端的狀態為： 已連線到伺服器。使用下導覽箭頭反白顯示 [傳送] 方塊。在 [傳送] 方塊中鍵入訊息，然後選擇 [傳送] 軟鍵。例如，鍵入 [Hello datagram server (您好，資料封包伺服器)]。

在執行資料封包伺服器的模擬器上，狀態顯示為： Message received - Hello datagram server (訊息已收到 － 您好，資料封包伺服器)。您可以使用下箭頭移動到 [傳送] 方塊並鍵入對用戶端的回覆。

資料封包用戶端的狀態欄位顯示已從伺服器收到的訊息。[傳送] 方塊包含您傳送的最後一條訊息。

---

A.15 ObexDemo

此應用程式會展示如何使用 OBEX API，在模擬器實例之間傳輸影像檔。此示範會展示透過模擬的紅外線連線使用 OBEX 的方式。

執行兩個模擬器實例。一個偵聽內送的連線，另一個則嘗試傳送影像。在第一個模擬器中，啟動應用程式後選擇 [Obex 示範]，然後選擇 [接收影像]。此模擬器說明 OBEX 連線允許其他裝置與您通話，並詢問「Is it OK to make the connection? (是否可以建立連線？)」 選擇「是」。偵聽程式模擬器會顯示螢幕，指出它正在等待內送的連線。

在第二個模擬器中 (寄件者)，啟動 [Obex 示範]，然後選擇 [傳送影像]。就會顯示影像清單。選取一個影像，並選擇 [傳送]。此模擬器說明示範要建立外送用戶端連線，並會詢問是否允許。選擇「是」。「傳送影像」公用程式會上傳影像。

在偵聽模擬器中，公用程式會顯示有關內送影像的資訊，並詢問「Would you like to receive it? (您是否願意接收？)」 請參閱圖 A-24。

圖 A-24 提示接受連線的偵聽程式

選擇「是」。選取的影像就會透過模擬的紅外線連結傳輸，顯示在第一個模擬器上。請參閱圖 A-25。

圖 A-25 成功傳輸影像

---

A.16 PDAPDemo

PDAPDemo 展示如何使用 PIM 與 FileConnection API (這是 JSR 75 規格的一部分)。

A.16.1 瀏覽檔案

如果您尚未完成此作業，若要執行檔案瀏覽器，將需要為 MIDlet 提供適當的安全授權。選擇 [編輯] > [偏好]。按一下 [安全性] 標籤。將 [安全網域] 變更為最大值，再按下 [確定]。

接著開啟並執行 PDAPDemo 專案。啟動 FileBrowser MIDlet。您會看到目錄清單，並瀏覽可用的目錄和檔案。預設狀況下有一個目錄 root1。

圖 A-26 瀏覽檔案

選取目錄，再按下 [選取] 按鈕以輸入該目錄。

圖 A-27 root1 目錄的內容

使用示範中的指令，您可以檢視檔案，或查看檔案特性。請嘗試選取檔案，並從功能表選擇 [特性] 或 [檢視]。

圖 A-28 檢視檔案內容和檔案特性

實際的檔案位於 workdir\appdb\DefaultColorPhone\filesystem (假設您使用的是 DefaultColorPhone 模擬器面板)。您可以隨意增加檔案與根目錄，就可以在 JSR 75 File API 中看到這些項目。如需詳細資訊，請參閱第 10 章。

A.16.2 PIM API

JSR75 PIM API 範例示範如何存取個人資訊，例如連絡人清單、行事曆與待辦事項清單。啟動範例之後，從主功能表選擇一種清單。

在這個應用程式範例中，每種清單的運作方式都一樣，而且每種清單類型都只包含一個清單。例如，如果選擇 [連絡人清單]，就只有一個 Contacts 連絡人清單。[事件清單] 只包含一個名為 Events 的清單，而 [待辦清單] 只包含一個名為 To do 的清單。

圖 A-29 選擇清單類型

選取清單類型，並選擇特定清單後，便可以檢視清單中的所有項目。如果這是您第一次執行本範例，清單可能是空的。

若要增加項目，請從功能表選擇 [新增]。應用程式會提示您輸入項目的格式化的名稱。您可以用功能表中的 [增加欄位] 將更多其他資料欄位增加到此項目。就會顯示欄位名稱清單。挑選一個欄位，然後輸入新欄位的值。

圖 A-30 增加連絡人欄位

若要儲存清單項目，請從功能表選擇 [確定] (選項 3)。

您可以選擇 [上一步] 指令，回到清單。剛建立的項目就會顯示在清單中。

您建立的項目會以標準 vCard 或 vCalendar 格式儲存在 workdir\appdb\skin\pim 目錄中。如需詳細資訊，請參閱第 10 章。

PIM API 允許匯出標準格式的連絡人、行事曆與待辦事項。確實的格式須視清單類型而定。當您檢視任何清單中的項目時，功能表會包含用於檢視匯出項目的指令。

例如，當您檢視連絡人清單項目時，功能表會包含 [顯示 vCard]。當您選擇此指令時，匯出的項目就會顯示在螢幕上。行事曆項目與待辦事項都會匯出為 vCalendar。

---

A.17 SATSADemos

SATSADemos 包含 SATSA (Security and Trust Services API) 的示範。大部分示範顯示如何與智慧卡通訊。模擬器可使用通訊端協定與模擬的智慧卡通訊。智慧卡模擬器 (cref) 包含在工具組中。如需詳細資訊，請參閱第 14 章。

以下各節中包含此示範的每個功能表選擇的說明。對於每個示範，在啟動模擬器之前一定要執行以下作業：

• 從指令行執行 cref 的實例。
• 一定要將安全網域設定為最大值。

A.17.1 APDUMIDlet

此 MIDlet 示範使用應用程式協定資料單元 (APDU；小的資料封包) 與智慧卡進行通訊。APDUMIDlet 需要找到兩個模擬的智慧卡。您可以使用 cref (Java Card Development Kit 的一部分) 執行智慧卡模擬器。

Mohair 應用程式包含預建立的記憶體影像，您可以將這些影像與 cref 配合使用。這些記憶體影像包含與 Mohair 相互作用的 Java Card 應用程式。這些記憶體影像位於 Mohair 專案的根目錄中。

在 Windows 上，依照如下方式啟動 cref 的兩個實例，分別對應每個模擬卡片槽 (假設目前的目錄為工具組安裝目錄)：

start bin\cref -p 9025 -i apps\SATSADemos\demo2.eeprom
start bin\cref -p 9026 -i apps\SATSADemos\demo2.eeprom

toolkit/bin/cref -p 9025 -i apps/SATSADemos/demo2.eeprom
toolkit/bin/cref -p 9026 -i apps/SATSADemos/demo2.eeprom

import javax.microedition.m2g.ScalableGraphics;
import javax.microedition.m2g.SVGImage;
 
...
String svgURI = ...;
SVGImage svgImage = (SVGImage) SVGImage.createImage(svgURI, null);
SVGAnimator svgAnimator = SVGAnimator.createAnimator(svgImage);
 
// If running a JSE applet, the target component is a JComponent.
JComponent svgAnimationComponent = (JComponent) svgAnimator.getTargetComponent();
...
 
svgAnimator.play();
...
svgAnimator.pause();
...
svgAnimator.stop();

Sun Java Wireless Toolkit for CLDC 使用者指南

Copyright © 2007, Sun Microsystems, Inc. 版權所有。