擷取記事內容

從 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_screenshotAppClipsServiceComponentconfig_screenshotAppClipsActivityComponent 提供實作項目。如需預設系統記事整合功能的實作方式,請參閱 notetask 套件。

系統 UI 必須變更,實作 Notes API 的擷取內容。原始設備製造商 (OEM) 可以自訂 UI,以觸發及編輯螢幕截圖,並在 Android 系統使用者介面中提供實作方式。以下是原始設備製造商 (OEM) 自訂整合的範例:系統 UI 可使用螢幕鎖定畫面捷徑 (例如螢幕鎖定畫面上的按鈕或圖示,或是以觸控筆為基礎的手勢),在螢幕鎖定畫面上啟動 NOTES 角色代管應用程式。同樣地,在主畫面上,系統 UI 可透過觸控筆手勢,在多工作視窗模式 (例如氣泡視窗或浮動視窗) 中啟動 NOTES 角色代管應用程式。

驗證筆記的擷取內容

如要進行 CTS 驗證器測試,請參閱「Capture Content for Notes test」。