Kể từ Android 14, các API Chụp nội dung cho ghi chú cho phép người dùng chụp ảnh màn hình ngay thông qua ứ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 vào ghi chú.
Capture Content for Notes API đượ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 chỉ những ứng dụng có vai trò NOTES
mới có thể dùng API Capture Content for Notes. Các ứng dụng phải kiểm tra xem mình có quyền hay không trước khi gọi các API. Các 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 phần sau để biết thêm thông tin về Capture Content for Notes API:
Tuỳ chỉnh của nhà sản xuất thiết bị gốc (OEM) cho tính năng Chụp 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. OEM có thể kiểm soát khả năng cung cấp 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 vai trò NOTES
được bật, thì OEM phải hỗ trợ API Chụp nội dung cho ghi chú bằng cách cung cấp các chế độ tuỳ chỉnh và tích hợp tính năng ghi chú hệ thống cần thiết. Các OEM có thể chọn tuỳ chỉnh chế độ triển khai AOSP mặc định hoặc cung cấp 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
để biết cách triển khai tích hợp hệ thống ghi chú mặc định.
Bạn cần thay đổi Giao diện người dùng hệ thống để triển khai API Chụp nội dung cho ghi chú. Các 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 việc triển khai trong Giao diện người dùng hệ thống Android. Ví dụ về hoạt độ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 một ứng dụng giữ vai trò NOTES
trên màn hình khoá bằng cách sử dụng một lối tắt trên màn hình khoá, chẳng hạn như một nút hoặc biểu tượng trên màn hình khoá hoặc một cử chỉ dựa trên 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ể khởi chạy ứng dụng giữ vai trò NOTES
ở chế độ cửa sổ đa nhiệm (chẳng hạn như cửa sổ bong bóng hoặc cửa sổ nổi) bằng một cử chỉ dựa trên bút cảm ứng.
Xác thực nội dung chụp cho Ghi chú
Để kiểm thử CTS-Verifier, hãy xem phần Kiểm thử Ghi chú về nội dung đã chụp.