Как добавлять контент в заметки

Начиная с Android 14, API Capture Content for Notes позволяют пользователям делать скриншоты прямо в приложении для заметок по умолчанию. С помощью этих API пользователи могут делать заметки в режиме многозадачности, вырезая нужный контент на экране и вставляя его в заметку.

API для захвата контента для заметок предназначены специально для приложений с ролью NOTES. В Android 14 используется разрешение LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE, чтобы гарантировать, что только приложения с ролью NOTES могут использовать API Capture Content for Notes. Перед вызовом API приложения должны проверять, есть ли у них разрешение. OEM-производители могут разрешить пользователям выбирать приложение для заметок по умолчанию, включив роль NOTES.

Дополнительную информацию об API Capture Content for Notes можно найти в следующих источниках:

Настройка OEM для функции "Запись контента для заметок"

Роль NOTES позволяет пользователям выбрать подходящее приложение для заметок в качестве приложения по умолчанию. OEM может контролировать доступность роли NOTES на устройстве, задав значение config_enableDefaultNotes. По умолчанию для правила config_enableDefaultNotes задано значение false.

Если роль NOTES включена, OEM-производитель должен поддерживать API Capture Content for Notes, предоставив необходимые настройки и системные интеграции для ведения заметок. Производители устройств могут настроить реализацию AOSP по умолчанию или предоставить собственную реализацию, переопределив config_screenshotAppClipsServiceComponent или config_screenshotAppClipsActivityComponent. Информацию о реализации интеграции систем для заметок по умолчанию можно найти в пакете notetask.

Чтобы реализовать API для сохранения контента в заметках, нужно внести изменения в интерфейс системы. Производители устройств могут настроить интерфейс, чтобы запускать и редактировать скриншоты, а также реализовать эту функцию в системном интерфейсе Android. Например, интерфейс системы может запустить приложение с ролью NOTES на заблокированном экране с помощью ярлыка, такого как кнопка или значок на заблокированном экране или жест стилусом. Аналогичным образом на главном экране системный интерфейс может запустить приложение, выполняющее роль NOTES, в многозадачном режиме, например в плавающем окне, с помощью жеста стилусом.

Проверка контента, захваченного с помощью функции "Заметки"

Информацию о тестировании CTS-Verifier можно найти в статье Как записать контент для теста "Заметки".