擷取筆記內容

從 Android 14 開始,使用者可以透過「擷取記事內容」API,直接透過預設記事應用程式擷取螢幕截圖。有了這些 API,使用者就能擷取螢幕上的偏好內容並貼到記事中,享受多工記事體驗。

Capture Content for Notes API 專為具有 NOTES 角色的應用程式設計。Android 14 會使用 LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE 權限,確保只有 NOTES 角色持有者應用程式可以使用 Capture Content for Notes API。應用程式必須先檢查是否具備權限,才能呼叫 API。OEM 可以啟用 NOTES 角色,讓使用者設定預設的記事應用程式。

如要進一步瞭解 Capture Content for Notes API,請參閱下列內容:

OEM 自訂「擷取內容到『記事』」功能

使用者可以透過NOTES角色選取符合資格的記事應用程式,做為預設記事應用程式。原始設備製造商可以設定 config_enableDefaultNotes,控管裝置上NOTES角色的可用性。config_enableDefaultNotes 的值預設為 false

如果啟用 NOTES 角色,OEM 必須支援「記事」API 的擷取內容功能,並提供必要的自訂項目和系統記事整合功能。原始設備製造商 (OEM) 可以選擇自訂預設 AOSP 實作,或透過覆寫 config_screenshotAppClipsServiceComponentconfig_screenshotAppClipsActivityComponent 提供實作。如要瞭解預設系統記事整合的實作方式,請參閱 notetask 套件。

如要實作 Capture Content for Notes API,必須變更系統 UI。原始設備製造商可以自訂 UI,觸發及編輯螢幕截圖,並在 Android 系統 UI 中提供實作項目。舉例來說,系統 UI 可使用螢幕鎖定捷徑 (例如螢幕鎖定畫面上的按鈕或圖示,或是以觸控筆為基礎的手勢),在螢幕鎖定畫面上啟動 NOTES 角色持有者應用程式。同樣地,在主畫面上,系統 UI 可以透過觸控筆手勢,在多工視窗模式 (例如泡泡視窗或浮動視窗) 中啟動 NOTES 角色持有者應用程式。

驗證記事的擷取內容

如要進行 CTS-Verifier 測試,請參閱「擷取內容以進行 Notes 測試」。