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，请参阅以下内容：

• Intent#ACTION_LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE

• Intent#EXTRA_CAPTURE_CONTENT_FOR_NOTE_STATUS_CODE

• android.permission.LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE

• StatusBarManager#canLaunchCaptureContentActivityForNote

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

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

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

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

Capture Content for Notes 的验证

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