功能與 API 總覽

Android 12 為開發人員推出了強大的新功能和 API。以下各節可協助您瞭解應用程式功能，並開始使用相關的 API。

如需新增、修改及移除 API 的詳細清單，請參閱 API 差異比較表。如要進一步瞭解新的 API，請參閱 Android API 參考資料 - 新的 API 會醒目顯示，以利於查看。此外，如要瞭解平台變更可能對應用程式造成的影響，請務必查看指定 Android 12 的應用程式和所有應用程式的 Android 12 行為變更。

使用者體驗

Material You

Android 12 推出名為 Material You 的新設計語言，協助您建構更具個人特色、更精美的應用程式。如要將所有最新的 Material Design 3 更新內容導入應用程式，請試用 Material Design 元件的 Alpha 版。

Material You

小工具改善項目

Android 12 重新設計現有的小工具 API，改善平台和啟動器中的使用者和開發人員體驗。我們製作了一份指南，協助您確保小工具與 Android 12 相容，並使用新功能重新整理。

詳情請參閱「Android 12 小工具改善項目」。

插入多媒體內容

Android 12 推出新的統合式 API，可讓應用程式從任何可用來源接收多媒體內容，包括剪貼簿、鍵盤或拖曳。

詳情請參閱「接收多媒體內容」。

應用程式啟動畫面 API

Android 12 為所有應用程式推出新的應用程式啟動動畫，包括從啟動點開始的應用程式內動作、顯示應用程式圖示的啟動畫面，以及轉換至應用程式本身。詳情請參閱啟動畫面開發人員指南。

圓角 API

Android 12 推出 RoundedCorner 和 WindowInsets.getRoundedCorner(int position)，可提供圓角的半徑和中心點。

詳情請參閱「圓角」。

豐富的觸覺體驗

Android 12 擴充了工具，可為 UI 事件建立資訊豐富的觸覺回饋、為遊戲建立身歷其境且令人愉悅的效果，以及為提高工作效率建立注意力觸覺。

執行器效果

Android 12 新增了低滴答聲等表現效果，可充分利用最新致動器的更廣頻率頻寬。遊戲開發人員現在可以在遊戲控制器中獨立存取多個不同的致動器，同步提供相同的效果，或在多個致動器上提供不同的觸覺效果。對於開發人員，我們建議使用常數和基元做為豐富觸覺效果的建構區塊，常數用於增強 UI 事件，觸覺作曲器用於排序基元以獲得更複雜的效果。這些 API 可在 Pixel 4 裝置上試用，我們也持續與裝置製造商合作夥伴合作，為整個生態系統的使用者提供最新的觸覺回饋支援。

音訊結合觸覺效果

Android 12 應用程式可使用手機的震動器，產生音訊工作階段的觸覺回饋。這可提供更具沉浸感的遊戲和音訊體驗。舉例來說，觸覺強化鈴聲可協助識別來電者，或賽車遊戲可模擬崎嶇地形的感覺。

詳情請參閱 HapticGenerator 參考文件。

AppSearch

Android 12 推出 AppSearch，這是一種高效能的裝置端搜尋引擎，可做為系統服務。AppSearch 可讓應用程式為結構化資料建立索引，並透過內建的全文搜尋功能搜尋資料。此外，AppSearch 支援原生搜尋功能，例如高效率的索引和擷取、多語言支援和關聯性排名。

圖表：AppSearch 中的索引和搜尋

AppSearch 有兩種版本：一種是與舊版 Android 相容的應用程式本機索引，另一種是 Android 12 中為整個系統維護的中央索引。應用程式可使用中央索引，允許系統預先安裝的智慧元件在系統 UI 介面上顯示資料。系統 UI 介面顯示的確切資料取決於原始設備製造商 (OEM)。此外，應用程式可以安全地與其他應用程式共用資料，讓其他應用程式也能搜尋這些資料。

如要進一步瞭解 AppSearch，請參閱開發人員指南，並開始搭配使用 AppSearch Jetpack 程式庫，該程式庫提供適合開發人員使用的 API 介面，以及註解處理器支援。

遊戲模式

遊戲模式 API 和遊戲模式干預可讓您根據使用者設定或遊戲專屬設定，透過將特性 (例如效能或電池續航力等) 按優先順序排列來將遊戲玩法最佳化。

詳情請參閱「遊戲模式」。

子母畫面 (PiP) 建議和改善項目

Android 12 針對子母畫面模式推出下列改善項目：

支援新的子母畫面手勢

Android 12 現在支援子母畫面視窗的隱藏和雙指撥動縮放手勢：

  • 如要隱藏視窗，使用者可以將視窗拖曳到左側或右側邊緣。如要取消隱藏視窗，使用者可以輕觸隱藏視窗的可見部分，或將視窗拖曳出來。

  • 使用者現在可以使用雙指撥動方式進行縮放，調整子母畫面視窗的大小。

Android 12 在全螢幕和子母畫面視窗之間的動畫轉場效果方面，大幅改善了外觀。強烈建議您實作所有適用的變更；完成後，這些變更會自動調整為摺疊式裝置和平板電腦等大螢幕，不需再進行任何其他工作。

這些功能包括：

新的來電通知功能，可依重要性將來電排序

Android 12 為通話新增了 Notification.CallStyle 通知樣式。使用這個範本，應用程式就能在狀態列中顯示醒目的方塊，並在方塊中顯示通話時間，藉此指出進行中的通話有多重要；使用者只要輕觸這個方塊，就能返回通話。

由於來電和通話中的通知對使用者來說最重要，因此這些通知在通知欄中會排在最前面。系統也可能根據這項排名，將這些優先來電轉接至其他裝置。

請為所有類型的呼叫實作下列程式碼。

Kotlin

// Create a new call with the user as caller.
val incoming_caller = Person.Builder()
    .setName("Jane Doe")
    .setImportant(true)
    .build()

Java

// Create a new call with the user as caller.
Person incoming_caller = new Person.Builder()
    .setName("Jane Doe")
    .setImportant(true)
    .build();

使用 forIncomingCall() 為來電建立通話樣式通知。

Kotlin

// Create a call style notification for an incoming call.
val builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
         Notification.CallStyle.forIncomingCall(caller, declineIntent, answerIntent))
    .addPerson(incoming_caller)

Java

// Create a call style notification for an incoming call.
Notification.Builder builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
        Notification.CallStyle.forIncomingCall(caller, declineIntent, answerIntent))
    .addPerson(incoming_caller);

使用 forOngoingCall() 為進行中的通話建立通話樣式通知。

Kotlin

// Create a call style notification for an ongoing call.
val builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
         Notification.CallStyle.forOnGoingCall(caller, hangupIntent))
    .addPerson(second_caller)

Java

// Create a call style notification for an ongoing call.
Notification.Builder builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
        Notification.CallStyle.forOnGoingCall(caller, hangupIntent))
    .addPerson(second_caller);

使用 forScreeningCall() 建立通話樣式通知，用於過濾來電。

Kotlin

// Create a call style notification for screening a call.
val builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
         Notification.CallStyle.forScreeningCall(caller, hangupIntent, answerIntent))
    .addPerson(second_caller)

Java

Notification.Builder builder = Notification.Builder(context, CHANNEL_ID)
    .setContentIntent(contentIntent)
    .setSmallIcon(smallIcon)
    .setStyle(
        Notification.CallStyle.forScreeningCall(caller, hangupIntent, answerIntent))
    .addPerson(second_caller);

通知支援更豐富的圖片

在 Android 12 中，您現在可以在 MessagingStyle() 和 BigPictureStyle() 通知中提供動畫圖片，豐富應用程式的通知體驗。此外，應用程式現在可讓使用者在回覆通知欄中的訊息時，傳送圖片訊息。

改善手勢操作的沉浸模式

Android 12 整合了現有行為，讓使用者在沉浸模式下更容易執行手勢操作指令。此外，Android 12 還提供固定沉浸模式的回溯相容性行為。

分享最近使用的網址 (僅限 Pixel)

在 Pixel 裝置上，使用者現在可以直接從「最近」畫面分享最近查看的網路內容連結。使用者在應用程式中瀏覽內容後，可以滑動至「最近」畫面，找到瀏覽內容的應用程式，然後輕觸連結按鈕，複製或分享網址。

詳情請參閱「啟用最近使用的網址分享功能」。

安全性和隱私權

隱私資訊主頁

垂直時間軸會列出可存取位置資訊的應用程式，以及存取時間
圖 1.位置使用畫面是「隱私權資訊主頁」的一部分。

在支援 Android 12 或以上版本的裝置上，系統設定會顯示「隱私權資訊主頁」畫面。在這畫面，使用者可以透過個別存取其畫面，看到應用程式存取位置、相機和麥克風的資訊。每個畫面都會顯示不同應用程式各自存取特定類型資料的時間軸。圖 1 顯示位置資訊的資料存取時間軸。

您的應用程式可以為使用者提供基本理由，協助他們瞭解應用程式存取位置、相機或麥克風資訊的原因。原因可能會顯示在新版「隱私資訊主頁」畫面、應用程式的權限頁面，或是兩處一併顯示。

藍牙權限

Android 12 推出 BLUETOOTH_SCAN、BLUETOOTH_ADVERTISE 和 BLUETOOTH_CONNECT 權限。這些權限可讓指定 Android 12 的應用程式更輕鬆地與藍牙裝置互動，尤其是無需存取裝置位置資訊的應用程式。

更新應用程式的藍牙權限聲明

如要讓裝置指定 Android 12 以上版本，請更新應用程式的邏輯。請宣告較新的藍牙權限組合，而非舊版藍牙權限組合。

權限群組查詢

在 Android 12 以上版本中，您可以查詢系統如何將平台提供的權限歸入權限群組：

隱藏應用程式疊加視窗

為了讓開發人員進一步控管使用者與開發人員應用程式互動時看到的內容，Android 12 導入了隱藏由具有 SYSTEM_ALERT_WINDOW 權限的應用程式繪製的疊加視窗的功能。

宣告 HIDE_OVERLAY_WINDOWS 權限後，應用程式可以呼叫 setHideOverlayWindows()，指出當應用程式本身的視窗可見時，應隱藏所有 TYPE_APPLICATION_OVERLAY 類型的視窗。應用程式在顯示交易確認流程等機密畫面時，可能會選擇這麼做。

如果應用程式會顯示 TYPE_APPLICATION_OVERLAY 類型的視窗，請考慮採用更適合其用途的替代方案，例如子母畫面或對話框。

已知簽署者權限保護標記

從 Android 12 開始，您可以在宣告時期利用簽章層級權限的 knownCerts 屬性，指定已知的簽署憑證的摘要。

應用程式可以宣告這項屬性，並使用 knownSigner 旗標，允許裝置和應用程式將簽章權限授予其他應用程式，而不需在裝置製造和出貨時就簽署該應用程式。

裝置屬性認證

Android 12 擴充了可驗證認證憑證中裝置屬性的應用程式組合，以便這些應用程式產生新金鑰。

自 Android 9 (API 級別 28) 起，使用 Keymaster 4.0 以上版本的裝置政策擁有者 (DPO) 可以驗證這些認證憑證中的裝置屬性。自 Android 12 起，凡是指定 Android 12 (API 級別 31) 以上版本的應用程式，都可以使用 setDevicePropertiesAttestationIncluded() 方法執行這項驗證。

產生的裝置屬性包含下列 Build 欄位：

  • BRAND
  • DEVICE
  • MANUFACTURER
  • MODEL
  • PRODUCT

安全的螢幕鎖定畫面通知動作

從 Android 12 開始，Notification.Action.Builder 類別支援 setAuthenticationRequired() 方法，可讓應用程式要求裝置必須先解鎖，才能叫用特定通知動作。這個方法可為已鎖定裝置上的通知增添進階安全保障。

BiometricPrompt 的可本地化字串

Android 12 導入新的 API，可協助您改善應用程式的生物辨識驗證使用者體驗。新的 BiometricManager.Strings 巢狀類別包含 getButtonLabel()、getPromptMessage() 和 getSettingName() 方法，可讓應用程式擷取使用者可讀取的本地化按鈕標籤、提示訊息或應用程式設定名稱。您可以使用這些標籤，根據所用的生物辨識驗證方式，建立更精確的面向使用者操作說明，例如「使用人臉解鎖」或「使用指紋繼續操作」。

媒體

相容媒體轉碼

自 Android 12 (API 級別 31) 起，系統會自動將裝置上錄製的 HEVC(H.265) 和 HDR (HDR10 和 HDR10+) 影片轉碼為 AVC (H.264)，這種格式與標準播放器廣泛相容。這項功能可充分運用新式轉碼器 (如有)，同時兼顧與舊版應用程式的相容性。

詳情請參閱「相容媒體轉碼」。

效能類別

Android 12 推出名為「效能類別」的標準。效能類別會指定超出 Android 基準要求的硬體功能。由於每部 Android 裝置都會聲明自身支援的效能類別，開發人員可以在執行階段查看裝置的效能類別，並提供能充分利用裝置功能的進階體驗。

詳情請參閱「效能等級」。

影片編碼改善

Android 12 定義了一組標準金鑰，用於控制影片編碼的量化參數 (QP) 值，讓開發人員可以避免使用供應商專屬程式碼。

新金鑰可在 MediaFormat API 和 NDK 媒體庫中使用。

從 Android 12 開始，影片編碼器會強制執行最低品質門檻。這樣一來，使用者在編碼場景複雜度高的影片時，就不會遇到畫質極低的問題。

音訊焦點

自 Android 12 (API 級別 31) 起，如果應用程式在另一個應用程式取得焦點並播放時要求音訊焦點，系統會淡出播放中的應用程式。

詳情請參閱「Android 12 以上版本的音訊焦點」。

MediaDrm 更新

如要判斷目前的 MediaDrm API 是否需要安全解碼器元件，請按照下列步驟操作：

  1. 建立 MediaDrm。
  2. 開啟工作階段，取得工作階段 ID。
  3. 使用工作階段 ID 建立 MediaCrypto。
  4. 呼叫 MediaCrypto.requiresSecureDecoderComponent(mimeType)。

使用新方法 requiresSecureDecoder(@NonNull String mime) 和 requiresSecureDecoder(@NonNull String mime, @SecurityLevel int level)，您可以在建立 MediaDrm 後立即判斷。

相機

Camera2 供應商擴充功能

許多裝置製造商合作夥伴都建構了自訂相機擴充功能 (例如散景、HDR、夜間模式等)，希望應用程式能使用這些功能，在裝置上打造差異化體驗。CameraX 程式庫已支援這些自訂供應商擴充功能。在 Android 12 中，這些供應商擴充功能現在會直接在平台中公開。

這項新增功能可協助具有複雜 Camera2 實作的應用程式，充分利用供應商擴充功能，而不必對舊版程式碼進行重大變更。Camera2 擴充功能 API 提供的擴充功能組合與 CameraX 完全相同，且許多不同裝置都已支援這些功能，因此您不需進行任何額外設定即可使用。

詳情請參閱 CameraExtensionCharacteristics。

支援 Quad Bayer 相機感應器

現今許多 Android 裝置都配備超高解析度相機感應器，通常採用 Quad 或 Nona Bayer 模式，在影像品質和低光源效能方面提供極大的彈性。Android 12 推出新的平台 API，可讓第三方應用程式充分運用這些多功能感應器。新版 API 支援這些感應器的獨特行為，並考量到在全解析度或「最高解析度」模式與「預設」模式下運作時，這些感應器可能支援不同的串流設定和組合。

圖形和圖片

允許應用程式直接存取空值標記追蹤記錄

從 Android 12 開始，您可以透過 ApplicationExitInfo.getTraceInputStream() 方法，以通訊協定緩衝區形式存取應用程式的原生程式碼發生錯誤空值標記。通訊協定緩衝區使用這個結構定義進行序列化。 在此之前，您只能透過 Android Debug Bridge (ADB) 存取這項資訊。

詳情請參閱「允許應用程式直接存取空值標記追蹤記錄」

支援 AVIF 圖片

Android 12 支援使用 AV1 圖片檔案格式 (AVIF) 的圖片。AVIF 是一種容器格式，適用於使用 AV1 圖片編碼的圖片和序列。AVIF 會利用影片壓縮的影格內編碼內容。與 JPEG 等舊版圖片格式相比，這種方式可以大幅提高相同檔案大小的圖片品質。如要深入瞭解這種格式的優勢，請參閱 Jake Archibald 的網誌文章。

更輕鬆地套用模糊、色彩濾鏡和其他效果

Android 12 新增了 RenderEffect，可將常見的圖形效果 (例如模糊、色彩濾鏡、Android 著色器效果等) 套用至 View 和算繪階層。效果可以組合成鏈結效果 (由內部和外部效果組成) 或混合效果。由於處理能力有限，不同的 Android 裝置不一定支援這項功能。

您也可以呼叫 View.setRenderEffect(RenderEffect)，將效果套用至 View 的基礎 RenderNode。

如要實作 RenderEffect，請按照下列步驟操作：

view.setRenderEffect(RenderEffect.createBlurEffect(radiusX, radiusY, SHADER_TILE_MODE))

原生動畫圖片解碼

在 Android 12 中，NDK ImageDecoder API 已擴展功能，可從 GIF 動畫和動態 WebP 檔案格式的圖片解碼所有影格和時間資料。在 Android 11 中推出時，此 API 只會對這些格式動畫的第一個圖片進行解碼。

請使用 ImageDecoder 而非第三方程式庫，進一步減少 APK 大小，且方便進行日後的安全性和效能相關更新。

如要進一步瞭解 API，請參閱 API 參考資料和 GitHub 範例。

連線能力

讓隨附應用程式保持運作

為支援隨附應用程式持續執行以管理裝置的需求，Android 12 推出可執行下列操作的 API：

  • 在配對裝置位於範圍內時喚醒應用程式。
  • 保證在裝置保持在範圍內時，程序會繼續執行。

如要使用 API，裝置必須透過隨附裝置管理工具連線。詳情請參閱 CompanionDeviceManager.startObservingDevicePresence() 和 CompanionDeviceService.onDeviceAppeared()。

隨附裝置管理工具設定檔

使用配對裝置設定檔，在單次要求內要求多項權限的權限對話方塊。

Android 12 (API 級別 31) 以上版本的配對應用程式可在與手錶連線後，使用配對裝置的設定檔。透過使用設定檔，應用程式能夠整合多種裝置類型專用權限的授予程序，只要一個步驟就能處理完畢，可簡化註冊流程。

連線到裝置時，系統便會授予這些隨附應用程式整合的權限，並只在裝置連線期間有效。刪除應用程式或移除關聯後，系統會一併移除權限。

詳情請參閱 AssociationRequest.Builder.setDeviceProfile()。

頻寬估算功能改善

在 Android 12 中，getLinkDownstreamBandwidthKbps() 和 getLinkUpstreamBandwidthKbps() 提供的頻寬估算功能，在 Wi-Fi 和行動網路連線方面都有所改善。現在傳回的值代表使用者在裝置上所有應用程式中，每個電信業者或 Wi-Fi SSID、網路類型和訊號等級的歷來加權平均處理量。相較於其他處理量估算方法，這種方法可傳回更準確、更符合實際情況的預期處理量估算值、提供應用程式冷啟動的估算值，且所需的週期較少。

Wi-Fi Aware (NAN) 強化功能

Android 12 對 Wi-Fi Aware 進行了一些強化：

  • 在搭載 Android 12 (API 級別 31) 以上版本的裝置上，您可以使用 onServiceLost() 回呼，在應用程式因服務停止或超出範圍而遺失探索到的服務時收到通知。
  • 多個資料路徑 (NAN 資料路徑) 的設定方式將有所變更，以提高效率。早期版本使用 L2 訊息交換發起者的對等互連資訊，因此會造成延遲。在搭載 Android 12 以上版本的裝置上，回應端 (伺服器) 可設為接受任何對等互連，也就是說，不必預先知道發起端資訊。這可加快資料路徑啟動速度，並透過單一網路要求啟用多個點對點連結。
  • 在搭載 Android 12 以上版本的裝置上，您可以呼叫 WifiAwareManager.getAvailableAwareResources()，防止架構因資源不足而拒絕探索或連線要求。這個方法的傳回值可讓您取得可用資料路徑數量、可用發布工作階段數量，以及可用訂閱工作階段數量。

同時進行點對點 + 網際網路連線

如果裝置指定 Android 12 (API 級別 31) 以上版本，且在支援硬體的裝置上執行，則使用點對點連線建立與對等互連裝置的連線時，不會中斷現有的 Wi-Fi 連線。如要檢查是否支援這項功能，請使用 WifiManager.isMultiStaConcurrencySupported()。

啟用螢幕關閉時進行 NFC 付款

在指定 Android 12 以上版本的應用程式中，您可以將 requireDeviceScreenOn 設為 false，在裝置螢幕未開啟時啟用 NFC 付款功能。如要進一步瞭解如何在螢幕關閉或鎖定時進行 NFC 付款，請參閱「螢幕關閉和螢幕鎖定行為」。

儲存空間

Android 12 推出下列儲存空間管理功能：

核心功能

自動應用程式更新

Android 12 為使用 PackageInstaller API 的應用程式導入 setRequireUserAction() 方法。這個方法可讓安裝程式應用程式執行應用程式更新，使用者不必確認動作。

裝置晶片組資訊

Android 12 在 android.os.Build 中新增兩個常數，可透過 SDK 公開 SoC 晶片組供應商和型號資訊。您可以分別呼叫 Build.SOC_MANUFACTURER 和 Build.SOC_MODEL 來擷取這項資訊。

核心 Java API 更新

根據開發人員的要求和協作，我們在 Android 12 中新增了下列核心程式庫：

Class API
java.lang.Deprecated
java.lang.Byte
java.lang.Short
java.lang.Math
java.lang.StrictMath
java.util.Set copyOf()
java.util.Map copyOf()
java.util.List copyOf()
java.time.Duration
java.time.LocalTime