從 Android 14 開始,Capture Content for Notes 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
角色可讓使用者選取符合資格的記事應用程式,做為預設的記事應用程式。原始設備製造商 (OEM) 可以設定 config_enableDefaultNotes
,控制裝置上 NOTES
角色的可用性。config_enableDefaultNotes
的值預設為 false
。
如果已啟用 NOTES
角色,OEM 必須提供必要的客製化功能和系統筆記整合,以支援「Capture Content for Notes」API。原始設備製造商 (OEM) 可以選擇自訂預設 AOSP 實作,或透過覆寫 config_screenshotAppClipsServiceComponent
或 config_screenshotAppClipsActivityComponent
提供實作項目。如需預設系統記事整合功能的實作方式,請參閱 notetask
套件。
系統 UI 必須變更,實作 Notes API 的擷取內容。原始設備製造商 (OEM) 可以自訂 UI,以觸發及編輯螢幕截圖,並在 Android 系統使用者介面中提供實作方式。以下是原始設備製造商 (OEM) 自訂整合的範例:系統 UI 可使用螢幕鎖定畫面捷徑 (例如螢幕鎖定畫面上的按鈕或圖示,或是以觸控筆為基礎的手勢),在螢幕鎖定畫面上啟動 NOTES
角色代管應用程式。同樣地,在主畫面上,系統 UI 可透過觸控筆手勢,在多工作視窗模式 (例如氣泡視窗或浮動視窗) 中啟動 NOTES
角色代管應用程式。
驗證筆記的擷取內容
如要進行 CTS 驗證器測試,請參閱「Capture Content for Notes test」。