Capture Content for Notes

从 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,请参阅以下内容:

适用于 Capture Content for Notes 的 OEM 自定义

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

如果 NOTES 角色处于启用状态,OEM 必须提供必要的自定义设置和系统记事集成,才能支持 Capture Content for Notes API。OEM 可以选择自定义默认 AOSP 实现或者通过替换 config_screenshotAppClipsServiceComponentconfig_screenshotAppClipsActivityComponent 提供实现。如需了解默认的系统记事集成实现,请参阅 notetask 软件包。

要实现 Capture Content for Notes API,需要对系统界面进行更改。OEM 可以自定义界面以触发和修改屏幕截图,并在 Android 系统界面中提供实现。作为 OEM 自定义集成的示例,系统界面可以使用锁定屏幕快捷方式(例如锁定屏幕上的按钮或图标或基于触控笔的手势)在锁定屏幕上启动 NOTES 角色持有者应用。同样,在主屏幕上,系统界面可以通过基于触控笔的手势,在多任务窗口模式(例如气泡窗口或浮动窗口)下启动 NOTES 角色持有者应用。

Capture Content for Notes 的验证

如需了解 CTS 验证程序测试的相关信息,请参阅 Capture Content for Notes 测试