Android 2.3.3 API

API 級別: 10

Android 2.3.3 (GINGERBREAD_MR1) 是一個小型功能版本,為 Android 2.3 平台新增多項改善項目和 API。

對開發人員來說,Android 2.3.3 平台是 Android SDK 的可下載元件。可下載的平台包含 Android 程式庫和系統映像檔,以及一組模擬器外觀等。如要開始開發或測試 Android 2.3.3 版,請使用 Android SDK Manager 將該平台下載到您的 SDK。

API 總覽

以下各節提供 2.3.3 版開發人員新功能的技術總覽,包括自上個版本以來,架構 API 的新功能和異動。

近距離無線通訊 (NFC)

Android 2.3.3 提供改善和擴充的 NFC 支援,讓應用程式以新的方式與更多類型的標記互動。

全新的一組功能完善的 API 可讓應用程式讀取及寫入更多種標準代碼技術,包括:

  • NFC-A (ISO 14443-3A)
  • NFC-B (ISO 14443-3B)
  • NFC-F (JIS 6319-4)
  • NFC-V (ISO 15693)
  • ISO-DEP (ISO 14443-4)
  • MIFARE 經典
  • MIFARE 超輕
  • NFC 論壇 NDEF 標記

平台也提供有限的點對點通訊通訊協定和 API。前景活動可利用這個 API 註冊 NDEF 訊息,並在連線時推送至其他 NFC 裝置。

進階標記分派功能現在可讓應用程式進一步控制偵測到 NFC 標記時應用程式的啟動方式和時機。過去,平台使用單一步驟調派功能,在發現標記時通知感興趣的應用程式。平台現在採用四個步驟的程序,讓前景應用程式先控制代碼事件,再將其傳送至其他應用程式 (android.nfc.NfcAdapter.enableForegroundDispatch())。 新的分派程序還能讓應用程式根據兩個新意圖動作 (android.nfc.action.NDEF_DISCOVEREDandroid.nfc.action.TECH_DISCOVERED) 監聽特定標記內容和標記技術。

NFC API 位於 android.nfcandroid.nfc.tech 套件。主要類別如下:

  • NfcAdapter,代表裝置上的 NFC 硬體。
  • NdefMessage:代表 NDEF 資料訊息,這是指在裝置和標記之間傳輸資料的「記錄」標準格式。NDEF 訊息指的是多種不同類型的 NDEF 記錄。應用程式可以從 NDEF_DISCOVEREDTECH_DISCOVEREDTAG_DISCOVERED Intent 接收這些訊息。
  • NdefMessage 傳送 NdefRecord,用於說明共用的資料類型並處理資料本身。
  • Tag,代表裝置掃描的標記。視基礎代碼技術而定,系統支援多種類型的代碼。
  • TagTechnology 這個介面,可讓應用程式根據標記中的技術,存取標記屬性和 I/O 作業。如需 Android 2.3.3 支援的標記技術完整清單,請參閱 android.nfc.tech

NFC 通訊仰賴裝置硬體的無線技術,但並非所有 Android 裝置都存在。不支援 NFC 的 Android 裝置會在呼叫 getDefaultAdapter(Context) 時傳回空值物件,而 context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_NFC) 會傳回 false。但無論基礎硬體支援為何,NFC API 一律為可見。

如要使用 NFC API,應用程式必須在資訊清單檔案中宣告 <uses-permission android:name="android.permission.NFC">,向使用者要求權限。

此外,開發人員可以要求在 Google Play 進行篩選,如果裝置不支援 NFC,使用者就無法找到他們的應用程式。如要提出篩選要求,請在應用程式的資訊清單中加入 <uses-feature android:name="android.hardware.nfc" android:required="true">

詳情請參閱「NFC」開發人員指南。

藍牙

Android 2.3.3 版新增了藍牙非安全通訊端連線的平台和 API 支援。如此一來,應用程式就能與未提供驗證用 UI 的簡易裝置進行通訊。詳情請參閱 createInsecureRfcommSocketToServiceRecord(java.util.UUID)listenUsingInsecureRfcommWithServiceRecord(java.lang.String, java.util.UUID)

圖像

  • 新的 BitmapRegionDecoder 類別可讓應用程式將圖片中的矩形區域解碼。當原始圖片較大,且應用程式只需要圖片的部分時,這個 API 特別實用。
  • BitmapFactory.Options 中的新 inPreferQualityOverSpeed 欄位可讓應用程式在 JPEG 解碼中使用更準確但稍慢的 IDCT 方法。進而改善重建圖片的品質。

媒體架構

語音辨識

Speech-recognition API 提供新的常數,可讓您以新方式管理語音搜尋結果。雖然一般使用語音辨識時不需要使用新的常數,但您可以使用常數,在應用程式中提供不同的語音搜尋結果檢視畫面。詳情請參閱 RecognizerResultsIntent

API 級別

Android 2.3.3 平台提供新版架構 API。Android 2.3.3 API 會指派一個儲存在系統本身中的整數 ID (10)。這個 ID 稱為「API 級別」,可讓系統在安裝應用程式前,正確判斷應用程式是否與系統相容。

如要在應用程式中使用 Android 2.3.3 版中導入的 API,您必須針對 Android 2.3.3 SDK 平台提供的 Android 程式庫編譯應用程式。視您的需求而定,您可能也需要在應用程式資訊清單的 <uses-sdk> 元素中加入 android:minSdkVersion="10" 屬性。如果您的應用程式專為 Android 2.3 以上版本執行,宣告這個屬性可避免舊版平台安裝應用程式。

詳情請參閱什麼是 API 級別?