功能與 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 重新設計現有的 Widgets 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 事件，觸覺效果作曲家則可排序基本型別，產生更複雜的效果。您可以在 Pixel 4 裝置上試用這些 API，我們也會持續與裝置製造商合作夥伴攜手，為整個生態系統的使用者提供最新的觸覺支援。

音訊耦合觸覺效果

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() 方法，可讓應用程式擷取使用者可讀取的本地化按鈕標籤、提示訊息或應用程式設定名稱。使用這些標籤建立更精確的使用者操作說明，具體說明所用的生物辨識驗證方法，例如「使用臉部解鎖」或「使用指紋繼續操作」。

在訊息應用程式中偵測網路釣魚 (僅限 Pixel)

偵測到可疑訊息時，使用者會看到類似下方的訊息。

在支援的 Pixel 裝置上，Android 12 會對熱門訊息應用程式收到的訊息執行網路釣魚偵測。系統會使用裝置端機器學習技術偵測可疑活動。偵測到這類內容時，系統會在訊息應用程式的 UI 上方顯示安全疊加畫面，提醒使用者。舉例來說，網路釣魚偵測功能可針對下列潛在風險向使用者發出警告：

  • 可疑要求，例如要求傳送驗證碼、匯款或類似要求
  • 不受信任的網址
  • 惡意附件
  • 惡意應用程式的連結

除了警告使用者，疊加畫面也允許使用者檢舉可疑郵件，並針對系統發出的警告提供意見回饋。

開發人員可以在應用程式資訊清單檔案中加入新的中繼資料標記 (包括字串 com.google.android.ALLOW_PHISHING_DETECTION)，選擇停用這項功能。例如：

<manifest>
    <application android:name="com.messagingapp">
        <meta-data android:name="com.google.android.ALLOW_PHISHING_DETECTION" android:value="false" />

    </application>
</manifest>

媒體

相容媒體轉碼

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

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

效能類別

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

詳情請參閱「效能類別」。

改善影片編碼

Android 12 定義了一組標準鍵，用於控制影片編碼的量化參數 (QP) 值，讓開發人員不必使用特定供應商的程式碼。

新金鑰適用於 MediaFormat API 和 NDK Media 程式庫。

自 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 Extension 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)，將效果套用至基礎 RenderNode 。View

如要導入 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 中，Wi-Fi 和行動網路連線的頻寬估算功能都有所提升，這些功能是由 getLinkDownstreamBandwidthKbps() 和 getLinkUpstreamBandwidthKbps() 提供。現在傳回的值代表使用者在裝置上所有應用程式中，每個電信業者或 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 中新增了下列核心程式庫：

課程 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