從 Android 14 開始,Capture Content for Notes API 允許使用者直接透過預設筆記應用程式擷取螢幕截圖。借助這些 API,用戶可以透過在螢幕上剪下首選內容並將其貼上到筆記中來獲得多任務筆記體驗。
擷取 Notes 內容 API 是專為擔任NOTES
角色的應用程式而設計的。 Android 14 使用LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE
權限來確保只有NOTES
角色持有者應用程式才能使用 Capture Content for Notes API。應用程式在呼叫API之前必須檢查自己是否有權限。 OEM 可讓使用者透過啟用NOTES
角色來設定預設的筆記應用程式。
有關 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 系統 UI 中提供實作。作為 OEM 自訂整合的範例,系統 UI 可以使用鎖定螢幕捷徑(例如鎖定螢幕上的按鈕或圖示或基於手寫筆的手勢)在鎖定螢幕上啟動NOTES
角色持有者應用程式。同樣,在主螢幕上,系統 UI 可以透過基於手寫筆的手勢以多任務視窗模式(例如氣泡視窗或浮動視窗)啟動NOTES
角色持有者應用程式。
驗證筆記擷取內容
有關 CTS-Verifier 測試,請參閱擷取 Notes 內容測試。