笔记内容捕获

从 Android 14 开始,“笔记内容捕获”API 让用户可以直接通过默认的记事应用捕获屏幕截图。借助这些 API,用户可以通过剪辑屏幕上的首选内容并将其粘贴到笔记中,从而获得多任务记笔记体验。

“笔记内容捕获”API 专为持有 NOTES 角色的应用而设计。Android 14 使用 LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE 权限来确保只有 NOTES 角色持有者应用才能使用“笔记内容捕获”API。应用必须在调用 API 之前检查它们是否具有该权限。OEM 可以通过启用 NOTES 角色来让用户设置其默认记事应用。

请参阅以下内容,详细了解“笔记内容捕获”API

“笔记内容捕获”的 OEM 自定义

NOTES 角色允许用户选择符合条件的记事应用作为默认记事应用。OEM 可以通过设置 config_enableDefaultNotes 来控制设备上 NOTES 角色的可用性。config_enableDefaultNotes 的值默认设置为 false

如果启用了 NOTES 角色,OEM 必须通过提供必要的自定义项和系统记事集成来支持“笔记内容捕获”API。OEM 可以选择自定义 默认 AOSP 实现,或者通过替换 config_screenshotAppClipsServiceComponentconfig_screenshotAppClipsActivityComponent 来提供其实现。请参阅 notetask 软件包,了解默认系统记事集成实现的示例。

在 System UI 中需要进行更改才能实现“笔记内容捕获”API。OEM 可以自定义 UI 以触发和编辑屏幕截图,并在 Android System UI 中提供实现。作为 OEM 自定义集成的示例,System UI 可以使用锁屏快捷方式(例如锁屏上的按钮或图标或基于触控笔的手势)在锁屏上启动 NOTES 角色持有者应用。同样,在主屏幕上,System UI 可以通过基于触控笔的手势,在多任务窗口模式(例如气泡窗口或浮动窗口)中启动 NOTES 角色持有者应用。

“笔记内容捕获”的验证

对于 CTS-Verifier 测试,请参阅“笔记内容捕获”测试