Ghi lại nội dung để ghi chú

Kể từ Android 14, API Ghi lại nội dung cho ghi chú cho phép người dùng chụp ảnh màn hình ngay trong ứng dụng ghi chú mặc định. Với các API này, người dùng có thể ghi chú đa nhiệm bằng cách cắt nội dung ưu tiên trên màn hình và dán nội dung đó vào ghi chú.

API Ghi lại nội dung cho ghi chú được thiết kế dành riêng cho các ứng dụng có vai trò NOTES. Android 14 sử dụng quyền LAUNCH_CAPTURE_CONTENT_ACTIVITY_FOR_NOTE để đảm bảo rằng chỉ các ứng dụng của chủ sở hữu vai trò NOTES mới có thể sử dụng API Ghi chú để chụp nội dung. Các ứng dụng phải kiểm tra xem có quyền hay không trước khi gọi API. Nhà sản xuất thiết bị gốc (OEM) có thể cho phép người dùng đặt ứng dụng ghi chú mặc định bằng cách bật vai trò NOTES.

Hãy xem các bài viết sau để biết thêm thông tin về các API Ghi lại nội dung:

Tuỳ chỉnh OEM khi ghi lại nội dung cho ghi chú

Vai trò NOTES cho phép người dùng chọn một ứng dụng ghi chú đủ điều kiện làm ứng dụng ghi chú mặc định. Nhà sản xuất thiết bị gốc (OEM) có thể kiểm soát khả năng sử dụng vai trò NOTES trên thiết bị bằng cách đặt config_enableDefaultNotes. Theo mặc định, giá trị của config_enableDefaultNotes được đặt thành false.

Nếu bật vai trò NOTES, OEM phải hỗ trợ API Ghi lại nội dung cho Ghi chú bằng cách cung cấp các tuỳ chỉnh cần thiết và tích hợp tính năng ghi chú của hệ thống. Nhà sản xuất thiết bị gốc (OEM) có thể chọn tuỳ chỉnh cách triển khai AOSP mặc định hoặc cung cấp cách triển khai của riêng họ bằng cách ghi đè config_screenshotAppClipsServiceComponent hoặc config_screenshotAppClipsActivityComponent. Tham khảo gói notetask để triển khai tính năng tích hợp ghi chú mặc định của hệ thống.

Bạn cần thực hiện các thay đổi trong Giao diện người dùng hệ thống để triển khai API Ghi chú cho tính năng Ghi lại nội dung. OEM có thể tuỳ chỉnh giao diện người dùng để kích hoạt và chỉnh sửa ảnh chụp màn hình, đồng thời cung cấp phương thức triển khai trong Giao diện người dùng hệ thống Android. Ví dụ về tính năng tích hợp tuỳ chỉnh của OEM, Giao diện người dùng hệ thống có thể chạy ứng dụng chủ vai trò NOTES trên màn hình khoá bằng cách sử dụng lối tắt trên màn hình khoá, chẳng hạn như nút hoặc biểu tượng trên màn hình khoá hoặc cử chỉ sử dụng bút cảm ứng. Tương tự, trên màn hình chính, giao diện người dùng hệ thống có thể chạy ứng dụng chủ sở hữu vai trò NOTES ở chế độ cửa sổ đa nhiệm, chẳng hạn như cửa sổ bong bóng trò chuyện hoặc cửa sổ nổi, bằng cử chỉ dựa trên bút cảm ứng.

Xác thực nội dung ghi lại cho ứng dụng Ghi chú

Để kiểm thử CTS-Verifier, hãy xem phần Ghi lại nội dung để kiểm thử ghi chú.