從 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_screenshotAppClipsServiceComponent
或 config_screenshotAppClipsActivityComponent
提供實作。如要瞭解預設系統記事整合的實作方式,請參閱 notetask
套件。
如要實作 Capture Content for Notes API,必須變更系統 UI。原始設備製造商可以自訂 UI,觸發及編輯螢幕截圖,並在 Android 系統 UI 中提供實作項目。舉例來說,系統 UI 可使用螢幕鎖定捷徑 (例如螢幕鎖定畫面上的按鈕或圖示,或是以觸控筆為基礎的手勢),在螢幕鎖定畫面上啟動 NOTES
角色持有者應用程式。同樣地,在主畫面上,系統 UI 可以透過觸控筆手勢,在多工視窗模式 (例如泡泡視窗或浮動視窗) 中啟動 NOTES
角色持有者應用程式。
驗證記事的擷取內容
如要進行 CTS-Verifier 測試,請參閱「擷取內容以進行 Notes 測試」。