1. Giới thiệu
Tài liệu này liệt kê các yêu cầu phải được đáp ứng để thiết bị tương thích với Android 9.
Việc sử dụng các từ khoá "PHẢI", "KHÔNG ĐƯỢC", "BẮT BUỘC", "SẼ", "KHÔNG SẼ", "NÊN", "KHÔNG NÊN", "NÊN DÙNG", "CÓ THỂ" và "KHÔNG BẮT BUỘC" tuân theo tiêu chuẩn IETF được xác định trong RFC2119.
Trong tài liệu này, "người triển khai thiết bị" hoặc "người triển khai" là một người hoặc tổ chức phát triển giải pháp phần cứng/phần mềm chạy Android 9. "Triển khai thiết bị" hoặc "triển khai" là giải pháp phần cứng/phần mềm được phát triển.
Để được coi là tương thích với Android 9, việc triển khai thiết bị PHẢI đáp ứng các yêu cầu được nêu trong Định nghĩa về khả năng tương thích này, bao gồm mọi tài liệu được đưa vào thông qua tham chiếu.
Nếu định nghĩa này hoặc các thử nghiệm phần mềm được mô tả trong phần 10 không đề cập, không rõ ràng hoặc không đầy đủ, thì người triển khai thiết bị có trách nhiệm đảm bảo khả năng tương thích với các phương thức triển khai hiện có.
Vì lý do này, Dự án nguồn mở Android vừa là tài liệu tham khảo vừa là phương thức triển khai ưu tiên của Android. NÊN triển khai mã nguồn "nguồn cấp trên" có sẵn trong Dự án nguồn mở Android ở mức độ tối đa có thể. Mặc dù có thể thay thế một số thành phần bằng cách triển khai thay thế, nhưng bạn KHÔNG NÊN làm như vậy vì việc vượt qua các bài kiểm thử phần mềm sẽ trở nên khó khăn hơn đáng kể. Người triển khai có trách nhiệm đảm bảo khả năng tương thích đầy đủ về hành vi với cách triển khai Android chuẩn, bao gồm cả Bộ kiểm thử khả năng tương thích. Cuối cùng, xin lưu ý rằng tài liệu này nghiêm cấm một số hoạt động thay thế và sửa đổi thành phần.
Nhiều tài nguyên được liên kết trong tài liệu này được lấy trực tiếp hoặc gián tiếp từ SDK Android và sẽ có chức năng giống với thông tin trong tài liệu của SDK đó. Trong mọi trường hợp, nếu Định nghĩa về khả năng tương thích này hoặc Bộ kiểm thử khả năng tương thích không đồng ý với tài liệu SDK, thì tài liệu SDK được coi là có thẩm quyền. Mọi thông tin chi tiết kỹ thuật được cung cấp trong các tài nguyên được liên kết trong tài liệu này đều được coi là một phần của Định nghĩa về khả năng tương thích này.
1.1 Cấu trúc tài liệu
1.1.1. Yêu cầu theo loại thiết bị
Mục 2 chứa tất cả các yêu cầu áp dụng cho một loại thiết bị cụ thể. Mỗi tiểu mục của Mục 2 dành riêng cho một loại thiết bị cụ thể.
Tất cả các yêu cầu khác áp dụng chung cho mọi hoạt động triển khai thiết bị Android đều được liệt kê trong các phần sau Phần 2. Các yêu cầu này được gọi là "Yêu cầu cốt lõi" trong tài liệu này.
1.1.2. Mã yêu cầu
Mã yêu cầu được chỉ định cho các yêu cầu PHẢI.
- Mã nhận dạng chỉ được chỉ định cho các yêu cầu PHẢI.
- Các yêu cầu NÊN CÓ được đánh dấu là [SR] nhưng không được chỉ định mã nhận dạng.
- Mã này bao gồm: Mã loại thiết bị – Mã điều kiện – Mã yêu cầu (ví dụ: C-0-1).
Mỗi mã được xác định như sau:
- Mã loại thiết bị (xem thêm trong phần 2. Loại thiết bị)
- C: Core (Yêu cầu áp dụng cho mọi hoạt động triển khai thiết bị Android)
- H: Thiết bị cầm tay Android
- T: Thiết bị Android TV
- Đáp: Triển khai Android Automotive
- Thẻ: Triển khai trên máy tính bảng Android
- Mã điều kiện
- Khi yêu cầu không có điều kiện, mã nhận dạng này được đặt thành 0.
- Khi yêu cầu có điều kiện, hệ thống sẽ chỉ định 1 cho điều kiện thứ nhất và số này sẽ tăng thêm 1 trong cùng một mục và cùng một loại thiết bị.
- Mã yêu cầu
- Mã nhận dạng này bắt đầu từ 1 và tăng thêm 1 trong cùng một mục và cùng một điều kiện.
1.1.3. Mã yêu cầu trong Phần 2
Mã yêu cầu trong Mục 2 bắt đầu bằng mã mục tương ứng, theo sau là Mã yêu cầu được mô tả ở trên.
- Mã trong Mục 2 bao gồm: Mã mục / Mã loại thiết bị – Mã điều kiện – Mã yêu cầu (ví dụ: 7.4.3/A-0-1).
2. Loại thiết bị
Mặc dù Dự án nguồn mở Android cung cấp một ngăn xếp phần mềm có thể dùng cho nhiều loại thiết bị và kiểu dáng, nhưng có một số loại thiết bị có hệ sinh thái phân phối ứng dụng tương đối tốt hơn.
Phần này mô tả các loại thiết bị đó, cũng như các yêu cầu và đề xuất bổ sung áp dụng cho từng loại thiết bị.
Tất cả các phương thức triển khai thiết bị Android không thuộc bất kỳ loại thiết bị nào được mô tả VẪN PHẢI đáp ứng tất cả các yêu cầu trong các phần khác của Định nghĩa về khả năng tương thích này.
2.1 Cấu hình thiết bị
Để biết những điểm khác biệt chính về cấu hình phần cứng theo loại thiết bị, hãy xem các yêu cầu dành riêng cho thiết bị trong phần sau của bài viết này.
2.2. Yêu cầu đối với thiết bị cầm tay
Thiết bị cầm tay Android là một cách triển khai thiết bị Android thường được sử dụng bằng cách cầm thiết bị trong tay, chẳng hạn như máy nghe nhạc mp3, điện thoại hoặc máy tính bảng.
Các phương thức triển khai thiết bị Android được phân loại là Thiết bị cầm tay nếu đáp ứng tất cả các tiêu chí sau:
- Có nguồn điện mang tính di động, chẳng hạn như pin.
- Có kích thước màn hình thực theo đường chéo trong khoảng từ 2,5 đến 8 inch.
Các yêu cầu bổ sung trong phần còn lại của mục này dành riêng cho việc triển khai thiết bị cầm tay Android.
2.2.1. Phần cứng
Triển khai thiết bị cầm tay:
- [7.1.1.1/H-0-1] PHẢI có màn hình có kích thước đường chéo vật lý tối thiểu là 2,5 inch.
- [7.1.1.3/H-SR] NÊN cung cấp cho người dùng khả năng thay đổi kích thước màn hình.(Mật độ màn hình)
Nếu việc triển khai thiết bị cầm tay tuyên bố hỗ trợ màn hình dải động cao thông qua Configuration.isScreenHdr()
, thì các thiết bị đó:
- [7.1.4.5/H-1-1] PHẢI quảng cáo việc hỗ trợ các tiện ích
EGL_EXT_gl_colorspace_bt2020_pq
,EGL_EXT_surface_SMPTE2086_metadata
,EGL_EXT_surface_CTA861_3_metadata
,VK_EXT_swapchain_colorspace
vàVK_EXT_hdr_metadata
.
Triển khai thiết bị cầm tay:
- [7.1.5/H-0-1] PHẢI hỗ trợ chế độ tương thích với ứng dụng cũ do mã nguồn mở Android cấp trên triển khai. Tức là việc triển khai thiết bị KHÔNG ĐƯỢC thay đổi các điều kiện kích hoạt hoặc ngưỡng kích hoạt chế độ tương thích và KHÔNG ĐƯỢC thay đổi hành vi của chính chế độ tương thích.
- [7.2.1/H-0-1] PHẢI hỗ trợ các ứng dụng Trình chỉnh sửa phương thức nhập (IME) của bên thứ ba.
- [7.2.3/H-0-1] PHẢI cung cấp các chức năng Trang chủ, Gần đây và Quay lại.
- [7.2.3/H-0-2] PHẢI gửi cả sự kiện nhấn thông thường và nhấn và giữ của hàm Quay lại (
KEYCODE_BACK
) đến ứng dụng trên nền trước. Hệ thống KHÔNG ĐƯỢC sử dụng các sự kiện này và CÓ THỂ được kích hoạt bên ngoài thiết bị Android (ví dụ: bàn phím phần cứng bên ngoài kết nối với thiết bị Android). - [7.2.4/H-0-1] PHẢI hỗ trợ phương thức nhập bằng màn hình cảm ứng.
- [7.2.4/H-SR] Bạn NÊN chạy ứng dụng hỗ trợ do người dùng chọn, nói cách khác là ứng dụng triển khai VoiceInteractionService hoặc một hoạt động xử lý
ACTION_ASSIST
khi nhấn và giữKEYCODE_MEDIA_PLAY_PAUSE
hoặcKEYCODE_HEADSETHOOK
nếu hoạt động trên nền trước không xử lý các sự kiện nhấn và giữ đó. - [7.3.1/H-SR] NÊN có gia tốc kế 3 trục.
Nếu việc triển khai thiết bị cầm tay bao gồm gia tốc kế 3 trục, thì các thiết bị đó:
- [7.3.1/H-1-1] PHẢI có khả năng báo cáo các sự kiện với tần suất tối thiểu là 100 Hz.
Nếu việc triển khai Thiết bị cầm tay có bao gồm con quay hồi chuyển, thì các thiết bị đó:
- [7.3.4/H-1-1] PHẢI có khả năng báo cáo các sự kiện với tần suất tối thiểu là 100 Hz.
Các phương thức triển khai thiết bị cầm tay có thể thực hiện cuộc gọi thoại và cho biết bất kỳ giá trị nào khác ngoài PHONE_TYPE_NONE
trong getPhoneType
:
- [7.3.8/H] PHẢI có cảm biến tiệm cận.
Triển khai thiết bị cầm tay:
- [7.3.12/H-SR] NÊN hỗ trợ cảm biến tư thế có 6 bậc tự do.
- [7.4.3/H] PHẢI hỗ trợ Bluetooth và Bluetooth LE.
Nếu việc triển khai Thiết bị cầm tay bao gồm một kết nối có đo lượng dữ liệu, thì các thiết bị đó:
- [7.4.7/H-1-1] PHẢI cung cấp chế độ tiết kiệm dữ liệu.
Triển khai thiết bị cầm tay:
- [7.6.1/H-0-1] PHẢI có ít nhất 4 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
- [7.6.1/H-0-2] PHẢI trả về "true" cho
ActivityManager.isLowRamDevice()
khi có ít hơn 1GB bộ nhớ cho nhân và không gian người dùng.
Nếu quá trình triển khai thiết bị cầm tay chỉ khai báo hỗ trợ ABI 32 bit:
-
[7.6.1/H-1-1] Bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 416 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến qHD (ví dụ: FWVGA).
-
[7.6.1/H-2-1] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 592 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến HD+ (ví dụ: HD, WSVGA).
-
[7.6.1/H-3-1] Bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 896 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến FHD (ví dụ: WSXGA+).
-
[7.6.1/H-4-1] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1344 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến QHD (ví dụ: QWXGA).
Nếu hoạt động triển khai thiết bị cầm tay khai báo hỗ trợ bất kỳ ABI 64 bit nào (có hoặc không có ABI 32 bit):
-
[7.6.1/H-5-1] Bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 816 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến qHD (ví dụ: FWVGA).
-
[7.6.1/H-6-1] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 944 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến HD+ (ví dụ: HD, WSVGA).
-
[7.6.1/H-7-1] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1280 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến FHD (ví dụ: WSXGA+).
-
[7.6.1/H-8-1] Bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1824 MB nếu màn hình mặc định sử dụng độ phân giải vùng đệm khung hình lên đến QHD (ví dụ: QWXGA).
Xin lưu ý rằng "bộ nhớ có sẵn cho nhân và không gian người dùng" ở trên đề cập đến không gian bộ nhớ được cung cấp ngoài mọi bộ nhớ đã dành riêng cho các thành phần phần cứng như đài, video, v.v. không thuộc quyền kiểm soát của nhân trong quá trình triển khai thiết bị.
Nếu việc triển khai thiết bị cầm tay bao gồm bộ nhớ có dung lượng dưới hoặc bằng 1 GB cho nhân và không gian người dùng, thì các thiết bị đó:
- [7.6.1/H-9-1] PHẢI khai báo cờ tính năng
android.hardware.ram.low
. - [7.6.1/H-9-2] PHẢI có ít nhất 1,1 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
Nếu việc triển khai thiết bị cầm tay bao gồm hơn 1 GB bộ nhớ cho nhân và không gian người dùng, thì các thiết bị đó:
- [7.6.1/H-10-1] PHẢI có ít nhất 4 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
- NÊN khai báo cờ tính năng
android.hardware.ram.normal
.
Triển khai thiết bị cầm tay:
- [7.6.2/H-0-1] KHÔNG ĐƯỢC cung cấp bộ nhớ dùng chung của ứng dụng nhỏ hơn 1 GiB.
- [7.7.1/H] PHẢI có cổng USB hỗ trợ chế độ ngoại vi.
Nếu việc triển khai thiết bị cầm tay bao gồm một cổng USB hỗ trợ chế độ ngoại vi, thì các thiết bị đó:
- [7.7.1/H-1-1] PHẢI triển khai API Phụ kiện mở Android (AOA).
Triển khai thiết bị cầm tay:
- [7.8.1/H-0-1] PHẢI có micrô.
- [7.8.2/H-0-1] PHẢI có đầu ra âm thanh và khai báo
android.hardware.audio.output
.
Nếu việc triển khai thiết bị cầm tay có thể đáp ứng tất cả các yêu cầu về hiệu suất để hỗ trợ chế độ VR và hỗ trợ chế độ này, thì các thiết bị đó:
- [7.9.1/H-1-1] BẮT BUỘC khai báo cờ tính năng
android.hardware.vr.high_performance
. - [7.9.1/H-1-2] PHẢI bao gồm một ứng dụng triển khai
android.service.vr.VrListenerService
mà các ứng dụng VR có thể bật thông quaandroid.app.Activity#setVrModeEnabled
.
2.2.2. Đa phương tiện
Việc triển khai thiết bị cầm tay PHẢI hỗ trợ các định dạng mã hoá âm thanh sau:
- [5.1.1/H-0-1] AMR-NB
- [5.1.1/H-0-2] AMR-WB
- [5.1.1/H-0-3] Hồ sơ MPEG-4 AAC (AAC LC)
- [5.1.1/H-0-4] Hồ sơ MPEG-4 HE AAC (AAC+)
- [5.1.1/H-0-5] AAC ELD (AAC độ trễ thấp nâng cao)
Việc triển khai thiết bị cầm tay PHẢI hỗ trợ giải mã âm thanh sau:
Việc triển khai thiết bị cầm tay PHẢI hỗ trợ và cung cấp tính năng mã hoá video sau đây cho các ứng dụng bên thứ ba:
Việc triển khai thiết bị cầm tay PHẢI hỗ trợ tính năng giải mã video sau:
2.2.3. Phần mềm
Triển khai thiết bị cầm tay:
- [3.2.3.1/H-0-1] PHẢI có một ứng dụng xử lý các ý định
ACTION_GET_CONTENT
,ACTION_OPEN_DOCUMENT
,ACTION_OPEN_DOCUMENT_TREE
vàACTION_CREATE_DOCUMENT
như mô tả trong tài liệu SDK, đồng thời cung cấp cho người dùng khả năng truy cập vào dữ liệu của nhà cung cấp tài liệu bằng cách sử dụng APIDocumentsProvider
. - [3.4.1/H-0-1] PHẢI cung cấp cách triển khai đầy đủ API
android.webkit.Webview
. - [3.4.2/H-0-1] PHẢI có một ứng dụng Trình duyệt độc lập để người dùng duyệt web thông thường.
- [3.8.1/H-SR] Bạn NÊN triển khai một trình chạy mặc định hỗ trợ ghim lối tắt, tiện ích và widgetFeatures trong ứng dụng.
- [3.8.1/H-SR] Bạn NÊN triển khai một trình chạy mặc định để truy cập nhanh vào các lối tắt bổ sung do các ứng dụng bên thứ ba cung cấp thông qua API ShortcutManager.
- [3.8.1/H-SR] Bạn NÊN đưa vào một ứng dụng trình chạy mặc định hiển thị huy hiệu cho các biểu tượng ứng dụng.
- [3.8.2/H-SR] NÊN hỗ trợ các tiện ích ứng dụng của bên thứ ba.
- [3.8.3/H-0-1] PHẢI cho phép ứng dụng bên thứ ba thông báo cho người dùng về các sự kiện đáng chú ý thông qua các lớp API
Notification
vàNotificationManager
. - [3.8.3/H-0-2] PHẢI hỗ trợ thông báo đa dạng thức.
- [3.8.3/H-0-3] PHẢI hỗ trợ thông báo quan trọng.
- [3.8.3/H-0-4] PHẢI có một ngăn thông báo, cho phép người dùng trực tiếp kiểm soát (ví dụ: trả lời, tạm ngưng, đóng, chặn) thông báo thông qua các tính năng hỗ trợ người dùng như nút hành động hoặc bảng điều khiển được triển khai trong AOSP.
- [3.8.3/H-0-5] PHẢI hiển thị các lựa chọn được cung cấp thông qua
RemoteInput.Builder setChoices()
trong ngăn thông báo. - [3.8.3/H-SR] Bạn NÊN hiển thị lựa chọn đầu tiên được cung cấp thông qua
RemoteInput.Builder setChoices()
trong ngăn thông báo mà không cần người dùng tương tác thêm. - [3.8.3/H-SR] Bạn NÊN hiển thị tất cả các lựa chọn được cung cấp thông qua
RemoteInput.Builder setChoices()
trong ngăn thông báo khi người dùng mở rộng tất cả thông báo trong ngăn thông báo. - [3.8.4/H-SR] Bạn NÊN triển khai trợ lý trên thiết bị để xử lý Hành động hỗ trợ.
Nếu các cách triển khai Thiết bị cầm tay hỗ trợ Thao tác hỗ trợ, thì các cách triển khai đó:
- [3.8.4/H-SR] Bạn NÊN sử dụng thao tác nhấn và giữ phím
HOME
làm thao tác tương tác được chỉ định để khởi chạy ứng dụng hỗ trợ như mô tả trong mục 7.2.3. PHẢI chạy ứng dụng hỗ trợ do người dùng chọn, nói cách khác là ứng dụng triển khaiVoiceInteractionService
hoặc một hoạt động xử lý ý địnhACTION_ASSIST
.
Nếu việc triển khai thiết bị cầm tay Android hỗ trợ màn hình khoá, thì các thiết bị đó:
- [3.8.10/H-1-1] PHẢI hiển thị Thông báo trên màn hình khoá, bao gồm cả Mẫu thông báo đa phương tiện.
Nếu việc triển khai thiết bị cầm tay hỗ trợ màn hình khoá bảo mật, thì các thiết bị đó:
- [3.9/H-1-1] PHẢI triển khai toàn bộ các chính sách quản trị thiết bị được xác định trong tài liệu SDK Android.
- [3.9/H-1-2] PHẢI khai báo việc hỗ trợ hồ sơ được quản lý thông qua cờ tính năng
android.software.managed_users
, ngoại trừ khi thiết bị được định cấu hình để báo cáo chính nó là thiết bị có RAM thấp hoặc để phân bổ bộ nhớ trong (không thể tháo rời) làm bộ nhớ dùng chung.
Triển khai thiết bị cầm tay:
- [3.10/H-0-1] PHẢI hỗ trợ các dịch vụ hỗ trợ tiếp cận của bên thứ ba.
- [3.10/H-SR] Bạn NÊN tải trước các dịch vụ hỗ trợ tiếp cận trên thiết bị có chức năng tương đương hoặc vượt trội so với các dịch vụ hỗ trợ tiếp cận của Tiếp cận bằng công tắc và TalkBack (đối với các ngôn ngữ được công cụ Chuyển văn bản sang lời nói được cài đặt sẵn hỗ trợ) như được cung cấp trong dự án nguồn mở talkback.
- [3.11/H-0-1] PHẢI hỗ trợ cài đặt công cụ TTS của bên thứ ba.
- [3.11/H-SR] Bạn NÊN đưa công cụ TTS hỗ trợ các ngôn ngữ có trên thiết bị vào.
- [3.13/H-SR] Bạn NÊN đưa thành phần giao diện người dùng Cài đặt nhanh vào.
Nếu việc triển khai thiết bị cầm tay Android khai báo hỗ trợ FEATURE_BLUETOOTH
hoặc FEATURE_WIFI
, thì các thiết bị đó:
- [3.16/H-1-1] PHẢI hỗ trợ tính năng ghép nối thiết bị đồng hành.
2.2.4. Hiệu suất và nguồn điện
- [8.1/H-0-1] Độ trễ khung hình nhất quán. Độ trễ khung hình không nhất quán hoặc độ trễ kết xuất khung hình KHÔNG ĐƯỢC xảy ra thường xuyên hơn 5 khung hình/giây và PHẢI dưới 1 khung hình/giây.
- [8.1/H-0-2] Độ trễ giao diện người dùng. Việc triển khai thiết bị PHẢI đảm bảo trải nghiệm người dùng có độ trễ thấp bằng cách cuộn danh sách gồm 10.000 mục danh sách theo định nghĩa của Bộ kiểm thử khả năng tương thích Android (CTS) trong vòng chưa đến 36 giây.
- [8.1/H-0-3] Chuyển đổi tác vụ. Khi nhiều ứng dụng đã được khởi chạy, việc khởi chạy lại một ứng dụng đang chạy sau khi ứng dụng đó đã được khởi chạy PHẢI mất chưa đến 1 giây.
Triển khai thiết bị cầm tay:
- [8.2/H-0-1] PHẢI đảm bảo hiệu suất ghi tuần tự tối thiểu là 5 MB/giây.
- [8.2/H-0-2] PHẢI đảm bảo hiệu suất ghi ngẫu nhiên tối thiểu là 0,5 MB/giây.
- [8.2/H-0-3] PHẢI đảm bảo hiệu suất đọc tuần tự ít nhất là 15 MB/giây.
- [8.2/H-0-4] PHẢI đảm bảo hiệu suất đọc ngẫu nhiên tối thiểu là 3,5 MB/giây.
Nếu việc triển khai Thiết bị cầm tay bao gồm các tính năng để cải thiện khả năng quản lý nguồn điện của thiết bị có trong AOSP hoặc mở rộng các tính năng có trong AOSP, thì các tính năng đó:
- [8.3/H-1-1] PHẢI cung cấp cho người dùng khả năng bật và tắt tính năng tiết kiệm pin.
- [8.3/H-1-2] PHẢI cung cấp cho người dùng khả năng hiển thị tất cả ứng dụng được miễn trừ khỏi chế độ Chế độ chờ ứng dụng và chế độ tiết kiệm pin Nghỉ.
Triển khai thiết bị cầm tay:
- [8.4/H-0-1] PHẢI cung cấp hồ sơ năng lượng cho mỗi thành phần xác định giá trị tiêu thụ hiện tại cho mỗi thành phần phần cứng và mức tiêu hao pin ước tính do các thành phần gây ra theo thời gian như được ghi nhận trong trang web Dự án nguồn mở Android.
- [8.4/H-0-2] PHẢI báo cáo tất cả giá trị tiêu thụ điện năng theo đơn vị miliampe giờ (mAh).
- [8.4/H-0-3] PHẢI báo cáo mức tiêu thụ điện năng của CPU theo UID của mỗi quy trình. Dự án nguồn mở Android đáp ứng yêu cầu này thông qua việc triển khai mô-đun hạt nhân
uid_cputime
. - [8.4/H-0-4] PHẢI cung cấp mức sử dụng năng lượng này cho nhà phát triển ứng dụng thông qua lệnh shell
adb shell dumpsys batterystats
. - [8,4/giờ] PHẢI được phân bổ cho chính thành phần phần cứng nếu không thể phân bổ mức sử dụng năng lượng của thành phần phần cứng cho một ứng dụng.
Nếu việc triển khai Thiết bị cầm tay bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- [8.4/H-1-1] PHẢI tuân thủ ý định
android.intent.action.POWER_USAGE_SUMMARY
và hiển thị trình đơn cài đặt cho biết mức sử dụng năng lượng này.
2.2.5. Mô hình bảo mật
Triển khai thiết bị cầm tay:
- [9.1/H-0-1] PHẢI cho phép ứng dụng bên thứ ba truy cập vào số liệu thống kê về mức sử dụng thông qua quyền
android.permission.PACKAGE_USAGE_STATS
và cung cấp cơ chế mà người dùng có thể truy cập để cấp hoặc thu hồi quyền truy cập vào các ứng dụng đó theo ý địnhandroid.settings.ACTION_USAGE_ACCESS_SETTINGS
.
Khi triển khai thiết bị cầm tay hỗ trợ màn hình khoá bảo mật, các thiết bị đó:
- [9.11/H-1-1] PHẢI cho phép người dùng chọn thời gian chờ khi ngủ ngắn nhất, tức là thời gian chuyển đổi từ trạng thái mở khoá sang trạng thái khoá, trong vòng 15 giây.
- [9.11/H-1-2] PHẢI cung cấp cho người dùng khả năng ẩn thông báo và tắt tất cả các hình thức xác thực, ngoại trừ phương thức xác thực chính được mô tả trong phần 9.11.1 Màn hình khoá an toàn. AOSP đáp ứng yêu cầu về chế độ khoá.
2.3. Yêu cầu đối với chương trình truyền hình
Thiết bị Android Television là một thiết bị Android được triển khai dưới dạng giao diện giải trí để người dùng ngồi cách khoảng 3 mét có thể thưởng thức nội dung đa phương tiện kỹ thuật số, phim, trò chơi, ứng dụng và/hoặc truyền hình trực tiếp (gọi là "giao diện người dùng thư giãn" hoặc "giao diện người dùng 3 mét").
Các phương thức triển khai thiết bị Android được phân loại là TV nếu đáp ứng tất cả các tiêu chí sau:
- Đã cung cấp một cơ chế để điều khiển từ xa giao diện người dùng được kết xuất trên màn hình có thể cách người dùng 3 mét.
- Có màn hình tích hợp với chiều đường chéo lớn hơn 24 inch HOẶC có cổng đầu ra video, chẳng hạn như VGA, HDMI, DisplayPort hoặc cổng không dây để hiển thị.
Các yêu cầu bổ sung trong phần còn lại của mục này dành riêng cho việc triển khai thiết bị Android TV.
2.3.1. Phần cứng
Triển khai thiết bị truyền hình:
- [7.2.2/T-0-1] PHẢI hỗ trợ D-pad.
- [7.2.3/T-0-1] PHẢI cung cấp các hàm Home (Trang chủ) và Back (Quay lại).
- [7.2.3/T-0-2] PHẢI gửi cả sự kiện nhấn và giữ thông thường và sự kiện nhấn và giữ lâu của hàm Quay lại (
KEYCODE_BACK
) đến ứng dụng trên nền trước. - [7.2.6.1/T-0-1] PHẢI hỗ trợ tay điều khiển trò chơi và khai báo cờ tính năng
android.hardware.gamepad
. - [7.2.7/T] NÊN cung cấp một thiết bị điều khiển từ xa để người dùng có thể truy cập vào các phương thức nhập điều hướng không chạm và các phím điều hướng cốt lõi.
Nếu việc triển khai thiết bị truyền hình có sử dụng con quay hồi chuyển, thì các thiết bị đó:
- [7.3.4/T-1-1] PHẢI có khả năng báo cáo các sự kiện với tần suất tối thiểu là 100 Hz.
Triển khai thiết bị truyền hình:
- [7.4.3/T-0-1] PHẢI hỗ trợ Bluetooth và Bluetooth LE.
- [7.6.1/T-0-1] PHẢI có ít nhất 4 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
Nếu việc triển khai thiết bị truyền hình có cổng USB hỗ trợ chế độ máy chủ, thì các thiết bị đó:
- [7.5.3/T-1-1] PHẢI hỗ trợ máy ảnh bên ngoài kết nối thông qua cổng USB này nhưng không nhất thiết phải luôn kết nối.
Nếu việc triển khai thiết bị TV là 32 bit:
-
[7.6.1/T-1-1] Bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 896 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 400dpi trở lên trên màn hình nhỏ/bình thường
- xhdpi trở lên trên màn hình lớn
- tvdpi trở lên trên màn hình cực lớn
Nếu việc triển khai thiết bị TV là 64 bit:
-
[7.6.1/T-2-1] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1280 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 400dpi trở lên trên màn hình nhỏ/bình thường
- xhdpi trở lên trên màn hình lớn
- tvdpi trở lên trên màn hình cực lớn
Xin lưu ý rằng "bộ nhớ có sẵn cho nhân và không gian người dùng" ở trên đề cập đến không gian bộ nhớ được cung cấp ngoài mọi bộ nhớ đã dành riêng cho các thành phần phần cứng như đài, video, v.v. không thuộc quyền kiểm soát của nhân trong quá trình triển khai thiết bị.
Triển khai thiết bị truyền hình:
- [7.8.1/T] PHẢI có micrô.
- [7.8.2/T-0-1] PHẢI có đầu ra âm thanh và khai báo
android.hardware.audio.output
.
2.3.2. Đa phương tiện
Việc triển khai thiết bị truyền hình PHẢI hỗ trợ các định dạng mã hoá âm thanh sau:
- [5.1/T-0-1] Hồ sơ MPEG-4 AAC (AAC LC)
- [5.1/T-0-2] Hồ sơ MPEG-4 HE AAC (AAC+)
- [5.1/T-0-3] AAC ELD (AAC độ trễ thấp nâng cao)
Việc triển khai thiết bị truyền hình PHẢI hỗ trợ các định dạng mã hoá video sau:
Triển khai thiết bị truyền hình:
- [5.2.2/T-SR] Bạn NÊN hỗ trợ tính năng mã hoá H.264 cho video có độ phân giải 720p và 1080p ở tốc độ 30 khung hình/giây.
Việc triển khai thiết bị truyền hình PHẢI hỗ trợ các định dạng giải mã video sau:
- [5.3.3/T-0-1] MPEG-4 SP
- [5.3.4/T-0-2] H.264 AVC
- [5.3.5/T-0-3] H.265 HEVC
- [5.3.6/T-0-4] VP8
- [5.3.7/T-0-5] VP9
Bạn NÊN hỗ trợ các định dạng giải mã video sau đây khi triển khai thiết bị truyền hình:
- [5.3.1/T-SR] MPEG-2
Việc triển khai thiết bị truyền hình PHẢI hỗ trợ giải mã H.264, như được nêu chi tiết trong Mục 5.3.4, ở tốc độ khung hình và độ phân giải video tiêu chuẩn lên đến và bao gồm:
- [5.3.4.4/T-1-1] HD 1080p với tốc độ 60 khung hình/giây bằng Hồ sơ cơ sở
- [5.3.4.4/T-1-2] HD 1080p với tốc độ 60 khung hình/giây theo Hồ sơ chính
- [5.3.4.4/T-1-3] HD 1080p với tốc độ 60 khung hình/giây theo Cấu hình cao cấp cấp 4.2
Việc triển khai thiết bị truyền hình có bộ giải mã phần cứng H.265 PHẢI hỗ trợ giải mã H.265, như được nêu chi tiết trong Mục 5.3.5, ở tốc độ khung hình và độ phân giải video tiêu chuẩn lên đến và bao gồm:
- [5.3.5.4/T-1-1] HD 1080p với tốc độ 60 khung hình/giây theo Cấu hình chính cấp 4.1
Nếu việc triển khai thiết bị truyền hình có bộ giải mã phần cứng H.265 hỗ trợ giải mã H.265 và hồ sơ giải mã UHD, thì các thiết bị đó:
- [5.3.5.5/T-2-1] PHẢI hỗ trợ hồ sơ giải mã UHD ở tốc độ 60 khung hình/giây với hồ sơ Cấp chính Main10 cấp 5.
Việc triển khai thiết bị truyền hình PHẢI hỗ trợ giải mã VP8, như được nêu chi tiết trong Mục 5.3.6, ở tốc độ khung hình và độ phân giải video tiêu chuẩn lên đến và bao gồm:
- [5.3.6.4/T-1-1] Hồ sơ giải mã HD 1080p với tốc độ 60 khung hình/giây
Việc triển khai thiết bị truyền hình có bộ giải mã phần cứng VP9 PHẢI hỗ trợ giải mã VP9, như được nêu chi tiết trong Mục 5.3.7, ở tốc độ khung hình và độ phân giải video tiêu chuẩn lên đến và bao gồm:
- [5.3.7.4/T-1-1] HD 1080p với tốc độ 60 khung hình/giây với hồ sơ 0 (độ sâu màu 8 bit)
Nếu việc triển khai thiết bị truyền hình bằng bộ giải mã phần cứng VP9 hỗ trợ giải mã VP9 và hồ sơ giải mã UHD, thì các thiết bị đó:
- [5.3.7.5/T-2-1] PHẢI hỗ trợ hồ sơ giải mã UHD ở tốc độ 60 khung hình/giây với hồ sơ 0 (độ sâu màu 8 bit).
- [5.3.7.5/T-2-1] NÊN hỗ trợ hồ sơ giải mã UHD ở tốc độ 60 khung hình/giây với hồ sơ 2 (độ sâu màu 10 bit).
Triển khai thiết bị truyền hình:
- [5.5.3/T-0-1] PHẢI hỗ trợ Âm lượng chính của hệ thống và giảm âm lượng đầu ra âm thanh kỹ thuật số trên các đầu ra được hỗ trợ, ngoại trừ đầu ra truyền âm thanh nén (không giải mã âm thanh trên thiết bị).
- [5.8/T-0-1] PHẢI đặt chế độ đầu ra HDMI để chọn độ phân giải tối đa có thể hỗ trợ với tốc độ làm mới 50Hz hoặc 60Hz cho tất cả màn hình có dây.
- [5.8/T-SR] NÊN cung cấp bộ chọn tốc độ làm mới HDMI có thể định cấu hình cho người dùng cho tất cả màn hình có dây.
- [5.8/T-SR] NÊN hỗ trợ giải mã đồng thời các luồng bảo mật. Ít nhất, bạn NÊN giải mã đồng thời hai luồng.
- [5.8] NÊN đặt tốc độ làm mới chế độ đầu ra HDMI thành 50Hz hoặc 60Hz, tuỳ thuộc vào tốc độ làm mới video cho khu vực bán thiết bị đối với tất cả màn hình có dây.
Nếu việc triển khai thiết bị truyền hình hỗ trợ giải mã UHD và hỗ trợ màn hình ngoài, thì các thiết bị đó:
- [5.8/T-1-1] PHẢI hỗ trợ HDCP 2.2.
Nếu việc triển khai thiết bị truyền hình không hỗ trợ giải mã UHD nhưng hỗ trợ màn hình ngoài, thì các thiết bị đó:
- [5.8/T-2-1] PHẢI hỗ trợ HDCP 1.4
2.3.3. Phần mềm
Triển khai thiết bị truyền hình:
- [3/T-0-1] BẮT BUỘC phải khai báo các tính năng
android.software.leanback
vàandroid.hardware.type.television
. - [3.4.1/T-0-1] PHẢI cung cấp cách triển khai đầy đủ API
android.webkit.Webview
.
Nếu việc triển khai thiết bị Android Television hỗ trợ màn hình khoá,thì các thiết bị đó:
- [3.8.10/T-1-1] PHẢI hiển thị Thông báo trên màn hình khoá, bao gồm cả Mẫu thông báo đa phương tiện.
Triển khai thiết bị truyền hình:
- [3.8.14/T-SR] Bạn NÊN hỗ trợ chế độ nhiều cửa sổ hình trong hình (PIP).
- [3.10/T-0-1] PHẢI hỗ trợ các dịch vụ hỗ trợ tiếp cận của bên thứ ba.
- [3.10/T-SR] Bạn NÊN tải trước các dịch vụ hỗ trợ tiếp cận trên thiết bị có chức năng tương đương hoặc vượt trội so với các dịch vụ hỗ trợ tiếp cận của TalkBack và Tiếp cận bằng công tắc (đối với các ngôn ngữ được công cụ Chuyển văn bản sang lời nói được cài đặt sẵn hỗ trợ) như được cung cấp trong dự án nguồn mở talkback.
Nếu việc triển khai thiết bị truyền hình báo cáo tính năng android.hardware.audio.output
, thì các thiết bị đó:
- [3.11/T-SR] Bạn NÊN thêm một công cụ TTS hỗ trợ các ngôn ngữ có trên thiết bị.
- [3.11/T-1-1] PHẢI hỗ trợ cài đặt công cụ TTS của bên thứ ba.
Triển khai thiết bị truyền hình:
- [3.12/T-0-1] PHẢI hỗ trợ Khung đầu vào TV.
2.3.4. Hiệu suất và nguồn điện
- [8.1/T-0-1] Độ trễ khung hình nhất quán. Độ trễ khung hình không nhất quán hoặc độ trễ kết xuất khung hình KHÔNG ĐƯỢC xảy ra thường xuyên hơn 5 khung hình/giây và PHẢI dưới 1 khung hình/giây.
- [8.2/T-0-1] PHẢI đảm bảo hiệu suất ghi tuần tự ít nhất là 5 MB/giây.
- [8.2/T-0-2] PHẢI đảm bảo hiệu suất ghi ngẫu nhiên tối thiểu là 0,5 MB/giây.
- [8.2/T-0-3] PHẢI đảm bảo hiệu suất đọc tuần tự ít nhất là 15 MB/giây.
- [8.2/T-0-4] PHẢI đảm bảo hiệu suất đọc ngẫu nhiên tối thiểu là 3,5 MB/giây.
Nếu việc triển khai thiết bị truyền hình bao gồm các tính năng để cải thiện khả năng quản lý nguồn điện của thiết bị có trong AOSP hoặc mở rộng các tính năng có trong AOSP, thì các tính năng đó:
- [8.3/T-1-1] PHẢI cung cấp cho người dùng khả năng bật và tắt tính năng tiết kiệm pin.
- [8.3/T-1-2] PHẢI cung cấp cho người dùng khả năng hiển thị tất cả ứng dụng được miễn trừ khỏi chế độ Chế độ chờ ứng dụng và chế độ tiết kiệm pin Nghỉ.
Triển khai thiết bị truyền hình:
- [8.4/T-0-1] PHẢI cung cấp hồ sơ năng lượng cho mỗi thành phần xác định giá trị tiêu thụ hiện tại cho mỗi thành phần phần cứng và mức hao pin gần đúng do các thành phần gây ra theo thời gian như được ghi nhận trong trang web Dự án nguồn mở Android.
- [8.4/T-0-2] PHẢI báo cáo tất cả các giá trị tiêu thụ năng lượng theo đơn vị miliampe giờ (mAh).
- [8.4/T-0-3] PHẢI báo cáo mức tiêu thụ điện năng của CPU theo UID của từng quy trình. Dự án nguồn mở Android đáp ứng yêu cầu này thông qua việc triển khai mô-đun hạt nhân
uid_cputime
. - [8.4/T] NÊN được phân bổ cho chính thành phần phần cứng nếu không thể phân bổ mức sử dụng năng lượng của thành phần phần cứng cho một ứng dụng.
- [8.4/T-0-4] PHẢI cung cấp mức sử dụng năng lượng này cho nhà phát triển ứng dụng thông qua lệnh shell
adb shell dumpsys batterystats
.
2.4. Yêu cầu đối với đồng hồ
Thiết bị đồng hồ Android là một thiết bị Android được triển khai để đeo trên cơ thể, có thể là trên cổ tay.
Các phương thức triển khai thiết bị Android được phân loại là Đồng hồ nếu đáp ứng tất cả các tiêu chí sau:
- Có màn hình có chiều dài đường chéo thực tế trong khoảng từ 1,1 đến 2,5 inch.
- Có cơ chế để đeo trên cơ thể.
Các yêu cầu bổ sung trong phần còn lại của phần này dành riêng cho việc triển khai thiết bị Android Watch.
2.4.1. Phần cứng
Xem cách triển khai thiết bị:
-
[7.1.1.1/W-0-1] PHẢI có màn hình có kích thước đường chéo thực tế trong khoảng từ 1,1 đến 2,5 inch.
-
[7.2.3/W-0-1] PHẢI có hàm Trang chủ và hàm Quay lại cho người dùng, ngoại trừ khi hàm này nằm trong
UI_MODE_TYPE_WATCH
. -
[7.2.4/W-0-1] PHẢI hỗ trợ phương thức nhập bằng màn hình cảm ứng.
-
[7.3.1/W-SR] NÊN có gia tốc kế 3 trục.
-
[7.4.3/W-0-1] PHẢI hỗ trợ Bluetooth.
-
[7.6.1/W-0-1] PHẢI có ít nhất 1 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
-
[7.6.1/W-0-2] PHẢI có ít nhất 416 MB bộ nhớ cho nhân và không gian người dùng.
-
[7.8.1/W-0-1] PHẢI có micrô.
-
[7.8.2/W] CÓ THỂ nhưng KHÔNG NÊN có đầu ra âm thanh.
2.4.2. Đa phương tiện
Không có yêu cầu bổ sung.
2.4.3. Phần mềm
Xem cách triển khai thiết bị:
- [3/W-0-1] PHẢI khai báo tính năng
android.hardware.type.watch
. - [3/W-0-2] PHẢI hỗ trợ uiMode = UI_MODE_TYPE_WATCH.
Xem cách triển khai thiết bị:
- [3.8.4/W-SR] Bạn NÊN triển khai một trợ lý trên thiết bị để xử lý Thao tác hỗ trợ.
Xem các cách triển khai thiết bị đồng hồ khai báo cờ tính năng android.hardware.audio.output
:
- [3.10/W-1-1] PHẢI hỗ trợ các dịch vụ hỗ trợ tiếp cận của bên thứ ba.
- [3.10/W-SR] Bạn NÊN tải trước các dịch vụ hỗ trợ tiếp cận trên thiết bị có chức năng tương đương hoặc vượt trội so với các dịch vụ hỗ trợ tiếp cận của Tiếp cận bằng công tắc và TalkBack (đối với các ngôn ngữ được công cụ Chuyển văn bản sang lời nói được cài đặt sẵn hỗ trợ) như được cung cấp trong dự án nguồn mở talkback.
Nếu việc triển khai thiết bị Watch báo cáo tính năng android.hardware.audio.output, thì các thiết bị đó:
-
[3.11/W-SR] Bạn NÊN đưa công cụ TTS hỗ trợ các ngôn ngữ có trên thiết bị vào.
-
[3.11/W-0-1] PHẢI hỗ trợ cài đặt công cụ TTS của bên thứ ba.
2.4.4. Hiệu suất và nguồn điện
Nếu việc triển khai thiết bị Watch bao gồm các tính năng để cải thiện khả năng quản lý nguồn điện của thiết bị có trong AOSP hoặc mở rộng các tính năng có trong AOSP, thì các tính năng đó:
- [8.3/W-SR] Bạn NÊN cung cấp cho người dùng khả năng hiển thị tất cả ứng dụng được miễn trừ khỏi chế độ Trạng thái chờ ứng dụng và chế độ tiết kiệm pin Ngủ.
- [8.3/W-SR] NÊN cung cấp cho người dùng khả năng bật và tắt tính năng tiết kiệm pin.
Xem cách triển khai thiết bị:
- [8.4/W-0-1] PHẢI cung cấp hồ sơ năng lượng cho mỗi thành phần xác định giá trị tiêu thụ hiện tại cho mỗi thành phần phần cứng và mức tiêu hao pin gần đúng do các thành phần gây ra theo thời gian như được ghi nhận trong trang web Dự án nguồn mở Android.
- [8.4/W-0-2] PHẢI báo cáo tất cả giá trị tiêu thụ điện năng theo đơn vị miliampe giờ (mAh).
- [8.4/W-0-3] PHẢI báo cáo mức tiêu thụ điện năng của CPU theo UID của từng quy trình. Dự án nguồn mở Android đáp ứng yêu cầu này thông qua việc triển khai mô-đun hạt nhân
uid_cputime
. - [8.4/W-0-4] PHẢI cung cấp thông tin về mức sử dụng năng lượng này cho nhà phát triển ứng dụng thông qua lệnh shell
adb shell dumpsys batterystats
. - [8,4/W] NÊN được phân bổ cho chính thành phần phần cứng nếu không thể phân bổ mức sử dụng năng lượng của thành phần phần cứng cho một ứng dụng.
2.5. Yêu cầu về ô tô
Triển khai Android Automotive đề cập đến đầu phát trung tâm trên ô tô chạy Android làm hệ điều hành cho một phần hoặc toàn bộ hệ thống và/hoặc chức năng thông tin giải trí.
Các hoạt động triển khai thiết bị Android được phân loại là Automotive nếu chúng khai báo tính năng android.hardware.type.automotive
hoặc đáp ứng tất cả các tiêu chí sau.
- Được nhúng vào hoặc có thể cắm vào một xe ô tô.
- Sử dụng màn hình ở hàng ghế lái làm màn hình chính.
Các yêu cầu bổ sung trong phần còn lại của phần này dành riêng cho việc triển khai thiết bị Android Automotive.
2.5.1. Phần cứng
Triển khai thiết bị ô tô:
- [7.1.1.1/A-0-1] PHẢI có màn hình có kích thước đường chéo vật lý tối thiểu là 6 inch.
-
[7.1.1.1/A-0-2] PHẢI có bố cục kích thước màn hình tối thiểu là 750 dp x 480 dp.
-
[7.2.3/A-0-1] PHẢI cung cấp hàm Home (Trang chủ) và CÓ THỂ cung cấp hàm Back (Quay lại) và Recent (Gần đây).
-
[7.2.3/A-0-2] PHẢI gửi cả sự kiện nhấn thông thường và nhấn và giữ của hàm Quay lại (
KEYCODE_BACK
) đến ứng dụng trên nền trước. -
[7.3.1/A-SR] NÊN có gia tốc kế 3 trục.
Nếu việc triển khai thiết bị ô tô bao gồm gia tốc kế 3 trục, thì các thiết bị đó:
- [7.3.1/A-1-1] PHẢI có khả năng báo cáo các sự kiện với tần suất tối thiểu là 100 Hz.
- [7.3.1/A-1-2] PHẢI tuân thủ hệ thống toạ độ cảm biến ô tô của Android.
Nếu việc triển khai thiết bị ô tô bao gồm con quay hồi chuyển, thì các thiết bị đó:
- [7.3.4/A-1-1] PHẢI có thể báo cáo các sự kiện với tần suất tối thiểu là 100 Hz.
Triển khai thiết bị ô tô:
- [7.3.11/A-0-1] PHẢI cung cấp thiết bị hiện tại dưới dạng
SENSOR_TYPE_GEAR
.
Triển khai thiết bị ô tô:
- [7.3.11.2/A-0-1] PHẢI hỗ trợ chế độ ban ngày/ban đêm được xác định là
SENSOR_TYPE_NIGHT
. - [7.3.11.2/A-0-2] Giá trị của cờ
SENSOR_TYPE_NIGHT
PHẢI nhất quán với chế độ ban ngày/ban đêm của trang tổng quan và PHẢI dựa trên dữ liệu đầu vào của cảm biến ánh sáng môi trường xung quanh. -
Cảm biến ánh sáng xung quanh cơ bản CÓ THỂ giống với Photometer.
-
[7.3.11.4/A-0-1] PHẢI cung cấp tốc độ xe như được xác định bởi
SENSOR_TYPE_CAR_SPEED
. -
[7.3.11.5/A-0-1] PHẢI cung cấp trạng thái phanh tay do
SENSOR_TYPE_PARKING_BRAKE
xác định. -
[7.4.3/A-0-1] PHẢI hỗ trợ Bluetooth và NÊN hỗ trợ Bluetooth LE.
- [7.4.3/A-0-2] Việc triển khai Android Automotive PHẢI hỗ trợ các hồ sơ Bluetooth sau:
- Gọi điện thoại qua Cấu hình rảnh tay (HFP).
- Phát nội dung nghe nhìn qua Cấu hình phân phối âm thanh (A2DP).
- Điều khiển chế độ phát nội dung nghe nhìn qua Cấu hình điều khiển từ xa (AVRCP).
- Chia sẻ danh bạ bằng Cấu hình truy cập danh bạ (PBAP).
-
[7.4.3/A-SR] NÊN hỗ trợ Hồ sơ truy cập tin nhắn (MAP).
-
[7.4.5/A] PHẢI hỗ trợ kết nối dữ liệu dựa trên mạng di động.
-
[7.4.5/A] CÓ THỂ sử dụng hằng số
NetworkCapabilities#NET_CAPABILITY_OEM_PAID
của API hệ thống cho các mạng mà ứng dụng hệ thống có thể sử dụng. -
[7.6.1/A-0-1] PHẢI có ít nhất 4 GB bộ nhớ không bay hơi cho dữ liệu riêng tư của ứng dụng (còn gọi là phân vùng "/data").
Triển khai thiết bị ô tô:
- [7.6.1/A] NÊN định dạng phân vùng dữ liệu để cải thiện hiệu suất và thời lượng sử dụng trên bộ nhớ flash, ví dụ: sử dụng hệ thống tệp
f2fs
.
Nếu việc triển khai thiết bị Automotive cung cấp bộ nhớ ngoài dùng chung thông qua một phần bộ nhớ trong không thể tháo rời, thì các thiết bị đó:
- [7.6.1/A-SR] Bạn NÊN giảm mức hao tổn I/O trên các thao tác được thực hiện trên bộ nhớ ngoài, ví dụ: bằng cách sử dụng
SDCardFS
.
Nếu việc triển khai thiết bị Automotive là 32 bit:
-
[7.6.1/A-1-1] Bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 512 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 280dpi trở xuống trên màn hình nhỏ/bình thường
- ldpi trở xuống trên màn hình cực lớn
- mdpi trở xuống trên màn hình lớn
-
[7.6.1/A-1-2] Dung lượng bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 608 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- xhdpi trở lên trên màn hình nhỏ/bình thường
- hdpi trở lên trên màn hình lớn
- mdpi trở lên trên màn hình cực lớn
-
[7.6.1/A-1-3] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 896 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 400dpi trở lên trên màn hình nhỏ/bình thường
- xhdpi trở lên trên màn hình lớn
- tvdpi trở lên trên màn hình cực lớn
-
[7.6.1/A-1-4] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1344 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 560dpi trở lên trên màn hình nhỏ/bình thường
- 400dpi trở lên trên màn hình lớn
- xhdpi trở lên trên màn hình cực lớn
Nếu việc triển khai thiết bị ô tô là 64 bit:
-
[7.6.1/A-2-1] Bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 816 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 280dpi trở xuống trên màn hình nhỏ/bình thường
- ldpi trở xuống trên màn hình cực lớn
- mdpi trở xuống trên màn hình lớn
-
[7.6.1/A-2-2] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 944 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- xhdpi trở lên trên màn hình nhỏ/bình thường
- hdpi trở lên trên màn hình lớn
- mdpi trở lên trên màn hình cực lớn
-
[7.6.1/A-2-3] Dung lượng bộ nhớ có sẵn cho nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1280 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 400dpi trở lên trên màn hình nhỏ/bình thường
- xhdpi trở lên trên màn hình lớn
- tvdpi trở lên trên màn hình cực lớn
-
[7.6.1/A-2-4] Dung lượng bộ nhớ có sẵn cho hạt nhân và không gian người dùng PHẢI có dung lượng tối thiểu là 1824 MB nếu sử dụng bất kỳ mật độ nào sau đây:
- 560dpi trở lên trên màn hình nhỏ/bình thường
- 400dpi trở lên trên màn hình lớn
- xhdpi trở lên trên màn hình cực lớn
Xin lưu ý rằng "bộ nhớ có sẵn cho nhân và không gian người dùng" ở trên đề cập đến không gian bộ nhớ được cung cấp ngoài mọi bộ nhớ đã dành riêng cho các thành phần phần cứng như đài, video, v.v. không thuộc quyền kiểm soát của nhân trong quá trình triển khai thiết bị.
Triển khai thiết bị ô tô:
- [7.7.1/A] PHẢI có cổng USB hỗ trợ chế độ ngoại vi.
Triển khai thiết bị ô tô:
- [7.8.1/A-0-1] PHẢI có micrô.
Triển khai thiết bị ô tô:
- [7.8.2/A-0-1] PHẢI có đầu ra âm thanh và khai báo
android.hardware.audio.output
.
2.5.2. Đa phương tiện
Quá trình triển khai thiết bị ô tô PHẢI hỗ trợ các định dạng mã hoá âm thanh sau:
- [5.1/A-0-1] Hồ sơ MPEG-4 AAC (AAC LC)
- [5.1/A-0-2] Hồ sơ MPEG-4 HE AAC (AAC+)
- [5.1/A-0-3] AAC ELD (AAC độ trễ thấp nâng cao)
Quá trình triển khai thiết bị ô tô PHẢI hỗ trợ các kiểu mã hoá video sau:
Quá trình triển khai thiết bị ô tô PHẢI hỗ trợ tính năng giải mã video sau:
Bạn NÊN triển khai các thiết bị ô tô để hỗ trợ giải mã video sau:
- [5.3/A-SR] H.265 HEVC
2.5.3. Phần mềm
Triển khai thiết bị ô tô:
-
[3/A-0-1] PHẢI khai báo tính năng
android.hardware.type.automotive
. -
[3/A-0-2] PHẢI hỗ trợ uiMode =
UI_MODE_TYPE_CAR
. -
[3/A-0-3] PHẢI hỗ trợ tất cả API công khai trong không gian tên
android.car.*
. -
[3.4.1/A-0-1] PHẢI cung cấp cách triển khai đầy đủ API
android.webkit.Webview
. -
[3.8.3/A-0-1] PHẢI hiển thị thông báo sử dụng API
Notification.CarExtender
khi ứng dụng bên thứ ba yêu cầu. -
[3.8.4/A-SR] Bạn nên triển khai một trợ lý trên thiết bị để xử lý Thao tác hỗ trợ.
-
[3.13/A-SR] Bạn NÊN đưa thành phần giao diện người dùng Cài đặt nhanh vào.
Nếu việc triển khai thiết bị Automotive có nút nhấn để nói, thì các thiết bị đó:
- [3.8.4/A-1-1] PHẢI sử dụng thao tác nhấn nhanh vào nút nhấn để nói làm thao tác tương tác được chỉ định để khởi chạy ứng dụng hỗ trợ do người dùng chọn, nói cách khác là ứng dụng triển khai
VoiceInteractionService
.
Triển khai thiết bị ô tô:
- [3.14/A-0-1] PHẢI bao gồm một khung giao diện người dùng để hỗ trợ các ứng dụng bên thứ ba sử dụng API đa phương tiện như mô tả trong phần 3.14.
2.5.4. Hiệu suất và nguồn điện
Nếu việc triển khai thiết bị Automotive bao gồm các tính năng để cải thiện khả năng quản lý nguồn điện của thiết bị có trong AOSP hoặc mở rộng các tính năng có trong AOSP, thì các tính năng đó:
- [8.3/A-1-1] PHẢI cung cấp cho người dùng khả năng bật và tắt tính năng tiết kiệm pin.
- [8.3/A-1-2] PHẢI cung cấp cho người dùng khả năng hiển thị tất cả ứng dụng được miễn trừ khỏi chế độ tiết kiệm pin Chế độ chờ ứng dụng và Nghỉ.
Triển khai thiết bị ô tô:
- [8.2/A-0-1] PHẢI báo cáo số byte được đọc và ghi vào bộ nhớ không bay hơi cho mỗi UID của quy trình để nhà phát triển có thể xem số liệu thống kê thông qua API hệ thống
android.car.storagemonitoring.CarStorageMonitoringManager
. Dự án nguồn mở Android đáp ứng yêu cầu thông qua mô-đun hạt nhânuid_sys_stats
. - [8.4/A-0-1] PHẢI cung cấp hồ sơ năng lượng cho mỗi thành phần xác định giá trị tiêu thụ hiện tại cho mỗi thành phần phần cứng và mức tiêu hao pin gần đúng do các thành phần gây ra theo thời gian như được ghi nhận trong trang web Dự án nguồn mở Android.
- [8.4/A-0-2] PHẢI báo cáo tất cả giá trị tiêu thụ điện năng theo đơn vị miliampe giờ (mAh).
- [8.4/A-0-3] PHẢI báo cáo mức tiêu thụ điện năng của CPU theo UID của mỗi quy trình. Dự án nguồn mở Android đáp ứng yêu cầu này thông qua việc triển khai mô-đun hạt nhân
uid_cputime
. - [8.4/A] NÊN được phân bổ cho chính thành phần phần cứng nếu không thể phân bổ mức sử dụng năng lượng của thành phần phần cứng cho một ứng dụng.
- [8.4/A-0-4] PHẢI cung cấp mức sử dụng năng lượng này cho nhà phát triển ứng dụng thông qua lệnh shell
adb shell dumpsys batterystats
.
2.5.5. Mô hình bảo mật
Nếu việc triển khai thiết bị Automotive hỗ trợ nhiều người dùng, thì các thiết bị đó:
- [9.5/A-1-1] PHẢI có một tài khoản khách cho phép tất cả các chức năng do hệ thống xe cung cấp mà không yêu cầu người dùng đăng nhập.
Nếu việc triển khai thiết bị ô tô hỗ trợ màn hình khoá bảo mật, thì các thiết bị đó:
- [9.9.2/A-1-1] PHẢI hỗ trợ mã hoá theo khoá xác thực dành riêng cho người dùng. Mã hoá dựa trên tệp (FBE) là một cách để thực hiện việc này.
Triển khai thiết bị ô tô:
- [9.14/A-0-1] PHẢI kiểm soát thông báo từ các hệ thống con của khung xe Android, ví dụ: đưa vào danh sách cho phép các loại thông báo và nguồn thông báo được phép.
- [9.14/A-0-2] PHẢI giám sát để chống lại các cuộc tấn công từ chối dịch vụ từ khung Android hoặc ứng dụng bên thứ ba. Điều này giúp ngăn chặn phần mềm độc hại làm ngập mạng xe bằng lưu lượng truy cập, từ đó có thể dẫn đến các hệ thống phụ của xe hoạt động không đúng cách.
2.6. Yêu cầu đối với máy tính bảng
Thiết bị máy tính bảng Android là một thiết bị Android đáp ứng tất cả các tiêu chí sau:
- Thường được sử dụng bằng cách cầm bằng cả hai tay.
- Không có cấu hình dạng vỏ sò hoặc có thể chuyển đổi.
- Mọi hoạt động triển khai bàn phím thực dùng với thiết bị PHẢI kết nối thông qua một phương thức kết nối tiêu chuẩn.
- Có nguồn điện cung cấp khả năng di động, chẳng hạn như pin.
- Có kích thước màn hình thực theo đường chéo trong khoảng từ 7 đến 18 inch.
Việc triển khai thiết bị máy tính bảng có các yêu cầu tương tự như việc triển khai thiết bị cầm tay. Các trường hợp ngoại lệ được biểu thị bằng dấu * trong phần đó và được ghi chú để tham khảo trong phần này.
2.4.1. Phần cứng
Kích thước màn hình
- [7.1.1.1/Tab-0-1] PHẢI có màn hình trong khoảng từ 7 đến 18 inch.
Bộ nhớ và dung lượng lưu trữ tối thiểu (Mục 7.6.1)
Mật độ màn hình được liệt kê cho màn hình nhỏ/bình thường trong các yêu cầu về thiết bị cầm tay không áp dụng cho máy tính bảng.
Chế độ thiết bị ngoại vi USB (Mục 7.7.1)
Nếu việc triển khai thiết bị máy tính bảng bao gồm một cổng USB hỗ trợ chế độ ngoại vi, thì các thiết bị đó:
- [7.7.1/Tab] CÓ THỂ triển khai API Phụ kiện mở Android (AOA).
Chế độ thực tế ảo (Mục 7.9.1)
Hiệu suất cao trong thực tế ảo (Mục 7.9.2)
Các yêu cầu về thực tế ảo không áp dụng cho máy tính bảng.
3. Phần mềm
3.1. Khả năng tương thích với API được quản lý
Môi trường thực thi mã byte Dalvik được quản lý là phương tiện chính cho các ứng dụng Android. Giao diện lập trình ứng dụng (API) Android là tập hợp các giao diện nền tảng Android hiển thị cho các ứng dụng chạy trong môi trường thời gian chạy được quản lý.
Triển khai trên thiết bị:
-
[C-0-1] PHẢI cung cấp cách triển khai đầy đủ, bao gồm tất cả hành vi được ghi nhận, của mọi API được ghi nhận mà SDK Android hiển thị hoặc mọi API được trang trí bằng điểm đánh dấu "@SystemApi" trong mã nguồn Android thượng nguồn.
-
[C-0-2] PHẢI hỗ trợ/duy trì tất cả các lớp, phương thức và phần tử liên kết được đánh dấu bằng chú thích TestApi (@TestApi).
-
[C-0-3] KHÔNG ĐƯỢC bỏ qua bất kỳ API nào được quản lý, thay đổi giao diện hoặc chữ ký API, sai lệch với hành vi được ghi nhận hoặc bao gồm các thao tác không hoạt động, ngoại trừ trường hợp được Định nghĩa về khả năng tương thích này cho phép cụ thể.
-
[C-0-4] VẪN PHẢI duy trì các API và hoạt động một cách hợp lý, ngay cả khi một số tính năng phần cứng mà Android bao gồm API bị bỏ qua. Hãy xem mục 7 để biết các yêu cầu cụ thể cho trường hợp này.
-
[C-0-5] PHẢI hạn chế việc ứng dụng bên thứ ba sử dụng các API ẩn, được xác định là API trong không gian tên Android được trang trí bằng chú thích
@hidden
nhưng không phải bằng@SystemAPI
hoặc@TestApi
, như mô tả trong tài liệu SDK và vận chuyển cùng với mọi API ẩn trên cùng một danh sách hạn chế như được cung cấp thông qua danh sách tạm thời và tệp danh sách từ chối trong đường dẫnprebuilts/runtime/appcompat/
cho nhánh cấp độ API thích hợp trong AOSP. Tuy nhiên, các ứng dụng này:- CÓ THỂ, nếu một API ẩn không có hoặc được triển khai theo cách khác trên quá trình triển khai thiết bị, hãy chuyển API ẩn đó vào danh sách từ chối hoặc loại bỏ API đó khỏi tất cả danh sách bị hạn chế.
- CÓ THỂ, nếu một API ẩn chưa tồn tại trong AOSP, hãy thêm API ẩn đó vào bất kỳ danh sách bị hạn chế nào.
- CÓ THỂ triển khai cơ chế cập nhật động để di chuyển một API ẩn từ danh sách bị hạn chế sang danh sách ít hạn chế hơn, ngoại trừ danh sách cho phép.
3.1.1. Tiện ích Android
Android hỗ trợ việc mở rộng các API được quản lý trong khi vẫn giữ nguyên phiên bản cấp độ API.
- [C-0-1] Việc triển khai thiết bị Android PHẢI tải trước việc triển khai AOSP của cả thư viện dùng chung
ExtShared
và dịch vụExtServices
có phiên bản cao hơn hoặc bằng phiên bản tối thiểu được phép cho mỗi cấp độ API. Ví dụ: việc triển khai thiết bị Android 7.0, chạy API cấp 24 PHẢI bao gồm ít nhất phiên bản 1.
3.1.2. Thư viện Android
Do ngừng sử dụng ứng dụng Apache HTTP, các hoạt động triển khai thiết bị:
- [C-0-1] KHÔNG ĐƯỢC đặt thư viện
org.apache.http.legacy
vào đường dẫn lớp khởi động. - [C-0-2] CHỈ được thêm thư viện
org.apache.http.legacy
vào đường dẫn lớp của ứng dụng khi ứng dụng đáp ứng một trong các điều kiện sau:- Nhắm đến API cấp 28 trở xuống.
- Khai báo trong tệp kê khai rằng ứng dụng cần thư viện bằng cách đặt thuộc tính
android:name
của<uses-library>
thànhorg.apache.http.legacy
.
Việc triển khai AOSP đáp ứng các yêu cầu này.
3.2. Khả năng tương thích mềm của API
Ngoài các API được quản lý trong phần 3.1, Android cũng bao gồm một API "mềm" quan trọng chỉ có trong thời gian chạy, dưới dạng các ý định, quyền và các khía cạnh tương tự của ứng dụng Android không thể được thực thi tại thời điểm biên dịch ứng dụng.
3.2.1. Quyền
- [C-0-1] Người triển khai thiết bị PHẢI hỗ trợ và thực thi tất cả hằng số quyền như được ghi nhận trong Trang tham khảo về quyền. Xin lưu ý rằng mục 9 liệt kê các yêu cầu bổ sung liên quan đến mô hình bảo mật của Android.
3.2.2. Tham số bản dựng
API Android bao gồm một số hằng số trên lớp android.os.Build dùng để mô tả thiết bị hiện tại.
- [C-0-1] Để cung cấp các giá trị nhất quán và có ý nghĩa trên các hoạt động triển khai thiết bị, bảng bên dưới bao gồm các quy định hạn chế bổ sung về định dạng của các giá trị này mà hoạt động triển khai thiết bị PHẢI tuân thủ.
Thông số | Thông tin chi tiết |
---|---|
VERSION.RELEASE | Phiên bản của hệ thống Android đang thực thi, ở định dạng mà con người có thể đọc được. Trường này PHẢI có một trong các giá trị chuỗi được xác định trong 9. |
VERSION.SDK | Phiên bản của hệ thống Android đang thực thi, ở định dạng mà mã ứng dụng bên thứ ba có thể truy cập. Đối với Android 9, trường này PHẢI có giá trị số nguyên 9_INT. |
VERSION.SDK_INT | Phiên bản của hệ thống Android đang thực thi, ở định dạng mà mã ứng dụng bên thứ ba có thể truy cập. Đối với Android 9, trường này PHẢI có giá trị số nguyên 9_INT. |
VERSION.INCREMENTAL | Giá trị do người triển khai thiết bị chọn, chỉ định bản dựng cụ thể của hệ thống Android đang thực thi, ở định dạng mà con người có thể đọc được. KHÔNG ĐƯỢC sử dụng lại giá trị này cho các bản dựng khác nhau được cung cấp cho người dùng cuối. Trường này thường được dùng để cho biết số bản dựng hoặc giá trị nhận dạng thay đổi trong hệ thống quản lý nguồn đã được dùng để tạo bản dựng. Không có yêu cầu về định dạng cụ thể của trường này, ngoại trừ việc trường này KHÔNG ĐƯỢC rỗng hoặc chuỗi trống (""). |
BẢNG | Giá trị do người triển khai thiết bị chọn để xác định phần cứng nội bộ cụ thể mà thiết bị sử dụng, ở định dạng mà con người có thể đọc được. Bạn có thể sử dụng trường này để cho biết bản sửa đổi cụ thể của bo mạch cấp nguồn cho thiết bị. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9_-]+$”. |
THƯƠNG HIỆU | Giá trị phản ánh tên thương hiệu được liên kết với thiết bị mà người dùng cuối biết. PHẢI ở định dạng mà con người có thể đọc được và NÊN đại diện cho nhà sản xuất thiết bị hoặc thương hiệu công ty mà thiết bị được tiếp thị. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9_-]+$”. |
SUPPORTED_ABIS | Tên của tập lệnh (loại CPU + quy ước ABI) của mã gốc. Xem mục 3.3. Khả năng tương thích với API gốc. |
SUPPORTED_32_BIT_ABIS | Tên của tập lệnh (loại CPU + quy ước ABI) của mã gốc. Xem mục 3.3. Khả năng tương thích với API gốc. |
SUPPORTED_64_BIT_ABIS | Tên của tập lệnh thứ hai (loại CPU + quy ước ABI) của mã gốc. Xem mục 3.3. Khả năng tương thích với API gốc. |
CPU_ABI | Tên của tập lệnh (loại CPU + quy ước ABI) của mã gốc. Xem mục 3.3. Khả năng tương thích với API gốc. |
CPU_ABI2 | Tên của tập lệnh thứ hai (loại CPU + quy ước ABI) của mã gốc. Xem mục 3.3. Khả năng tương thích với API gốc. |
THIẾT BỊ | Giá trị do người triển khai thiết bị chọn, chứa tên phát triển hoặc tên mã xác định cấu hình của các tính năng phần cứng và thiết kế công nghiệp của thiết bị. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy "^[a-zA-Z0-9_-]+$". Tên thiết bị này KHÔNG ĐƯỢC thay đổi trong suốt thời gian hoạt động của sản phẩm. |
VÂN TAY |
Một chuỗi nhận dạng duy nhất bản dựng này. Tên này PHẢI dễ đọc đối với con người. Tiêu đề phải tuân theo mẫu sau:
$(BRAND)/$(PRODUCT)/ Ví dụ:
acme/myproduct/ Vân tay KHÔNG ĐƯỢC chứa ký tự khoảng trắng. Nếu các trường khác có trong mẫu ở trên có ký tự khoảng trắng, thì bạn PHẢI thay thế các ký tự đó trong vân tay bản dựng bằng một ký tự khác, chẳng hạn như ký tự dấu gạch dưới ("_"). Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit. |
PHẦN CỨNG | Tên của phần cứng (từ dòng lệnh hạt nhân hoặc /proc). Tên này PHẢI dễ đọc đối với con người. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9_-]+$”. |
MÁY CHỦ | Một chuỗi nhận dạng duy nhất máy chủ lưu trữ mà bản dựng được tạo, ở định dạng mà con người đọc được. Không có yêu cầu về định dạng cụ thể của trường này, ngoại trừ việc trường này KHÔNG ĐƯỢC rỗng hoặc chuỗi trống (""). |
ID | Giá trị nhận dạng do người triển khai thiết bị chọn để tham chiếu đến một bản phát hành cụ thể, ở định dạng mà con người có thể đọc được. Trường này có thể giống với android.os.Build.VERSION.INCREMENTAL, nhưng PHẢI là một giá trị đủ ý nghĩa để người dùng cuối có thể phân biệt giữa các bản dựng phần mềm. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9._-]+$”. |
NHÀ SẢN XUẤT | Tên thương mại của Nhà sản xuất thiết bị gốc (OEM) của sản phẩm. Không có yêu cầu cụ thể về định dạng của trường này, ngoại trừ việc trường này KHÔNG ĐƯỢC để trống hoặc chuỗi trống (""). Trường này KHÔNG ĐƯỢC thay đổi trong suốt thời gian hoạt động của sản phẩm. |
KIỂU MÁY | Giá trị do người triển khai thiết bị chọn, chứa tên của thiết bị mà người dùng cuối biết. Tên này PHẢI giống với tên mà thiết bị được tiếp thị và bán cho người dùng cuối. Không có yêu cầu cụ thể về định dạng của trường này, ngoại trừ việc trường này KHÔNG ĐƯỢC để trống hoặc chuỗi trống (""). Trường này KHÔNG ĐƯỢC thay đổi trong suốt thời gian hoạt động của sản phẩm. |
SẢN PHẨM | Giá trị do người triển khai thiết bị chọn, chứa tên phát triển hoặc tên mã của sản phẩm cụ thể (SKU) và PHẢI là duy nhất trong cùng một thương hiệu. PHẢI là văn bản mà con người có thể đọc được, nhưng không nhất thiết phải là văn bản mà người dùng cuối có thể xem. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9_-]+$”. Tên sản phẩm này KHÔNG ĐƯỢC thay đổi trong suốt thời gian hoạt động của sản phẩm. |
SỐ SÊ-RI | PHẢI trả về "UNKNOWN". |
THẺ TỪ KHOÁ | Danh sách các thẻ được phân tách bằng dấu phẩy do người triển khai thiết bị chọn để phân biệt thêm bản dựng. Trường này PHẢI có một trong các giá trị tương ứng với 3 cấu hình ký điển hình của nền tảng Android: khoá phát hành, khoá nhà phát triển, khoá kiểm thử. |
THỜI GIAN | Giá trị đại diện cho dấu thời gian của thời điểm bản dựng xảy ra. |
LOẠI | Giá trị do người triển khai thiết bị chọn, chỉ định cấu hình thời gian chạy của bản dựng. Trường này PHẢI có một trong các giá trị tương ứng với 3 cấu hình thời gian chạy Android thông thường: user, userdebug hoặc eng. |
NGƯỜI DÙNG | Tên hoặc mã nhận dạng người dùng của người dùng (hoặc người dùng tự động) đã tạo bản dựng. Không có yêu cầu về định dạng cụ thể của trường này, ngoại trừ việc trường này KHÔNG ĐƯỢC rỗng hoặc chuỗi trống (""). |
SECURITY_PATCH | Giá trị cho biết cấp bản vá bảo mật của một bản dựng. Chứng chỉ này PHẢI cho biết rằng bản dựng không gặp phải bất kỳ vấn đề nào được mô tả trong Bản tin công khai về bảo mật Android được chỉ định. Ngày phát hành PHẢI ở định dạng [YYYY-MM-DD], khớp với một chuỗi đã xác định được ghi lại trong Bản tin công khai về bảo mật Android hoặc trong Thông báo bảo mật của Android, ví dụ: "2015-11-01". |
BASE_OS | Một giá trị đại diện cho tham số FINGERPRINT của bản dựng giống hệt với bản dựng này, ngoại trừ các bản vá được cung cấp trong Bản tin bảo mật công khai của Android. Phương thức này PHẢI báo cáo giá trị chính xác và nếu không có bản dựng nào như vậy, hãy báo cáo một chuỗi trống (""). |
BOOTLOADER | Giá trị do người triển khai thiết bị chọn để xác định phiên bản trình tải khởi động nội bộ cụ thể được sử dụng trong thiết bị, ở định dạng mà con người có thể đọc được. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9._-]+$”. |
getRadioVersion() | PHẢI (là hoặc trả về) một giá trị do người triển khai thiết bị chọn để xác định phiên bản radio/mô-đun nội bộ cụ thể được sử dụng trong thiết bị, ở định dạng mà con người có thể đọc được. Nếu không có đài/mô-đun nội bộ, thiết bị PHẢI trả về giá trị NULL. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9._-,]+$”. |
getSerial() | PHẢI (là hoặc trả về) số sê-ri phần cứng, số này PHẢI có sẵn và duy nhất trên các thiết bị có cùng MẪU và NHÀ SẢN XUẤT. Giá trị của trường này PHẢI có thể mã hoá dưới dạng ASCII 7 bit và khớp với biểu thức chính quy “^[a-zA-Z0-9._-,]+$”. |
3.2.3. Khả năng tương thích với ý định
3.2.3.1. Ý định cốt lõi của ứng dụng
Ý định Android cho phép các thành phần ứng dụng yêu cầu chức năng từ các thành phần Android khác. Dự án ngược dòng Android bao gồm danh sách các ứng dụng được coi là ứng dụng Android cốt lõi, triển khai một số mẫu ý định để thực hiện các thao tác phổ biến.
-
[C-0-1] Việc triển khai thiết bị PHẢI tải trước một hoặc nhiều ứng dụng hoặc thành phần dịch vụ bằng trình xử lý ý định, đối với tất cả các mẫu bộ lọc ý định công khai do các ứng dụng Android cốt lõi sau đây xác định trong AOSP:
- Đồng hồ để bàn
- Trình duyệt
- Lịch
- Danh bạ
- Thư viện
- GlobalSearch
- Trình chạy
- Âm nhạc
- Cài đặt
3.2.3.2. Giải quyết ý định
-
[C-0-1] Vì Android là một nền tảng có thể mở rộng, nên việc triển khai thiết bị PHẢI cho phép các ứng dụng bên thứ ba ghi đè từng mẫu ý định được tham chiếu trong mục 3.2.3.1, ngoại trừ phần Cài đặt. Theo mặc định, phương thức triển khai nguồn mở Android ngược dòng cho phép điều này.
-
[C-0-2] Người triển khai Dvice KHÔNG ĐƯỢC đính kèm các đặc quyền đặc biệt vào việc sử dụng các mẫu ý định này của ứng dụng hệ thống hoặc ngăn ứng dụng bên thứ ba liên kết và giả định quyền kiểm soát các mẫu này. Quy định cấm này bao gồm nhưng không giới hạn ở việc tắt giao diện người dùng "Công cụ chọn" cho phép người dùng chọn giữa nhiều ứng dụng đều xử lý cùng một mẫu ý định.
-
[C-0-3] Việc triển khai thiết bị PHẢI cung cấp giao diện người dùng để người dùng sửa đổi hoạt động mặc định cho ý định.
-
Tuy nhiên, việc triển khai thiết bị CÓ THỂ cung cấp các hoạt động mặc định cho các mẫu URI cụ thể (ví dụ: http://play.google.com) khi hoạt động mặc định cung cấp thuộc tính cụ thể hơn cho URI dữ liệu. Ví dụ: mẫu bộ lọc ý định chỉ định URI dữ liệu "http://www.android.com" cụ thể hơn mẫu ý định cốt lõi của trình duyệt cho "http://".
Android cũng bao gồm một cơ chế để các ứng dụng bên thứ ba khai báo hành vi liên kết ứng dụng mặc định có thẩm quyền cho một số loại ý định URI web nhất định. Khi các nội dung khai báo có thẩm quyền như vậy được xác định trong mẫu bộ lọc ý định của ứng dụng, các hoạt động triển khai thiết bị sẽ:
- [C-0-4] PHẢI cố gắng xác thực mọi bộ lọc ý định bằng cách thực hiện các bước xác thực được xác định trong thông số kỹ thuật về Đường liên kết đến tài sản kỹ thuật số do Trình quản lý gói triển khai trong Dự án nguồn mở Android ngược dòng.
- [C-0-5] PHẢI xác thực bộ lọc ý định trong quá trình cài đặt ứng dụng và đặt tất cả bộ lọc ý định URI đã xác thực thành công làm trình xử lý ứng dụng mặc định cho URI của chúng.
- CÓ THỂ đặt các bộ lọc ý định URI cụ thể làm trình xử lý ứng dụng mặc định cho URI của chúng, nếu các bộ lọc đó được xác minh thành công nhưng các bộ lọc URI đề xuất khác không xác minh được. Nếu triển khai thiết bị thực hiện việc này, thì thiết bị đó PHẢI cung cấp cho người dùng các cơ chế ghi đè mẫu phù hợp cho mỗi URI trong trình đơn cài đặt.
- PHẢI cung cấp cho người dùng các chế độ kiểm soát Đường liên kết trong ứng dụng theo ứng dụng trong phần Cài đặt như sau:
- [C-0-6] Người dùng PHẢI có thể ghi đè toàn diện hành vi liên kết ứng dụng mặc định để ứng dụng: luôn mở, luôn hỏi hoặc không bao giờ mở, và điều này phải áp dụng như nhau cho tất cả bộ lọc ý định URI đề xuất.
- [C-0-7] Người dùng PHẢI xem được danh sách các bộ lọc ý định URI đề xuất.
- Việc triển khai thiết bị CÓ THỂ cho phép người dùng ghi đè các bộ lọc ý định URI đề xuất cụ thể đã được xác minh thành công, trên cơ sở mỗi bộ lọc ý định.
- [C-0-8] Việc triển khai thiết bị PHẢI cho phép người dùng xem và ghi đè các bộ lọc ý định URI đề xuất cụ thể nếu việc triển khai thiết bị cho phép một số bộ lọc ý định URI đề xuất xác minh thành công trong khi một số bộ lọc khác có thể không xác minh được.
3.2.3.3. Không gian tên ý định
- [C-0-1] Việc triển khai thiết bị KHÔNG ĐƯỢC bao gồm bất kỳ thành phần Android nào tuân thủ bất kỳ mẫu ý định mới hoặc ý định truyền tin nào bằng cách sử dụng ACTION, CATEGORY hoặc chuỗi khoá khác trong không gian tên android. hoặc com.android..
- [C-0-2] Người triển khai thiết bị KHÔNG ĐƯỢC đưa bất kỳ thành phần Android nào tuân thủ bất kỳ mẫu ý định mới hoặc ý định truyền tin nào bằng cách sử dụng ACTION, CATEGORY hoặc chuỗi khoá khác trong không gian gói thuộc về một tổ chức khác.
- [C-0-3] Người triển khai thiết bị KHÔNG ĐƯỢC thay đổi hoặc mở rộng bất kỳ mẫu ý định nào mà các ứng dụng cốt lõi sử dụng được liệt kê trong mục 3.2.3.1.
- Việc triển khai thiết bị CÓ THỂ bao gồm các mẫu ý định sử dụng không gian tên được liên kết rõ ràng và rõ ràng với tổ chức của riêng thiết bị. Quy định cấm này tương tự như quy định được chỉ định cho các lớp ngôn ngữ Java trong mục 3.6.
3.2.3.4. Ý định truyền tin
Các ứng dụng bên thứ ba dựa vào nền tảng để truyền tin một số ý định nhất định nhằm thông báo cho ứng dụng về những thay đổi trong môi trường phần cứng hoặc phần mềm.
Triển khai trên thiết bị:
- [C-0-1] PHẢI truyền phát ý định truyền tin công khai để phản hồi các sự kiện hệ thống thích hợp như mô tả trong tài liệu SDK. Xin lưu ý rằng yêu cầu này không xung đột với mục 3.5 vì giới hạn đối với các ứng dụng chạy ở chế độ nền cũng được mô tả trong tài liệu SDK.
3.2.3.5. Cài đặt ứng dụng mặc định
Android có các chế độ cài đặt giúp người dùng dễ dàng chọn ứng dụng mặc định, chẳng hạn như cho Màn hình chính hoặc SMS.
Khi thích hợp, việc triển khai thiết bị PHẢI cung cấp một trình đơn cài đặt tương tự và tương thích với mẫu bộ lọc ý định và các phương thức API được mô tả trong tài liệu SDK như bên dưới.
Nếu các hoạt động triển khai thiết bị báo cáo android.software.home_screen
, thì các hoạt động đó:
- [C-1-1] PHẢI tuân thủ ý định
android.settings.HOME_SETTINGS
để hiển thị trình đơn cài đặt ứng dụng mặc định cho Màn hình chính.
Nếu các hoạt động triển khai thiết bị báo cáo android.hardware.telephony
, thì các hoạt động đó:
-
[C-2-1] PHẢI cung cấp trình đơn cài đặt sẽ gọi ý định
android.provider.Telephony.ACTION_CHANGE_DEFAULT
để hiển thị hộp thoại thay đổi ứng dụng SMS mặc định. -
[C-2-2] PHẢI tuân thủ ý định
android.telecom.action.CHANGE_DEFAULT_DIALER
để hiển thị hộp thoại cho phép người dùng thay đổi ứng dụng Điện thoại mặc định.- PHẢI sử dụng giao diện người dùng của ứng dụng Điện thoại mặc định do người dùng chọn cho các cuộc gọi đến và đi, ngoại trừ cuộc gọi khẩn cấp sẽ sử dụng ứng dụng Điện thoại cài sẵn.
-
[C-2-3] PHẢI tuân thủ ý định android.telecom.action.CHANGE_PHONE_ACCOUNTS để cung cấp cho người dùng khả năng định cấu hình
ConnectionServices
liên kết vớiPhoneAccounts
, cũng như PhoneAccount mặc định mà nhà cung cấp dịch vụ viễn thông sẽ sử dụng để thực hiện cuộc gọi đi. Việc triển khai AOSP đáp ứng yêu cầu này bằng cách đưa trình đơn "Tuỳ chọn tài khoản gọi" vào trình đơn cài đặt "Cuộc gọi".
Nếu các hoạt động triển khai thiết bị báo cáo android.hardware.nfc.hce
, thì các hoạt động đó:
- [C-3-1] PHẢI tuân thủ ý định android.settings.NFC_PAYMENT_SETTINGS để hiển thị trình đơn cài đặt ứng dụng mặc định cho tính năng Chạm là thanh toán.
Nếu việc triển khai thiết bị hỗ trợ VoiceInteractionService
và có nhiều ứng dụng sử dụng API này được cài đặt cùng một lúc, thì các thiết bị đó:
- [C-4-1] PHẢI tuân thủ ý định
android.settings.ACTION_VOICE_INPUT_SETTINGS
để hiển thị trình đơn cài đặt ứng dụng mặc định cho tính năng nhập liệu bằng giọng nói và trợ giúp.
3.2.4. Hoạt động trên màn hình phụ
Nếu việc triển khai thiết bị cho phép chạy Hoạt động Android thông thường trên màn hình phụ, thì các thiết bị đó:
- [C-1-1] PHẢI đặt cờ tính năng
android.software.activities_on_secondary_displays
. - [C-1-2] PHẢI đảm bảo khả năng tương thích của API tương tự như một hoạt động chạy trên màn hình chính.
- [C-1-3] PHẢI đưa hoạt động mới đến cùng một màn hình với hoạt động đã khởi chạy hoạt động đó, khi hoạt động mới được khởi chạy mà không chỉ định màn hình mục tiêu thông qua API
ActivityOptions.setLaunchDisplayId()
. - [C-1-4] PHẢI huỷ tất cả hoạt động khi xoá màn hình có cờ
Display.FLAG_PRIVATE
. - [C-1-5] PHẢI đổi kích thước cho tất cả hoạt động trên
VirtualDisplay
cho phù hợp nếu chính màn hình được đổi kích thước. - CÓ THỂ hiển thị IME (trình chỉnh sửa phương thức nhập, một tuỳ chọn kiểm soát người dùng cho phép người dùng nhập văn bản) trên màn hình chính, khi một trường nhập văn bản được lấy tiêu điểm trên màn hình phụ.
- NÊN triển khai tiêu điểm đầu vào trên màn hình phụ độc lập với màn hình chính, khi các phương thức nhập bằng thao tác chạm hoặc phím được hỗ trợ.
- NÊN có
android.content.res.Configuration
tương ứng với màn hình đó để hiển thị, hoạt động chính xác và duy trì khả năng tương thích nếu một hoạt động được chạy trên màn hình phụ.
Nếu việc triển khai thiết bị cho phép khởi chạy Hoạt động Android thông thường trên màn hình phụ và màn hình chính và màn hình phụ có android.util.DisplayMetrics khác nhau:
- [C-2-1] KHÔNG ĐƯỢC cho phép các hoạt động không thể đổi kích thước (có
resizeableActivity=false
trongAndroidManifest.xml
) và ứng dụng nhắm đến API cấp 23 trở xuống trên màn hình phụ.
Nếu việc triển khai thiết bị cho phép khởi chạy Hoạt động Android thông thường trên màn hình phụ và màn hình phụ có cờ android.view.Display.FLAG_PRIVATE:
- [C-3-1] Chỉ chủ sở hữu của màn hình, hệ thống và các hoạt động đã có trên màn hình đó mới CÓ THỂ chạy trên màn hình đó. Mọi người đều có thể khởi chạy trên màn hình có cờ android.view.Display.FLAG_PUBLIC.
3.3. Khả năng tương thích với API gốc
Khả năng tương thích của mã gốc là một thách thức. Vì lý do này, trình triển khai thiết bị là:
- [SR] Bạn NÊN sử dụng các phương thức triển khai của các thư viện được liệt kê bên dưới từ Dự án nguồn mở Android ngược dòng.
3.3.1. Giao diện nhị phân của ứng dụng
Mã byte Dalvik được quản lý có thể gọi vào mã gốc được cung cấp trong tệp .apk
của ứng dụng dưới dạng tệp .so
ELF được biên dịch cho cấu trúc phần cứng thiết bị thích hợp. Vì mã gốc phụ thuộc nhiều vào công nghệ xử lý cơ bản, nên Android xác định một số Giao diện nhị phân của ứng dụng (ABI) trong Android NDK.
Triển khai trên thiết bị:
- [C-0-1] PHẢI tương thích với một hoặc nhiều ABI đã xác định và triển khai khả năng tương thích với Android NDK.
- [C-0-2] PHẢI hỗ trợ mã chạy trong môi trường được quản lý để gọi vào mã gốc, sử dụng ngữ nghĩa Giao diện gốc Java (JNI) chuẩn.
- [C-0-3] PHẢI tương thích với nguồn (tức là tương thích với tiêu đề) và tương thích với tệp nhị phân (đối với ABI) với từng thư viện bắt buộc trong danh sách bên dưới.
- [C-0-5] PHẢI báo cáo chính xác Giao diện nhị phân của ứng dụng (ABI) gốc mà thiết bị hỗ trợ, thông qua các tham số
android.os.Build.SUPPORTED_ABIS
,android.os.Build.SUPPORTED_32_BIT_ABIS
vàandroid.os.Build.SUPPORTED_64_BIT_ABIS
, mỗi tham số là một danh sách ABI được phân tách bằng dấu phẩy, sắp xếp từ ABI được ưu tiên nhất đến ABI được ưu tiên ít nhất. -
[C-0-6] BẮT BUỘC báo cáo, thông qua các tham số ở trên, một tập hợp con trong danh sách ABI sau đây và KHÔNG ĐƯỢC báo cáo bất kỳ ABI nào không có trong danh sách.
-
armeabi
-
armeabi-v7a
-
arm64-v8a
-
x86
-
x86-64
-
[C-0-7] PHẢI cung cấp tất cả các thư viện sau đây (cung cấp API gốc) cho các ứng dụng có mã gốc:
-
libaaudio.so (Hỗ trợ âm thanh gốc AAudio)
- libandroid.so (hỗ trợ hoạt động gốc trên Android)
- libc (thư viện C)
- libcamera2ndk.so
- libdl (trình liên kết động)
- libEGL.so (quản lý nền tảng OpenGL gốc)
- libGLESv1_CM.so (OpenGL ES 1.x)
- libGLESv2.so (OpenGL ES 2.0)
- libGLESv3.so (OpenGL ES 3.x)
- libicui18n.so
- libicuuc.so
- libjnigraphics.so
- liblog (Ghi nhật ký Android)
- libmediandk.so (hỗ trợ API nội dung nghe nhìn gốc)
- libm (thư viện toán học)
- libneuralnetworks.so (Neural Networks API)
- libOpenMAXAL.so (hỗ trợ OpenMAX AL 1.0.1)
- libOpenSLES.so (hỗ trợ âm thanh OpenSL ES 1.0.1)
- libRS.so
- libstdc++ (Hỗ trợ tối thiểu cho C++)
- libvulkan.so (Vulkan)
- libz (nén Zlib)
- Giao diện JNI
-
-
[C-0-8] KHÔNG ĐƯỢC thêm hoặc xoá các hàm công khai cho các thư viện gốc được liệt kê ở trên.
- [C-0-9] PHẢI liệt kê các thư viện không phải AOSP khác được hiển thị trực tiếp cho các ứng dụng bên thứ ba trong
/vendor/etc/public.libraries.txt
. - [C-0-10] KHÔNG ĐƯỢC hiển thị bất kỳ thư viện gốc nào khác, được triển khai và cung cấp trong AOSP dưới dạng thư viện hệ thống, cho các ứng dụng bên thứ ba nhắm đến API cấp 24 trở lên vì các thư viện này được đặt trước.
- [C-0-11] PHẢI xuất tất cả các ký hiệu hàm OpenGL ES 3.1 và Gói tiện ích Android, như được xác định trong NDK, thông qua thư viện
libGLESv3.so
. Xin lưu ý rằng mặc dù tất cả các ký hiệu PHẢI có mặt, nhưng phần 7.1.4.1 mô tả chi tiết hơn về các yêu cầu đối với thời điểm triển khai đầy đủ từng hàm tương ứng. - [C-0-12] PHẢI xuất các ký hiệu hàm cho các ký hiệu hàm cốt lõi Vulkan 1.0, cũng như các tiện ích
VK_KHR_surface
,VK_KHR_android_surface
,VK_KHR_swapchain
,VK_KHR_maintenance1
vàVK_KHR_get_physical_device_properties2
thông qua thư việnlibvulkan.so
. Xin lưu ý rằng mặc dù tất cả các ký hiệu PHẢI có mặt, nhưng mục 7.1.4.2 mô tả chi tiết hơn về các yêu cầu đối với thời điểm triển khai đầy đủ từng hàm tương ứng. - NÊN được tạo bằng mã nguồn và tệp tiêu đề có trong Dự án nguồn mở Android ngược dòng
Xin lưu ý rằng các bản phát hành Android trong tương lai có thể hỗ trợ thêm các ABI.
3.3.2. Khả năng tương thích với mã gốc ARM 32 bit
Nếu các hoạt động triển khai thiết bị báo cáo việc hỗ trợ ABI armeabi
, thì các hoạt động đó:
- [C-3-1] CŨNG PHẢI hỗ trợ
armeabi-v7a
và báo cáo việc hỗ trợ đó, vìarmeabi
chỉ dành cho khả năng tương thích ngược với các ứng dụng cũ.
Nếu quá trình triển khai thiết bị báo cáo việc hỗ trợ ABI armeabi-v7a
, thì đối với các ứng dụng sử dụng ABI này, chúng sẽ:
-
[C-2-1] PHẢI đưa các dòng sau vào
/proc/cpuinfo
và KHÔNG ĐƯỢC thay đổi các giá trị trên cùng một thiết bị, ngay cả khi các ABI khác đọc các giá trị đó.-
Features:
, theo sau là danh sách các tính năng CPU ARMv7 không bắt buộc mà thiết bị hỗ trợ. -
CPU architecture:
, theo sau là một số nguyên mô tả cấu trúc ARM được hỗ trợ cao nhất của thiết bị (ví dụ: "8" đối với thiết bị ARMv8).
-
-
[C-2-2] PHẢI luôn duy trì các thao tác sau, ngay cả trong trường hợp ABI được triển khai trên kiến trúc ARMv8, thông qua tính năng hỗ trợ CPU gốc hoặc thông qua tính năng mô phỏng phần mềm:
- Hướng dẫn SWP và SWPB.
- Lệnh SETEND.
- Thao tác rào chắn CP15ISB, CP15DSB và CP15DMB.
-
[C-2-3] PHẢI hỗ trợ tiện ích Advanced SIMD (còn gọi là NEON).
3.4. Khả năng tương thích với web
3.4.1. Khả năng tương thích với WebView
Nếu quá trình triển khai thiết bị cung cấp quá trình triển khai đầy đủ API android.webkit.Webview
, thì các quá trình đó:
- [C-1-1] PHẢI báo cáo
android.software.webview
. - [C-1-2] PHẢI sử dụng bản dựng Dự án Chromium từ Dự án nguồn mở Android ngược dòng trên nhánh Android 9 để triển khai API
android.webkit.WebView
. -
[C-1-3] Chuỗi tác nhân người dùng do WebView báo cáo PHẢI có định dạng như sau:
Mozilla/5.0 (Linux; Android $(VERSION); [$(MODEL)] [Build/$(BUILD)]; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 $(CHROMIUM_VER) Mobile Safari/537.36
- Giá trị của chuỗi $(VERSION) PHẢI giống với giá trị của android.os.Build.VERSION.RELEASE.
- Chuỗi $(MODEL) CÓ THỂ để trống, nhưng nếu không để trống thì CHÚNG PHẢI có cùng giá trị với android.os.Build.MODEL.
- Bạn CÓ THỂ bỏ qua "Build/$(BUILD)", nhưng nếu có, chuỗi $(BUILD) PHẢI giống với giá trị của android.os.Build.ID.
- Giá trị của chuỗi $(CHROMIUM_VER) PHẢI là phiên bản Chromium trong Dự án nguồn mở Android ngược dòng.
- Việc triển khai thiết bị CÓ THỂ bỏ qua Di động trong chuỗi tác nhân người dùng.
-
Thành phần WebView PHẢI hỗ trợ nhiều tính năng HTML5 nhất có thể và nếu hỗ trợ tính năng thì PHẢI tuân thủ quy cách HTML5.
3.4.2. Khả năng tương thích với trình duyệt
Nếu quá trình triển khai thiết bị bao gồm một ứng dụng Trình duyệt độc lập để duyệt web chung, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ từng API sau đây liên kết với HTML5:
- [C-1-2] PHẢI hỗ trợ API webstorage HTML5/W3C và NÊN hỗ trợ API IndexedDB HTML5/W3C. Xin lưu ý rằng khi các tổ chức tiêu chuẩn phát triển web chuyển sang ưu tiên IndexedDB hơn là webstorage, IndexedDB dự kiến sẽ trở thành một thành phần bắt buộc trong phiên bản Android sau này.
- CÓ THỂ gửi chuỗi tác nhân người dùng tuỳ chỉnh trong ứng dụng Trình duyệt độc lập.
- NÊN triển khai tính năng hỗ trợ nhiều HTML5 nhất có thể trên ứng dụng Trình duyệt độc lập (dù dựa trên ứng dụng Trình duyệt WebKit thượng nguồn hay ứng dụng thay thế của bên thứ ba).
Tuy nhiên, nếu quá trình triển khai thiết bị không bao gồm ứng dụng Trình duyệt độc lập, thì các thiết bị đó:
- [C-2-1] VẪN PHẢI hỗ trợ các mẫu ý định công khai như mô tả trong phần 3.2.3.1.
3.5. Khả năng tương thích về hành vi của API
Triển khai trên thiết bị:
- [C-0-9] PHẢI đảm bảo rằng khả năng tương thích hành vi của API được áp dụng cho tất cả ứng dụng đã cài đặt, trừ phi các ứng dụng đó bị hạn chế như mô tả trong Mục 3.5.1.
- [C-0-10] KHÔNG ĐƯỢC triển khai phương pháp danh sách cho phép chỉ đảm bảo khả năng tương thích về hành vi của API đối với các ứng dụng do người triển khai thiết bị chọn.
Hành vi của từng loại API (được quản lý, mềm, gốc và web) phải nhất quán với cách triển khai ưu tiên của Dự án nguồn mở Android ở thượng nguồn. Một số khía cạnh cụ thể về khả năng tương thích là:
- [C-0-1] Thiết bị KHÔNG ĐƯỢC thay đổi hành vi hoặc ngữ nghĩa của một ý định chuẩn.
- [C-0-2] Thiết bị KHÔNG ĐƯỢC thay đổi vòng đời hoặc ngữ nghĩa vòng đời của một loại thành phần hệ thống cụ thể (chẳng hạn như Dịch vụ, Hoạt động, ContentProvider, v.v.).
- [C-0-3] Thiết bị KHÔNG ĐƯỢC thay đổi ngữ nghĩa của một quyền tiêu chuẩn.
- Thiết bị KHÔNG ĐƯỢC thay đổi các giới hạn được thực thi đối với ứng dụng chạy nền. Cụ thể hơn, đối với các ứng dụng chạy nền:
- [C-0-4] chúng PHẢI ngừng thực thi các lệnh gọi lại do ứng dụng đăng ký để nhận đầu ra từ
GnssMeasurement
vàGnssNavigationMessage
. - [C-0-5] ứng dụng PHẢI giới hạn tốc độ cập nhật được cung cấp cho ứng dụng thông qua lớp API
LocationManager
hoặc phương thứcWifiManager.startScan()
. - [C-0-6] nếu ứng dụng nhắm đến API cấp 25 trở lên, thì ứng dụng KHÔNG ĐƯỢC cho phép đăng ký trình nhận truyền tin cho các thông báo truyền tin ngầm ẩn của ý định Android chuẩn trong tệp kê khai của ứng dụng, trừ phi ý định truyền tin yêu cầu quyền
protectionLevel
"signature"
hoặc"signatureOrSystem"
hoặc nằm trong danh sách miễn trừ. - [C-0-7] nếu ứng dụng nhắm đến API cấp 25 trở lên, thì ứng dụng PHẢI dừng các dịch vụ trong nền của ứng dụng, giống như khi ứng dụng đã gọi phương thức
stopSelf()
của các dịch vụ, trừ phi ứng dụng được đưa vào danh sách cho phép tạm thời để xử lý một tác vụ mà người dùng nhìn thấy. - [C-0-8] nếu ứng dụng nhắm đến API cấp 25 trở lên, thì ứng dụng PHẢI giải phóng các khoá chế độ thức mà ứng dụng giữ.
- [C-0-4] chúng PHẢI ngừng thực thi các lệnh gọi lại do ứng dụng đăng ký để nhận đầu ra từ
- [C-0-9] Thiết bị PHẢI trả về các trình cung cấp dịch vụ bảo mật sau đây dưới dạng 7 giá trị mảng đầu tiên từ phương thức
Security.getProviders()
, theo thứ tự đã cho và với tên đã cho (doProvider.getName()
trả về) và các lớp, trừ phi ứng dụng đã sửa đổi danh sách thông quainsertProviderAt()
hoặcremoveProvider()
. Thiết bị CÓ THỂ trả về các nhà cung cấp bổ sung sau danh sách nhà cung cấp được chỉ định bên dưới.-
AndroidNSSP –
android.security.net.config.NetworkSecurityConfigProvider
-
AndroidOpenSSL –
com.android.org.conscrypt.OpenSSLProvider
-
CertPathProvider –
sun.security.provider.CertPathProvider
-
AndroidKeyStoreBCWorkaround –
android.security.keystore.AndroidKeyStoreBCWorkaroundProvider
-
BC –
com.android.org.bouncycastle.jce.provider.BouncyCastleProvider
-
HarmonyJSSE –
com.android.org.conscrypt.JSSEProvider
-
AndroidKeyStore –
android.security.keystore.AndroidKeyStoreProvider
-
AndroidNSSP –
Danh sách bên trên chưa đầy đủ. Bộ kiểm thử tính tương thích (CTS) kiểm thử các phần quan trọng của nền tảng để xác định khả năng tương thích về hành vi, nhưng không phải tất cả. Bên triển khai có trách nhiệm đảm bảo khả năng tương thích về hành vi với Dự án nguồn mở Android. Vì lý do này, người triển khai thiết bị NÊN sử dụng mã nguồn có sẵn thông qua Dự án nguồn mở Android (nếu có thể), thay vì triển khai lại các phần quan trọng của hệ thống.
3.5.1. Hạn chế chạy trong nền
Nếu việc triển khai thiết bị triển khai các hạn chế về ứng dụng có trong AOSP hoặc mở rộng các hạn chế về ứng dụng, thì các hạn chế đó:
- [C-SR] Bạn NÊN cung cấp cho người dùng khả năng thao tác để họ có thể xem danh sách ứng dụng bị hạn chế.
- [C-1-2] PHẢI cung cấp cho người dùng khả năng bật / tắt các quy định hạn chế đối với từng ứng dụng.
- [C-1-3] KHÔNG ĐƯỢC tự động áp dụng các hạn chế khi không có bằng chứng về hành vi có hại cho tình trạng hệ thống, nhưng CÓ THỂ áp dụng các hạn chế đối với ứng dụng khi phát hiện hành vi có hại cho tình trạng hệ thống như bị kẹt khoá chế độ thức, các dịch vụ chạy trong thời gian dài và các tiêu chí khác. Các tiêu chí này CÓ THỂ do người triển khai thiết bị xác định nhưng PHẢI liên quan đến tác động của ứng dụng đối với tình trạng của hệ thống. KHÔNG được sử dụng các tiêu chí khác không liên quan hoàn toàn đến tình trạng hệ thống, chẳng hạn như ứng dụng không phổ biến trên thị trường, làm tiêu chí.
- [C-1-4] KHÔNG ĐƯỢC tự động áp dụng các hạn chế đối với ứng dụng khi người dùng đã tắt các hạn chế đối với ứng dụng theo cách thủ công và CÓ THỂ đề xuất người dùng áp dụng các hạn chế đối với ứng dụng.
- [C-1-5] PHẢI thông báo cho người dùng nếu các hạn chế về ứng dụng được áp dụng tự động cho một ứng dụng.
- [C-1-6] PHẢI trả về
true
choActivityManager.isBackgroundRestricted()
khi ứng dụng bị hạn chế gọi API này. - [C-1-7] KHÔNG ĐƯỢC hạn chế ứng dụng trên cùng ở chế độ nền trước mà người dùng sử dụng một cách rõ ràng.
- [C-1-8] PHẢI tạm ngưng các quy định hạn chế đối với một ứng dụng trở thành ứng dụng trên nền trước hàng đầu khi người dùng bắt đầu sử dụng ứng dụng từng bị hạn chế một cách rõ ràng.
3.6. Không gian tên API
Android tuân theo các quy ước về không gian tên gói và lớp do ngôn ngữ lập trình Java xác định. Để đảm bảo khả năng tương thích với các ứng dụng bên thứ ba, người triển khai thiết bị KHÔNG ĐƯỢC thực hiện bất kỳ sửa đổi bị cấm nào (xem bên dưới) đối với các không gian tên gói sau:
-
java.*
-
javax.*
-
sun.*
-
android.*
-
androidx.*
-
com.android.*
Tức là:
- [C-0-1] KHÔNG ĐƯỢC sửa đổi các API được hiển thị công khai trên nền tảng Android bằng cách thay đổi bất kỳ phương thức hoặc chữ ký lớp nào, hoặc bằng cách xoá các lớp hoặc trường lớp.
- [C-0-2] KHÔNG ĐƯỢC thêm bất kỳ phần tử nào được hiển thị công khai (chẳng hạn như lớp hoặc giao diện, hoặc trường hoặc phương thức vào các lớp hoặc giao diện hiện có) hoặc API Kiểm thử hoặc API Hệ thống vào các API trong không gian tên ở trên. "Thành phần hiển thị công khai" là bất kỳ cấu trúc nào không được trang trí bằng điểm đánh dấu "@hide" như được sử dụng trong mã nguồn Android ngược dòng.
Người triển khai thiết bị CÓ THỂ sửa đổi phương thức triển khai cơ bản của các API, nhưng những sửa đổi đó:
- [C-0-3] KHÔNG ĐƯỢC ảnh hưởng đến hành vi đã nêu và chữ ký ngôn ngữ Java của bất kỳ API nào được công khai.
- [C-0-4] KHÔNG ĐƯỢC quảng cáo hoặc hiển thị cho nhà phát triển.
Tuy nhiên, người triển khai thiết bị CÓ THỂ thêm các API tuỳ chỉnh bên ngoài không gian tên Android tiêu chuẩn, nhưng các API tuỳ chỉnh:
- [C-0-5] KHÔNG ĐƯỢC nằm trong không gian tên thuộc sở hữu của một tổ chức khác hoặc tham chiếu đến một tổ chức khác. Ví dụ: người triển khai thiết bị KHÔNG ĐƯỢC thêm API vào
com.google.*
hoặc không gian tên tương tự: chỉ Google mới có thể làm như vậy. Tương tự, Google KHÔNG ĐƯỢC thêm API vào không gian tên của các công ty khác. - [C-0-6] PHẢI được đóng gói trong một thư viện dùng chung của Android để chỉ những ứng dụng sử dụng các API đó một cách rõ ràng (thông qua cơ chế <uses-library>) mới bị ảnh hưởng bởi mức sử dụng bộ nhớ tăng lên của các API đó.
Nếu người triển khai thiết bị đề xuất cải thiện một trong các không gian tên gói ở trên (chẳng hạn như bằng cách thêm chức năng mới hữu ích vào một API hiện có hoặc thêm một API mới), thì người triển khai NÊN truy cập vào source.android.com và bắt đầu quy trình đóng góp thay đổi và mã, theo thông tin trên trang web đó.
Xin lưu ý rằng các quy định hạn chế ở trên tương ứng với các quy ước đặt tên API tiêu chuẩn trong ngôn ngữ lập trình Java; mục này chỉ nhằm củng cố các quy ước đó và ràng buộc các quy ước đó thông qua việc đưa vào Định nghĩa về khả năng tương thích này.
3.7. Khả năng tương thích với thời gian chạy
Triển khai trên thiết bị:
-
[C-0-1] PHẢI hỗ trợ định dạng có thể thực thi Dalvik (DEX) đầy đủ và thông số kỹ thuật và ngữ nghĩa của mã byte Dalvik.
-
[C-0-2] PHẢI định cấu hình thời gian chạy Dalvik để phân bổ bộ nhớ theo nền tảng Android thượng nguồn và như được chỉ định trong bảng sau. (Xem phần 7.1.1 để biết định nghĩa về kích thước màn hình và mật độ màn hình.)
-
NÊN sử dụng Android RunTime (ART), phương thức triển khai ngược dòng tham chiếu của Định dạng có thể thực thi Dalvik và hệ thống quản lý gói của phương thức triển khai tham chiếu.
-
NÊN chạy kiểm thử tìm lỗi mã nguồn trong nhiều chế độ thực thi và cấu trúc mục tiêu để đảm bảo độ ổn định của thời gian chạy. Tham khảo JFuzz và DexFuzz trên trang web Dự án nguồn mở Android.
Xin lưu ý rằng các giá trị bộ nhớ được chỉ định bên dưới được coi là giá trị tối thiểu và việc triển khai thiết bị CÓ THỂ phân bổ nhiều bộ nhớ hơn cho mỗi ứng dụng.
Bố cục màn hình | Mật độ màn hình | Bộ nhớ tối thiểu của ứng dụng |
---|---|---|
Đồng hồ Android | 120 dpi (ldpi) | 32MB |
160 dpi (mdpi) | ||
213 dpi (tvdpi) | ||
240 dpi (hdpi) | 36MB | |
280 dpi (280dpi) | ||
320 dpi (xhdpi) | 48MB | |
360 dpi (360dpi) | ||
400 dpi (400dpi) | 56MB | |
420 dpi (420dpi) | 64MB | |
480 dpi (xxhdpi) | 88MB | |
560 dpi (560dpi) | 112MB | |
640 dpi (xxxhdpi) | 154MB | |
nhỏ/bình thường | 120 dpi (ldpi) | 32MB |
160 dpi (mdpi) | ||
213 dpi (tvdpi) | 48MB | |
240 dpi (hdpi) | ||
280 dpi (280dpi) | ||
320 dpi (xhdpi) | 80MB | |
360 dpi (360dpi) | ||
400 dpi (400dpi) | 96MB | |
420 dpi (420dpi) | 112MB | |
480 dpi (xxhdpi) | 128MB | |
560 dpi (560dpi) | 192MB | |
640 dpi (xxxhdpi) | 256MB | |
lớn | 120 dpi (ldpi) | 32MB |
160 dpi (mdpi) | 48MB | |
213 dpi (tvdpi) | 80MB | |
240 dpi (hdpi) | ||
280 dpi (280dpi) | 96MB | |
320 dpi (xhdpi) | 128MB | |
360 dpi (360dpi) | 160MB | |
400 dpi (400dpi) | 192MB | |
420 dpi (420dpi) | 228MB | |
480 dpi (xxhdpi) | 256MB | |
560 dpi (560dpi) | 384MB | |
640 dpi (xxxhdpi) | 512 MB | |
xlarge | 120 dpi (ldpi) | 48MB |
160 dpi (mdpi) | 80MB | |
213 dpi (tvdpi) | 96MB | |
240 dpi (hdpi) | ||
280 dpi (280dpi) | 144MB | |
320 dpi (xhdpi) | 192MB | |
360 dpi (360dpi) | 240MB | |
400 dpi (400dpi) | 288MB | |
420 dpi (420dpi) | 336MB | |
480 dpi (xxhdpi) | 384MB | |
560 dpi (560dpi) | 576MB | |
640 dpi (xxxhdpi) | 768MB |
3.8. Khả năng tương thích của giao diện người dùng
3.8.1. Trình chạy (Màn hình chính)
Android bao gồm một ứng dụng trình chạy (màn hình chính) và hỗ trợ các ứng dụng của bên thứ ba để thay thế trình chạy thiết bị (màn hình chính).
Nếu việc triển khai thiết bị cho phép các ứng dụng bên thứ ba thay thế màn hình chính của thiết bị, thì các ứng dụng đó:
- [C-1-1] BẮT BUỘC khai báo tính năng nền tảng
android.software.home_screen
. - [C-1-2] PHẢI trả về đối tượng
AdaptiveIconDrawable
khi ứng dụng bên thứ ba sử dụng thẻ<adaptive-icon>
để cung cấp biểu tượng và các phương thứcPackageManager
để truy xuất biểu tượng được gọi.
Nếu quá trình triển khai thiết bị bao gồm một trình chạy mặc định hỗ trợ tính năng ghim lối tắt trong ứng dụng, thì các thiết bị đó:
- [C-2-1] PHẢI báo cáo
true
choShortcutManager.isRequestPinShortcutSupported()
. - [C-2-2] PHẢI có khả năng hỗ trợ người dùng yêu cầu người dùng trước khi thêm lối tắt do ứng dụng yêu cầu thông qua phương thức API
ShortcutManager.requestPinShortcut()
. - [C-2-3] PHẢI hỗ trợ lối tắt được ghim cũng như lối tắt động và tĩnh như được ghi nhận trên trang Lối tắt ứng dụng.
Ngược lại, nếu cách triển khai thiết bị không hỗ trợ ghim lối tắt trong ứng dụng, thì các thiết bị đó:
- [C-3-1] PHẢI báo cáo
false
choShortcutManager.isRequestPinShortcutSupported()
.
Nếu việc triển khai thiết bị triển khai một trình chạy mặc định cung cấp quyền truy cập nhanh vào các lối tắt bổ sung do các ứng dụng bên thứ ba cung cấp thông qua API ShortcutManager, thì các trình chạy đó:
- [C-4-1] PHẢI hỗ trợ tất cả các tính năng lối tắt được ghi nhận (ví dụ: lối tắt tĩnh và động, ghim lối tắt) và triển khai đầy đủ các API của lớp API
ShortcutManager
.
Nếu quá trình triển khai thiết bị bao gồm một ứng dụng trình chạy mặc định hiển thị huy hiệu cho biểu tượng ứng dụng, thì các huy hiệu đó:
- [C-5-1] PHẢI tuân thủ phương thức API
NotificationChannel.setShowBadge()
. Nói cách khác, hãy hiển thị một tính năng trực quan liên kết với biểu tượng ứng dụng nếu giá trị được đặt thànhtrue
và không hiển thị bất kỳ chương trình gắn huy hiệu biểu tượng ứng dụng nào khi tất cả các kênh thông báo của ứng dụng đã đặt giá trị thànhfalse
. - CÓ THỂ ghi đè huy hiệu biểu tượng ứng dụng bằng lược đồ huy hiệu độc quyền khi các ứng dụng bên thứ ba cho biết hỗ trợ lược đồ huy hiệu độc quyền thông qua việc sử dụng các API độc quyền, nhưng PHẢI sử dụng các tài nguyên và giá trị được cung cấp thông qua API huy hiệu thông báo được mô tả trong SDK, chẳng hạn như API
Notification.Builder.setNumber()
vàNotification.Builder.setBadgeIconType()
.
3.8.2. Tiện ích
Android hỗ trợ tiện ích ứng dụng của bên thứ ba bằng cách xác định loại thành phần, API và vòng đời tương ứng cho phép các ứng dụng hiển thị “AppWidget” cho người dùng cuối.
Nếu việc triển khai thiết bị hỗ trợ tiện ích ứng dụng của bên thứ ba, thì các tiện ích đó:
- [C-1-1] PHẢI khai báo hỗ trợ tính năng nền tảng
android.software.app_widgets
. - [C-1-2] PHẢI có tính năng hỗ trợ tích hợp cho AppWidgets và hiển thị các tính năng trên giao diện người dùng để thêm, định cấu hình, xem và xoá AppWidgets ngay trong Trình chạy.
- [C-1-3] PHẢI có khả năng hiển thị các tiện ích có kích thước 4 x 4 theo kích thước lưới chuẩn. Hãy xem Nguyên tắc thiết kế tiện ích ứng dụng trong tài liệu SDK Android để biết thông tin chi tiết.
- CÓ THỂ hỗ trợ tiện ích ứng dụng trên màn hình khoá.
Nếu việc triển khai thiết bị hỗ trợ tiện ích ứng dụng bên thứ ba và tính năng ghim lối tắt trong ứng dụng, thì các thiết bị đó:
- [C-2-1] PHẢI báo cáo
true
choAppWidgetManager.html.isRequestPinAppWidgetSupported()
. - [C-2-2] PHẢI có khả năng hỗ trợ người dùng yêu cầu người dùng trước khi thêm lối tắt do ứng dụng yêu cầu thông qua phương thức API
AppWidgetManager.requestPinAppWidget()
.
3.8.3. Thông báo
Android bao gồm các API Notification
và NotificationManager
cho phép nhà phát triển ứng dụng bên thứ ba thông báo cho người dùng về các sự kiện đáng chú ý và thu hút sự chú ý của người dùng bằng cách sử dụng các thành phần phần cứng (ví dụ: âm thanh, độ rung và ánh sáng) và các tính năng phần mềm (ví dụ: ngăn thông báo, thanh hệ thống) của thiết bị.
3.8.3.1. Trình bày thông báo
Nếu việc triển khai thiết bị cho phép ứng dụng bên thứ ba thông báo cho người dùng về các sự kiện đáng chú ý, thì các ứng dụng đó:
- [C-1-1] PHẢI hỗ trợ thông báo sử dụng các tính năng phần cứng, như mô tả trong tài liệu SDK và trong phạm vi có thể với phần cứng triển khai thiết bị. Ví dụ: nếu việc triển khai thiết bị bao gồm một bộ rung, thì thiết bị đó PHẢI triển khai chính xác các API rung. Nếu việc triển khai thiết bị thiếu phần cứng, thì các API tương ứng PHẢI được triển khai dưới dạng không hoạt động. Hành vi này được mô tả chi tiết hơn trong phần 7.
- [C-1-2] PHẢI hiển thị chính xác tất cả tài nguyên (biểu tượng, tệp ảnh động, v.v.) được cung cấp trong API hoặc trong hướng dẫn về kiểu biểu tượng của Thanh trạng thái/Hệ thống, mặc dù các tài nguyên này CÓ THỂ mang lại trải nghiệm người dùng thay thế cho thông báo so với trải nghiệm do hoạt động triển khai Android Open Source tham chiếu cung cấp.
- [C-1-3] PHẢI tuân thủ và triển khai đúng cách các hành vi được mô tả cho API để cập nhật, xoá và nhóm thông báo.
- [C-1-4] PHẢI cung cấp toàn bộ hành vi của API NotificationChannel được ghi lại trong SDK.
- [C-1-5] PHẢI cung cấp cho người dùng khả năng chặn và sửa đổi thông báo của một ứng dụng bên thứ ba nhất định theo từng kênh và cấp gói ứng dụng.
- [C-1-6] CŨNG PHẢI cung cấp cho người dùng khả năng hiển thị các kênh thông báo đã xoá.
- [C-1-7] PHẢI hiển thị chính xác tất cả tài nguyên (hình ảnh, hình dán, biểu tượng, v.v.) được cung cấp thông qua Notification.MessagingStyle cùng với văn bản thông báo mà không cần người dùng tương tác thêm. Ví dụ: PHẢI hiển thị tất cả tài nguyên, bao gồm cả biểu tượng được cung cấp thông qua android.app.Person trong cuộc trò chuyện nhóm được thiết lập thông qua setGroupConversation.
- [C-SR] Bạn NÊN tự động hiển thị một cơ hội để người dùng chặn thông báo của một ứng dụng bên thứ ba nhất định theo từng kênh và cấp gói ứng dụng sau khi người dùng đóng thông báo đó nhiều lần.
- PHẢI hỗ trợ thông báo đa dạng thức.
- NÊN hiển thị một số thông báo có mức độ ưu tiên cao hơn dưới dạng thông báo quan trọng.
- NÊN có tính năng cho phép người dùng tạm ẩn thông báo.
- CHỈ ĐƯỢC quản lý chế độ hiển thị và thời điểm ứng dụng bên thứ ba có thể thông báo cho người dùng về các sự kiện đáng chú ý để giảm thiểu các vấn đề về an toàn, chẳng hạn như làm người lái xe mất tập trung.
Nếu việc triển khai thiết bị hỗ trợ thông báo đa dạng thức, thì các thiết bị đó:
- [C-2-1] PHẢI sử dụng chính xác các tài nguyên được cung cấp thông qua lớp API
Notification.Style
và các lớp con của lớp đó cho các phần tử tài nguyên được trình bày. - NÊN trình bày từng phần tử tài nguyên (ví dụ: biểu tượng, tiêu đề và văn bản tóm tắt) được xác định trong lớp API
Notification.Style
và các lớp con của lớp đó.
Nếu việc triển khai thiết bị hỗ trợ thông báo quan trọng, thì các thiết bị đó:
- [C-3-1] PHẢI sử dụng thành phần hiển thị và tài nguyên thông báo quan trọng như mô tả trong lớp API
Notification.Builder
khi hiển thị thông báo quan trọng. - [C-3-2] PHẢI hiển thị các thao tác được cung cấp thông qua
Notification.Builder.addAction()
cùng với nội dung thông báo mà không cần người dùng tương tác thêm như mô tả trong SDK.
3.8.3.2. Dịch vụ trình nghe thông báo
Android bao gồm các API NotificationListenerService
cho phép ứng dụng (sau khi người dùng bật một cách rõ ràng) nhận bản sao của tất cả thông báo khi thông báo được đăng hoặc cập nhật.
Nếu việc triển khai thiết bị báo cáo cờ tính năng android.hardware.ram.normal
, thì các thiết bị đó:
- [C-1-1] PHẢI cập nhật toàn bộ thông báo một cách chính xác và kịp thời cho tất cả các dịch vụ trình nghe đã cài đặt và do người dùng bật, bao gồm mọi siêu dữ liệu được đính kèm vào đối tượng Thông báo.
- [C-1-2] PHẢI tuân thủ lệnh gọi API
snoozeNotification()
, đồng thời đóng thông báo và thực hiện lệnh gọi lại sau khoảng thời gian tạm ẩn được đặt trong lệnh gọi API.
Nếu việc triển khai thiết bị có khả năng hỗ trợ người dùng tạm ẩn thông báo, thì các thiết bị đó:
- [C-2-1] PHẢI phản ánh chính xác trạng thái thông báo đã tạm ngưng thông qua các API chuẩn như
NotificationListenerService.getSnoozedNotifications()
. - [C-2-2] PHẢI cung cấp tính năng này cho người dùng để họ có thể tạm hoãn thông báo từ mỗi ứng dụng bên thứ ba đã cài đặt, trừ phi đó là thông báo từ các dịch vụ liên tục/trên nền trước.
3.8.3.3. Chế độ DND (Không làm phiền)
Nếu việc triển khai thiết bị hỗ trợ tính năng Không làm phiền, thì các thiết bị đó sẽ:
- [C-1-1] PHẢI triển khai một hoạt động phản hồi ý định ACTION_NOTIFICATION_POLICY_ACCESS_SETTINGS. Đối với các hoạt động triển khai với UI_MODE_TYPE_NORMAL, PHẢI là một hoạt động mà người dùng có thể cấp hoặc từ chối quyền truy cập của ứng dụng vào cấu hình chính sách DND.
- [C-1-2] BẮT BUỘC, khi việc triển khai thiết bị đã cung cấp phương tiện để người dùng cấp hoặc từ chối cho phép ứng dụng bên thứ ba truy cập vào cấu hình chính sách DND, hãy hiển thị Quy tắc DND tự động do các ứng dụng tạo cùng với các quy tắc do người dùng tạo và được xác định trước.
- [C-1-3] PHẢI tuân thủ các giá trị
suppressedVisualEffects
được truyền dọc theoNotificationManager.Policy
và nếu một ứng dụng đã đặt bất kỳ cờ nào trong số SUPPRESSED_EFFECT_SCREEN_OFF hoặc SUPPRESSED_EFFECT_SCREEN_ON, thì ứng dụng đó PHẢI cho người dùng biết rằng các hiệu ứng hình ảnh bị tắt trong trình đơn cài đặt DND.
3.8.4. Tìm kiếm
Android bao gồm các API cho phép nhà phát triển tích hợp tính năng tìm kiếm vào ứng dụng và hiển thị dữ liệu của ứng dụng trong tính năng tìm kiếm trên toàn hệ thống. Nhìn chung, chức năng này bao gồm một giao diện người dùng duy nhất trên toàn hệ thống, cho phép người dùng nhập truy vấn, hiển thị nội dung đề xuất khi người dùng nhập và hiển thị kết quả. API Android cho phép nhà phát triển sử dụng lại giao diện này để cung cấp tính năng tìm kiếm trong ứng dụng của riêng họ và cho phép nhà phát triển cung cấp kết quả cho giao diện người dùng tìm kiếm chung trên toàn cầu.
- Việc triển khai thiết bị Android PHẢI bao gồm tính năng tìm kiếm toàn cầu, một giao diện người dùng tìm kiếm duy nhất, dùng chung trên toàn hệ thống, có thể đưa ra đề xuất theo thời gian thực để phản hồi nội dung người dùng nhập.
Nếu triển khai giao diện tìm kiếm chung, thì các thiết bị sẽ:
- [C-1-1] PHẢI triển khai các API cho phép ứng dụng bên thứ ba thêm nội dung đề xuất vào hộp tìm kiếm khi hộp tìm kiếm chạy ở chế độ tìm kiếm toàn cầu.
Nếu bạn chưa cài đặt ứng dụng nào của bên thứ ba sử dụng tính năng tìm kiếm toàn cầu:
- Hành vi mặc định PHẢI là hiển thị kết quả và nội dung đề xuất của công cụ tìm kiếm trên web.
Android cũng bao gồm API Trợ lý để cho phép các ứng dụng chọn lượng thông tin về ngữ cảnh hiện tại được chia sẻ với trợ lý trên thiết bị.
Nếu việc triển khai thiết bị hỗ trợ thao tác Hỗ trợ, thì các thiết bị đó:
- [C-2-1] PHẢI cho người dùng cuối biết rõ thời điểm chia sẻ ngữ cảnh, bằng cách:
- Mỗi khi ứng dụng trợ lý truy cập vào ngữ cảnh, một ánh sáng trắng sẽ xuất hiện xung quanh các cạnh của màn hình, đáp ứng hoặc vượt quá thời lượng và độ sáng của quá trình triển khai Dự án nguồn mở Android.
- Đối với ứng dụng hỗ trợ được cài đặt sẵn, hãy cung cấp cho người dùng một thao tác ít hơn 2 thao tác điều hướng từ trình đơn cài đặt ứng dụng hỗ trợ và phương thức nhập bằng giọng nói mặc định, đồng thời chỉ chia sẻ ngữ cảnh khi người dùng gọi rõ ràng ứng dụng hỗ trợ thông qua cụm từ kích hoạt hoặc phương thức nhập bằng phím điều hướng hỗ trợ.
- [C-2-2] Hoạt động tương tác được chỉ định để chạy ứng dụng hỗ trợ như mô tả trong mục 7.2.3 PHẢI chạy ứng dụng hỗ trợ do người dùng chọn, nói cách khác là ứng dụng triển khai
VoiceInteractionService
hoặc một hoạt động xử lý ý địnhACTION_ASSIST
.
3.8.5. Cảnh báo và thông báo ngắn
Các ứng dụng có thể sử dụng API Toast
để hiển thị các chuỗi ngắn không theo phương thức phương thức cho người dùng cuối và các chuỗi này sẽ biến mất sau một khoảng thời gian ngắn, đồng thời sử dụng API loại cửa sổ TYPE_APPLICATION_OVERLAY
để hiển thị cửa sổ cảnh báo dưới dạng lớp phủ trên các ứng dụng khác.
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
-
[C-1-1] PHẢI cung cấp cho người dùng khả năng chặn ứng dụng hiển thị cửa sổ cảnh báo sử dụng
TYPE_APPLICATION_OVERLAY
. Cách triển khai AOSP đáp ứng yêu cầu này bằng cách có các chế độ điều khiển trong ngăn thông báo. -
[C-1-2] PHẢI tuân thủ Toast API và hiển thị thông báo ngắn từ các ứng dụng cho người dùng cuối theo một cách dễ thấy.
3.8.6. Giao diện
Android cung cấp "giao diện" dưới dạng một cơ chế để các ứng dụng áp dụng kiểu trên toàn bộ Hoạt động hoặc ứng dụng.
Android bao gồm một gia đình giao diện "Holo" và "Material" dưới dạng một tập hợp các kiểu được xác định để nhà phát triển ứng dụng sử dụng nếu họ muốn khớp với giao diện của giao diện Holo do SDK Android xác định.
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- [C-1-1] KHÔNG ĐƯỢC thay đổi bất kỳ thuộc tính giao diện Holo nào hiển thị với các ứng dụng.
- [C-1-2] PHẢI hỗ trợ gia đình giao diện "Material" và KHÔNG ĐƯỢC thay đổi bất kỳ thuộc tính giao diện Material nào hoặc các thành phần hiển thị với ứng dụng.
Android cũng bao gồm một nhóm giao diện "Mặc định của thiết bị" dưới dạng một tập hợp các kiểu được xác định để nhà phát triển ứng dụng sử dụng nếu họ muốn khớp giao diện của giao diện thiết bị theo cách mà người triển khai thiết bị xác định.
- Việc triển khai thiết bị CÓ THỂ sửa đổi các thuộc tính giao diện mặc định của thiết bị hiển thị cho các ứng dụng.
Android hỗ trợ giao diện biến thể với các thanh hệ thống mờ, cho phép nhà phát triển ứng dụng lấp đầy khu vực phía sau thanh trạng thái và thanh điều hướng bằng nội dung ứng dụng của họ. Để mang lại trải nghiệm nhất quán cho nhà phát triển trong cấu hình này, điều quan trọng là bạn phải duy trì kiểu biểu tượng thanh trạng thái trên nhiều thiết bị triển khai.
Nếu quá trình triển khai thiết bị bao gồm thanh trạng thái hệ thống, thì các thiết bị đó:
- [C-2-1] PHẢI sử dụng màu trắng cho biểu tượng trạng thái hệ thống (chẳng hạn như cường độ tín hiệu và mức pin) và thông báo do hệ thống phát hành, trừ phi biểu tượng đang cho biết trạng thái có vấn đề hoặc ứng dụng yêu cầu thanh trạng thái sáng bằng cờ SYSTEM_UI_FLAG_LIGHT_STATUS_BAR.
- [C-2-2] Việc triển khai thiết bị Android PHẢI thay đổi màu của biểu tượng trạng thái hệ thống thành màu đen (để biết thông tin chi tiết, hãy tham khảo R.style) khi một ứng dụng yêu cầu thanh trạng thái sáng.
3.8.7. Hình nền động (Live Wallpaper)
Android xác định một loại thành phần, API và vòng đời tương ứng cho phép các ứng dụng hiển thị một hoặc nhiều "Hình nền động" cho người dùng cuối. Hình nền động là ảnh động, mẫu hoặc hình ảnh tương tự có khả năng nhập hạn chế, hiển thị dưới dạng hình nền, phía sau các ứng dụng khác.
Phần cứng được coi là có khả năng chạy hình nền động một cách đáng tin cậy nếu có thể chạy tất cả hình nền động, không có giới hạn về chức năng, ở tốc độ khung hình hợp lý mà không ảnh hưởng bất lợi đến các ứng dụng khác. Nếu các giới hạn về phần cứng khiến hình nền và/hoặc ứng dụng gặp sự cố, hoạt động không đúng cách, tiêu thụ quá nhiều CPU hoặc pin hoặc chạy ở tốc độ khung hình thấp không chấp nhận được, thì phần cứng đó được coi là không thể chạy hình nền động. Ví dụ: một số hình nền động có thể sử dụng ngữ cảnh OpenGL 2.0 hoặc 3.x để hiển thị nội dung của chúng. Hình nền động sẽ không chạy ổn định trên phần cứng không hỗ trợ nhiều ngữ cảnh OpenGL vì việc sử dụng ngữ cảnh OpenGL của hình nền động có thể xung đột với các ứng dụng khác cũng sử dụng ngữ cảnh OpenGL.
- Các phương thức triển khai thiết bị có thể chạy hình nền động một cách đáng tin cậy như mô tả ở trên PHẢI triển khai hình nền động.
Nếu triển khai hình nền động, các thiết bị sẽ:
- [C-1-1] PHẢI báo cáo cờ tính năng nền tảng android.software.live_wallpaper.
3.8.8. Chuyển đổi hoạt động
Mã nguồn Android ngược dòng bao gồm màn hình tổng quan, một giao diện người dùng cấp hệ thống để chuyển đổi tác vụ và hiển thị các hoạt động và tác vụ được truy cập gần đây bằng hình thu nhỏ của trạng thái đồ hoạ của ứng dụng tại thời điểm người dùng rời khỏi ứng dụng gần đây nhất.
Việc triển khai thiết bị bao gồm cả phím điều hướng chức năng gần đây như được nêu chi tiết trong phần 7.2.3 CÓ THỂ làm thay đổi giao diện.
Nếu việc triển khai thiết bị bao gồm cả phím điều hướng chức năng gần đây như được nêu chi tiết trong phần 7.2.3 làm thay đổi giao diện, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ ít nhất 7 hoạt động hiển thị.
- PHẢI hiển thị ít nhất tiêu đề của 4 hoạt động cùng một lúc.
- [C-1-2] PHẢI triển khai hành vi ghim màn hình và cung cấp cho người dùng một trình đơn cài đặt để bật/tắt tính năng này.
- NÊN hiển thị màu làm nổi bật, biểu tượng, tiêu đề màn hình trong phần gần đây.
- NÊN hiển thị một đối tượng đóng ("x") nhưng CÓ THỂ trì hoãn việc này cho đến khi người dùng tương tác với màn hình.
- NÊN triển khai một lối tắt để dễ dàng chuyển sang hoạt động trước đó.
- NÊN kích hoạt thao tác chuyển đổi nhanh giữa hai ứng dụng được sử dụng gần đây nhất, khi nhấn đúp vào phím chức năng gần đây.
- NÊN kích hoạt chế độ nhiều cửa sổ chia đôi màn hình (nếu được hỗ trợ) khi nhấn và giữ phím chức năng gần đây.
- CÓ THỂ hiển thị các nội dung gần đây được liên kết dưới dạng một nhóm di chuyển cùng nhau.
- [SR] Bạn NÊN sử dụng giao diện người dùng Android ngược dòng (hoặc giao diện tương tự dựa trên hình thu nhỏ) cho màn hình tổng quan.
3.8.9. Quản lý đầu vào
Android hỗ trợ Quản lý phương thức nhập và hỗ trợ trình chỉnh sửa phương thức nhập của bên thứ ba.
Nếu việc triển khai thiết bị cho phép người dùng sử dụng phương thức nhập của bên thứ ba trên thiết bị, thì họ:
- [C-1-1] PHẢI khai báo tính năng nền tảng android.software.input_methods và hỗ trợ các API IME như được xác định trong tài liệu SDK Android.
- [C-1-2] PHẢI cung cấp một cơ chế mà người dùng có thể truy cập để thêm và định cấu hình các phương thức nhập của bên thứ ba nhằm phản hồi ý định android.settings.INPUT_METHOD_SETTINGS.
Nếu quá trình triển khai thiết bị khai báo cờ tính năng android.software.autofill
, thì các thiết bị đó:
- [C-2-1] PHẢI triển khai đầy đủ các API
AutofillService
vàAutofillManager
, đồng thời tuân thủ ý địnhandroid.settings.REQUEST_SET_AUTOFILL_SERVICE
để hiển thị trình đơn cài đặt ứng dụng mặc định nhằm bật và tắt tính năng tự động điền cũng như thay đổi dịch vụ tự động điền mặc định cho người dùng.
3.8.10. Điều khiển nội dung nghe nhìn trên màn hình khoá
API ứng dụng điều khiển từ xa không còn được dùng nữa từ Android 5.0, thay vào đó là Mẫu thông báo nội dung nghe nhìn cho phép các ứng dụng đa phương tiện tích hợp với các nút điều khiển phát hiển thị trên màn hình khoá.
3.8.11. Trình bảo vệ màn hình (trước đây là Ước mơ)
Android hỗ trợ trình bảo vệ màn hình tương tác, trước đây gọi là Dreams. Trình bảo vệ màn hình cho phép người dùng tương tác với các ứng dụng khi thiết bị được kết nối với nguồn điện ở trạng thái rảnh hoặc được gắn vào đế cắm trên bàn. Các thiết bị Android Watch CÓ THỂ triển khai trình bảo vệ màn hình, nhưng các loại triển khai thiết bị khác PHẢI hỗ trợ trình bảo vệ màn hình và cung cấp tuỳ chọn cài đặt để người dùng định cấu hình trình bảo vệ màn hình theo ý định android.settings.DREAM_SETTINGS
.
3.8.12. Vị trí
Nếu quá trình triển khai thiết bị bao gồm một cảm biến phần cứng (ví dụ: GPS) có thể cung cấp toạ độ, thì các thiết bị đó
- [C-1-2] PHẢI hiển thị trạng thái hiện tại của thông tin vị trí trong trình đơn Vị trí trong phần Cài đặt.
- [C-1-3] KHÔNG ĐƯỢC hiển thị các chế độ vị trí trong trình đơn Vị trí trong phần Cài đặt.
3.8.13. Unicode và phông chữ
Android hỗ trợ các ký tự biểu tượng cảm xúc được xác định trong Unicode 10.0.
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- [C-1-1] PHẢI có khả năng hiển thị các ký tự biểu tượng cảm xúc này ở dạng ký tự màu.
- [C-1-2] PHẢI hỗ trợ:
- Phông chữ Roboto 2 với nhiều độ đậm – sans-serif-thin, sans-serif-light, sans-serif-medium, sans-serif-black, sans-serif-condensed, sans-serif-condensed-light cho các ngôn ngữ có trên thiết bị.
- Bao gồm đầy đủ Unicode 7.0 cho tiếng Latinh, tiếng Hy Lạp và tiếng Cyrillic, bao gồm cả các phạm vi Latinh mở rộng A, B, C và D, cũng như tất cả các ký tự trong khối ký hiệu tiền tệ của Unicode 7.0.
- PHẢI hỗ trợ màu da và các biểu tượng cảm xúc đa dạng về gia đình như được chỉ định trong Báo cáo kỹ thuật Unicode số 51.
Nếu triển khai IME trên thiết bị, thì các thiết bị đó:
- PHẢI cung cấp phương thức nhập cho người dùng để nhập các ký tự biểu tượng cảm xúc này.
3.8.14. Nhiều cửa sổ
Nếu có khả năng hiển thị nhiều hoạt động cùng lúc, thì các hoạt động triển khai thiết bị sẽ:
- [C-1-1] PHẢI triển khai(các) chế độ nhiều cửa sổ như vậy theo hành vi của ứng dụng và API được mô tả trong tài liệu hỗ trợ chế độ nhiều cửa sổ của SDK Android và đáp ứng các yêu cầu sau:
- [C-1-2] Ứng dụng có thể cho biết liệu chúng có thể hoạt động ở chế độ nhiều cửa sổ trong tệp
AndroidManifest.xml
hay không, rõ ràng là thông qua việc đặt thuộc tínhandroid:resizeableActivity
thànhtrue
hoặc ngầm ẩn bằng cách đặt targetSdkVersion > 24. KHÔNG ĐƯỢC chạy những ứng dụng đặt thuộc tính này thànhfalse
một cách rõ ràng trong tệp kê khai ở chế độ nhiều cửa sổ. Các ứng dụng cũ có targetSdkVersion < 24 và không đặt thuộc tínhandroid:resizeableActivity
này CÓ THỂ được chạy ở chế độ nhiều cửa sổ, nhưng hệ thống PHẢI đưa ra cảnh báo rằng ứng dụng có thể không hoạt động như mong đợi ở chế độ nhiều cửa sổ. - [C-1-3] KHÔNG ĐƯỢC cung cấp chế độ chia đôi màn hình hoặc chế độ hình dạng tuỳ ý nếu chiều cao màn hình < 440 dp và chiều rộng màn hình < 440 dp.
- Việc triển khai thiết bị có kích thước màn hình
xlarge
PHẢI hỗ trợ chế độ hình dạng tuỳ ý.
Nếu việc triển khai thiết bị hỗ trợ(các) chế độ nhiều cửa sổ và chế độ chia đôi màn hình, thì các chế độ đó:
- [C-2-1] PHẢI tải trước một trình chạy có thể đổi kích thước làm mặc định.
- [C-2-2] PHẢI cắt bớt hoạt động được kêt nối của chế độ nhiều cửa sổ chia đôi màn hình nhưng NÊN hiển thị một số nội dung của hoạt động đó, nếu ứng dụng Trình chạy là cửa sổ được lấy làm tâm điểm.
- [C-2-3] PHẢI tuân thủ các giá trị
AndroidManifestLayout_minWidth
vàAndroidManifestLayout_minHeight
đã khai báo của ứng dụng trình chạy bên thứ ba và không ghi đè các giá trị này trong quá trình hiển thị một số nội dung của hoạt động được kêt nối.
Nếu việc triển khai thiết bị hỗ trợ(các) chế độ nhiều cửa sổ và chế độ nhiều cửa sổ hình trong hình, thì các chế độ đó:
- [C-3-1] PHẢI chạy các hoạt động ở chế độ nhiều cửa sổ hình trong hình khi ứng dụng: * Nhắm đến API cấp 26 trở lên và khai báo
android:supportsPictureInPicture
* Nhắm đến API cấp 25 trở xuống và khai báo cảandroid:resizeableActivity
vàandroid:supportsPictureInPicture
. - [C-3-2] PHẢI hiển thị các thao tác trong SystemUI theo chỉ định của hoạt động PIP hiện tại thông qua API
setActions()
. - [C-3-3] PHẢI hỗ trợ tỷ lệ khung hình lớn hơn hoặc bằng 1:2,39 và nhỏ hơn hoặc bằng 2,39:1, như được chỉ định bởi hoạt động PIP thông qua API
setAspectRatio()
. - [C-3-4] PHẢI sử dụng
KeyEvent.KEYCODE_WINDOW
để điều khiển cửa sổ PIP; nếu không triển khai chế độ PIP, thì khoá PHẢI có sẵn cho hoạt động trên nền trước. - [C-3-5] PHẢI cung cấp cho người dùng khả năng chặn một ứng dụng hiển thị ở chế độ PIP; cách triển khai AOSP đáp ứng yêu cầu này bằng cách có các chế độ điều khiển trong ngăn thông báo.
- [C-3-6] PHẢI phân bổ chiều rộng và chiều cao tối thiểu là 108 dp cho cửa sổ PIP và chiều rộng tối thiểu là 240 dp và chiều cao là 135 dp cho cửa sổ PIP khi
Configuration.uiMode
được định cấu hình làUI_MODE_TYPE_TELEVISION
.
3.8.15. Vết cắt trên màn hình
Android hỗ trợ tính năng Lỗ khoét màn hình như mô tả trong tài liệu SDK. API DisplayCutout
xác định một khu vực ở cạnh màn hình không có chức năng hiển thị nội dung.
Nếu quá trình triển khai thiết bị bao gồm(các) phần cắt màn hình, thì các phần cắt đó:
- [C-1-1] CHỈ ĐƯỢC có(các) phần cắt trên(các) cạnh ngắn của thiết bị. Ngược lại, nếu tỷ lệ khung hình của thiết bị là 1.0(1:1), thì thiết bị KHÔNG ĐƯỢC có(các) phần cắt.
- [C-1-2] KHÔNG ĐƯỢC có nhiều hơn một phần cắt trên mỗi cạnh.
- [C-1-3] PHẢI tuân thủ các cờ cắt màn hình do ứng dụng đặt thông qua API
WindowManager.LayoutParams
như mô tả trong SDK. - [C-1-4] PHẢI báo cáo giá trị chính xác cho tất cả chỉ số cắt được xác định trong API
DisplayCutout
.
3.9. Quản trị thiết bị
Android có các tính năng cho phép các ứng dụng nhận biết được bảo mật thực hiện các chức năng quản trị thiết bị ở cấp hệ thống, chẳng hạn như thực thi chính sách mật khẩu hoặc xoá từ xa thông qua Android Device Administration API.
Nếu việc triển khai thiết bị triển khai toàn bộ các chính sách quản trị thiết bị được xác định trong tài liệu SDK Android, thì các chính sách đó:
- [C-1-1] PHẢI khai báo
android.software.device_admin
. - [C-1-2] PHẢI hỗ trợ việc cấp phép cho chủ sở hữu thiết bị như mô tả trong mục 3.9.1 và mục 3.9.1.1.
3.9.1 Cấp phép thiết bị
3.9.1.1 Cấp phép cho chủ sở hữu thiết bị
Nếu các hoạt động triển khai thiết bị khai báo android.software.device_admin
, thì các hoạt động đó:
- [C-1-1] PHẢI hỗ trợ việc đăng ký Ứng dụng chính sách thiết bị (DPC) làm Ứng dụng của chủ sở hữu thiết bị như mô tả dưới đây:
- Khi chưa định cấu hình dữ liệu người dùng cho quá trình triển khai thiết bị, quá trình này sẽ:
- [C-1-3] PHẢI báo cáo
true
choDevicePolicyManager.isProvisioningAllowed(ACTION_PROVISION_MANAGED_DEVICE)
. - [C-1-4] PHẢI đăng ký ứng dụng DPC làm ứng dụng Chủ sở hữu thiết bị để phản hồi thao tác theo ý định
android.app.action.PROVISION_MANAGED_DEVICE
. - [C-1-5] PHẢI đăng ký ứng dụng DPC làm ứng dụng Chủ sở hữu thiết bị nếu thiết bị khai báo hỗ trợ Giao tiếp phạm vi gần (NFC) thông qua cờ tính năng
android.hardware.nfc
và nhận được thông báo NFC chứa bản ghi có loại MIMEMIME_TYPE_PROVISIONING_NFC
.
- [C-1-3] PHẢI báo cáo
- Khi quá trình triển khai thiết bị có dữ liệu người dùng, quá trình này sẽ:
- [C-1-6] PHẢI báo cáo
false
choDevicePolicyManager.isProvisioningAllowed(ACTION_PROVISION_MANAGED_DEVICE)
. - [C-1-7] KHÔNG ĐƯỢC đăng ký bất kỳ ứng dụng DPC nào làm Ứng dụng của chủ sở hữu thiết bị nữa.
- [C-1-6] PHẢI báo cáo
- Khi chưa định cấu hình dữ liệu người dùng cho quá trình triển khai thiết bị, quá trình này sẽ:
- [C-1-2] PHẢI yêu cầu người dùng thực hiện một số hành động xác nhận trong quá trình cấp phép để đồng ý với việc ứng dụng được đặt làm Chủ sở hữu thiết bị. Sự đồng ý có thể được thực hiện thông qua hành động của người dùng hoặc một số phương thức lập trình trong quá trình cấp phép, nhưng KHÔNG ĐƯỢC mã hoá cứng hoặc ngăn việc sử dụng các ứng dụng khác của Chủ sở hữu thiết bị.
Nếu các hoạt động triển khai thiết bị khai báo android.software.device_admin
, nhưng cũng bao gồm một giải pháp quản lý Chủ sở hữu thiết bị độc quyền và cung cấp cơ chế để quảng bá một ứng dụng được định cấu hình trong giải pháp của họ dưới dạng "Chủ sở hữu thiết bị tương đương" với "Chủ sở hữu thiết bị" tiêu chuẩn được các API DevicePolicyManager Android tiêu chuẩn công nhận, thì các hoạt động triển khai đó:
- [C-2-1] PHẢI có quy trình xác minh rằng ứng dụng cụ thể đang được quảng bá thuộc về một giải pháp quản lý thiết bị doanh nghiệp hợp pháp và ứng dụng đó đã được định cấu hình trong giải pháp độc quyền để có quyền tương đương với "Chủ sở hữu thiết bị".
- [C-2-2] PHẢI hiển thị thông tin công bố về sự đồng ý của Chủ sở hữu thiết bị AOSP giống như quy trình do
android.app.action.PROVISION_MANAGED_DEVICE
khởi tạo trước khi đăng ký ứng dụng DPC làm "Chủ sở hữu thiết bị". - CÓ THỂ có dữ liệu người dùng trên thiết bị trước khi đăng ký ứng dụng DPC làm "Chủ sở hữu thiết bị".
3.9.1.2 Cấp phép hồ sơ được quản lý
Nếu các hoạt động triển khai thiết bị khai báo android.software.managed_users
, thì các hoạt động đó:
-
[C-1-1] BẮT BUỘC triển khai API cho phép ứng dụng Trình điều khiển chính sách thiết bị (DPC) trở thành chủ sở hữu của Hồ sơ được quản lý mới.
-
[C-1-2] Quy trình cấp hồ sơ được quản lý (quy trình do android.app.action.PROVISION_MANAGED_PROFILE khởi tạo) mà người dùng trải nghiệm PHẢI phù hợp với cách triển khai AOSP.
-
[C-1-3] PHẢI cung cấp các chức năng sau đây cho người dùng trong phần Cài đặt để cho người dùng biết khi nào Trình điều khiển chính sách thiết bị (DPC) đã tắt một chức năng cụ thể của hệ thống:
- Một biểu tượng nhất quán hoặc các tính năng hỗ trợ người dùng khác (ví dụ: biểu tượng thông tin AOSP ngược dòng) để thể hiện thời điểm một chế độ cài đặt cụ thể bị Quản trị viên thiết bị hạn chế.
- Thông báo giải thích ngắn gọn do Quản trị viên thiết bị cung cấp thông qua
setShortSupportMessage
. - Biểu tượng của ứng dụng DPC.
3.9.2 Hỗ trợ hồ sơ được quản lý
Nếu các hoạt động triển khai thiết bị khai báo android.software.managed_users
, thì các hoạt động đó:
- [C-1-1] PHẢI hỗ trợ hồ sơ được quản lý thông qua API
android.app.admin.DevicePolicyManager
. - [C-1-2] PHẢI cho phép tạo một và chỉ một hồ sơ được quản lý.
- [C-1-3] PHẢI sử dụng huy hiệu biểu tượng (tương tự như huy hiệu công việc ngược dòng AOSP) để biểu thị các ứng dụng và tiện ích được quản lý cũng như các thành phần giao diện người dùng có huy hiệu khác như Gần đây và Thông báo.
- [C-1-4] PHẢI hiển thị biểu tượng thông báo (tương tự như huy hiệu công việc ngược dòng AOSP) để cho biết thời điểm người dùng đang sử dụng ứng dụng trong hồ sơ được quản lý.
- [C-1-5] PHẢI hiển thị thông báo ngắn cho biết người dùng đang ở trong hồ sơ được quản lý nếu và khi thiết bị thức dậy (ACTION_USER_PRESENT) và ứng dụng trên nền trước nằm trong hồ sơ được quản lý.
- [C-1-6] Khi có hồ sơ được quản lý, BẮT BUỘC phải hiển thị một tính năng hỗ trợ trực quan trong "Bộ chọn" ý định để cho phép người dùng chuyển tiếp ý định từ hồ sơ được quản lý đến người dùng chính hoặc ngược lại, nếu Trình điều khiển chính sách thiết bị bật tính năng này.
- [C-1-7] Khi có hồ sơ được quản lý, PHẢI hiển thị các chức năng sau đây cho người dùng đối với cả người dùng chính và hồ sơ được quản lý:
- Tính riêng mức sử dụng pin, vị trí, dữ liệu di động và bộ nhớ cho người dùng chính và hồ sơ được quản lý.
- Quản lý độc lập các Ứng dụng VPN được cài đặt trong hồ sơ người dùng chính hoặc hồ sơ được quản lý.
- Quản lý độc lập các ứng dụng được cài đặt trong người dùng chính hoặc hồ sơ được quản lý.
- Quản lý độc lập các tài khoản trong người dùng chính hoặc hồ sơ được quản lý.
- [C-1-8] PHẢI đảm bảo rằng ứng dụng quay số, danh bạ và nhắn tin được cài đặt sẵn có thể tìm kiếm và tra cứu thông tin người gọi từ hồ sơ được quản lý (nếu có) cùng với thông tin từ hồ sơ chính, nếu Trình kiểm soát chính sách thiết bị cho phép.
- [C-1-9] PHẢI đảm bảo rằng hồ sơ này đáp ứng tất cả các yêu cầu bảo mật áp dụng cho một thiết bị có nhiều người dùng được bật (xemmục 9.5), mặc dù hồ sơ được quản lý không được tính là một người dùng khác ngoài người dùng chính.
- [C-1-10] PHẢI hỗ trợ khả năng chỉ định một màn hình khoá riêng biệt đáp ứng các yêu cầu sau để cấp quyền truy cập cho các ứng dụng chạy trong hồ sơ được quản lý.
- Việc triển khai thiết bị PHẢI tuân thủ ý định
DevicePolicyManager.ACTION_SET_NEW_PASSWORD
và hiển thị một giao diện để định cấu hình thông tin xác thực màn hình khoá riêng cho hồ sơ được quản lý. - Thông tin đăng nhập trên màn hình khoá của hồ sơ được quản lý PHẢI sử dụng cùng một cơ chế quản lý và lưu trữ thông tin đăng nhập như hồ sơ gốc, như được ghi nhận trên Trang web dự án nguồn mở Android.
- Chính sách mật khẩu của DPC PHẢI chỉ áp dụng cho thông tin xác thực màn hình khoá của hồ sơ được quản lý, trừ phi được gọi trên thực thể
DevicePolicyManager
do getParentProfileInstance trả về.
- Việc triển khai thiết bị PHẢI tuân thủ ý định
- Khi danh bạ trong hồ sơ được quản lý xuất hiện trong nhật ký cuộc gọi được cài đặt sẵn, giao diện người dùng trong cuộc gọi, thông báo về cuộc gọi đang diễn ra và cuộc gọi nhỡ, danh bạ và ứng dụng nhắn tin, thì các danh bạ đó PHẢI được gắn huy hiệu giống với huy hiệu dùng để chỉ các ứng dụng trong hồ sơ được quản lý.
3.9.3 Hỗ trợ người dùng được quản lý
Nếu các hoạt động triển khai thiết bị khai báo android.software.managed_users
, thì các hoạt động đó:
- [C-1-1] PHẢI cung cấp cho người dùng khả năng đăng xuất khỏi người dùng hiện tại và chuyển về người dùng chính trong phiên nhiều người dùng khi
isLogoutEnabled
trả vềtrue
. Người dùng PHẢI truy cập được vào tính năng hỗ trợ từ màn hình khoá mà không cần mở khoá thiết bị.
3.10. Hỗ trợ tiếp cận
Android cung cấp một lớp hỗ trợ tiếp cận giúp người dùng khuyết tật dễ dàng thao tác trên thiết bị của họ hơn. Ngoài ra, Android cung cấp các API nền tảng cho phép triển khai dịch vụ hỗ trợ tiếp cận để nhận lệnh gọi lại cho các sự kiện của người dùng và hệ thống, đồng thời tạo các cơ chế phản hồi thay thế, chẳng hạn như văn bản sang lời nói, phản hồi xúc giác và điều hướng bằng bi xoay/d-pad.
Nếu việc triển khai thiết bị hỗ trợ các dịch vụ hỗ trợ tiếp cận của bên thứ ba, thì các dịch vụ đó:
- [C-1-1] PHẢI cung cấp cách triển khai khung hỗ trợ tiếp cận Android như mô tả trong tài liệu SDK về API hỗ trợ tiếp cận.
- [C-1-2] PHẢI tạo sự kiện hỗ trợ tiếp cận và phân phối
AccessibilityEvent
thích hợp cho tất cả các phương thức triển khaiAccessibilityService
đã đăng ký như được ghi lại trong SDK. - [C-1-3] PHẢI tuân thủ ý định
android.settings.ACCESSIBILITY_SETTINGS
để cung cấp cơ chế mà người dùng có thể truy cập nhằm bật và tắt các dịch vụ hỗ trợ tiếp cận của bên thứ ba cùng với các dịch vụ hỗ trợ tiếp cận được cài đặt sẵn. - [C-1-4] PHẢI thêm một nút trong thanh điều hướng của hệ thống cho phép người dùng kiểm soát dịch vụ hỗ trợ tiếp cận khi các dịch vụ hỗ trợ tiếp cận đã bật khai báo
AccessibilityServiceInfo.FLAG_REQUEST_ACCESSIBILITY_BUTTON
. Xin lưu ý rằng đối với các phương thức triển khai thiết bị không có thanh điều hướng hệ thống, bạn không thể áp dụng yêu cầu này. Tuy nhiên, các phương thức triển khai thiết bị PHẢI cung cấp cho người dùng khả năng điều khiển các dịch vụ hỗ trợ tiếp cận này.
Nếu việc triển khai thiết bị bao gồm các dịch vụ hỗ trợ tiếp cận được cài đặt sẵn, thì các dịch vụ đó:
- [C-2-1] PHẢI triển khai các dịch vụ hỗ trợ tiếp cận được cài đặt sẵn này dưới dạng ứng dụng Nhận biết chế độ khởi động trực tiếp khi bộ nhớ dữ liệu được mã hoá bằng phương thức Mã hoá dựa trên tệp (FBE).
- NÊN cung cấp một cơ chế trong quy trình thiết lập ban đầu để người dùng bật các dịch vụ hỗ trợ tiếp cận có liên quan, cũng như các tuỳ chọn để điều chỉnh cỡ chữ, kích thước màn hình và cử chỉ phóng to.
3.11. Chuyển văn bản sang lời nói
Android bao gồm các API cho phép ứng dụng sử dụng dịch vụ chuyển văn bản sang lời nói (TTS) và cho phép nhà cung cấp dịch vụ triển khai các dịch vụ TTS.
Nếu việc triển khai thiết bị báo cáo tính năng android.hardware.audio.output, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ các API khung TTS Android.
Nếu quá trình triển khai thiết bị hỗ trợ việc cài đặt công cụ TTS của bên thứ ba, thì các công cụ đó:
- [C-2-1] PHẢI cung cấp khả năng hỗ trợ người dùng để cho phép người dùng chọn công cụ TTS để sử dụng ở cấp hệ thống.
3.12. Khung đầu vào TV
Khung đầu vào Android Television (TIF) đơn giản hoá việc phân phối nội dung phát trực tiếp đến các thiết bị Android Television. TIF cung cấp một API tiêu chuẩn để tạo các mô-đun đầu vào điều khiển thiết bị Android Television.
Nếu các hoạt động triển khai thiết bị hỗ trợ TIF, thì các hoạt động đó:
- [C-1-1] BẮT BUỘC khai báo tính năng nền tảng
android.software.live_tv
. - [C-1-2] PHẢI hỗ trợ tất cả API TIF để có thể cài đặt và sử dụng ứng dụng sử dụng các API này và dịch vụ dữ liệu đầu vào dựa trên TIF của bên thứ ba trên thiết bị.
3.13. Cài đặt nhanh
Android cung cấp một thành phần giao diện người dùng Cài đặt nhanh cho phép truy cập nhanh vào các thao tác thường dùng hoặc cần thiết khẩn cấp.
Nếu quá trình triển khai thiết bị bao gồm thành phần giao diện người dùng Cài đặt nhanh, thì các thiết bị đó:
- [C-1-1] PHẢI cho phép người dùng thêm hoặc xoá các thẻ thông tin được cung cấp thông qua API
quicksettings
từ một ứng dụng bên thứ ba. - [C-1-2] KHÔNG ĐƯỢC tự động thêm thẻ thông tin từ ứng dụng của bên thứ ba trực tiếp vào phần Cài đặt nhanh.
- [C-1-3] PHẢI hiển thị tất cả thẻ thông tin do người dùng thêm từ các ứng dụng bên thứ ba cùng với thẻ cài đặt nhanh do hệ thống cung cấp.
3.14. Giao diện người dùng đa phương tiện
Nếu việc triển khai thiết bị bao gồm khung giao diện người dùng hỗ trợ các ứng dụng bên thứ ba phụ thuộc vào MediaBrowser
và MediaSession
, thì các ứng dụng đó:
- [C-1-1] PHẢI hiển thị biểu tượng MediaItem và biểu tượng thông báo không bị thay đổi.
- [C-1-2] PHẢI hiển thị các mục đó như mô tả của MediaSession, ví dụ: siêu dữ liệu, biểu tượng, hình ảnh.
- [C-1-3] PHẢI hiển thị tiêu đề ứng dụng.
- [C-1-4] PHẢI có ngăn hoặc cơ chế khác để trình bày hệ phân cấp MediaBrowser và cung cấp khả năng tương tác cho người dùng đối với hệ phân cấp MediaBrowser.
- [C-1-5] PHẢI xem xét việc nhấn đúp vào
KEYCODE_HEADSETHOOK
hoặcKEYCODE_MEDIA_PLAY_PAUSE
dưới dạngKEYCODE_MEDIA_NEXT
choMediaSession.Callback#onMediaButtonEvent
.
3.15. Ứng dụng tức thì
Việc triển khai thiết bị PHẢI đáp ứng các yêu cầu sau:
- [C-0-1] Chỉ được cấp quyền cho Ứng dụng tức thì có
android:protectionLevel
được đặt thành"instant"
. - [C-0-2] Ứng dụng tức thì KHÔNG ĐƯỢC tương tác với các ứng dụng đã cài đặt thông qua ý định ngầm ẩn, trừ phi một trong những điều kiện sau đây là đúng:
- Bộ lọc mẫu ý định của thành phần được hiển thị và có CATEGORY_BROWSABLE
- Thao tác là một trong các thao tác ACTION_SEND, ACTION_SENDTO, ACTION_SEND_MULTIPLE
- Mục tiêu được hiển thị rõ ràng bằng android:visibleToInstantApps
- [C-0-3] Ứng dụng tức thì KHÔNG ĐƯỢC tương tác rõ ràng với các ứng dụng đã cài đặt, trừ phi thành phần được hiển thị thông qua android:visibleToInstantApps.
- [C-0-4] Ứng dụng đã cài đặt KHÔNG ĐƯỢC xem thông tin chi tiết về Ứng dụng tức thì trên thiết bị, trừ phi Ứng dụng tức thì kết nối rõ ràng với ứng dụng đã cài đặt.
3.16. Ghép nối thiết bị đồng hành
Android hỗ trợ tính năng ghép nối thiết bị đồng hành để quản lý mối liên kết với thiết bị đồng hành hiệu quả hơn, đồng thời cung cấp API CompanionDeviceManager
để các ứng dụng có thể truy cập vào tính năng này.
Nếu việc triển khai thiết bị hỗ trợ tính năng ghép nối thiết bị đồng hành, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC phải khai báo cờ tính năng
FEATURE_COMPANION_DEVICE_SETUP
. - [C-1-2] PHẢI đảm bảo triển khai đầy đủ các API trong gói
android.companion
. - [C-1-3] PHẢI cung cấp cho người dùng các tính năng hỗ trợ để người dùng có thể chọn/xác nhận rằng thiết bị đồng hành hiện có và đang hoạt động.
3.17. Ứng dụng nặng
Nếu quá trình triển khai thiết bị khai báo tính năng FEATURE_CANT_SAVE_STATE
, thì các quá trình đó:
- [C-1-1] PHẢI chỉ có một ứng dụng đã cài đặt chỉ định
cantSaveState
chạy trong hệ thống tại mỗi thời điểm. Nếu người dùng rời khỏi một ứng dụng như vậy mà không thoát ứng dụng một cách rõ ràng (ví dụ: nhấn vào nút màn hình chính trong khi rời khỏi một hoạt động đang hoạt động trong hệ thống, thay vì nhấn nút quay lại khi không còn hoạt động nào đang hoạt động trong hệ thống), thì việc triển khai thiết bị PHẢI ưu tiên ứng dụng đó trong RAM như cách họ làm với những ứng dụng khác dự kiến sẽ tiếp tục chạy, chẳng hạn như dịch vụ trên nền trước. Khi một ứng dụng như vậy chạy ở chế độ nền, hệ thống vẫn có thể áp dụng các tính năng quản lý nguồn điện cho ứng dụng đó, chẳng hạn như giới hạn CPU và quyền truy cập mạng. - [C-1-2] PHẢI cung cấp một chức năng trên giao diện người dùng để chọn ứng dụng sẽ không tham gia vào cơ chế lưu/khôi phục trạng thái thông thường sau khi người dùng chạy ứng dụng thứ hai được khai báo bằng thuộc tính
cantSaveState
. - [C-1-3] KHÔNG ĐƯỢC áp dụng các thay đổi khác trong chính sách cho các ứng dụng chỉ định
cantSaveState
, chẳng hạn như thay đổi hiệu suất CPU hoặc thay đổi mức độ ưu tiên lên lịch.
Nếu quá trình triển khai thiết bị không khai báo tính năng FEATURE_CANT_SAVE_STATE
, thì các quá trình đó:
- [C-1-1] PHẢI bỏ qua thuộc tính
cantSaveState
do ứng dụng đặt và KHÔNG ĐƯỢC thay đổi hành vi của ứng dụng dựa trên thuộc tính đó.
4. Khả năng tương thích của tính năng đóng gói ứng dụng
Triển khai thiết bị:
- [C-0-1] PHẢI có khả năng cài đặt và chạy các tệp ".apk" của Android do công cụ "aapt" tạo ra trong SDK Android chính thức.
- Vì yêu cầu trên có thể gây khó khăn, nên bạn NÊN sử dụng hệ thống quản lý gói của quá trình triển khai tham chiếu AOSP để triển khai thiết bị.
Triển khai trên thiết bị:
- [C-0-2] PHẢI hỗ trợ xác minh tệp ".apk" bằng Lược đồ chữ ký APK phiên bản 3 , Lược đồ chữ ký APK phiên bản 2 và kỹ thuật ký JAR.
- [C-0-3] KHÔNG ĐƯỢC mở rộng định dạng .apk, Tệp kê khai Android, mã byte Dalvik hoặc mã byte RenderScript theo cách ngăn các tệp đó cài đặt và chạy chính xác trên các thiết bị tương thích khác.
-
[C-0-4] KHÔNG ĐƯỢC cho phép các ứng dụng khác ngoài "trình cài đặt bản ghi" hiện tại của gói gỡ cài đặt ứng dụng mà không cần người dùng xác nhận, như được ghi lại trong SDK cho quyền
DELETE_PACKAGE
. Các trường hợp ngoại lệ duy nhất là ứng dụng trình xác minh gói hệ thống xử lý ý định PACKAGE_NEEDS_VERIFICATION và ứng dụng trình quản lý bộ nhớ xử lý ý định ACTION_MANAGE_STORAGE. -
[C-0-5] PHẢI có một hoạt động xử lý ý định
android.settings.MANAGE_UNKNOWN_APP_SOURCES
. -
[C-0-6] KHÔNG ĐƯỢC cài đặt gói ứng dụng từ các nguồn không xác định, trừ phi ứng dụng yêu cầu cài đặt đáp ứng tất cả các yêu cầu sau:
- Tệp này PHẢI khai báo quyền
REQUEST_INSTALL_PACKAGES
hoặc đặtandroid:targetSdkVersion
ở mức 24 trở xuống. - Người dùng PHẢI cấp quyền cài đặt ứng dụng từ các nguồn không xác định.
- Tệp này PHẢI khai báo quyền
-
NÊN cung cấp cho người dùng khả năng cấp/thu hồi quyền cài đặt ứng dụng từ các nguồn không xác định cho mỗi ứng dụng, nhưng CÓ THỂ chọn triển khai tính năng này dưới dạng không hoạt động và trả về
RESULT_CANCELED
chostartActivityForResult()
, nếu việc triển khai thiết bị không muốn cho phép người dùng có lựa chọn này. Tuy nhiên, ngay cả trong những trường hợp như vậy, ứng dụng CẦN cho người dùng biết lý do không có lựa chọn như vậy. -
[C-0-7] PHẢI hiển thị hộp thoại cảnh báo với chuỗi cảnh báo được cung cấp thông qua API hệ thống
PackageManager.setHarmfulAppWarning
cho người dùng trước khi khởi chạy một hoạt động trong ứng dụng đã được đánh dấu bằng cùng một API hệ thốngPackageManager.setHarmfulAppWarning
là có thể gây hại. - NÊN cung cấp cho người dùng khả năng chọn gỡ cài đặt hoặc chạy ứng dụng trên hộp thoại cảnh báo.
5. Khả năng tương thích đa phương tiện
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ các định dạng nội dung nghe nhìn, bộ mã hoá, bộ giải mã, loại tệp và định dạng vùng chứa được xác định trong phần 5.1 cho từng bộ mã hoá và giải mã do
MediaCodecList
khai báo. - [C-0-2] PHẢI khai báo và báo cáo việc hỗ trợ bộ mã hoá, bộ giải mã có sẵn cho các ứng dụng bên thứ ba thông qua
MediaCodecList
. - [C-0-3] PHẢI có thể giải mã và cung cấp cho các ứng dụng bên thứ ba tất cả định dạng mà ứng dụng đó có thể mã hoá. Bao gồm tất cả các luồng bit mà bộ mã hoá tạo ra và các hồ sơ được báo cáo trong
CamcorderProfile
.
Triển khai trên thiết bị:
- NÊN hướng đến độ trễ bộ mã hoá và giải mã tối thiểu, nói cách khác, các bộ mã hoá và giải mã này
- KHÔNG được sử dụng và lưu trữ vùng đệm đầu vào, chỉ trả về vùng đệm đầu vào sau khi xử lý.
- KHÔNG ĐƯỢC giữ lại vùng đệm đã giải mã lâu hơn thời gian quy định theo tiêu chuẩn (ví dụ: SPS).
- KHÔNG NÊN giữ lại vùng đệm đã mã hoá lâu hơn thời gian mà cấu trúc GOP yêu cầu.
Tất cả bộ mã hoá và giải mã được liệt kê trong phần dưới đây đều được cung cấp dưới dạng phương thức triển khai phần mềm trong phương thức triển khai Android ưu tiên của Dự án nguồn mở Android.
Xin lưu ý rằng cả Google và Liên minh điện thoại mở đều không đưa ra tuyên bố nào rằng các bộ mã hoá và giải mã này không có bằng sáng chế của bên thứ ba. Những người có ý định sử dụng mã nguồn này trong các sản phẩm phần cứng hoặc phần mềm nên lưu ý rằng việc triển khai mã này, bao gồm cả trong phần mềm nguồn mở hoặc phần mềm chia sẻ, có thể yêu cầu giấy phép bằng sáng chế của các chủ sở hữu bằng sáng chế có liên quan.
5.1. Bộ mã hoá và giải mã nội dung nghe nhìn
5.1.1. Mã hoá âm thanh
Xem thêm thông tin chi tiết trong phần 5.1.3. Chi tiết về bộ mã hoá và giải mã âm thanh.
Nếu quá trình triển khai thiết bị khai báo android.hardware.microphone
, thì các thiết bị đó PHẢI hỗ trợ các phương thức mã hoá âm thanh sau:
- [C-1-1] PCM/WAVE
5.1.2. Giải mã âm thanh
Xem thêm thông tin chi tiết trong phần 5.1.3. Chi tiết về bộ mã hoá và giải mã âm thanh.
Nếu quá trình triển khai thiết bị khai báo hỗ trợ tính năng android.hardware.audio.output
, thì các thiết bị đó phải hỗ trợ giải mã các định dạng âm thanh sau:
- [C-1-1] Hồ sơ MPEG-4 AAC (AAC LC)
- [C-1-2] Hồ sơ MPEG-4 HE AAC (AAC+)
- [C-1-3] Hồ sơ MPEG-4 HE AACv2 (AAC+ nâng cao)
- [C-1-4] AAC ELD (AAC độ trễ thấp nâng cao)
- [C-1-11] xHE-AAC (Hồ sơ HE AAC mở rộng ISO/IEC 23003-3, bao gồm Hồ sơ cơ sở USAC và Hồ sơ kiểm soát phạm vi động ISO/IEC 23003-4)
- [C-1-5] FLAC
- [C-1-6] MP3
- [C-1-7] MIDI
- [C-1-8] Vorbis
- [C-1-9] PCM/WAVE
- [C-1-10] Opus
Nếu việc triển khai thiết bị hỗ trợ giải mã vùng đệm đầu vào AAC của các luồng nhiều kênh (tức là nhiều hơn hai kênh) thành PCM thông qua bộ giải mã âm thanh AAC mặc định trong API android.media.MediaCodec
, thì PHẢI hỗ trợ những tính năng sau:
- [C-2-1] BẮT BUỘC phải giải mã mà không được kết hợp xuống (ví dụ: luồng AAC 5.0 phải được giải mã thành 5 kênh PCM, luồng AAC 5.1 phải được giải mã thành 6 kênh PCM).
- [C-2-2] Siêu dữ liệu về dải động PHẢI như được xác định trong "Chế độ điều khiển dải động (DRC)" trong ISO/IEC 14496-3 và các khoá DRC
android.media.MediaFormat
để định cấu hình các hành vi liên quan đến dải động của bộ giải mã âm thanh. Các khoá AAC DRC được giới thiệu trong API 21,bao gồm:KEY_AAC_DRC_ATTENUATION_FACTOR
,KEY_AAC_DRC_BOOST_FACTOR
,KEY_AAC_DRC_HEAVY_COMPRESSION
,KEY_AAC_DRC_TARGET_REFERENCE_LEVEL
vàKEY_AAC_ENCODED_TARGET_LEVEL
.
Khi giải mã âm thanh USAC, MPEG-D (ISO/IEC 23003-4):
- [C-3-1] Siêu dữ liệu về độ to và DRC PHẢI được diễn giải và áp dụng theo Cấu hình điều khiển phạm vi động MPEG-D DRC Cấp 1.
- [C-3-2] Bộ giải mã PHẢI hoạt động theo cấu hình được đặt bằng các khoá
android.media.MediaFormat
sau:KEY_AAC_DRC_TARGET_REFERENCE_LEVEL
vàKEY_AAC_DRC_EFFECT_TYPE
.
Bộ giải mã hồ sơ MPEG-4 AAC, HE AAC và HE AACv2:
- CÓ THỂ hỗ trợ điều khiển độ to và dải động bằng Hồ sơ điều khiển dải động ISO/IEC 23003-4.
Nếu ISO/IEC 23003-4 được hỗ trợ và nếu cả siêu dữ liệu ISO/IEC 23003-4 và ISO/IEC 14496-3 đều có trong luồng bit đã giải mã, thì:
- Siêu dữ liệu ISO/IEC 23003-4 PHẢI được ưu tiên.
5.1.3. Thông tin chi tiết về bộ mã hoá và giải mã âm thanh
Định dạng/Bộ mã hoá và giải mã | Thông tin chi tiết | Các loại tệp/Định dạng vùng chứa được hỗ trợ |
---|---|---|
Hồ sơ MPEG-4 AAC (AAC LC) |
Hỗ trợ nội dung đơn âm/âm thanh nổi/5.0/5.1 với tốc độ lấy mẫu tiêu chuẩn từ 8 đến 48 kHz. |
|
Hồ sơ MPEG-4 HE AAC (AAC+) | Hỗ trợ nội dung đơn âm/âm thanh nổi/5.0/5.1 với tốc độ lấy mẫu tiêu chuẩn từ 16 đến 48 kHz. | |
Hồ sơ MPEG-4 HE AACv2 (AAC+ nâng cao) |
Hỗ trợ nội dung đơn âm/âm thanh nổi/5.0/5.1 với tốc độ lấy mẫu tiêu chuẩn từ 16 đến 48 kHz. | |
AAC ELD (AAC độ trễ thấp nâng cao) | Hỗ trợ nội dung đơn âm/âm thanh nổi với tốc độ lấy mẫu tiêu chuẩn từ 16 đến 48 kHz. | |
USAC | Hỗ trợ nội dung đơn âm/âm thanh nổi với tốc độ lấy mẫu chuẩn từ 7,35 đến 48 kHz. | MPEG-4 (.mp4, .m4a) |
AMR-NB | 4,75 đến 12,2 kbps lấy mẫu ở 8 kHz | 3GPP (.3gp) |
AMR-WB | 9 tốc độ từ 6,60 kbit/giây đến 23,85 kbit/giây lấy mẫu ở 16 kHz | |
FLAC | Đơn âm/Âm thanh nổi (không có đa kênh). Tốc độ lấy mẫu lên đến 48 kHz (nhưng NÊN dùng tốc độ lấy mẫu lên đến 44,1 kHz trên các thiết bị có đầu ra 44,1 kHz, vì bộ lấy mẫu giảm từ 48 xuống 44,1 kHz không bao gồm bộ lọc thông thấp). NÊN dùng 16 bit; không áp dụng kỹ thuật tạo nhiễu cho 24 bit. | Chỉ FLAC (.flac) |
MP3 | Âm thanh đơn kênh/âm thanh nổi 8-320 Kb/giây không đổi (CBR) hoặc tốc độ bit biến thiên (VBR) | MP3 (.mp3) |
MIDI | MIDI Loại 0 và 1. DLS Phiên bản 1 và 2. XMF và XMF dành cho thiết bị di động. Hỗ trợ các định dạng nhạc chuông RTTTL/RTX, OTA và iMelody |
|
Vorbis |
|
|
PCM/WAVE | PCM tuyến tính 16 bit (tốc độ lên đến giới hạn của phần cứng). Thiết bị PHẢI hỗ trợ tốc độ lấy mẫu để ghi âm PCM thô ở tần số 8000, 11025, 16000 và 44100 Hz. | WAVE (.wav) |
Opus | Matroska (.mkv), Ogg(.ogg) |
5.1.4. Mã hoá hình ảnh
Xem thêm thông tin chi tiết trong phần 5.1.6. Thông tin chi tiết về bộ mã hoá và giải mã hình ảnh.
Việc triển khai thiết bị PHẢI hỗ trợ việc mã hoá hình ảnh sau:
- [C-0-1] JPEG
- [C-0-2] PNG
- [C-0-3] WebP
5.1.5. Giải mã hình ảnh
Xem thêm thông tin chi tiết trong phần 5.1.6. Thông tin chi tiết về bộ mã hoá và giải mã hình ảnh.
Việc triển khai thiết bị PHẢI hỗ trợ giải mã các phương thức mã hoá hình ảnh sau:
- [C-0-1] JPEG
- [C-0-2] Ảnh GIF
- [C-0-3] PNG
- [C-0-4] BMP
- [C-0-5] WebP
- [C-0-6] Thô
- [C-0-7] HEIF (HEIC)
5.1.6. Thông tin chi tiết về bộ mã hoá và giải mã hình ảnh
Định dạng/Bộ mã hoá và giải mã | Thông tin chi tiết | Các loại tệp/Định dạng vùng chứa được hỗ trợ |
---|---|---|
JPEG | Cơ sở + lũy tiến | JPEG (.jpg) |
GIF | GIF (.gif) | |
PNG | PNG (.png) | |
BMP | BMP (.bmp) | |
WebP | WebP (.webp) | |
Thô | ARW (.arw), CR2 (.cr2), DNG (.dng), NEF (.nef), NRW (.nrw), ORF (.orf), PEF (.pef), RAF (.raf), RW2 (.rw2), SRW (.srw) | |
HEIF | Hình ảnh, Bộ sưu tập hình ảnh, Chuỗi hình ảnh | HEIF (.heif), HEIC (.heic) |
5.1.7. Bộ mã hoá và giải mã video
- Để có chất lượng chấp nhận được cho dịch vụ phát trực tuyến video trên web và hội nghị truyền hình, việc triển khai thiết bị PHẢI sử dụng bộ mã hoá và giải mã VP8 phần cứng đáp ứng các yêu cầu.
Nếu quá trình triển khai thiết bị bao gồm bộ giải mã hoặc bộ mã hoá video:
-
[C-1-1] Bộ mã hoá và giải mã video PHẢI hỗ trợ kích thước vùng đệm byte đầu ra và đầu vào phù hợp với khung hình nén và không nén lớn nhất có thể theo tiêu chuẩn và cấu hình, nhưng cũng không được phân bổ quá mức.
-
[C-1-2] Bộ mã hoá và giải mã video PHẢI hỗ trợ định dạng màu linh hoạt YUV420 (COLOR_FormatYUV420Flexible).
Nếu việc triển khai thiết bị quảng cáo tính năng hỗ trợ hồ sơ HDR thông qua Display.HdrCapabilities
, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ phân tích cú pháp và xử lý siêu dữ liệu tĩnh HDR.
Nếu hoạt động triển khai thiết bị quảng cáo tính năng hỗ trợ làm mới nội bộ thông qua FEATURE_IntraRefresh
trong lớp MediaCodecInfo.CodecCapabilities
, thì các hoạt động đó:
- [C-3-1] PHẢI hỗ trợ khoảng thời gian làm mới trong khoảng từ 10 đến 60 khung hình và hoạt động chính xác trong vòng 20% khoảng thời gian làm mới đã định cấu hình.
5.1.8. Danh sách bộ mã hoá và giải mã video
Định dạng/Bộ mã hoá và giải mã | Thông tin chi tiết |
Các loại tệp được hỗ trợ/Định dạng vùng chứa |
---|---|---|
H.263 |
|
|
H.264 AVC | Xem phần 5.2 và 5.3 để biết thông tin chi tiết |
|
H.265 HEVC | Xem mục 5.3 để biết thông tin chi tiết | MPEG-4 (.mp4) |
MPEG-2 | Cấu hình chính | MPEG2-TS |
MPEG-4 SP | 3GPP (.3gp) | |
VP8 | Xem phần 5.2 và 5.3 để biết thông tin chi tiết |
|
VP9 | Xem mục 5.3 để biết thông tin chi tiết |
|
5.2. Mã hoá video
Nếu việc triển khai thiết bị hỗ trợ bất kỳ bộ mã hoá video nào và cung cấp bộ mã hoá đó cho các ứng dụng bên thứ ba, thì các ứng dụng đó:
- KHÔNG được vượt quá ~15% tốc độ bit giữa các khoảng thời gian khung hình nội bộ (I-frame) trong hai cửa sổ trượt.
- KHÔNG ĐƯỢC vượt quá ~100% tốc độ bit trong khoảng thời gian trượt là 1 giây.
Nếu việc triển khai thiết bị bao gồm màn hình được nhúng có chiều dài đường chéo ít nhất là 2,5 inch hoặc bao gồm cổng đầu ra video hoặc khai báo hỗ trợ máy ảnh thông qua cờ tính năng android.hardware.camera.any
, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ ít nhất một trong các bộ mã hoá video VP8 hoặc H.264 và cung cấp bộ mã hoá đó cho các ứng dụng bên thứ ba.
- PHẢI hỗ trợ cả bộ mã hoá video VP8 và H.264, đồng thời cung cấp bộ mã hoá này cho các ứng dụng của bên thứ ba.
Nếu việc triển khai thiết bị hỗ trợ bất kỳ bộ mã hoá video H.264, VP8, VP9 hoặc HEVC nào và cung cấp bộ mã hoá đó cho các ứng dụng bên thứ ba, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ tốc độ bit có thể định cấu hình linh động.
- NÊN hỗ trợ tốc độ khung hình biến thiên, trong đó bộ mã hoá video NÊN xác định thời lượng khung hình tức thì dựa trên dấu thời gian của vùng đệm đầu vào và phân bổ bộ chứa bit dựa trên thời lượng khung hình đó.
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá video MPEG-4 SP và cung cấp bộ mã hoá này cho các ứng dụng bên thứ ba, thì các thiết bị đó:
- PHẢI hỗ trợ tốc độ bit có thể định cấu hình linh động cho bộ mã hoá được hỗ trợ.
5.2.1. H.263
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá H.263 và cung cấp bộ mã hoá đó cho các ứng dụng bên thứ ba, thì các ứng dụng đó:
- [C-1-1] PHẢI hỗ trợ Hồ sơ cơ sở cấp 45.
- PHẢI hỗ trợ tốc độ bit có thể định cấu hình linh động cho bộ mã hoá được hỗ trợ.
5.2.2. H-264
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã H.264, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ Hồ sơ cơ sở cấp 3. Tuy nhiên, bạn KHÔNG BẮT BUỘC phải hỗ trợ ASO (Sắp xếp lát cắt tuỳ ý), FMO (Sắp xếp khối xếp lớn linh hoạt) và RS (Lát cắt dư thừa). Hơn nữa, để duy trì khả năng tương thích với các thiết bị Android khác, bạn KHÔNG NÊN sử dụng ASO, FMO và RS cho Hồ sơ cơ sở bằng bộ mã hoá.
- [C-1-2] PHẢI hỗ trợ các hồ sơ mã hoá video SD (Độ phân giải chuẩn) trong bảng sau.
- PHẢI hỗ trợ Hồ sơ chính cấp 4.
- PHẢI hỗ trợ các hồ sơ mã hoá video HD (Độ phân giải cao) như được chỉ định trong bảng sau.
Nếu việc triển khai thiết bị báo cáo hỗ trợ mã hoá H.264 cho video có độ phân giải 720p hoặc 1080p thông qua API đa phương tiện, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ các hồ sơ mã hoá trong bảng sau.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | |
---|---|---|---|---|
Độ phân giải video | 320 x 240 px | 720 x 480 px | 1280 x 720 px | 1920 x 1080 px |
Tốc độ khung hình video | 20 khung hình/giây | 30 fps | 30 fps | 30 fps |
Tốc độ bit của video | 384 Kb/giây | 2 Mb/giây | 4 Mb/giây | 10 Mb/giây |
5.2.3. VP8
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP8, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ hồ sơ mã hoá video SD.
- PHẢI hỗ trợ các hồ sơ mã hoá video HD (Độ phân giải cao) sau đây.
- NÊN hỗ trợ ghi tệp Matroska WebM.
- NÊN sử dụng bộ mã hoá và giải mã VP8 phần cứng đáp ứng các yêu cầu về mã hoá phần cứng RTC của dự án WebM để đảm bảo chất lượng chấp nhận được của dịch vụ truyền phát video trên web và hội nghị truyền hình.
Nếu việc triển khai thiết bị báo cáo hỗ trợ mã hoá VP8 cho video có độ phân giải 720p hoặc 1080p thông qua API đa phương tiện, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ các hồ sơ mã hoá trong bảng sau.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | |
---|---|---|---|---|
Độ phân giải video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px |
Tốc độ khung hình video | 30 fps | 30 fps | 30 fps | 30 fps |
Tốc độ bit của video | 800 Kb/giây | 2 Mb/giây | 4 Mb/giây | 10 Mb/giây |
5.2.4. VP9
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP9, thì các thiết bị đó:
- NÊN hỗ trợ ghi tệp Matroska WebM.
5.3. Giải mã video
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP8, VP9, H.264 hoặc H.265, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ độ phân giải video động và chuyển đổi tốc độ khung hình thông qua các API Android tiêu chuẩn trong cùng một luồng cho tất cả bộ mã hoá và giải mã VP8, VP9, H.264 và H.265 theo thời gian thực và lên đến độ phân giải tối đa mà mỗi bộ mã hoá và giải mã hỗ trợ trên thiết bị.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ bộ giải mã Dolby Vision thông qua HDR_TYPE_DOLBY_VISION
, thì các hoạt động đó:
- [C-2-1] PHẢI cung cấp trình trích xuất có khả năng hỗ trợ Dolby Vision.
- [C-2-2] PHẢI hiển thị đúng nội dung Dolby Vision trên màn hình thiết bị hoặc trên cổng đầu ra video tiêu chuẩn (ví dụ: HDMI).
- [C-2-3] PHẢI đặt chỉ mục kênh của(các) lớp cơ sở tương thích ngược (nếu có) giống với chỉ mục kênh của lớp Dolby Vision kết hợp.
5.3.1. MPEG-2
Nếu quá trình triển khai thiết bị hỗ trợ bộ giải mã MPEG-2, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ Cấp cao của Hồ sơ chính.
5.3.2. H.263
Nếu các phương thức triển khai thiết bị hỗ trợ bộ giải mã H.263, thì các phương thức đó:
- [C-1-1] PHẢI hỗ trợ Hồ sơ cơ sở cấp 30 và cấp 45.
5.3.3. MPEG-4
Nếu triển khai thiết bị bằng bộ giải mã MPEG-4, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ Hồ sơ đơn giản cấp 3.
5.3.4. H.264
Nếu việc triển khai thiết bị hỗ trợ bộ giải mã H.264, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ Hồ sơ chính cấp 3.1 và Hồ sơ cơ sở. Không bắt buộc phải hỗ trợ ASO (Sắp xếp lát cắt tuỳ ý), FMO (Sắp xếp macroblock linh hoạt) và RS (Lát cắt dư thừa).
- [C-1-2] PHẢI có khả năng giải mã video có hồ sơ SD (Độ phân giải chuẩn) được liệt kê trong bảng sau và được mã hoá bằng Hồ sơ cơ sở và Hồ sơ chính cấp 3.1 (bao gồm cả 720p30).
- PHẢI có khả năng giải mã video theo hồ sơ HD (Độ phân giải cao) như được chỉ định trong bảng sau.
Nếu chiều cao do phương thức Display.getSupportedModes()
báo cáo bằng hoặc lớn hơn độ phân giải video, thì việc triển khai thiết bị sẽ:
- [C-2-1] PHẢI hỗ trợ các hồ sơ giải mã video HD 720p trong bảng sau.
- [C-2-2] PHẢI hỗ trợ các hồ sơ giải mã video HD 1080p trong bảng sau.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | |
---|---|---|---|---|
Độ phân giải video | 320 x 240 px | 720 x 480 px | 1280 x 720 px | 1920 x 1080 px |
Tốc độ khung hình video | 30 fps | 30 fps | 60 khung hình/giây | 30 khung hình/giây (60 khung hình/giâyTV) |
Tốc độ bit của video | 800 Kb/giây | 2 Mb/giây | 8 Mb/giây | 20 Mb/giây |
5.3.5. H.265 (HEVC)
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã H.265, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ Cấu hình chính cấp 3 cấp chính và cấu hình giải mã video SD như được chỉ định trong bảng sau.
- PHẢI hỗ trợ các cấu hình giải mã HD như được chỉ định trong bảng sau.
- [C-1-2] PHẢI hỗ trợ các hồ sơ giải mã HD như được chỉ định trong bảng sau nếu có bộ giải mã phần cứng.
Nếu chiều cao do phương thức Display.getSupportedModes()
báo cáo bằng hoặc lớn hơn độ phân giải video, thì:
- [C-2-1] Việc triển khai thiết bị PHẢI hỗ trợ ít nhất một trong các tính năng giải mã H.265 hoặc VP9 của hồ sơ 720, 1080 và UHD.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | UHD | |
---|---|---|---|---|---|
Độ phân giải video | 352 x 288 px | 720 x 480 px | 1280 x 720 px | 1920 x 1080 px | 3840 x 2160 px |
Tốc độ khung hình video | 30 fps | 30 fps | 30 fps | 30/60 khung hình/giây (60 khung hình/giâyTV có giải mã phần cứng H.265) | 60 khung hình/giây |
Tốc độ bit của video | 600 Kb/giây | 1,6 Mb/giây | 4 Mb/giây | 5 Mb/giây | 20 Mb/giây |
5.3.6. VP8
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP8, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ các hồ sơ giải mã SD trong bảng sau.
- NÊN sử dụng bộ mã hoá và giải mã VP8 phần cứng đáp ứng các yêu cầu.
- NÊN hỗ trợ các hồ sơ giải mã HD trong bảng sau.
Nếu chiều cao do phương thức Display.getSupportedModes()
báo cáo bằng hoặc lớn hơn độ phân giải video, thì:
- [C-2-1] Quá trình triển khai thiết bị PHẢI hỗ trợ các hồ sơ 720p trong bảng sau.
- [C-2-2] Quá trình triển khai thiết bị PHẢI hỗ trợ các hồ sơ 1080p trong bảng sau.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | |
---|---|---|---|---|
Độ phân giải video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px |
Tốc độ khung hình video | 30 fps | 30 fps | 30 khung hình/giây (60 khung hình/giâyTV) | 30 (60 khung hình/giâyTruyền hình) |
Tốc độ bit của video | 800 Kb/giây | 2 Mb/giây | 8 Mb/giây | 20 Mb/giây |
5.3.7. VP9
Nếu việc triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP9, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ các hồ sơ giải mã video SD như được chỉ định trong bảng sau.
- PHẢI hỗ trợ các cấu hình giải mã HD như được chỉ định trong bảng sau.
Nếu phương thức triển khai thiết bị hỗ trợ bộ mã hoá và giải mã VP9 và bộ giải mã phần cứng:
- [C-2-1] PHẢI hỗ trợ các cấu hình giải mã HD như được chỉ định trong bảng sau.
Nếu chiều cao do phương thức Display.getSupportedModes()
báo cáo bằng hoặc lớn hơn độ phân giải video, thì:
- [C-3-1] Việc triển khai thiết bị PHẢI hỗ trợ ít nhất một trong các tính năng giải mã VP9 hoặc H.265 của hồ sơ 720, 1080 và UHD.
SD (Chất lượng thấp) | SD (Chất lượng cao) | HD 720p | HD 1080p | UHD | |
---|---|---|---|---|---|
Độ phân giải video | 320 x 180 px | 640 x 360 px | 1280 x 720 px | 1920 x 1080 px | 3840 x 2160 px |
Tốc độ khung hình video | 30 fps | 30 fps | 30 fps | 30 khung hình/giây (60 khung hình/giâyTV có giải mã phần cứng VP9) | 60 khung hình/giây |
Tốc độ bit của video | 600 Kb/giây | 1,6 Mb/giây | 4 Mb/giây | 5 Mb/giây | 20 Mb/giây |
5.4. Ghi âm
Mặc dù một số yêu cầu được nêu trong phần này được liệt kê là NÊN kể từ Android 4.3, nhưng Định nghĩa về khả năng tương thích cho các phiên bản trong tương lai dự kiến sẽ thay đổi các yêu cầu này thành PHẢI. Các thiết bị Android hiện tại và mới NÊN đáp ứng các yêu cầu này, nếu không, chúng sẽ không thể đạt được khả năng tương thích với Android khi nâng cấp lên phiên bản trong tương lai.
5.4.1. Quay âm thanh thô
Nếu các hoạt động triển khai thiết bị khai báo android.hardware.microphone
, thì các hoạt động đó:
-
[C-1-1] PHẢI cho phép ghi lại nội dung âm thanh thô có các đặc điểm sau:
- Định dạng: PCM tuyến tính, 16 bit
- Tốc độ lấy mẫu: 8000, 11025, 16000, 44100 Hz
- Kênh: Đơn âm
-
[C-1-2] PHẢI ghi ở tốc độ lấy mẫu cao hơn mà không cần lấy mẫu lên.
- [C-1-3] PHẢI bao gồm bộ lọc khử răng cưa thích hợp khi tốc độ lấy mẫu nêu trên được chụp bằng cách giảm tần số lấy mẫu.
-
PHẢI cho phép ghi lại nội dung âm thanh thô ở chất lượng DVD và đài AM, tức là có các đặc điểm sau:
- Định dạng: PCM tuyến tính, 16 bit
- Tốc độ lấy mẫu: 22050, 48000 Hz
- Số kênh: Âm thanh nổi
Nếu việc triển khai thiết bị cho phép ghi lại nội dung âm thanh thô ở chất lượng đài AM và DVD, thì thiết bị đó:
- [C-2-1] PHẢI ghi lại mà không cần lấy mẫu lên ở tỷ lệ cao hơn 16000:22050 hoặc 44100:48000.
- [C-2-2] PHẢI bao gồm một bộ lọc khử răng cưa thích hợp cho mọi hoạt động lấy mẫu lên hoặc lấy mẫu xuống.
5.4.2. Ghi âm để nhận dạng giọng nói
Nếu các hoạt động triển khai thiết bị khai báo android.hardware.microphone
, thì các hoạt động đó:
- [C-1-1] PHẢI ghi nguồn âm thanh
android.media.MediaRecorder.AudioSource.VOICE_RECOGNITION
ở một trong các tốc độ lấy mẫu là 44100 và 48000. - [C-1-2] Theo mặc định, BẮT BUỘC tắt mọi quá trình xử lý âm thanh giảm tiếng ồn khi ghi luồng âm thanh từ nguồn âm thanh
AudioSource.VOICE_RECOGNITION
. - [C-1-3] Theo mặc định, BẮT BUỘC phải tắt mọi chế độ kiểm soát độ lợi tự động khi ghi luồng âm thanh từ nguồn âm thanh
AudioSource.VOICE_RECOGNITION
. - NÊN ghi lại luồng âm thanh nhận dạng giọng nói với biên độ gần như bằng phẳng so với các đặc điểm tần số: cụ thể là ±3 dB, từ 100 Hz đến 4000 Hz.
- NÊN ghi luồng âm thanh nhận dạng giọng nói với độ nhạy đầu vào được đặt sao cho nguồn công suất âm thanh (SPL) 90 dB ở tần số 1000 Hz tạo ra RMS là 2500 đối với các mẫu 16 bit.
- NÊN ghi luồng âm thanh nhận dạng giọng nói để các mức biên độ PCM theo dõi tuyến tính các thay đổi về SPL đầu vào trong phạm vi ít nhất là 30 dB từ -18 dB đến +12 dB so với 90 dB SPL tại micrô.
- NÊN ghi luồng âm thanh nhận dạng giọng nói với độ méo hài tổng (THD) dưới 1% đối với 1 kHz ở mức đầu vào SPL 90 dB tại micrô.
Nếu quá trình triển khai thiết bị khai báo android.hardware.microphone
và các công nghệ giảm tiếng ồn được điều chỉnh để nhận dạng lời nói, thì các công nghệ đó sẽ:
- [C-2-1] PHẢI cho phép kiểm soát hiệu ứng âm thanh này bằng API
android.media.audiofx.NoiseSuppressor
. - [C-2-2] PHẢI xác định riêng từng phương thức triển khai công nghệ loại bỏ tạp âm thông qua trường
AudioEffect.Descriptor.uuid
.
5.4.3. Ghi lại để định tuyến lại quá trình phát
Lớp android.media.MediaRecorder.AudioSource
bao gồm nguồn âm thanh REMOTE_SUBMIX
.
Nếu các hoạt động triển khai thiết bị khai báo cả android.hardware.audio.output
và android.hardware.microphone
, thì các hoạt động đó:
-
[C-1-1] PHẢI triển khai đúng cách nguồn âm thanh
REMOTE_SUBMIX
để khi một ứng dụng sử dụng APIandroid.media.AudioRecord
để ghi âm từ nguồn âm thanh này, ứng dụng đó sẽ ghi lại tất cả các luồng âm thanh ngoại trừ những luồng sau:-
AudioManager.STREAM_RING
-
AudioManager.STREAM_ALARM
-
AudioManager.STREAM_NOTIFICATION
-
5.5. Phát âm thanh
Android hỗ trợ cho phép các ứng dụng phát âm thanh thông qua thiết bị ngoại vi đầu ra âm thanh như được xác định trong phần 7.8.2.
5.5.1. Phát âm thanh thô
Nếu các hoạt động triển khai thiết bị khai báo android.hardware.audio.output
, thì các hoạt động đó:
-
[C-1-1] PHẢI cho phép phát nội dung âm thanh thô có các đặc điểm sau:
- Định dạng: PCM tuyến tính, 16 bit, 8 bit, dấu phẩy động
- Kênh: Đơn kênh, Âm thanh nổi, cấu hình đa kênh hợp lệ với tối đa 8 kênh
-
Tốc độ lấy mẫu (tính bằng Hz):
- 8000, 11025, 16000, 22050, 32000, 44100, 48000 ở các cấu hình kênh nêu trên
- 96000 ở chế độ đơn âm và âm thanh nổi
-
NÊN cho phép phát nội dung âm thanh thô có các đặc điểm sau:
- Tốc độ lấy mẫu: 24000, 48000
5.5.2. Hiệu ứng âm thanh
Android cung cấp API cho hiệu ứng âm thanh để triển khai trên thiết bị.
Nếu quá trình triển khai thiết bị khai báo tính năng android.hardware.audio.output
, thì các quá trình đó:
- [C-1-1] PHẢI hỗ trợ các phương thức triển khai
EFFECT_TYPE_EQUALIZER
vàEFFECT_TYPE_LOUDNESS_ENHANCER
có thể kiểm soát được thông qua các lớp con AudioEffectEqualizer
,LoudnessEnhancer
. - [C-1-2] PHẢI hỗ trợ việc triển khai API trình trực quan hoá, có thể kiểm soát thông qua lớp
Visualizer
. - [C-1-3] PHẢI hỗ trợ việc triển khai
EFFECT_TYPE_DYNAMICS_PROCESSING
có thể kiểm soát được thông qua lớp con AudioEffectDynamicsProcessing
. - NÊN hỗ trợ các hoạt động triển khai
EFFECT_TYPE_BASS_BOOST
,EFFECT_TYPE_ENV_REVERB
,EFFECT_TYPE_PRESET_REVERB
vàEFFECT_TYPE_VIRTUALIZER
có thể kiểm soát được thông qua các lớp conAudioEffect
BassBoost
,EnvironmentalReverb
,PresetReverb
vàVirtualizer
.
5.5.3. Âm lượng đầu ra âm thanh
Triển khai thiết bị ô tô:
- NÊN cho phép điều chỉnh âm lượng âm thanh riêng biệt cho từng luồng âm thanh bằng cách sử dụng loại nội dung hoặc cách sử dụng do AudioAttributes xác định và cách sử dụng âm thanh trên ô tô được xác định công khai trong
android.car.CarAudioManager
.
5.6. Độ trễ âm thanh
Độ trễ âm thanh là độ trễ thời gian khi tín hiệu âm thanh truyền qua một hệ thống. Nhiều lớp ứng dụng dựa vào độ trễ ngắn để đạt được hiệu ứng âm thanh theo thời gian thực.
Trong mục này, hãy sử dụng các định nghĩa sau:
- độ trễ đầu ra. Khoảng thời gian giữa thời điểm một ứng dụng ghi một khung dữ liệu được mã hoá PCM và thời điểm âm thanh tương ứng được trình bày cho môi trường tại một bộ chuyển đổi trên thiết bị hoặc tín hiệu rời khỏi thiết bị thông qua một cổng và có thể được quan sát bên ngoài.
- Độ trễ đầu ra nguội. Độ trễ đầu ra cho khung hình đầu tiên, khi hệ thống đầu ra âm thanh không hoạt động và tắt nguồn trước khi có yêu cầu.
- độ trễ đầu ra liên tục. Độ trễ đầu ra cho các khung hình tiếp theo, sau khi thiết bị phát âm thanh.
- độ trễ đầu vào. Khoảng thời gian giữa thời điểm âm thanh được môi trường trình bày cho thiết bị tại một bộ chuyển đổi trên thiết bị hoặc tín hiệu đi vào thiết bị thông qua một cổng và thời điểm ứng dụng đọc khung tương ứng của dữ liệu được mã hoá PCM.
- mất dữ liệu đầu vào. Phần đầu của tín hiệu đầu vào không thể sử dụng hoặc không có.
- Độ trễ đầu vào nguội. Tổng thời gian nhập bị mất và độ trễ đầu vào cho khung hình đầu tiên, khi hệ thống nhập âm thanh ở trạng thái rảnh và tắt nguồn trước yêu cầu.
- độ trễ đầu vào liên tục. Độ trễ đầu vào cho các khung hình tiếp theo, trong khi thiết bị đang ghi âm.
- độ trễ đầu ra nguội. Sự biến thiên giữa các phép đo riêng biệt về giá trị độ trễ đầu ra nguội.
- độ trễ đầu vào nguội. Sự biến thiên giữa các phép đo riêng biệt về giá trị độ trễ đầu vào nguội.
- độ trễ trọn vòng liên tục. Tổng độ trễ đầu vào liên tục cộng với độ trễ đầu ra liên tục cộng với một khoảng thời gian đệm. Khoảng thời gian đệm cho phép ứng dụng xử lý tín hiệu và thời gian để ứng dụng giảm thiểu sự khác biệt về pha giữa luồng đầu vào và đầu ra.
- API hàng đợi bộ đệm PCM OpenSL ES. Tập hợp các API OpenSL ES liên quan đến PCM trong Android NDK.
- API âm thanh gốc AAudio. Tập hợp các API AAudio trong Android NDK.
- Dấu thời gian. Một cặp bao gồm vị trí khung hình tương đối trong luồng và thời gian ước tính khi khung hình đó vào hoặc rời khỏi quy trình xử lý âm thanh trên điểm cuối được liên kết. Xem thêm AudioTimestamp.
Nếu triển khai thiết bị khai báo android.hardware.audio.output
, bạn NÊN đáp ứng hoặc vượt quá các yêu cầu sau:
- [C-SR] Độ trễ đầu ra nguội từ 100 mili giây trở xuống
- [C-SR] Độ trễ đầu ra liên tục từ 45 mili giây trở xuống
- [C-SR] Giảm thiểu độ trễ đầu ra nguội
- [C-SR] Dấu thời gian đầu ra do AudioTrack.getTimestamp và
AAudioStream_getTimestamp
trả về có độ chính xác +/- 1 mili giây.
Nếu việc triển khai thiết bị đáp ứng các yêu cầu trên, sau khi hiệu chỉnh ban đầu, khi sử dụng cả hàng đợi bộ đệm PCM OpenSL ES và API âm thanh gốc AAudio, đối với độ trễ đầu ra liên tục và độ trễ đầu ra nguội trên ít nhất một thiết bị đầu ra âm thanh được hỗ trợ, thì các độ trễ này là:
- [C-SR] NÊN báo cáo âm thanh có độ trễ thấp bằng cách khai báo cờ tính năng
android.hardware.audio.low_latency
. - [C-SR] NÊN đáp ứng các yêu cầu về âm thanh có độ trễ thấp thông qua API AAudio.
- [C-SR] BẠN NÊN đảm bảo rằng đối với các luồng trả về
AAUDIO_PERFORMANCE_MODE_LOW_LATENCY
từAAudioStream_getPerformanceMode()
, giá trị doAAudioStream_getFramesPerBurst()
trả về nhỏ hơn hoặc bằng giá trị doandroid.media.AudioManager.getProperty(String)
trả về cho khoá thuộc tínhAudioManager.PROPERTY_OUTPUT_FRAMES_PER_BUFFER
.
Nếu việc triển khai thiết bị không đáp ứng các yêu cầu về âm thanh có độ trễ thấp thông qua cả hàng đợi bộ đệm PCM OpenSL ES và API âm thanh gốc AAudio, thì các thiết bị đó:
- [C-1-1] KHÔNG ĐƯỢC báo cáo hỗ trợ âm thanh có độ trễ thấp.
Nếu triển khai thiết bị bao gồm android.hardware.microphone
, bạn NÊN đáp ứng các yêu cầu sau đây về âm thanh đầu vào:
- [C-SR] Độ trễ đầu vào nguội từ 100 mili giây trở xuống.
- [C-SR] Độ trễ đầu vào liên tục từ 30 mili giây trở xuống.
- [C-SR] Độ trễ trọn vòng liên tục từ 50 mili giây trở xuống.
- [C-SR] Giảm thiểu độ trễ đầu vào nguội.
- [C-SR] Giới hạn lỗi trong dấu thời gian đầu vào, do AudioRecord.getTimestamp hoặc
AAudioStream_getTimestamp
trả về, ở mức +/- 1 mili giây.
5.7. Giao thức mạng
Việc triển khai thiết bị PHẢI hỗ trợ các giao thức mạng nội dung nghe nhìn để phát âm thanh và video như được chỉ định trong tài liệu SDK Android.
Nếu việc triển khai thiết bị bao gồm bộ giải mã âm thanh hoặc video, thì các thiết bị đó:
-
[C-1-1] PHẢI hỗ trợ tất cả các định dạng vùng chứa và bộ mã hoá và giải mã bắt buộc trong mục 5.1 qua HTTP(S).
-
[C-1-2] PHẢI hỗ trợ các định dạng phân đoạn nội dung đa phương tiện được nêu trong bảng Định dạng phân đoạn nội dung đa phương tiện bên dưới qua Giao thức dự thảo Phát trực tuyến dựa trên HTTP, Phiên bản 7.
-
[C-1-3] PHẢI hỗ trợ hồ sơ video âm thanh RTP và các bộ mã hoá và giải mã liên quan sau đây trong bảng RTSP bên dưới. Đối với các trường hợp ngoại lệ, vui lòng xem chú thích cuối bảng trong mục 5.1.
Định dạng phân đoạn nội dung nghe nhìn
Định dạng phân đoạn | (Các) tài liệu tham khảo | Hỗ trợ bộ mã hoá và giải mã bắt buộc |
---|---|---|
Luồng truyền tải MPEG-2 | ISO 13818 |
Bộ mã hoá và giải mã video:
và MPEG-2. Bộ mã hoá và giải mã âm thanh:
|
AAC với khung ADTS và thẻ ID3 | ISO 13818-7 | Xem mục 5.1.1 để biết thông tin chi tiết về AAC và các biến thể của AAC |
WebVTT | WebVTT |
RTSP (RTP, SDP)
Tên hồ sơ | (Các) tài liệu tham khảo | Hỗ trợ bộ mã hoá và giải mã bắt buộc |
---|---|---|
H264 AVC | RFC 6184 | Xem phần 5.1.3 để biết thông tin chi tiết về H264 AVC |
MP4A-LATM | RFC 6416 | Xem mục 5.1.1 để biết thông tin chi tiết về AAC và các biến thể của AAC |
H263-1998 |
RFC 3551 RFC 4629 RFC 2190 |
Xem mục 5.1.3 để biết thông tin chi tiết về H263 |
H263-2000 | RFC 4629 | Xem mục 5.1.3 để biết thông tin chi tiết về H263 |
AMR | RFC 4867 | Xem phần 5.1.1 để biết thông tin chi tiết về AMR-NB |
AMR-WB | RFC 4867 | Xem phần 5.1.1 để biết thông tin chi tiết về AMR-WB |
MP4V-ES | RFC 6416 | Xem phần 5.1.3 để biết thông tin chi tiết về MPEG-4 SP |
mpeg4-generic | RFC 3640 | Xem mục 5.1.1 để biết thông tin chi tiết về AAC và các biến thể của AAC |
MP2T | RFC 2250 | Xem Luồng truyền tải MPEG-2 bên dưới phần Phát trực tuyến dựa trên HTTP để biết thông tin chi tiết |
5.8. Secure Media
Nếu việc triển khai thiết bị hỗ trợ đầu ra video an toàn và có khả năng hỗ trợ các nền tảng an toàn, thì các thiết bị đó:
- [C-1-1] PHẢI khai báo hỗ trợ cho
Display.FLAG_SECURE
.
Nếu việc triển khai thiết bị khai báo hỗ trợ Display.FLAG_SECURE
và hỗ trợ giao thức hiển thị không dây, thì các thiết bị đó:
- [C-2-1] PHẢI bảo mật đường liên kết bằng một cơ chế mã hoá mạnh như HDCP 2.x trở lên đối với các màn hình được kết nối thông qua các giao thức không dây như Miracast.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ Display.FLAG_SECURE
và hỗ trợ màn hình ngoài có dây, thì các hoạt động đó:
- [C-3-1] PHẢI hỗ trợ HDCP 1.2 trở lên cho tất cả màn hình ngoài được kết nối qua cổng có dây mà người dùng có thể truy cập.
5.9. Giao diện kỹ thuật số cho nhạc cụ (MIDI)
Nếu quá trình triển khai thiết bị báo cáo hỗ trợ tính năng android.software.midi
thông qua lớp android.content.pm.PackageManager
, thì các thiết bị đó:
-
[C-1-1] PHẢI hỗ trợ MIDI qua tất cả phương thức truyền tải phần cứng có khả năng MIDI mà các phương thức này cung cấp khả năng kết nối chung không phải MIDI, trong đó các phương thức truyền tải đó là:
-
[C-1-2] PHẢI hỗ trợ việc truyền phần mềm MIDI giữa các ứng dụng (thiết bị MIDI ảo)
5.10. Âm thanh chuyên nghiệp
Nếu quá trình triển khai thiết bị báo cáo hỗ trợ tính năng android.hardware.audio.pro
thông qua lớp android.content.pm.PackageManager, thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo khả năng hỗ trợ tính năng
android.hardware.audio.low_latency
. - [C-1-2] PHẢI có độ trễ âm thanh trọn vòng liên tục, như được xác định trong mục 5.6 Độ trễ âm thanh, PHẢI là 20 mili giây trở xuống và NÊN là 10 mili giây trở xuống trên ít nhất một đường dẫn được hỗ trợ.
- [C-1-3] PHẢI có(các) cổng USB hỗ trợ chế độ máy chủ USB và chế độ thiết bị ngoại vi USB.
- [C-1-4] PHẢI báo cáo khả năng hỗ trợ tính năng
android.software.midi
. - [C-1-5] PHẢI đáp ứng độ trễ và các yêu cầu về âm thanh USB bằng cách sử dụng cả hàng đợi bộ đệm PCM OpenSL ES và API âm thanh gốc AAudio.
- [SR] NÊN cung cấp mức hiệu suất CPU nhất quán trong khi âm thanh đang hoạt động và tải CPU thay đổi. Bạn nên kiểm thử bằng cách sử dụng thay đổi SimpleSynth 1bd6391. Bạn cần chạy ứng dụng SimpleSynth với các tham số bên dưới và đạt được 0 lần thiếu dữ liệu sau 10 phút:
- Chu kỳ công việc: 200.000
- Tải biến: BẬT (chế độ này sẽ chuyển đổi giữa 100% và 10% giá trị chu kỳ công việc mỗi 2 giây và được thiết kế để kiểm thử hành vi của trình quản lý CPU)
- Tải ổn định: TẮT
- NÊN giảm thiểu độ không chính xác và độ lệch của đồng hồ âm thanh so với thời gian chuẩn.
- NÊN giảm thiểu độ trễ đồng hồ âm thanh so với
CLOCK_MONOTONIC
của CPU khi cả hai đều đang hoạt động. - NÊN giảm thiểu độ trễ âm thanh qua các bộ chuyển đổi trên thiết bị.
- NÊN giảm thiểu độ trễ âm thanh qua âm thanh kỹ thuật số qua USB.
- NÊN ghi lại kết quả đo lường độ trễ âm thanh trên tất cả các đường dẫn.
- NÊN giảm thiểu độ trễ trong thời gian nhập lệnh gọi lại hoàn tất vùng đệm âm thanh, vì điều này ảnh hưởng đến tỷ lệ phần trăm băng thông CPU đầy đủ có thể sử dụng của lệnh gọi lại.
- NÊN cung cấp âm thanh không bị thiếu (đầu ra) hoặc vượt quá (đầu vào) trong quá trình sử dụng bình thường ở độ trễ được báo cáo.
- PHẢI cung cấp độ trễ giữa các kênh bằng 0.
- NÊN giảm thiểu độ trễ trung bình của MIDI trên tất cả các phương thức truyền tải.
- NÊN giảm thiểu độ biến thiên độ trễ MIDI khi tải (jitter) trên tất cả các phương thức truyền tải.
- NÊN cung cấp dấu thời gian MIDI chính xác trên tất cả các phương thức truyền tải.
- NÊN giảm thiểu nhiễu tín hiệu âm thanh qua các bộ chuyển đổi trên thiết bị, bao gồm cả khoảng thời gian ngay sau khi khởi động nguội.
- PHẢI cung cấp độ lệch xung nhịp âm thanh bằng 0 giữa phía đầu vào và đầu ra của các điểm cuối tương ứng, khi cả hai đều đang hoạt động. Ví dụ về các điểm cuối tương ứng bao gồm micrô và loa trên thiết bị hoặc đầu vào và đầu ra của giắc cắm âm thanh.
- NÊN xử lý lệnh gọi lại hoàn tất bộ đệm âm thanh cho phía đầu vào và đầu ra của các điểm cuối tương ứng trên cùng một luồng khi cả hai đều đang hoạt động và nhập lệnh gọi lại đầu ra ngay sau khi trả về từ lệnh gọi lại đầu vào. Hoặc nếu không thể xử lý các lệnh gọi lại trên cùng một luồng, hãy nhập lệnh gọi lại đầu ra ngay sau khi nhập lệnh gọi lại đầu vào để cho phép ứng dụng có thời gian nhất quán cho các bên đầu vào và đầu ra.
- NÊN giảm thiểu sự khác biệt về pha giữa vùng đệm âm thanh HAL cho các bên đầu vào và đầu ra của các điểm cuối tương ứng.
- NÊN giảm thiểu độ trễ khi chạm.
- NÊN giảm thiểu độ biến thiên của độ trễ cảm ứng khi tải (jitter).
- PHẢI có độ trễ từ đầu vào cảm ứng đến đầu ra âm thanh nhỏ hơn hoặc bằng 40 mili giây.
Nếu việc triển khai thiết bị đáp ứng tất cả các yêu cầu trên, thì:
- [SR] NÊN báo cáo tính năng hỗ trợ
android.hardware.audio.pro
thông qua lớpandroid.content.pm.PackageManager
.
Nếu việc triển khai thiết bị bao gồm giắc âm thanh 3,5 mm 4 dây, thì các thiết bị đó:
- [C-2-1] PHẢI có độ trễ âm thanh trọn vòng liên tục dưới 20 mili giây qua đường dẫn giắc cắm âm thanh.
- [SR] BẠN NÊN tuân thủ phần Thông số kỹ thuật của thiết bị di động (giắc cắm) trong Thông số kỹ thuật của tai nghe âm thanh có dây (phiên bản 1.1).
- Độ trễ âm thanh trọn vòng liên tục PHẢI là 10 mili giây trở xuống qua đường dẫn giắc cắm âm thanh.
Nếu quá trình triển khai thiết bị bỏ qua giắc âm thanh 3,5 mm 4 dây và bao gồm(các) cổng USB hỗ trợ chế độ máy chủ USB, thì các thiết bị đó:
- [C-3-1] PHẢI triển khai lớp âm thanh USB.
- [C-3-2] PHẢI có độ trễ âm thanh liên tục từ đầu đến cuối là 20 mili giây trở xuống qua cổng chế độ máy chủ USB bằng cách sử dụng lớp âm thanh USB.
- Độ trễ âm thanh trọn vòng liên tục PHẢI là 10 mili giây trở xuống qua cổng chế độ máy chủ USB bằng cách sử dụng lớp âm thanh USB.
Nếu triển khai cổng HDMI, thiết bị sẽ:
- [C-4-1] PHẢI hỗ trợ đầu ra âm thanh nổi và 8 kênh ở độ sâu 20 bit hoặc 24 bit và 192 kHz mà không làm mất độ sâu bit hoặc lấy mẫu lại, trong ít nhất một cấu hình.
5.11. Chụp cho chưa xử lý
Android hỗ trợ tính năng ghi âm thanh chưa xử lý thông qua nguồn âm thanh android.media.MediaRecorder.AudioSource.UNPROCESSED
. Trong OpenSL ES, bạn có thể truy cập vào tệp này bằng SL_ANDROID_RECORDING_PRESET_UNPROCESSED
cài đặt trước bản ghi.
Nếu việc triển khai thiết bị có ý định hỗ trợ nguồn âm thanh chưa qua xử lý và cung cấp nguồn âm thanh đó cho các ứng dụng bên thứ ba, thì các thiết bị đó:
-
[C-1-1] PHẢI báo cáo tính năng hỗ trợ thông qua thuộc tính
android.media.AudioManager
PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED. -
[C-1-2] PHẢI thể hiện đặc điểm biên độ so với tần số gần như phẳng trong dải tần số trung bình: cụ thể là ±10dB từ 100 Hz đến 7000 Hz đối với từng micrô dùng để ghi nguồn âm thanh chưa qua xử lý.
-
[C-1-3] PHẢI cho thấy các mức biên độ trong dải tần số thấp: cụ thể là từ ±20 dB từ 5 Hz đến 100 Hz so với dải tần số trung bình cho từng micrô dùng để ghi nguồn âm thanh chưa qua xử lý.
-
[C-1-4] PHẢI cho thấy các mức biên độ trong dải tần số cao: cụ thể là từ ±30 dB từ 7000 Hz đến 22 KHz so với dải tần số trung bình cho từng micrô dùng để ghi nguồn âm thanh chưa qua xử lý.
-
[C-1-5] PHẢI đặt độ nhạy đầu vào âm thanh sao cho nguồn âm thanh dạng sóng sin 1000 Hz phát ở Độ áp suất âm thanh (SPL) 94 dB sẽ tạo ra phản hồi có RMS là 520 đối với các mẫu 16 bit (hoặc -36 dB Full Scale đối với các mẫu dấu phẩy động/độ chính xác kép) cho mọi micrô dùng để ghi nguồn âm thanh chưa qua xử lý.
-
[C-1-6] PHẢI có tỷ lệ tín hiệu trên tạp âm (SNR) ở mức 60 dB trở lên đối với mọi micrô dùng để ghi nguồn âm thanh chưa qua xử lý. (trong khi SNR được đo bằng chênh lệch giữa 94 dB SPL và SPL tương đương của tiếng ồn tự thân, theo trọng số A).
-
[C-1-7] PHẢI có tổng độ méo hài (THD) nhỏ hơn 1% đối với 1 kHz ở mức đầu vào SPL 90 dB trên mọi micrô dùng để ghi nguồn âm thanh chưa xử lý.
-
KHÔNG được có bất kỳ quá trình xử lý tín hiệu nào khác (ví dụ: Kiểm soát độ lợi tự động, Bộ lọc thông cao hoặc Huỷ tiếng vọng) trong đường dẫn ngoài hệ số mức để đưa mức độ đến phạm vi mong muốn. Hay nói cách khác:
- [C-1-8] Nếu có bất kỳ hoạt động xử lý tín hiệu nào trong cấu trúc vì bất kỳ lý do gì, thì hoạt động đó PHẢI bị vô hiệu hoá và phải đưa ra độ trễ bằng 0 hoặc độ trễ bổ sung một cách hiệu quả cho đường dẫn tín hiệu.
- [C-1-9] Mặc dù được phép nằm trên đường dẫn, nhưng hệ số mức KHÔNG ĐƯỢC gây ra độ trễ hoặc độ trễ cho đường dẫn tín hiệu.
Tất cả các phép đo SPL đều được thực hiện ngay bên cạnh micrô đang được kiểm thử. Đối với nhiều cấu hình micrô, các yêu cầu này áp dụng cho từng micrô.
Nếu quá trình triển khai thiết bị khai báo android.hardware.microphone
nhưng không hỗ trợ nguồn âm thanh chưa xử lý, thì các thiết bị đó:
- [C-2-1] PHẢI trả về
null
cho phương thức APIAudioManager.getProperty(PROPERTY_SUPPORT_AUDIO_SOURCE_UNPROCESSED)
để cho biết chính xác việc không được hỗ trợ. - [SR] vẫn được KHUYẾN KHÍCH mạnh mẽ để đáp ứng nhiều yêu cầu nhất có thể đối với đường dẫn tín hiệu cho nguồn ghi âm chưa xử lý.
6. Khả năng tương thích của các công cụ và tuỳ chọn dành cho nhà phát triển
6.1. Công cụ dành cho nhà phát triển
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ Bộ công cụ dành cho nhà phát triển Android được cung cấp trong SDK Android.
-
- [C-0-2] PHẢI hỗ trợ adb như được ghi nhận trong SDK Android và các lệnh shell được cung cấp trong AOSP. Nhà phát triển ứng dụng có thể sử dụng các lệnh này, bao gồm cả
dumpsys
vàcmd stats
. - [C-0-3] KHÔNG ĐƯỢC thay đổi định dạng hoặc nội dung của các sự kiện hệ thống thiết bị (batterystats , diskstats, fingerprint, graphicsstats, netstats, notification, procstats) được ghi lại thông qua lệnh dumpsys.
- [C-0-10] PHẢI ghi lại, không được bỏ qua và cho phép truy cập vào các sự kiện sau đây cho lệnh shell
cmd stats
và lớp API Hệ thốngStatsManager
.- ActivityForegroundStateChanged
- AnomalyDetected
- AppBreadcrumbReported
- AppCrashOccurred
- AppStartOccurred
- BatteryLevelChanged
- BatterySaverModeStateChanged
- BleScanResultReceived
- BleScanStateChanged
- ChargingStateChanged
- DeviceIdleModeStateChanged
- ForegroundServiceStateChanged
- GpsScanStateChanged
- JobStateChanged
- PluggedStateChanged
- ScheduledJobStateChanged
- ScreenStateChanged
- SyncStateChanged
- SystemElapsedRealtime
- UidProcessStateChanged
- WakelockStateChanged
- WakeupAlarmOccurred
- WifiLockStateChanged
- WifiMulticastLockStateChanged
- WifiScanStateChanged
- [C-0-4] PHẢI để trình nền adb phía thiết bị ở trạng thái không hoạt động theo mặc định và PHẢI có cơ chế mà người dùng có thể truy cập để bật Cầu gỡ lỗi Android.
- [C-0-5] PHẢI hỗ trợ adb bảo mật. Android hỗ trợ adb bảo mật. adb bảo mật cho phép adb trên các máy chủ đã xác thực đã biết.
-
[C-0-6] PHẢI cung cấp cơ chế cho phép kết nối adb từ máy chủ. Ví dụ:
- Các hoạt động triển khai thiết bị không có cổng USB hỗ trợ chế độ ngoại vi PHẢI triển khai adb thông qua mạng cục bộ (chẳng hạn như Ethernet hoặc Wi-Fi).
- PHẢI cung cấp trình điều khiển cho Windows 7, 9 và 10, cho phép nhà phát triển kết nối với thiết bị bằng giao thức adb.
- [C-0-2] PHẢI hỗ trợ adb như được ghi nhận trong SDK Android và các lệnh shell được cung cấp trong AOSP. Nhà phát triển ứng dụng có thể sử dụng các lệnh này, bao gồm cả
-
Dalvik Debug Monitor Service (ddms)
- [C-0-7] PHẢI hỗ trợ tất cả tính năng ddms như được ghi nhận trong SDK Android. Vì ddms sử dụng adb, nên tính năng hỗ trợ ddms PHẢI ở trạng thái không hoạt động theo mặc định, nhưng PHẢI được hỗ trợ bất cứ khi nào người dùng đã kích hoạt Cầu gỡ lỗi Android, như trên.
-
Monkey
- [C-0-8] PHẢI đưa khung Monkey vào và cung cấp khung này cho các ứng dụng sử dụng.
-
SysTrace
- [C-0-9] PHẢI hỗ trợ công cụ systrace như được ghi nhận trong SDK Android. Theo mặc định, Systrace phải ở trạng thái không hoạt động và PHẢI có một cơ chế mà người dùng có thể truy cập để bật Systrace.
Nếu việc triển khai thiết bị báo cáo việc hỗ trợ Vulkan 1.0 trở lên thông qua cờ tính năng android.hardware.vulkan.version
, thì các thiết bị đó:
- [C-1-1] PHẢI cung cấp một tính năng để nhà phát triển ứng dụng có thể bật/tắt các lớp gỡ lỗi GPU.
- [C-1-2] PHẢI, khi bật các lớp gỡ lỗi GPU, hãy liệt kê các lớp trong thư viện do các công cụ bên ngoài cung cấp (tức là không thuộc nền tảng hoặc gói ứng dụng) có trong thư mục cơ sở của các ứng dụng có thể gỡ lỗi để hỗ trợ các phương thức API vkEnumerateInstanceLayerProperties() và vkCreateInstance().
6.2. Tuỳ chọn cho nhà phát triển
Android hỗ trợ nhà phát triển định cấu hình các chế độ cài đặt liên quan đến việc phát triển ứng dụng.
Việc triển khai thiết bị PHẢI mang lại trải nghiệm nhất quán cho Tuỳ chọn cho nhà phát triển, cụ thể:
- [C-0-1] PHẢI tuân thủ ý định android.settings.APPLICATION_DEVELOPMENT_SETTINGS để hiển thị các chế độ cài đặt liên quan đến việc phát triển ứng dụng. Theo mặc định, việc triển khai Android ngược dòng sẽ ẩn trình đơn Tuỳ chọn cho nhà phát triển và cho phép người dùng chạy Tuỳ chọn cho nhà phát triển sau khi nhấn 7 lần vào mục trình đơn Cài đặt > Giới thiệu về thiết bị > Số bản dựng.
- [C-0-2] PHẢI ẩn Tuỳ chọn cho nhà phát triển theo mặc định.
- [C-0-3] PHẢI cung cấp một cơ chế rõ ràng để không ưu tiên một ứng dụng bên thứ ba so với ứng dụng khác để bật Tuỳ chọn cho nhà phát triển. PHẢI cung cấp tài liệu hoặc trang web công khai mô tả cách bật Tuỳ chọn cho nhà phát triển. Tài liệu hoặc trang web này PHẢI có thể liên kết từ tài liệu SDK Android.
- NÊN có thông báo trực quan liên tục cho người dùng khi bật Tuỳ chọn cho nhà phát triển và cần quan tâm đến sự an toàn của người dùng.
- CÓ THỂ tạm thời hạn chế quyền truy cập vào trình đơn Tuỳ chọn cho nhà phát triển bằng cách ẩn hoặc tắt trình đơn để tránh gây mất tập trung trong các trường hợp cần quan tâm đến sự an toàn của người dùng.
7. Khả năng tương thích với phần cứng
Nếu một thiết bị có một thành phần phần cứng cụ thể có API tương ứng cho nhà phát triển bên thứ ba:
- [C-0-1] Việc triển khai thiết bị PHẢI triển khai API đó như mô tả trong tài liệu SDK Android.
Nếu một API trong SDK tương tác với một thành phần phần cứng được nêu là không bắt buộc và quá trình triển khai thiết bị không có thành phần đó:
- [C-0-2] Vẫn PHẢI trình bày định nghĩa lớp đầy đủ (theo tài liệu của SDK) cho các API thành phần.
- [C-0-3] Hành vi của API PHẢI được triển khai dưới dạng không hoạt động theo một cách hợp lý.
- [C-0-4] Các phương thức API PHẢI trả về giá trị rỗng khi tài liệu SDK cho phép.
- [C-0-5] Các phương thức API PHẢI trả về các phương thức triển khai không hoạt động của các lớp mà tài liệu SDK không cho phép giá trị rỗng.
- [C-0-6] Các phương thức API KHÔNG ĐƯỢC gửi ngoại lệ không được tài liệu SDK ghi lại.
- [C-0-7] Việc triển khai thiết bị PHẢI báo cáo nhất quán thông tin cấu hình phần cứng chính xác thông qua các phương thức
getSystemAvailableFeatures()
vàhasSystemFeature(String)
trên lớp android.content.pm.PackageManager cho cùng một vân tay bản dựng.
Một ví dụ điển hình về trường hợp áp dụng các yêu cầu này là API điện thoại: Ngay cả trên các thiết bị không phải điện thoại, các API này phải được triển khai dưới dạng không hoạt động hợp lý.
7.1. Màn hình và đồ hoạ
Android có các cơ sở tự động điều chỉnh thành phần ứng dụng và bố cục giao diện người dùng cho phù hợp với thiết bị để đảm bảo rằng các ứng dụng bên thứ ba chạy tốt trên nhiều cấu hình phần cứng. Thiết bị PHẢI triển khai đúng cách các API và hành vi này, như được nêu chi tiết trong phần này.
Các đơn vị được tham chiếu theo yêu cầu trong phần này được xác định như sau:
- Kích thước đường chéo thực tế. Khoảng cách tính bằng inch giữa hai góc đối diện của phần được chiếu sáng trên màn hình.
- số điểm trên mỗi inch (dpi). Số pixel được bao phủ bởi một khoảng không gian tuyến tính theo chiều ngang hoặc chiều dọc là 1 inch. Khi liệt kê các giá trị dpi, cả dpi theo chiều ngang và chiều dọc đều phải nằm trong phạm vi.
- tỷ lệ khung hình. Tỷ lệ pixel của kích thước dài hơn so với kích thước ngắn hơn của màn hình. Ví dụ: màn hình 480x854 pixel sẽ là 854/480 = 1,779 hoặc gần bằng "16:9".
- pixel không phụ thuộc vào mật độ (dp). Đơn vị pixel ảo được chuẩn hoá cho màn hình 160 dpi, được tính như sau: pixels = dps * (density/160).
7.1.1. Cấu hình màn hình
7.1.1.1. Kích thước và hình dạng màn hình
Khung giao diện người dùng Android hỗ trợ nhiều kích thước bố cục màn hình logic khác nhau và cho phép các ứng dụng truy vấn kích thước bố cục màn hình của cấu hình hiện tại thông qua Configuration.screenLayout
với SCREENLAYOUT_SIZE_MASK
và Configuration.smallestScreenWidthDp
.
Triển khai trên thiết bị:
-
[C-0-1] PHẢI báo cáo kích thước bố cục chính xác cho
Configuration.screenLayout
như được xác định trong tài liệu SDK Android. Cụ thể, việc triển khai thiết bị PHẢI báo cáo kích thước màn hình pixel không phụ thuộc vào mật độ logic (dp) chính xác như bên dưới:- Các thiết bị có
Configuration.uiMode
được đặt thành bất kỳ giá trị nào khác ngoài UI_MODE_TYPE_WATCH và báo cáo kích thướcsmall
choConfiguration.screenLayout
, PHẢI có kích thước tối thiểu là 426 dp x 320 dp. - Các thiết bị báo cáo kích thước
normal
choConfiguration.screenLayout
, PHẢI có kích thước tối thiểu là 480 dp x 320 dp. - Các thiết bị báo cáo kích thước
large
choConfiguration.screenLayout
, PHẢI có kích thước tối thiểu là 640 dp x 480 dp. - Các thiết bị báo cáo kích thước
xlarge
choConfiguration.screenLayout
, PHẢI có kích thước tối thiểu là 960 dp x 720 dp.
- Các thiết bị có
-
[C-0-2] PHẢI tuân thủ đúng tính năng hỗ trợ kích thước màn hình mà ứng dụng đã nêu thông qua thuộc tính <
supports-screens
> trong AndroidManifest.xml, như mô tả trong tài liệu SDK Android. -
CÓ THỂ có màn hình bo tròn các góc.
Nếu việc triển khai thiết bị hỗ trợ UI_MODE_TYPE_NORMAL
và có màn hình bo tròn các góc, thì các thiết bị đó:
- [C-1-1] PHẢI đảm bảo bán kính của các góc bo tròn nhỏ hơn hoặc bằng 38 dp.
- NÊN bao gồm khả năng hỗ trợ người dùng chuyển sang chế độ hiển thị có các góc hình chữ nhật.
7.1.1.2. Tỷ lệ khung hình màn hình
Mặc dù không có quy định hạn chế đối với giá trị tỷ lệ khung hình màn hình hiển thị thực, nhưng tỷ lệ khung hình màn hình hiển thị logic mà các ứng dụng bên thứ ba hiển thị trong đó, có thể được lấy từ các giá trị chiều cao và chiều rộng được báo cáo thông qua API view.Display
và API Cấu hình, PHẢI đáp ứng các yêu cầu sau:
-
[C-0-1] Việc triển khai thiết bị với
Configuration.uiMode
được đặt thànhUI_MODE_TYPE_NORMAL
PHẢI có giá trị tỷ lệ khung hình từ 1,3333 (4:3) đến 1,86 (khoảng 16:9), trừ phi ứng dụng có thể được coi là đã sẵn sàng để kéo dài hơn bằng cách đáp ứng một trong các điều kiện sau:- Ứng dụng đã khai báo rằng ứng dụng hỗ trợ tỷ lệ khung hình màn hình lớn hơn thông qua giá trị siêu dữ liệu
android.max_aspect
. - Ứng dụng khai báo rằng có thể đổi kích thước thông qua thuộc tính android:resizeableActivity.
- Ứng dụng đang nhắm đến API cấp 24 trở lên và không khai báo
android:MaxAspectRatio
để hạn chế tỷ lệ khung hình được phép.
- Ứng dụng đã khai báo rằng ứng dụng hỗ trợ tỷ lệ khung hình màn hình lớn hơn thông qua giá trị siêu dữ liệu
-
[C-0-2] Việc triển khai thiết bị với
Configuration.uiMode
được đặt thànhUI_MODE_TYPE_WATCH
PHẢI có giá trị tỷ lệ khung hình được đặt thành 1.0 (1:1).
7.1.1.3. Mật độ màn hình
Khung giao diện người dùng Android xác định một tập hợp mật độ logic tiêu chuẩn để giúp nhà phát triển ứng dụng nhắm đến tài nguyên ứng dụng.
-
[C-0-1] Theo mặc định, việc triển khai thiết bị CHỈ ĐƯỢC báo cáo một trong các mật độ khung Android logic sau đây thông qua API DENSITY_DEVICE_STABLE và giá trị này KHÔNG ĐƯỢC thay đổi bất cứ lúc nào; tuy nhiên, thiết bị CÓ THỂ báo cáo một mật độ tuỳ ý khác theo các thay đổi về cấu hình hiển thị do người dùng thực hiện (ví dụ: kích thước màn hình) được đặt sau khi khởi động ban đầu.
- 120 dpi (ldpi)
- 160 dpi (mdpi)
- 213 dpi (tvdpi)
- 240 dpi (hdpi)
- 260 dpi (260dpi)
- 280 dpi (280dpi)
- 300 dpi (300dpi)
- 320 dpi (xhdpi)
- 340 dpi (340dpi)
- 360 dpi (360dpi)
- 400 dpi (400dpi)
- 420 dpi (420dpi)
- 480 dpi (xxhdpi)
- 560 dpi (560dpi)
- 640 dpi (xxxhdpi)
-
Việc triển khai thiết bị PHẢI xác định mật độ khung Android chuẩn gần nhất về mặt số học với mật độ thực tế của màn hình, trừ phi mật độ logic đó đẩy kích thước màn hình được báo cáo xuống dưới mức tối thiểu được hỗ trợ. Nếu mật độ khung Android chuẩn gần nhất về mặt số học với mật độ thực tế dẫn đến kích thước màn hình nhỏ hơn kích thước màn hình tương thích được hỗ trợ nhỏ nhất (chiều rộng 320 dp), thì việc triển khai thiết bị PHẢI báo cáo mật độ khung Android chuẩn thấp nhất tiếp theo.
Nếu có khả năng thay đổi kích thước hiển thị của thiết bị:
- [C-1-1] Kích thước màn hình KHÔNG ĐƯỢC lớn hơn 1,5 lần mật độ gốc hoặc tạo kích thước màn hình tối thiểu hiệu quả nhỏ hơn 320 dp (tương đương với bộ hạn định tài nguyên sw320dp), tuỳ theo giá trị nào đến trước.
- [C-1-2] Kích thước màn hình KHÔNG ĐƯỢC nhỏ hơn 0,85 lần mật độ gốc.
- Để đảm bảo khả năng hữu dụng và kích thước phông chữ nhất quán, bạn NÊN cung cấp tỷ lệ sau đây cho các tuỳ chọn Màn hình gốc (trong khi tuân thủ các giới hạn nêu trên)
- Nhỏ: 0,85x
- Mặc định: 1x (Tỷ lệ hiển thị gốc)
- Lớn: 1,15x
- Lớn hơn: 1,3 lần
- Lớn nhất 1,45x
7.1.2. Chỉ số về Mạng Hiển thị
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo giá trị chính xác cho tất cả chỉ số hiển thị được xác định trong API
android.util.DisplayMetrics
.
Nếu việc triển khai thiết bị không bao gồm màn hình nhúng hoặc đầu ra video, thì thiết bị đó:
- [C-2-1] PHẢI báo cáo các giá trị hợp lý cho tất cả chỉ số hiển thị được xác định trong API
android.util.DisplayMetrics
choview.Display
mặc định được mô phỏng.
7.1.3. Hướng màn hình
Triển khai trên thiết bị:
- [C-0-1] PHẢI báo cáo hướng màn hình mà ứng dụng hỗ trợ (
android.hardware.screen.portrait
và/hoặcandroid.hardware.screen.landscape
) và PHẢI báo cáo ít nhất một hướng được hỗ trợ. Ví dụ: một thiết bị có màn hình ngang cố định, chẳng hạn như TV hoặc máy tính xách tay, CHỈ NÊN báo cáoandroid.hardware.screen.landscape
. - [C-0-2] PHẢI báo cáo đúng giá trị cho hướng hiện tại của thiết bị, bất cứ khi nào được truy vấn thông qua
android.content.res.Configuration.orientation
,android.view.Display.getOrientation()
hoặc các API khác.
Nếu cách triển khai thiết bị hỗ trợ cả hai hướng màn hình, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ hướng động của các ứng dụng theo hướng màn hình dọc hoặc ngang. Tức là thiết bị phải tuân theo yêu cầu của ứng dụng về hướng màn hình cụ thể.
- [C-1-2] KHÔNG ĐƯỢC thay đổi kích thước hoặc mật độ màn hình được báo cáo khi thay đổi hướng.
- CÓ THỂ chọn hướng dọc hoặc ngang làm hướng mặc định.
7.1.4. Tăng tốc đồ hoạ 2D và 3D
7.1.4.1 OpenGL ES
Triển khai trên thiết bị:
- [C-0-1] PHẢI xác định chính xác các phiên bản OpenGL ES được hỗ trợ (1.1, 2.0, 3.0, 3.1, 3.2) thông qua các API được quản lý (chẳng hạn như thông qua phương thức
GLES10.getString()
) và các API gốc. - [C-0-2] PHẢI hỗ trợ tất cả API được quản lý và API gốc tương ứng cho mọi phiên bản OpenGL ES mà họ xác định là hỗ trợ.
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ cả OpenGL ES 1.1 và 2.0, như được nêu và nêu chi tiết trong tài liệu về SDK Android.
- [SR] NÊN hỗ trợ OpenGL ES 3.1.
- PHẢI hỗ trợ OpenGL ES 3.2.
Nếu việc triển khai thiết bị hỗ trợ bất kỳ phiên bản OpenGL ES nào, thì các phiên bản đó:
- [C-2-1] PHẢI báo cáo thông qua các API do OpenGL ES quản lý và API gốc về mọi tiện ích OpenGL ES khác mà họ đã triển khai, và ngược lại, KHÔNG ĐƯỢC báo cáo các chuỗi tiện ích mà họ không hỗ trợ.
- [C-2-2] PHẢI hỗ trợ các tiện ích
EGL_KHR_image
,EGL_KHR_image_base
,EGL_ANDROID_image_native_buffer
,EGL_ANDROID_get_native_client_buffer
,EGL_KHR_wait_sync
,EGL_KHR_get_all_proc_addresses
,EGL_ANDROID_presentation_time
,EGL_KHR_swap_buffers_with_damage
vàEGL_ANDROID_recordable
. - [SR] NÊN hỗ trợ EGL_KHR_partial_update.
- PHẢI báo cáo chính xác thông qua phương thức
getString()
, mọi định dạng nén kết cấu mà chúng hỗ trợ, thường là dành riêng cho nhà cung cấp.
Nếu việc triển khai thiết bị khai báo hỗ trợ OpenGL ES 3.0, 3.1 hoặc 3.2, thì các thiết bị đó:
- [C-3-1] PHẢI xuất các biểu tượng hàm tương ứng cho các phiên bản này ngoài các biểu tượng hàm OpenGL ES 2.0 trong thư viện libGLESv2.so.
Nếu các phương thức triển khai thiết bị hỗ trợ OpenGL ES 3.2, thì các phương thức đó:
- [C-4-1] PHẢI hỗ trợ toàn bộ Gói tiện ích Android OpenGL ES.
Nếu quá trình triển khai thiết bị hỗ trợ toàn bộ Gói tiện ích Android OpenGL ES, thì các thiết bị đó:
- [C-5-1] PHẢI xác định tính năng hỗ trợ thông qua cờ tính năng
android.hardware.opengles.aep
.
Nếu việc triển khai thiết bị hiển thị tính năng hỗ trợ cho tiện ích EGL_KHR_mutable_render_buffer
, thì các thiết bị đó:
- [C-6-1] CŨNG PHẢI hỗ trợ tiện ích
EGL_ANDROID_front_buffer_auto_refresh
.
7.1.4.2 Vulkan
Android hỗ trợ Vulkan , một API nhiều nền tảng, mức hao tổn thấp dành cho đồ hoạ 3D hiệu suất cao.
Nếu các phương thức triển khai thiết bị hỗ trợ OpenGL ES 3.1, thì các phương thức đó:
- [SR] Bạn NÊN hỗ trợ Vulkan 1.1.
Nếu quá trình triển khai thiết bị bao gồm màn hình hoặc đầu ra video, thì các thiết bị đó:
- PHẢI hỗ trợ Vulkan 1.1.
Nếu việc triển khai thiết bị có hỗ trợ Vulkan 1.0, thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo giá trị số nguyên chính xác bằng cờ tính năng
android.hardware.vulkan.level
vàandroid.hardware.vulkan.version
. - [C-1-2] PHẢI liệt kê ít nhất một
VkPhysicalDevice
cho API gốc VulkanvkEnumeratePhysicalDevices()
. - [C-1-3] PHẢI triển khai đầy đủ các API Vulkan 1.0 cho mỗi
VkPhysicalDevice
được liệt kê. - [C-1-4] PHẢI liệt kê các lớp, có trong thư viện gốc có tên là
libVkLayer*.so
trong thư mục thư viện gốc của gói ứng dụng, thông qua API gốc VulkanvkEnumerateInstanceLayerProperties()
vàvkEnumerateDeviceLayerProperties()
. - [C-1-5] KHÔNG ĐƯỢC liệt kê các lớp do thư viện cung cấp bên ngoài gói ứng dụng hoặc cung cấp các cách khác để theo dõi hoặc chặn API Vulkan, trừ phi ứng dụng có thuộc tính
android:debuggable
được đặt thànhtrue
. - [C-1-6] PHẢI báo cáo tất cả chuỗi tiện ích mà chúng hỗ trợ thông qua API gốc Vulkan và ngược lại , KHÔNG ĐƯỢC báo cáo chuỗi tiện ích mà chúng không hỗ trợ chính xác.
- [C-1-7] PHẢI hỗ trợ các tiện ích VK_KHR_surface, VK_KHR_android_surface, VK_KHR_swapchain và VK_KHR_incremental_present.
Nếu không hỗ trợ Vulkan 1.0, các phương thức triển khai thiết bị sẽ:
- [C-2-1] KHÔNG ĐƯỢC khai báo bất kỳ cờ tính năng nào của Vulkan (ví dụ:
android.hardware.vulkan.level
,android.hardware.vulkan.version
). - [C-2-2] KHÔNG ĐƯỢC liệt kê bất kỳ
VkPhysicalDevice
nào cho API gốc VulkanvkEnumeratePhysicalDevices()
.
Nếu việc triển khai thiết bị có hỗ trợ Vulkan 1.1, thì các thiết bị đó:
- [C-3-1] PHẢI hiển thị tính năng hỗ trợ cho loại semaphore và handle bên ngoài
SYNC_FD
. - [SR] NÊN hỗ trợ tiện ích
VK_ANDROID_external_memory_android_hardware_buffer
.
7.1.4.3 RenderScript
- [C-0-1] Việc triển khai thiết bị PHẢI hỗ trợ Android RenderScript, như được nêu chi tiết trong tài liệu SDK Android.
7.1.4.4 Tăng tốc đồ hoạ 2D
Android có một cơ chế để các ứng dụng khai báo rằng chúng muốn bật tính năng tăng tốc phần cứng cho đồ hoạ 2D ở cấp Ứng dụng, Hoạt động, Cửa sổ hoặc Khung hiển thị thông qua việc sử dụng thẻ tệp kê khai android:hardwareAccelerated hoặc lệnh gọi API trực tiếp.
Triển khai trên thiết bị:
- [C-0-1] PHẢI bật tính năng tăng tốc phần cứng theo mặc định và PHẢI tắt tính năng tăng tốc phần cứng nếu nhà phát triển yêu cầu bằng cách đặt android:hardwareAccelerated="false" hoặc tắt tính năng tăng tốc phần cứng trực tiếp thông qua API Khung hiển thị Android.
- [C-0-2] PHẢI thể hiện hành vi nhất quán với tài liệu SDK Android về tính năng tăng tốc phần cứng.
Android bao gồm một đối tượng TextureView cho phép nhà phát triển trực tiếp tích hợp các kết cấu OpenGL ES được tăng tốc phần cứng làm mục tiêu kết xuất trong hệ phân cấp giao diện người dùng.
Triển khai trên thiết bị:
- [C-0-3] PHẢI hỗ trợ API TextureView và PHẢI thể hiện hành vi nhất quán với cách triển khai Android ngược dòng.
7.1.4.5 Màn hình gam màu rộng
Nếu các hoạt động triển khai thiết bị tuyên bố hỗ trợ màn hình gam màu rộng thông qua Configuration.isScreenWideColorGamut()
, thì các hoạt động đó:
- [C-1-1] PHẢI có màn hình được hiệu chỉnh màu.
- [C-1-2] PHẢI có màn hình có gam màu bao phủ toàn bộ gam màu sRGB trong không gian xyY CIE 1931.
- [C-1-3] PHẢI có màn hình có gam màu có diện tích ít nhất là 90% DCI-P3 trong không gian CIE 1931 xyY.
- [C-1-4] PHẢI hỗ trợ OpenGL ES 3.1 hoặc 3.2 và báo cáo đúng cách.
- [C-1-5] PHẢI quảng cáo tính năng hỗ trợ cho các tiện ích
EGL_KHR_no_config_context
,EGL_EXT_pixel_format_float
,EGL_KHR_gl_colorspace
,EGL_EXT_gl_colorspace_scrgb
,EGL_EXT_gl_colorspace_scrgb_linear
,EGL_EXT_gl_colorspace_display_p3
vàEGL_KHR_gl_colorspace_display_p3
. - [SR] NÊN hỗ trợ
GL_EXT_sRGB
.
Ngược lại, nếu việc triển khai thiết bị không hỗ trợ màn hình gam màu rộng, thì các thiết bị đó:
- [C-2-1] PHẢI bao phủ 100% trở lên của sRGB trong không gian xyY CIE 1931, mặc dù gam màu màn hình không được xác định.
7.1.5. Chế độ tương thích với ứng dụng cũ
Android chỉ định một "chế độ tương thích" trong đó khung hoạt động ở chế độ tương đương với kích thước màn hình "bình thường" (chiều rộng 320 dp) để mang lại lợi ích cho các ứng dụng cũ không được phát triển cho các phiên bản Android cũ trước khi có tính năng độc lập với kích thước màn hình.
7.1.6. Công nghệ màn hình
Nền tảng Android bao gồm các API cho phép ứng dụng kết xuất đồ hoạ đa dạng thức cho màn hình. Thiết bị PHẢI hỗ trợ tất cả các API này theo định nghĩa của SDK Android, trừ phi được cho phép cụ thể trong tài liệu này.
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ màn hình có khả năng kết xuất đồ hoạ màu 16 bit.
- PHẢI hỗ trợ màn hình có thể hiển thị đồ hoạ màu 24 bit.
- [C-0-2] PHẢI hỗ trợ màn hình có khả năng kết xuất ảnh động.
- [C-0-3] PHẢI sử dụng công nghệ hiển thị có tỷ lệ khung hình pixel (PAR) từ 0,9 đến 1,15. Tức là tỷ lệ khung hình bằng pixel PHẢI gần vuông (1, 0) với dung sai 10 đến 15%.
7.1.7. Màn hình phụ
Android hỗ trợ màn hình phụ để bật các tính năng chia sẻ nội dung nghe nhìn và API dành cho nhà phát triển để truy cập vào màn hình ngoài.
Nếu việc triển khai thiết bị hỗ trợ màn hình ngoài thông qua kết nối có dây, không dây hoặc kết nối màn hình bổ sung được nhúng, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai dịch vụ hệ thống và API
DisplayManager
như mô tả trong tài liệu SDK Android.
7.2. Thiết bị Đầu vào
Triển khai trên thiết bị:
- [C-0-1] PHẢI có cơ chế nhập, chẳng hạn như màn hình cảm ứng hoặc chế độ điều hướng không chạm để di chuyển giữa các thành phần trên giao diện người dùng.
7.2.1. Bàn phím
Nếu việc triển khai thiết bị bao gồm việc hỗ trợ các ứng dụng Trình chỉnh sửa phương thức nhập (IME) của bên thứ ba, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC phải khai báo cờ tính năng
android.software.input_methods
. - [C-1-2] PHẢI triển khai đầy đủ
Input Management Framework
- [C-1-3] PHẢI có bàn phím phần mềm được cài đặt sẵn.
Triển khai thiết bị: * [C-0-1] KHÔNG ĐƯỢC đưa bàn phím phần cứng không khớp với một trong các định dạng được chỉ định trong android.content.res.Configuration.keyboard (QWERTY hoặc 12 phím). * NÊN bao gồm các phương thức triển khai bàn phím mềm bổ sung. * CÓ THỂ có bàn phím phần cứng.
7.2.2. Điều hướng không chạm
Android hỗ trợ d-pad, bi xoay và bánh xe dưới dạng cơ chế điều hướng không chạm.
Triển khai trên thiết bị:
- [C-0-1] PHẢI báo cáo giá trị chính xác cho android.content.res.Configuration.navigation.
Nếu việc triển khai thiết bị thiếu tính năng điều hướng không chạm, thì thiết bị đó:
- [C-1-1] PHẢI cung cấp một cơ chế giao diện người dùng thay thế hợp lý để chọn và chỉnh sửa văn bản, tương thích với Công cụ quản lý đầu vào. Việc triển khai nguồn mở Android ngược dòng bao gồm một cơ chế lựa chọn phù hợp để sử dụng với các thiết bị thiếu phương thức nhập điều hướng không chạm.
7.2.3. Phím điều hướng
Các hàm Màn hình chính, Gần đây và Quay lại thường được cung cấp thông qua hoạt động tương tác với một nút vật lý chuyên dụng hoặc một phần riêng biệt của màn hình cảm ứng, là yếu tố thiết yếu đối với mô hình điều hướng của Android và do đó, việc triển khai thiết bị:
- [C-0-1] PHẢI cung cấp cho người dùng khả năng khởi chạy các ứng dụng đã cài đặt có hoạt động với
<intent-filter>
được đặt bằngACTION=MAIN
vàCATEGORY=LAUNCHER
hoặcCATEGORY=LEANBACK_LAUNCHER
để triển khai thiết bị truyền hình. Hàm Trang chủ PHẢI là cơ chế cho khả năng hỗ trợ người dùng này. - NÊN cung cấp các nút cho chức năng Gần đây và Quay lại.
Nếu có chức năng Trang chủ, Gần đây hoặc Quay lại, thì các chức năng này:
- [C-1-1] PHẢI truy cập được bằng một thao tác (ví dụ: nhấn, nhấp đúp hoặc cử chỉ) khi có thể truy cập được bất kỳ thao tác nào trong số này.
- [C-1-2] PHẢI cho biết rõ hành động nào sẽ kích hoạt từng hàm. Ví dụ về các chỉ báo như vậy bao gồm việc in một biểu tượng rõ ràng trên nút, hiển thị biểu tượng phần mềm trên phần thanh điều hướng của màn hình hoặc hướng dẫn người dùng thực hiện quy trình minh hoạ từng bước trong quá trình thiết lập ngay khi lấy ra khỏi hộp.
Triển khai trên thiết bị:
- [SR] KHÔNG NÊN cung cấp cơ chế nhập cho Hàm trình đơn vì hàm này không còn được dùng nữa mà thay vào đó là thanh thao tác kể từ Android 4.0.
Nếu quá trình triển khai thiết bị cung cấp hàm Trình đơn, thì các thiết bị đó:
- [C-2-1] PHẢI hiển thị nút trình đơn mục bổ sung thao tác bất cứ khi nào cửa sổ bật lên của trình đơn mục bổ sung thao tác không trống và thanh thao tác hiển thị.
- [C-2-2] KHÔNG ĐƯỢC sửa đổi vị trí của cửa sổ bật lên mục bổ sung thao tác hiển thị bằng cách chọn nút mục bổ sung trong thanh thao tác, nhưng CÓ THỂ hiển thị cửa sổ bật lên mục bổ sung thao tác ở vị trí đã sửa đổi trên màn hình khi cửa sổ này hiển thị bằng cách chọn hàm Trình đơn.
Nếu việc triển khai thiết bị không cung cấp chức năng Trình đơn, thì để tương thích ngược, các thiết bị đó: * [C-3-1] PHẢI cung cấp chức năng Trình đơn cho các ứng dụng khi targetSdkVersion
nhỏ hơn 10, bằng nút vật lý, khoá phần mềm hoặc cử chỉ. Bạn có thể truy cập vào hàm Trình đơn này trừ phi nó bị ẩn cùng với các hàm điều hướng khác.
Nếu việc triển khai thiết bị cung cấp Hàm hỗ trợ, thì các thiết bị đó: * [C-4-1] PHẢI cho phép truy cập vào Hàm hỗ trợ bằng một thao tác duy nhất (ví dụ: nhấn, nhấp đúp hoặc cử chỉ) khi có thể truy cập vào các phím điều hướng khác. * [SR] NÊN sử dụng thao tác nhấn và giữ trên hàm HOME (TRANG CHỦ) làm thao tác tương tác được chỉ định này.
Nếu việc triển khai thiết bị sử dụng một phần riêng biệt của màn hình để hiển thị các phím điều hướng, thì các phím đó:
- [C-5-1] Các phím điều hướng PHẢI sử dụng một phần màn hình riêng biệt, không dành cho ứng dụng và KHÔNG ĐƯỢC che khuất hoặc can thiệp vào phần màn hình dành cho ứng dụng.
- [C-5-2] PHẢI cung cấp một phần màn hình cho các ứng dụng đáp ứng các yêu cầu được xác định trong mục 7.1.1.
- [C-5-3] PHẢI tuân thủ các cờ do ứng dụng đặt thông qua phương thức API
View.setSystemUiVisibility()
để phần riêng biệt này của màn hình (còn gọi là thanh điều hướng) được ẩn đúng cách như được ghi lại trong SDK.
7.2.4. Nhập bằng màn hình cảm ứng
Android hỗ trợ nhiều hệ thống nhập bằng con trỏ, chẳng hạn như màn hình cảm ứng, bàn di chuột và thiết bị nhập bằng thao tác chạm giả. Các hoạt động triển khai thiết bị dựa trên màn hình cảm ứng được liên kết với màn hình để người dùng có cảm giác trực tiếp thao tác với các mục trên màn hình. Vì người dùng đang trực tiếp chạm vào màn hình, nên hệ thống không yêu cầu thêm bất kỳ tính năng nào để cho biết các đối tượng đang được thao tác.
Triển khai trên thiết bị:
- PHẢI có một hệ thống nhập con trỏ (giống như chuột hoặc cảm ứng).
- PHẢI hỗ trợ các con trỏ được theo dõi hoàn toàn độc lập.
Nếu việc triển khai thiết bị bao gồm màn hình cảm ứng (một lần chạm trở lên), thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo
TOUCHSCREEN_FINGER
cho trường APIConfiguration.touchscreen
. - [C-1-2] PHẢI báo cáo cờ tính năng
android.hardware.touchscreen
vàandroid.hardware.faketouch
.
Nếu việc triển khai thiết bị bao gồm một màn hình cảm ứng có thể theo dõi nhiều thao tác chạm, thì thiết bị đó:
- [C-2-1] PHẢI báo cáo các cờ tính năng thích hợp
android.hardware.touchscreen.multitouch
,android.hardware.touchscreen.multitouch.distinct
,android.hardware.touchscreen.multitouch.jazzhand
tương ứng với loại màn hình cảm ứng cụ thể trên thiết bị.
Nếu việc triển khai thiết bị không bao gồm màn hình cảm ứng (và chỉ dựa vào thiết bị con trỏ) và đáp ứng các yêu cầu về thao tác chạm giả trong mục 7.2.5, thì các thiết bị đó:
- [C-3-1] KHÔNG ĐƯỢC báo cáo bất kỳ cờ tính năng nào bắt đầu bằng
android.hardware.touchscreen
và CHỈ ĐƯỢC báo cáoandroid.hardware.faketouch
.
7.2.5. Nhập bằng cách chạm giả
Giao diện cảm ứng giả cung cấp hệ thống hoạt động đầu vào của người dùng gần giống với một số tính năng của màn hình cảm ứng. Ví dụ: chuột hoặc điều khiển từ xa điều khiển con trỏ trên màn hình gần giống như thao tác chạm, nhưng yêu cầu người dùng phải trỏ hoặc lấy nét trước rồi nhấp. Nhiều thiết bị đầu vào như chuột, bàn di chuột, chuột không dây dựa trên con quay hồi chuyển, con trỏ con quay hồi chuyển, cần điều khiển và bàn di chuột cảm ứng đa điểm có thể hỗ trợ các hoạt động tương tác bằng thao tác chạm giả. Android bao gồm hằng số tính năng android.hardware.faketouch, tương ứng với một thiết bị đầu vào không chạm (dựa trên con trỏ) có độ trung thực cao, chẳng hạn như chuột hoặc bàn di chuột có thể mô phỏng đầy đủ phương thức nhập dựa trên cảm ứng (bao gồm cả hỗ trợ cử chỉ cơ bản) và cho biết rằng thiết bị hỗ trợ một tập hợp con được mô phỏng của chức năng màn hình cảm ứng.
Nếu việc triển khai thiết bị không bao gồm màn hình cảm ứng nhưng bao gồm một hệ thống nhập con trỏ khác mà họ muốn cung cấp, thì các thiết bị đó:
- NÊN khai báo hỗ trợ cờ tính năng
android.hardware.faketouch
.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ android.hardware.faketouch
, thì các hoạt động đó:
- [C-1-1] PHẢI báo cáo vị trí màn hình X và Y tuyệt đối của vị trí con trỏ và hiển thị con trỏ hình ảnh trên màn hình.
- [C-1-2] PHẢI báo cáo sự kiện chạm bằng mã hành động chỉ định thay đổi trạng thái xảy ra trên con trỏ di xuống hoặc lên trên màn hình.
- [C-1-3] PHẢI hỗ trợ con trỏ xuống và lên trên một đối tượng trên màn hình, cho phép người dùng mô phỏng thao tác nhấn vào một đối tượng trên màn hình.
- [C-1-4] PHẢI hỗ trợ thao tác con trỏ xuống, con trỏ lên, con trỏ xuống rồi con trỏ lên ở cùng một vị trí trên một đối tượng trên màn hình trong một ngưỡng thời gian, cho phép người dùng mô phỏng thao tác nhấn đúp trên một đối tượng trên màn hình.
- [C-1-5] PHẢI hỗ trợ con trỏ xuống tại một điểm tuỳ ý trên màn hình, con trỏ di chuyển đến bất kỳ điểm tuỳ ý nào khác trên màn hình, theo sau là con trỏ lên, cho phép người dùng mô phỏng thao tác kéo bằng cảm ứng.
- [C-1-6] PHẢI hỗ trợ con trỏ xuống, sau đó cho phép người dùng nhanh chóng di chuyển đối tượng đến một vị trí khác trên màn hình, rồi con trỏ lên trên màn hình, cho phép người dùng hất một đối tượng trên màn hình.
- [C-1-7] PHẢI báo cáo
TOUCHSCREEN_NOTOUCH
cho trường APIConfiguration.touchscreen
.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ android.hardware.faketouch.multitouch.distinct
, thì các hoạt động đó:
- [C-2-1] PHẢI khai báo hỗ trợ
android.hardware.faketouch
. - [C-2-2] PHẢI hỗ trợ tính năng theo dõi riêng biệt của hai hoặc nhiều đầu vào con trỏ độc lập.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ android.hardware.faketouch.multitouch.jazzhand
, thì các hoạt động đó:
- [C-3-1] PHẢI khai báo hỗ trợ cho
android.hardware.faketouch
. - [C-3-2] PHẢI hỗ trợ tính năng theo dõi riêng biệt 5 (theo dõi một bàn tay gồm các ngón tay) hoặc nhiều đầu vào con trỏ một cách hoàn toàn độc lập.
7.2.6. Hỗ trợ tay điều khiển trò chơi
7.2.6.1. Ánh xạ nút
Nếu quá trình triển khai thiết bị khai báo cờ tính năng android.hardware.gamepad
, thì các thiết bị đó:
- [C-1-1] PHẢI nhúng tay điều khiển hoặc vận chuyển kèm theo tay điều khiển riêng trong hộp, để cung cấp phương tiện nhập tất cả sự kiện được liệt kê trong các bảng bên dưới.
- [C-1-2] PHẢI có khả năng liên kết các sự kiện HID với các hằng số
view.InputEvent
Android được liên kết như được liệt kê trong các bảng bên dưới. Việc triển khai Android ngược dòng bao gồm cả việc triển khai cho tay điều khiển trò chơi đáp ứng yêu cầu này.
Nút | Mức sử dụng HID2 | Nút Android |
---|---|---|
A1 | 0x09 0x0001 | KEYCODE_BUTTON_A (96) |
B1 | 0x09 0x0002 | KEYCODE_BUTTON_B (97) |
X1 | 0x09 0x0004 | KEYCODE_BUTTON_X (99) |
Có1 | 0x09 0x0005 | KEYCODE_BUTTON_Y (100) |
D-pad lên1 D-pad xuống1 |
0x01 0x00393 | AXIS_HAT_Y4 |
D-pad trái1 D-pad phải1 |
0x01 0x00393 | AXIS_HAT_X4 |
Nút vai trái1 | 0x09 0x0007 | KEYCODE_BUTTON_L1 (102) |
Nút vai phải1 | 0x09 0x0008 | KEYCODE_BUTTON_R1 (103) |
Nhấp vào cần điều khiển bên trái1 | 0x09 0x000E | KEYCODE_BUTTON_THUMBL (106) |
Nhấp vào cần điều khiển bên phải1 | 0x09 0x000F | KEYCODE_BUTTON_THUMBR (107) |
Trang chủ1 | 0x0c 0x0223 | KEYCODE_HOME (3) |
Quay lại1 | 0x0c 0x0224 | KEYCODE_BACK (4) |
1 KeyEvent
2 Bạn phải khai báo các trường hợp sử dụng HID nêu trên trong một CA của tay điều khiển trò chơi (0x01 0x0005).
3 Mức sử dụng này phải có Giá trị tối thiểu hợp lý là 0, Giá trị tối đa hợp lý là 7, Giá trị tối thiểu thực tế là 0, Giá trị tối đa thực tế là 315, Đơn vị tính là Độ và Kích thước báo cáo là 4. Giá trị logic được xác định là xoay theo chiều kim đồng hồ ra khỏi trục dọc; ví dụ: giá trị logic 0 thể hiện không xoay và nút lên đang được nhấn, trong khi giá trị logic 1 thể hiện xoay 45 độ và cả nút lên và nút trái đang được nhấn.
Điều khiển tương tự1 | Mức sử dụng HID | Nút Android |
---|---|---|
Bộ kích hoạt bên trái | 0x02 0x00C5 | AXIS_LTRIGGER |
Bộ kích hoạt bên phải | 0x02 0x00C4 | AXIS_RTRIGGER |
Cần điều khiển bên trái |
0x01 0x0030 0x01 0x0031 |
AXIS_X AXIS_Y |
Cần điều khiển bên phải |
0x01 0x0032 0x01 0x0035 |
AXIS_Z AXIS_RZ |
7.2.7. Điều khiển từ xa
Hãy xem Mục 2.3.1 để biết các yêu cầu dành riêng cho thiết bị.
7.3. Cảm biến
Nếu quá trình triển khai thiết bị bao gồm một loại cảm biến cụ thể có API tương ứng cho nhà phát triển bên thứ ba, thì quá trình triển khai thiết bị PHẢI triển khai API đó như mô tả trong tài liệu về SDK Android và tài liệu về nguồn mở Android về các cảm biến.
Triển khai trên thiết bị:
- [C-0-1] PHẢI báo cáo chính xác sự hiện diện hoặc vắng mặt của cảm biến theo lớp
android.content.pm.PackageManager
. - [C-0-2] PHẢI trả về danh sách chính xác các cảm biến được hỗ trợ thông qua
SensorManager.getSensorList()
và các phương thức tương tự. - [C-0-3] PHẢI hoạt động hợp lý đối với tất cả các API cảm biến khác (ví dụ: bằng cách trả về
true
hoặcfalse
khi thích hợp khi các ứng dụng cố gắng đăng ký trình nghe, không gọi trình nghe cảm biến khi không có cảm biến tương ứng; v.v.).
Nếu việc triển khai thiết bị bao gồm một loại cảm biến cụ thể có API tương ứng cho nhà phát triển bên thứ ba, thì họ:
- [C-1-1] PHẢI báo cáo tất cả kết quả đo lường của cảm biến bằng cách sử dụng các giá trị thích hợp của Hệ thống đo lường quốc tế (theo hệ mét) cho từng loại cảm biến như được xác định trong tài liệu về SDK Android.
- [C-1-2] PHẢI báo cáo dữ liệu cảm biến với độ trễ tối đa là 100 mili giây + 2 * sample_time đối với trường hợp cảm biến được truyền trực tuyến với độ trễ tối thiểu bắt buộc là 5 mili giây + 2 * sample_time khi bộ xử lý ứng dụng đang hoạt động. Độ trễ này không bao gồm bất kỳ độ trễ lọc nào.
- [C-1-3] PHẢI báo cáo mẫu cảm biến đầu tiên trong vòng 400 mili giây + 2 * sample_time của cảm biến đang được kích hoạt. Mẫu này có thể có độ chính xác là 0.
-
[SR] NÊN báo cáo thời gian sự kiện tính bằng nano giây như được xác định trong tài liệu SDK Android, thể hiện thời gian xảy ra sự kiện và được đồng bộ hoá với đồng hồ SystemClock.elapsedRealtimeNano(). Các thiết bị Android hiện tại và mới NÊN đáp ứng các yêu cầu này để có thể nâng cấp lên các bản phát hành nền tảng trong tương lai, trong đó đây có thể là một thành phần BẮT BUỘC. Lỗi đồng bộ hoá PHẢI dưới 100 mili giây.
-
[C-1-4] Đối với mọi API mà tài liệu SDK Android cho biết là cảm biến liên tục, việc triển khai thiết bị PHẢI liên tục cung cấp các mẫu dữ liệu định kỳ và NÊN có độ trễ dưới 3%, trong đó độ trễ được xác định là độ lệch chuẩn của chênh lệch giữa các giá trị dấu thời gian được báo cáo giữa các sự kiện liên tiếp.
-
[C-1-5] PHẢI đảm bảo rằng luồng sự kiện cảm biến KHÔNG được ngăn CPU thiết bị chuyển sang trạng thái tạm ngưng hoặc thức dậy từ trạng thái tạm ngưng.
- Khi nhiều cảm biến được kích hoạt, mức tiêu thụ điện năng KHÔNG ĐƯỢC vượt quá tổng mức tiêu thụ điện năng được báo cáo của từng cảm biến.
Danh sách trên chưa đầy đủ; hành vi được ghi nhận của SDK Android và Tài liệu nguồn mở Android về các cảm biến được coi là có thẩm quyền.
Một số loại cảm biến là cảm biến tổng hợp, nghĩa là chúng có thể được lấy từ dữ liệu do một hoặc nhiều cảm biến khác cung cấp. (Ví dụ: cảm biến hướng và cảm biến gia tốc tuyến tính.)
Triển khai trên thiết bị:
- NÊN triển khai các loại cảm biến này khi chúng bao gồm các cảm biến vật lý cần thiết như mô tả trong các loại cảm biến.
Nếu quá trình triển khai thiết bị bao gồm cảm biến tổng hợp, thì các thiết bị đó:
- [C-2-1] PHẢI triển khai cảm biến như mô tả trong tài liệu về cảm biến tổng hợp của Android Open Source.
7.3.1. Gia tốc kế
- Việc triển khai thiết bị PHẢI bao gồm gia tốc kế 3 trục.
Nếu triển khai gia tốc kế 3 trục trên thiết bị, thì các thiết bị đó:
- [C-1-1] PHẢI có thể báo cáo các sự kiện có tần suất tối thiểu là 50 Hz.
- [C-1-2] PHẢI triển khai và báo cáo cảm biến
TYPE_ACCELEROMETER
. - [C-1-3] PHẢI tuân thủ hệ toạ độ cảm biến Android như được nêu chi tiết trong API Android.
- [C-1-4] PHẢI có khả năng đo lường từ trạng thái rơi tự do lên đến 4 lần trọng lực(4g) trở lên trên bất kỳ trục nào.
- [C-1-5] PHẢI có độ phân giải tối thiểu là 12 bit.
- [C-1-6] PHẢI có độ lệch chuẩn không lớn hơn 0,05 m/s^, trong đó độ lệch chuẩn phải được tính trên cơ sở mỗi trục trên các mẫu được thu thập trong khoảng thời gian ít nhất 3 giây ở tốc độ lấy mẫu nhanh nhất.
- [SR] NÊN triển khai cảm biến tổng hợp
TYPE_SIGNIFICANT_MOTION
. - [SR] NÊN triển khai cảm biến
TYPE_ACCELEROMETER_UNCALIBRATED
nếu có thể hiệu chỉnh gia tốc kế trực tuyến. - NÊN triển khai các cảm biến tổng hợp
TYPE_SIGNIFICANT_MOTION
,TYPE_TILT_DETECTOR
,TYPE_STEP_DETECTOR
,TYPE_STEP_COUNTER
như mô tả trong tài liệu SDK Android. - NÊN báo cáo các sự kiện lên đến ít nhất 200 Hz.
- NÊN có độ phân giải tối thiểu là 16 bit.
- NÊN được hiệu chuẩn trong khi sử dụng nếu các đặc điểm thay đổi trong vòng đời và được bù, đồng thời duy trì các thông số bù giữa các lần khởi động lại thiết bị.
- PHẢI được bù trừ nhiệt độ.
- CŨNG NÊN triển khai cảm biến
TYPE_ACCELEROMETER_UNCALIBRATED
.
Nếu việc triển khai thiết bị bao gồm gia tốc kế 3 trục và bất kỳ cảm biến tổng hợp TYPE_SIGNIFICANT_MOTION
, TYPE_TILT_DETECTOR
, TYPE_STEP_DETECTOR
, TYPE_STEP_COUNTER
nào được triển khai:
- [C-2-1] Tổng mức tiêu thụ điện năng của các thiết bị này PHẢI luôn nhỏ hơn 4 mW.
- NÊN có công suất dưới 2 mW và 0,5 mW khi thiết bị ở trạng thái động hoặc tĩnh.
Nếu việc triển khai thiết bị bao gồm gia tốc kế 3 trục và cảm biến con quay hồi chuyển, thì các thiết bị đó:
- [C-3-1] PHẢI triển khai cảm biến tổng hợp
TYPE_GRAVITY
vàTYPE_LINEAR_ACCELERATION
. - NÊN triển khai cảm biến tổng hợp
TYPE_GAME_ROTATION_VECTOR
. - [SR] Bạn NÊN triển khai cảm biến
TYPE_GAME_ROTATION_VECTOR
trên các thiết bị Android hiện có và mới.
Nếu việc triển khai thiết bị bao gồm gia tốc kế 3 trục, cảm biến con quay hồi chuyển và cảm biến từ kế, thì các thiết bị đó:
- [C-4-1] PHẢI triển khai cảm biến tổng hợp
TYPE_ROTATION_VECTOR
.
7.3.2. Từ kế
- Việc triển khai thiết bị PHẢI bao gồm từ kế (la bàn) 3 trục.
Nếu việc triển khai thiết bị bao gồm một cảm biến từ trường 3 trục, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai cảm biến
TYPE_MAGNETIC_FIELD
. - [C-1-2] PHẢI có thể báo cáo sự kiện với tần suất tối thiểu là 10 Hz và NÊN báo cáo sự kiện với tần suất tối thiểu là 50 Hz.
- [C-1-3] PHẢI tuân thủ hệ toạ độ cảm biến Android như được nêu chi tiết trong API Android.
- [C-1-4] PHẢI có khả năng đo từ -900 µT đến +900 µT trên mỗi trục trước khi bão hoà.
- [C-1-5] PHẢI có giá trị bù sắt cứng nhỏ hơn 700 µT và NÊN có giá trị dưới 200 µT, bằng cách đặt máy đo từ trường cách xa trường từ động (do dòng điện gây ra) và trường từ tĩnh (do nam châm gây ra).
- [C-1-6] PHẢI có độ phân giải bằng hoặc dày hơn 0,6 µT.
- [C-1-7] PHẢI hỗ trợ việc hiệu chỉnh và bù độ lệch từ tính cứng trực tuyến, đồng thời duy trì các tham số bù giữa các lần khởi động lại thiết bị.
- [C-1-8] PHẢI áp dụng tính năng bù sắt mềm – bạn có thể thực hiện việc hiệu chuẩn trong khi sử dụng hoặc trong quá trình sản xuất thiết bị.
- [C-1-9] PHẢI có độ lệch chuẩn, được tính trên mỗi trục dựa trên các mẫu được thu thập trong khoảng thời gian ít nhất 3 giây ở tốc độ lấy mẫu nhanh nhất, không lớn hơn 1,5 µT; NÊN có độ lệch chuẩn không lớn hơn 0,5 µT.
- NÊN triển khai cảm biến
TYPE_MAGNETIC_FIELD_UNCALIBRATED
. - [SR] Bạn NÊN triển khai cảm biến
TYPE_MAGNETIC_FIELD_UNCALIBRATED
trên các thiết bị Android hiện có và mới.
Nếu việc triển khai thiết bị bao gồm từ kế 3 trục, cảm biến gia tốc kế và cảm biến con quay hồi chuyển, thì các thiết bị đó:
- [C-2-1] PHẢI triển khai cảm biến tổng hợp
TYPE_ROTATION_VECTOR
.
Nếu việc triển khai thiết bị bao gồm một từ kế 3 trục, một gia tốc kế, thì các thiết bị đó:
- CÓ THỂ triển khai cảm biến
TYPE_GEOMAGNETIC_ROTATION_VECTOR
.
Nếu quá trình triển khai thiết bị bao gồm một cảm biến từ kế 3 trục, một gia tốc kế và cảm biến TYPE_GEOMAGNETIC_ROTATION_VECTOR
, thì các thiết bị đó:
- [C-3-1] PHẢI tiêu thụ ít hơn 10 mW.
- NÊN tiêu thụ ít hơn 3 mW khi cảm biến được đăng ký cho chế độ hàng loạt ở tần số 10 Hz.
7.3.3. GPS
Triển khai trên thiết bị:
- PHẢI có bộ thu GPS/GNSS.
Nếu việc triển khai thiết bị bao gồm bộ thu GPS/GNSS và báo cáo chức năng này cho các ứng dụng thông qua cờ tính năng android.hardware.location.gps
, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ đầu ra vị trí với tốc độ tối thiểu là 1 Hz khi được yêu cầu thông qua
LocationManager#requestLocationUpdate
. - [C-1-2] PHẢI xác định được vị trí trong điều kiện bầu trời quang đãng (tín hiệu mạnh, đa đường truyền không đáng kể, HDOP < 2) trong vòng 10 giây (thời gian nhanh để xác định vị trí lần đầu), khi kết nối với kết nối Internet có tốc độ dữ liệu từ 0,5 Mb/giây trở lên. Yêu cầu này thường được đáp ứng bằng cách sử dụng một số hình thức kỹ thuật GPS/GNSS được hỗ trợ hoặc dự đoán để giảm thiểu thời gian khoá GPS/GNSS (Dữ liệu hỗ trợ bao gồm Thời gian tham chiếu, Vị trí tham chiếu và Bảng thông tin thiên văn/Đồng hồ vệ tinh).
- [C-1-6] Sau khi thực hiện phép tính vị trí như vậy, việc triển khai thiết bị PHẢI xác định vị trí của thiết bị, ở ngoài trời, trong vòng 5 giây, khi các yêu cầu vị trí được khởi động lại, tối đa một giờ sau khi tính toán vị trí ban đầu, ngay cả khi yêu cầu tiếp theo được thực hiện mà không có kết nối dữ liệu và/hoặc sau một chu kỳ nguồn.
-
Trong điều kiện ngoài trời sau khi xác định vị trí, khi đứng yên hoặc di chuyển với gia tốc dưới 1 mét trên giây bình phương:
- [C-1-3] PHẢI xác định được vị trí trong phạm vi 20 mét và tốc độ trong phạm vi 0,5 mét/giây ít nhất 95% thời gian.
- [C-1-4] PHẢI đồng thời theo dõi và báo cáo qua
GnssStatus.Callback
ít nhất 8 vệ tinh từ một chòm sao. - PHẢI có khả năng theo dõi đồng thời ít nhất 24 vệ tinh, từ nhiều chòm sao (ví dụ: GPS + ít nhất một trong các vệ tinh Glonass, Beidou, Galileo).
- [C-1-5] PHẢI báo cáo thế hệ công nghệ GNSS thông qua API kiểm thử "getGnssYearOfHardware".
- [SR] Tiếp tục phân phối đầu ra thông tin vị trí GPS/GNSS thông thường trong khi gọi điện khẩn cấp.
- [SR] Báo cáo kết quả đo lường GNSS từ tất cả các chòm sao được theo dõi (như được báo cáo trong thông báo GnssStatus), ngoại trừ SBAS.
- [SR] Báo cáo AGC và Tần suất đo lường GNSS.
- [SR] Báo cáo tất cả thông tin ước tính về độ chính xác (bao gồm cả Độ lệch, Tốc độ và Độ dốc) trong mỗi vị trí GPS/GNSS.
- [SR] NÊN đáp ứng nhiều yêu cầu bắt buộc bổ sung nhất có thể đối với các thiết bị báo cáo năm "2016" hoặc "2017" thông qua API Kiểm thử
LocationManager.getGnssYearOfHardware()
.
Nếu việc triển khai thiết bị bao gồm một bộ thu GPS/GNSS và báo cáo chức năng cho các ứng dụng thông qua cờ tính năng android.hardware.location.gps
và API Kiểm thử LocationManager.getGnssYearOfHardware()
báo cáo năm "2016" trở lên, thì các thiết bị đó:
- [C-2-1] PHẢI báo cáo kết quả đo lường GNSS ngay khi phát hiện được, ngay cả khi vị trí được tính toán từ GPS/GNSS chưa được báo cáo.
- [C-2-2] PHẢI báo cáo khoảng thời gian giả và tốc độ khoảng thời gian giả của GNSS, trong điều kiện bầu trời quang đãng sau khi xác định vị trí, trong khi đứng yên hoặc di chuyển với gia tốc dưới 0, 2 mét trên giây vuông, đủ để tính toán vị trí trong vòng 20 mét và tốc độ trong vòng 0, 2 mét trên giây, ít nhất là 95% thời gian.
Nếu việc triển khai thiết bị bao gồm một bộ thu GPS/GNSS và báo cáo khả năng này cho các ứng dụng thông qua cờ tính năng android.hardware.location.gps
và API kiểm thử LocationManager.getGnssYearOfHardware()
báo cáo năm "2017" trở lên, thì các thiết bị đó:
- [C-3-1] PHẢI tiếp tục phân phối đầu ra thông tin vị trí GPS/GNSS thông thường trong cuộc gọi điện thoại khẩn cấp.
- [C-3-2] PHẢI báo cáo kết quả đo lường GNSS từ tất cả các chòm sao được theo dõi (như được báo cáo trong thông báo GnssStatus), ngoại trừ SBAS.
- [C-3-3] PHẢI báo cáo AGC và Tần suất đo lường GNSS.
- [C-3-4] PHẢI báo cáo tất cả thông tin ước tính về độ chính xác (bao gồm cả Độ lệch, Tốc độ và Độ cao) trong mỗi vị trí GPS/GNSS.
Nếu việc triển khai thiết bị bao gồm một bộ thu GPS/GNSS và báo cáo khả năng này cho các ứng dụng thông qua cờ tính năng android.hardware.location.gps
và API Kiểm thử LocationManager.getGnssYearOfHardware()
báo cáo năm "2018" trở lên, thì các thiết bị đó:
- [C-4-1] PHẢI tiếp tục phân phối đầu ra GPS/GNSS thông thường cho các ứng dụng trong cuộc gọi phiên khẩn cấp do mạng (dựa trên Trạm di động) khởi tạo.
- [C-4-2] PHẢI báo cáo vị trí và thông tin đo lường cho API Nhà cung cấp vị trí GNSS.
7.3.4. Con quay hồi chuyển
Triển khai trên thiết bị:
- PHẢI có con quay hồi chuyển (cảm biến thay đổi góc).
- KHÔNG ĐƯỢC bao gồm cảm biến con quay hồi chuyển trừ phi cũng có gia tốc kế 3 trục.
Nếu việc triển khai thiết bị bao gồm con quay hồi chuyển, thì các thiết bị đó:
- [C-1-1] PHẢI có thể báo cáo các sự kiện có tần suất tối thiểu là 50 Hz.
- [C-1-2] PHẢI triển khai cảm biến
TYPE_GYROSCOPE
và CŨNG NÊN triển khai cảm biếnTYPE_GYROSCOPE_UNCALIBRATED
. - [C-1-3] PHẢI có khả năng đo lường các thay đổi về hướng lên đến 1.000 độ mỗi giây.
- [C-1-4] PHẢI có độ phân giải từ 12 bit trở lên và NÊN có độ phân giải từ 16 bit trở lên.
- [C-1-5] PHẢI được bù trừ nhiệt độ.
- [C-1-6] PHẢI được hiệu chỉnh và bù trong khi sử dụng, đồng thời duy trì các tham số bù giữa các lần khởi động lại thiết bị.
- [C-1-7] PHẢI có độ biến thiên không lớn hơn 1e-7 rad^2 / s^2 trên mỗi Hz (độ biến thiên trên mỗi Hz hoặc rad^2 / s). Độ lệch được phép thay đổi theo tốc độ lấy mẫu, nhưng PHẢI bị ràng buộc bởi giá trị này. Nói cách khác, nếu bạn đo độ biến thiên của con quay hồi chuyển ở tốc độ lấy mẫu 1 Hz, thì độ biến thiên NÊN không lớn hơn 1e-7 rad^2/s^2.
- [SR] Bạn NÊN triển khai cảm biến
SENSOR_TYPE_GYROSCOPE_UNCALIBRATED
trên các thiết bị Android hiện có và mới. - [SR] NÊN LÀ lỗi hiệu chỉnh dưới 0,01 rad/s khi thiết bị đứng yên ở nhiệt độ phòng.
- NÊN báo cáo các sự kiện lên đến ít nhất 200 Hz.
Nếu việc triển khai thiết bị bao gồm con quay hồi chuyển, cảm biến gia tốc kế và cảm biến từ kế, thì các thiết bị đó:
- [C-2-1] PHẢI triển khai cảm biến tổng hợp
TYPE_ROTATION_VECTOR
.
Nếu việc triển khai thiết bị bao gồm con quay hồi chuyển và cảm biến gia tốc kế, thì các thiết bị đó:
- [C-3-1] PHẢI triển khai cảm biến tổng hợp
TYPE_GRAVITY
vàTYPE_LINEAR_ACCELERATION
. - [SR] Bạn NÊN triển khai cảm biến
TYPE_GAME_ROTATION_VECTOR
trên các thiết bị Android hiện có và mới. - NÊN triển khai cảm biến tổng hợp
TYPE_GAME_ROTATION_VECTOR
.
7.3.5. Khí áp kế
- Việc triển khai thiết bị PHẢI bao gồm một khí áp kế (cảm biến áp suất không khí xung quanh).
Nếu triển khai thiết bị có áp kế, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai và báo cáo cảm biến
TYPE_PRESSURE
. - [C-1-2] PHẢI có khả năng phân phối sự kiện ở tốc độ 5 Hz trở lên.
- [C-1-3] PHẢI được bù trừ nhiệt độ.
- [SR] NÊN có khả năng báo cáo kết quả đo áp suất trong phạm vi từ 300hPa đến 1100hPa.
- PHẢI có độ chính xác tuyệt đối là 1hPa.
- PHẢI có độ chính xác tương đối là 0,12hPa trong phạm vi 20hPa (tương đương với độ chính xác ~1m trong khoảng thay đổi ~200m ở mực nước biển).
7.3.6. Nhiệt kế
Cách triển khai trên thiết bị: * CÓ THỂ bao gồm nhiệt kế môi trường xung quanh (cảm biến nhiệt độ). * CÓ THỂ nhưng KHÔNG NÊN bao gồm cảm biến nhiệt độ CPU.
Nếu việc triển khai thiết bị bao gồm nhiệt kế môi trường xung quanh (cảm biến nhiệt độ), thì các thiết bị đó:
- [C-1-1] PHẢI được xác định là
SENSOR_TYPE_AMBIENT_TEMPERATURE
và PHẢI đo nhiệt độ môi trường xung quanh (phòng/cabin xe) tại nơi người dùng đang tương tác với thiết bị theo độ C. - [C-1-2] PHẢI được xác định là
SENSOR_TYPE_TEMPERATURE
. - [C-1-3] PHẢI đo nhiệt độ của CPU thiết bị.
- [C-1-4] KHÔNG ĐƯỢC đo bất kỳ nhiệt độ nào khác.
Lưu ý rằng loại cảm biến SENSOR_TYPE_TEMPERATURE
không còn được dùng trong Android 4.0.
7.3.7. Máy đo ánh sáng
- Việc triển khai thiết bị CÓ THỂ bao gồm máy đo quang phổ (cảm biến ánh sáng xung quanh).
7.3.8. Cảm biến độ gần
- Việc triển khai thiết bị CÓ THỂ bao gồm cảm biến độ gần.
Nếu triển khai cảm biến độ gần trên thiết bị, thì các thiết bị đó:
- [C-1-1] PHẢI đo khoảng cách của một đối tượng theo cùng hướng với màn hình. Tức là cảm biến khoảng cách PHẢI được định hướng để phát hiện các đối tượng ở gần màn hình, vì ý định chính của loại cảm biến này là phát hiện điện thoại mà người dùng đang sử dụng. Nếu việc triển khai thiết bị bao gồm cảm biến khoảng cách với bất kỳ hướng nào khác, thì KHÔNG được truy cập vào cảm biến đó thông qua API này.
- [C-1-2] PHẢI có độ chính xác từ 1 bit trở lên.
7.3.9. Cảm biến có độ trung thực cao
Nếu việc triển khai thiết bị bao gồm một bộ cảm biến chất lượng cao hơn như được xác định trong phần này và cung cấp các cảm biến đó cho ứng dụng bên thứ ba, thì các cảm biến đó:
- [C-1-1] PHẢI xác định chức năng thông qua cờ tính năng
android.hardware.sensor.hifi_sensors
.
Nếu các hoạt động triển khai thiết bị khai báo android.hardware.sensor.hifi_sensors
, thì các hoạt động đó:
-
[C-2-1] PHẢI có cảm biến
TYPE_ACCELEROMETER
:- PHẢI có phạm vi đo lường từ -8g đến +8g, NÊN có phạm vi đo lường từ -16g đến +16g.
- PHẢI có độ phân giải đo lường tối thiểu là 2048 LSB/g.
- PHẢI có tần số đo lường tối thiểu là 12,5 Hz trở xuống.
- PHẢI có tần suất đo tối đa là 400 Hz trở lên; NÊN hỗ trợ SensorDirectChannel
RATE_VERY_FAST
. - PHẢI có độ nhiễu đo lường không vượt quá 400 μg/√Hz.
- PHẢI triển khai một dạng không đánh thức của cảm biến này với khả năng lưu vào bộ đệm ít nhất 3000 sự kiện cảm biến.
- PHẢI có mức tiêu thụ điện năng theo lô không tệ hơn 3 mW.
- [C-SR] NÊN có băng thông đo lường 3dB ít nhất là 80% tần số Nyquist và phổ nhiễu trắng trong băng thông này.
- PHẢI có tốc độ đi ngẫu nhiên của gia tốc nhỏ hơn 30 μg √Hz được kiểm tra ở nhiệt độ phòng.
- PHẢI có sự thay đổi về độ lệch so với nhiệt độ ≤ +/- 1 mg/°C.
- PHẢI có độ phi tuyến tính của đường phù hợp nhất ≤ 0,5% và độ thay đổi độ nhạy so với nhiệt độ ≤ 0,03%/C°.
- PHẢI có độ nhạy theo trục chéo < 2,5 % và độ biến thiên của độ nhạy theo trục chéo < 0,2% trong phạm vi nhiệt độ hoạt động của thiết bị.
-
[C-2-2] PHẢI có
TYPE_ACCELEROMETER_UNCALIBRATED
với các yêu cầu về chất lượng giống nhưTYPE_ACCELEROMETER
. -
[C-2-3] PHẢI có cảm biến
TYPE_GYROSCOPE
:- PHẢI có phạm vi đo lường từ -1000 đến +1000 dps.
- PHẢI có độ phân giải đo lường tối thiểu là 16 LSB/dps.
- PHẢI có tần số đo lường tối thiểu là 12,5 Hz trở xuống.
- PHẢI có tần suất đo tối đa là 400 Hz trở lên; NÊN hỗ trợ SensorDirectChannel
RATE_VERY_FAST
. - PHẢI có độ nhiễu đo lường không vượt quá 0,014°/giây/√Hz.
- [C-SR] NÊN có băng thông đo lường 3dB ít nhất là 80% tần số Nyquist và phổ nhiễu trắng trong băng thông này.
- PHẢI có tốc độ đi ngẫu nhiên dưới 0,001 °/s √Hz được kiểm tra ở nhiệt độ phòng.
- NÊN có sự thay đổi độ lệch so với nhiệt độ ≤ +/- 0,05 °/ s / °C.
- PHẢI có mức thay đổi độ nhạy so với nhiệt độ ≤ 0,02% / °C.
- PHẢI có độ phi tuyến tính của đường phù hợp nhất ≤ 0,2%.
- PHẢI có mật độ nhiễu ≤ 0,007 °/s/√Hz.
- PHẢI có lỗi hiệu chuẩn dưới 0,002 rad/s trong phạm vi nhiệt độ từ 10 đến 40 ℃ khi thiết bị đứng yên.
- PHẢI có độ nhạy g-force nhỏ hơn 0,1°/giây/g.
- PHẢI có độ nhạy theo trục chéo < 4,0 % và độ biến thiên độ nhạy theo trục chéo < 0,3% trong phạm vi nhiệt độ hoạt động của thiết bị.
-
[C-2-4] PHẢI có
TYPE_GYROSCOPE_UNCALIBRATED
có các yêu cầu về chất lượng giống nhưTYPE_GYROSCOPE
. -
[C-2-5] PHẢI có cảm biến
TYPE_GEOMAGNETIC_FIELD
:- PHẢI có phạm vi đo lường từ -900 đến +900 μT.
- PHẢI có độ phân giải đo lường ít nhất là 5 LSB/uT.
- PHẢI có tần số đo lường tối thiểu là 5 Hz trở xuống.
- PHẢI có tần suất đo tối đa là 50 Hz trở lên.
- PHẢI có độ nhiễu đo lường không vượt quá 0,5 uT.
-
[C-2-6] PHẢI có
TYPE_MAGNETIC_FIELD_UNCALIBRATED
với các yêu cầu về chất lượng giống nhưTYPE_GEOMAGNETIC_FIELD
và ngoài ra:- PHẢI triển khai một dạng không đánh thức của cảm biến này với khả năng lưu vào bộ đệm ít nhất 600 sự kiện cảm biến.
- [C-SR] Bạn NÊN có phổ nhiễu trắng từ 1 Hz đến ít nhất 10 Hz khi tốc độ báo cáo là 50 Hz trở lên.
-
[C-2-7] PHẢI có cảm biến
TYPE_PRESSURE
:- PHẢI có phạm vi đo lường từ 300 đến 1100 hPa.
- PHẢI có độ phân giải đo lường tối thiểu là 80 LSB/hPa.
- PHẢI có tần suất đo lường tối thiểu là 1 Hz trở xuống.
- PHẢI có tần suất đo tối đa từ 10 Hz trở lên.
- PHẢI có độ nhiễu đo lường không vượt quá 2 Pa/√Hz.
- PHẢI triển khai một dạng không đánh thức của cảm biến này với khả năng lưu vào bộ đệm ít nhất 300 sự kiện cảm biến.
- PHẢI có mức tiêu thụ điện năng theo lô không tệ hơn 2 mW.
- [C-2-8] PHẢI có cảm biến
TYPE_GAME_ROTATION_VECTOR
:- PHẢI triển khai một dạng không đánh thức của cảm biến này với khả năng lưu vào bộ đệm ít nhất 300 sự kiện cảm biến.
- PHẢI có mức tiêu thụ điện năng theo lô không tệ hơn 4 mW.
- [C-2-9] PHẢI có cảm biến
TYPE_SIGNIFICANT_MOTION
:- PHẢI có mức tiêu thụ năng lượng không tệ hơn 0,5 mW khi thiết bị đứng yên và 1,5 mW khi thiết bị đang di chuyển.
- [C-2-10] PHẢI có cảm biến
TYPE_STEP_DETECTOR
:- PHẢI triển khai một dạng không đánh thức của cảm biến này với khả năng lưu vào bộ đệm ít nhất 100 sự kiện cảm biến.
- PHẢI có mức tiêu thụ năng lượng không tệ hơn 0,5 mW khi thiết bị đứng yên và 1,5 mW khi thiết bị đang di chuyển.
- PHẢI có mức tiêu thụ điện năng theo lô không tệ hơn 4 mW.
- [C-2-11] PHẢI có cảm biến
TYPE_STEP_COUNTER
:- PHẢI có mức tiêu thụ năng lượng không tệ hơn 0,5 mW khi thiết bị đứng yên và 1,5 mW khi thiết bị đang di chuyển.
- [C-2-12] PHẢI có cảm biến
TILT_DETECTOR
:- PHẢI có mức tiêu thụ năng lượng không tệ hơn 0,5 mW khi thiết bị đứng yên và 1,5 mW khi thiết bị đang di chuyển.
- [C-2-13] Dấu thời gian của sự kiện của cùng một sự kiện vật lý do Gia tốc kế, Con quay hồi chuyển và Máy đo từ trường báo cáo PHẢI nằm trong khoảng 2, 5 mili giây. Dấu thời gian của sự kiện về cùng một sự kiện vật lý do Gia tốc kế và Con quay hồi chuyển báo cáo PHẢI nằm trong khoảng 0,25 mili giây so với nhau.
- [C-2-14] PHẢI có dấu thời gian sự kiện cảm biến Con quay hồi chuyển trên cùng một cơ sở thời gian với hệ thống con máy ảnh và trong phạm vi sai số 1 mili giây.
- [C-2-15] PHẢI phân phối mẫu cho ứng dụng trong vòng 5 mili giây kể từ thời điểm dữ liệu có sẵn trên bất kỳ cảm biến vật lý nào nêu trên cho ứng dụng.
- [C-2-16] KHÔNG ĐƯỢC tiêu thụ nhiều năng lượng hơn 0,5 mW khi thiết bị ở trạng thái tĩnh và 2,0 mW khi thiết bị đang di chuyển khi bất kỳ tổ hợp nào của các cảm biến sau được bật:
-
SENSOR_TYPE_SIGNIFICANT_MOTION
-
SENSOR_TYPE_STEP_DETECTOR
-
SENSOR_TYPE_STEP_COUNTER
-
SENSOR_TILT_DETECTORS
-
- [C-2-17] CÓ THỂ có cảm biến
TYPE_PROXIMITY
, nhưng nếu có thì PHẢI có dung lượng bộ đệm tối thiểu là 100 sự kiện cảm biến.
Xin lưu ý rằng tất cả các yêu cầu về mức tiêu thụ điện năng trong phần này không bao gồm mức tiêu thụ điện năng của Bộ xử lý ứng dụng. Mức tiêu thụ này bao gồm cả năng lượng mà toàn bộ chuỗi cảm biến tiêu thụ – cảm biến, mọi mạch điện hỗ trợ, mọi hệ thống xử lý cảm biến chuyên dụng, v.v.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ cảm biến trực tiếp, thì các thiết bị đó:
- [C-3-1] PHẢI khai báo chính xác việc hỗ trợ các loại kênh trực tiếp và cấp tỷ lệ báo cáo trực tiếp thông qua API
isDirectChannelTypeSupported
vàgetHighestDirectReportRateLevel
. - [C-3-2] PHẢI hỗ trợ ít nhất một trong hai loại kênh trực tiếp của cảm biến cho tất cả các cảm biến khai báo hỗ trợ kênh trực tiếp của cảm biến.
- PHẢI hỗ trợ báo cáo sự kiện thông qua kênh trực tiếp của cảm biến cho cảm biến chính (biến thể không đánh thức) thuộc các loại sau:
-
TYPE_ACCELEROMETER
-
TYPE_ACCELEROMETER_UNCALIBRATED
-
TYPE_GYROSCOPE
-
TYPE_GYROSCOPE_UNCALIBRATED
-
TYPE_MAGNETIC_FIELD
-
TYPE_MAGNETIC_FIELD_UNCALIBRATED
-
7.3.10. Cảm biến sinh trắc học
7.3.10.1. Cảm biến vân tay
Nếu triển khai màn hình khoá bảo mật, thiết bị sẽ:
- PHẢI có cảm biến vân tay.
Nếu triển khai cảm biến vân tay trên thiết bị và cung cấp cảm biến đó cho các ứng dụng bên thứ ba, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC phải khai báo hỗ trợ tính năng
android.hardware.fingerprint
. - [C-1-2] PHẢI triển khai đầy đủ API tương ứng như mô tả trong tài liệu SDK Android.
- [C-1-3] PHẢI có tỷ lệ chấp nhận sai không cao hơn 0,002%.
- [SR] Bạn NÊN có tỷ lệ chấp nhận nội dung giả mạo và mạo danh không cao hơn 7%.
- [C-1-4] PHẢI công bố rằng chế độ này có thể kém an toàn hơn so với mã PIN, hình mở khoá hoặc mật khẩu mạnh và liệt kê rõ ràng các rủi ro khi bật chế độ này, nếu tỷ lệ chấp nhận hành vi giả mạo và mạo danh cao hơn 7%.
- [C-1-5] PHẢI giới hạn số lần thử trong ít nhất 30 giây sau 5 lần thử xác minh vân tay không thành công.
- [C-1-6] PHẢI triển khai kho khoá dựa trên phần cứng và thực hiện so khớp vân tay trong Môi trường thực thi đáng tin cậy (TEE) hoặc trên một khối có kênh bảo mật đến TEE.
- [C-1-7] PHẢI mã hoá và xác thực bằng mật mã tất cả dữ liệu vân tay có thể nhận dạng để không thể thu thập, đọc hoặc thay đổi dữ liệu đó bên ngoài TEE hoặc một khối có kênh bảo mật đến TEE như được ghi nhận trong nguyên tắc triển khai trên trang web Dự án nguồn mở Android.
- [C-1-8] PHẢI ngăn việc thêm vân tay mà không thiết lập chuỗi tin cậy trước bằng cách yêu cầu người dùng xác nhận thông tin xác thực hiện có hoặc thêm thông tin xác thực thiết bị mới (Mã PIN/hình mở khoá/mật khẩu) do TEE bảo mật; việc triển khai Dự án nguồn mở Android cung cấp cơ chế trong khung để thực hiện việc này.
- [C-1-9] KHÔNG ĐƯỢC cho phép các ứng dụng bên thứ ba phân biệt giữa các vân tay riêng lẻ.
- [C-1-10] PHẢI tuân thủ cờ DevicePolicyManager.KEYGUARD_DISABLE_FINGERPRINT.
- [C-1-11] PHẢI di chuyển dữ liệu vân tay một cách an toàn để đáp ứng các yêu cầu trên hoặc xoá dữ liệu vân tay khi nâng cấp từ phiên bản thấp hơn Android 6.0.
- [C-1-12] PHẢI xoá hoàn toàn tất cả dữ liệu vân tay có thể nhận dạng của người dùng khi tài khoản của người dùng bị xoá (bao gồm cả việc đặt lại về trạng thái ban đầu).
- [C-1-13] BẮT BUỘC không cho phép truy cập không mã hoá vào dữ liệu vân tay nhận dạng hoặc bất kỳ dữ liệu nào bắt nguồn từ dữ liệu đó (chẳng hạn như dữ liệu nhúng) cho Bộ xử lý ứng dụng.
- [SR] NÊN có tỷ lệ từ chối sai dưới 10%, được đo lường trên thiết bị.
- [SR] NÊN có độ trễ dưới 1 giây, được đo từ khi chạm vào cảm biến vân tay cho đến khi mở khoá màn hình, đối với một ngón tay đã đăng ký.
- NÊN sử dụng biểu tượng Vân tay Android được cung cấp trong Dự án nguồn mở Android.
7.3.10.2. Các cảm biến sinh trắc học khác
Nếu việc triển khai thiết bị bao gồm một hoặc nhiều cảm biến sinh trắc học không dựa trên vân tay và cung cấp các cảm biến đó cho ứng dụng bên thứ ba, thì các ứng dụng đó:
- [C-1-1] PHẢI có tỷ lệ chấp nhận sai không cao hơn 0,002%.
- [C-SR] Bạn NÊN có tỷ lệ chấp nhận nội dung giả mạo và nội dung mạo danh không cao hơn 7%.
- [C-1-2] PHẢI công bố rằng chế độ này có thể kém an toàn hơn so với mã PIN, hình mở khoá hoặc mật khẩu khó đoán và liệt kê rõ ràng các rủi ro khi bật chế độ này, nếu tỷ lệ chấp nhận hành vi giả mạo và mạo danh cao hơn 7%.
- [C-1-3] PHẢI giới hạn số lần thử trong ít nhất 30 giây sau 5 lần thử xác minh sinh trắc học không thành công – trong đó, lần thử không thành công là lần thử có chất lượng chụp đủ (ACQUIRED_GOOD) nhưng không khớp với dữ liệu sinh trắc học đã đăng ký
- [C-1-4] PHẢI triển khai kho khoá được hỗ trợ phần cứng và thực hiện việc so khớp sinh trắc học trong TEE hoặc trên một khối có kênh bảo mật đến TEE.
- [C-1-5] PHẢI mã hoá và xác thực bằng mật mã tất cả dữ liệu nhận dạng để không thể thu thập, đọc hoặc thay đổi dữ liệu đó bên ngoài TEE hoặc một khối có kênh bảo mật đến TEE như được ghi nhận trong nguyên tắc triển khai trên trang web Dự án nguồn mở Android.
- [C-1-6] PHẢI ngăn việc thêm thông tin sinh trắc học mới mà không thiết lập chuỗi tin cậy trước bằng cách yêu cầu người dùng xác nhận thông tin xác thực hiện có hoặc thêm thông tin xác thực thiết bị mới (mã PIN/mẫu/mật khẩu) do TEE bảo mật; việc triển khai Dự án nguồn mở Android cung cấp cơ chế trong khung để thực hiện việc này.
- [C-1-7] KHÔNG ĐƯỢC cho phép ứng dụng bên thứ ba phân biệt giữa các lần đăng ký sinh trắc học.
- [C-1-8] PHẢI tuân thủ cờ riêng lẻ cho thông tin sinh trắc học đó (tức là:
DevicePolicyManager.KEYGUARD_DISABLE_FINGERPRINT
,DevicePolicymanager.KEYGUARD_DISABLE_FACE
hoặcDevicePolicymanager.KEYGUARD_DISABLE_IRIS
). - [C-1-9] PHẢI xoá hoàn toàn tất cả dữ liệu sinh trắc học có thể nhận dạng của người dùng khi tài khoản của người dùng bị xoá (bao gồm cả việc đặt lại về trạng thái ban đầu).
- [C-1-10] KHÔNG được cho phép truy cập không mã hoá vào dữ liệu sinh trắc học có thể nhận dạng hoặc bất kỳ dữ liệu nào bắt nguồn từ dữ liệu đó (chẳng hạn như dữ liệu nhúng) vào Bộ xử lý ứng dụng bên ngoài ngữ cảnh của TEE.
- [C-SR] NÊN có tỷ lệ từ chối sai dưới 10%, được đo lường trên thiết bị.
- [C-SR] NÊN có độ trễ dưới 1 giây, được đo từ khi phát hiện dữ liệu sinh trắc học cho đến khi mở khoá màn hình, đối với mỗi dữ liệu sinh trắc học đã đăng ký.
7.3.11. Cảm biến chỉ dành cho Android Automotive
Các cảm biến dành riêng cho ô tô được xác định trong android.car.CarSensorManager API
.
7.3.11.1. Bánh răng hiện tại
Hãy xem Mục 2.5.1 để biết các yêu cầu dành riêng cho thiết bị.
7.3.11.2. Chế độ ngày đêm
Hãy xem Mục 2.5.1 để biết các yêu cầu dành riêng cho thiết bị.
7.3.11.3. Trạng thái lái xe
Yêu cầu này không còn được dùng nữa.
7.3.11.4. Tốc độ bánh xe
Hãy xem Mục 2.5.1 để biết các yêu cầu dành riêng cho thiết bị.
7.3.11.5. Phanh đỗ xe
Hãy xem Mục 2.5.1 để biết các yêu cầu dành riêng cho thiết bị.
7.3.12. Cảm biến tư thế
Triển khai trên thiết bị:
- CÓ THỂ hỗ trợ cảm biến tư thế với 6 bậc tự do.
Nếu việc triển khai thiết bị hỗ trợ cảm biến tư thế với 6 bậc tự do, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai và báo cáo cảm biến
TYPE_POSE_6DOF
. - [C-1-2] PHẢI chính xác hơn so với chỉ vectơ xoay.
7.4. Kết nối dữ liệu
7.4.1. Điện thoại
"Điện thoại" như được sử dụng bởi các API Android và tài liệu này đề cập cụ thể đến phần cứng liên quan đến việc thực hiện cuộc gọi thoại và gửi tin nhắn SMS qua mạng GSM hoặc CDMA. Mặc dù các cuộc gọi thoại này có thể được chuyển đổi gói hoặc không, nhưng đối với Android, các cuộc gọi này được coi là độc lập với mọi kết nối dữ liệu có thể được triển khai bằng cùng một mạng. Nói cách khác, chức năng và API "thoại" của Android đề cập cụ thể đến cuộc gọi thoại và tin nhắn SMS. Ví dụ: các phương thức triển khai thiết bị không thể thực hiện cuộc gọi hoặc gửi/nhận tin nhắn SMS không được coi là thiết bị điện thoại, bất kể thiết bị có sử dụng mạng di động để kết nối dữ liệu hay không.
- Android CÓ THỂ được sử dụng trên các thiết bị không có phần cứng điện thoại. Tức là Android tương thích với các thiết bị không phải điện thoại.
Nếu việc triển khai thiết bị bao gồm điện thoại GSM hoặc CDMA, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC khai báo cờ tính năng
android.hardware.telephony
và các cờ tính năng phụ khác theo công nghệ. - [C-1-2] PHẢI triển khai hỗ trợ đầy đủ cho API cho công nghệ đó.
Nếu việc triển khai thiết bị không bao gồm phần cứng điện thoại, thì các thiết bị đó:
- [C-2-1] PHẢI triển khai toàn bộ API dưới dạng không hoạt động.
7.4.1.1. Khả năng tương thích với tính năng Chặn số
Nếu quá trình triển khai thiết bị báo cáo android.hardware.telephony feature
, thì các quá trình đó:
- [C-1-1] PHẢI hỗ trợ tính năng chặn số
- [C-1-2] PHẢI triển khai đầy đủ
BlockedNumberContract
và API tương ứng như mô tả trong tài liệu SDK. - [C-1-3] PHẢI chặn tất cả cuộc gọi và tin nhắn từ một số điện thoại trong "BlockedNumberProvider" mà không có bất kỳ hoạt động tương tác nào với ứng dụng. Ngoại lệ duy nhất là khi việc chặn số tạm thời được gỡ bỏ như mô tả trong tài liệu SDK.
- [C-1-4] KHÔNG ĐƯỢC ghi vào nhà cung cấp nhật ký cuộc gọi của nền tảng cho cuộc gọi bị chặn.
- [C-1-5] KHÔNG ĐƯỢC ghi vào Nhà cung cấp dịch vụ điện thoại cho một tin nhắn bị chặn.
- [C-1-6] PHẢI triển khai giao diện người dùng quản lý số điện thoại bị chặn. Giao diện này được mở bằng ý định do phương thức
TelecomManager.createManageBlockedNumbersIntent()
trả về. - [C-1-7] KHÔNG ĐƯỢC cho phép người dùng phụ xem hoặc chỉnh sửa các số điện thoại bị chặn trên thiết bị vì nền tảng Android giả định rằng người dùng chính có toàn quyền kiểm soát các dịch vụ điện thoại, một phiên bản duy nhất, trên thiết bị. Tất cả giao diện người dùng liên quan đến việc chặn PHẢI được ẩn đối với người dùng phụ và danh sách chặn PHẢI được tuân thủ.
- NÊN di chuyển các số bị chặn vào nhà cung cấp khi thiết bị cập nhật lên Android 7.0.
7.4.1.2. Telecom API
Nếu các hoạt động triển khai thiết bị báo cáo android.hardware.telephony
, thì các hoạt động đó:
- [C-1-1] PHẢI hỗ trợ các API
ConnectionService
được mô tả trong SDK. - [C-1-2] PHẢI hiển thị cuộc gọi đến mới và cung cấp cho người dùng khả năng chấp nhận hoặc từ chối cuộc gọi đến khi người dùng đang thực hiện cuộc gọi do ứng dụng bên thứ ba thực hiện và ứng dụng đó không hỗ trợ tính năng giữ được chỉ định thông qua
CAPABILITY_SUPPORT_HOLD
. -
[C-SR] Bạn NÊN thông báo cho người dùng biết rằng việc trả lời cuộc gọi đến sẽ làm gián đoạn cuộc gọi đang diễn ra.
Việc triển khai AOSP đáp ứng các yêu cầu này bằng một thông báo quan trọng cho người dùng biết rằng việc trả lời cuộc gọi đến sẽ khiến cuộc gọi kia bị ngắt.
-
[C-SR] Bạn NÊN tải trước ứng dụng trình quay số mặc định hiển thị mục nhập nhật ký cuộc gọi và tên của ứng dụng bên thứ ba trong nhật ký cuộc gọi khi ứng dụng bên thứ ba đặt khoá bổ sung
EXTRA_LOG_SELF_MANAGED_CALLS
trênPhoneAccount
thànhtrue
. - [C-SR] Bạn NÊN xử lý các sự kiện
KEYCODE_MEDIA_PLAY_PAUSE
vàKEYCODE_HEADSETHOOK
của tai nghe âm thanh cho các APIandroid.telecom
như bên dưới:- Gọi
Connection.onDisconnect()
khi phát hiện thấy một sự kiện nhấn phím ngắn trong cuộc gọi đang diễn ra. - Gọi
Connection.onAnswer()
khi phát hiện thấy một sự kiện nhấn phím ngắn trong cuộc gọi đến. - Gọi
Connection.onReject()
khi phát hiện thấy sự kiện nhấn và giữ phím trong cuộc gọi đến. - Bật/tắt trạng thái tắt tiếng của
CallAudioState
.
- Gọi
7.4.2. IEEE 802.11 (Wi-Fi)
Triển khai trên thiết bị:
- PHẢI hỗ trợ một hoặc nhiều dạng 802.11.
Nếu việc triển khai thiết bị bao gồm hỗ trợ 802.11 và hiển thị chức năng cho ứng dụng bên thứ ba, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC phải triển khai API Android tương ứng.
- [C-1-2] PHẢI báo cáo cờ tính năng phần cứng
android.hardware.wifi
. - [C-1-3] PHẢI triển khai multicast API như mô tả trong tài liệu SDK.
- [C-1-4] PHẢI hỗ trợ DNS đa địa chỉ (mDNS) và KHÔNG ĐƯỢC lọc gói mDNS (224.0.0.251) tại bất kỳ thời điểm hoạt động nào, bao gồm:
- Ngay cả khi màn hình không ở trạng thái đang hoạt động.
- Đối với việc triển khai thiết bị Android Television, ngay cả khi ở trạng thái nguồn điện chờ.
- [C-1-5] KHÔNG ĐƯỢC coi lệnh gọi phương thức API
WifiManager.enableNetwork()
là chỉ báo đầy đủ để chuyển đổiNetwork
đang hoạt động được sử dụng theo mặc định cho lưu lượng truy cập ứng dụng và được các phương thức APIConnectivityManager
trả về, chẳng hạn nhưgetActiveNetwork
vàregisterDefaultNetworkCallback
. Nói cách khác, nhà cung cấp dịch vụ có THỂ chỉ tắt quyền truy cập Internet do nhà cung cấp mạng khác cung cấp (ví dụ: dữ liệu di động) nếu xác thực thành công rằng mạng Wi-Fi đang cung cấp quyền truy cập Internet. - [C-SR] KHUYẾN KHÍCH KHI gọi phương thức API
ConnectivityManager.reportNetworkConnectivity()
, hãy đánh giá lại quyền truy cập Internet trênNetwork
và sau khi đánh giá xác định rằngNetwork
hiện tại không còn cung cấp quyền truy cập Internet, hãy chuyển sang bất kỳ mạng nào khác có sẵn (ví dụ: dữ liệu di động) cung cấp quyền truy cập Internet. - [C-SR] NÊN tạo địa chỉ MAC nguồn và số thứ tự của các khung yêu cầu thăm dò ngẫu nhiên, một lần ở đầu mỗi lần quét, trong khi STA bị ngắt kết nối.
- Mỗi nhóm khung yêu cầu thăm dò bao gồm một lần quét phải sử dụng một địa chỉ MAC nhất quán (KHÔNG ĐƯỢC tạo địa chỉ MAC ngẫu nhiên giữa chừng trong quá trình quét).
- Số thứ tự yêu cầu thăm dò phải lặp lại như bình thường (tuần tự) giữa các yêu cầu thăm dò trong một lần quét.
- Số thứ tự yêu cầu thăm dò phải được tạo ngẫu nhiên giữa yêu cầu thăm dò cuối cùng của một lần quét và yêu cầu thăm dò đầu tiên của lần quét tiếp theo.
- [C-SR] NÊN, trong khi STA bị ngắt kết nối, chỉ cho phép các phần tử sau trong khung yêu cầu thăm dò:
- Bộ thông số SSID (0)
- Tập hợp tham số DS (3)
Nếu việc triển khai thiết bị hỗ trợ Wi-Fi và sử dụng Wi-Fi để quét vị trí, thì các thiết bị đó:
- [C-2-1] PHẢI cung cấp cho người dùng khả năng bật/tắt giá trị được đọc thông qua phương thức API
WifiManager.isScanAlwaysAvailable
.
7.4.2.1. Wi-Fi Direct
Triển khai trên thiết bị:
- PHẢI hỗ trợ Wi-Fi Direct (Wi-Fi ngang hàng).
Nếu việc triển khai thiết bị có hỗ trợ Wi-Fi Direct, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai API Android tương ứng như mô tả trong tài liệu SDK.
- [C-1-2] PHẢI báo cáo tính năng phần cứng
android.hardware.wifi.direct
. - [C-1-3] PHẢI hỗ trợ hoạt động Wi-Fi thông thường.
- [C-1-4] PHẢI hỗ trợ đồng thời các hoạt động Wi-Fi và Wi-Fi Direct.
7.4.2.2. Thiết lập đường liên kết trực tiếp được tạo đường hầm qua Wi-Fi
Triển khai trên thiết bị:
- PHẢI hỗ trợ Thiết lập đường liên kết trực tiếp qua đường hầm Wi-Fi (TDLS) như mô tả trong Tài liệu SDK Android.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ TDLS và TDLS được bật bằng API WiFiManager, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC khai báo hỗ trợ TDLS thông qua
WifiManager.isTdlsSupported
. - Chỉ NÊN sử dụng TDLS khi có thể VÀ có lợi.
- NÊN có một số phương pháp phỏng đoán và KHÔNG sử dụng TDLS khi hiệu suất của phương thức này có thể kém hơn so với khi đi qua điểm truy cập Wi-Fi.
7.4.2.3. Wi-Fi Aware
Triển khai trên thiết bị:
- PHẢI hỗ trợ tính năng Nhận biết Wi-Fi.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ Wi-Fi Aware và hiển thị chức năng này cho các ứng dụng bên thứ ba, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai các API
WifiAwareManager
như mô tả trong tài liệu SDK. - [C-1-2] PHẢI khai báo cờ tính năng
android.hardware.wifi.aware
. - [C-1-3] PHẢI hỗ trợ đồng thời các thao tác Wi-Fi và Wi-Fi Aware.
- [C-1-4] PHẢI tạo địa chỉ giao diện quản lý Wi-Fi Aware ngẫu nhiên theo khoảng thời gian không quá 30 phút và bất cứ khi nào bật Wi-Fi Aware.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ Wi-Fi Aware và Wi-Fi Location như mô tả trong Mục 7.4.2.5 và hiển thị các chức năng này cho ứng dụng bên thứ ba, thì các chức năng đó:
- [C-2-1] PHẢI triển khai các API khám phá có thể nhận biết vị trí: setRangingEnabled, setMinDistanceMm, setMaxDistanceMm và onServiceDiscoveredWithinRange.
7.4.2.4. Wi-Fi Passpoint
Triển khai trên thiết bị:
- PHẢI hỗ trợ Wi-Fi Passpoint.
Nếu việc triển khai thiết bị có hỗ trợ Wi-Fi Passpoint, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai các API
WifiManager
liên quan đến Passpoint như mô tả trong tài liệu SDK. - [C-1-2] PHẢI hỗ trợ tiêu chuẩn IEEE 802.11u, liên quan cụ thể đến tính năng Khám phá và Chọn mạng, chẳng hạn như Dịch vụ quảng cáo chung (GAS) và Giao thức truy vấn mạng truy cập (ANQP).
Ngược lại, nếu việc triển khai thiết bị không hỗ trợ Wi-Fi Passpoint:
- [C-2-1] Việc triển khai các API
WifiManager
liên quan đến Passpoint PHẢI gửi mộtUnsupportedOperationException
.
7.4.2.5. Vị trí Wi-Fi (Thời gian trọn vòng của Wi-Fi – RTT)
Triển khai trên thiết bị:
- PHẢI hỗ trợ Vị trí Wi-Fi.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ Vị trí Wi-Fi và hiển thị chức năng này cho các ứng dụng bên thứ ba, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai các API
WifiRttManager
như mô tả trong tài liệu SDK. - [C-1-2] PHẢI khai báo cờ tính năng
android.hardware.wifi.rtt
. - [C-1-3] PHẢI tạo địa chỉ MAC nguồn ngẫu nhiên cho mỗi luồng RTT được thực thi trong khi giao diện Wi-Fi mà RTT đang được thực thi không được liên kết với một Điểm truy cập.
7.4.3. Bluetooth
Nếu việc triển khai thiết bị hỗ trợ hồ sơ Âm thanh Bluetooth, thì các thiết bị đó:
- PHẢI hỗ trợ Bộ mã hoá và giải mã âm thanh nâng cao và Bộ mã hoá và giải mã âm thanh Bluetooth (ví dụ: LDAC).
Nếu việc triển khai thiết bị hỗ trợ HFP, A2DP và AVRCP, thì các thiết bị đó:
- PHẢI hỗ trợ ít nhất 5 thiết bị được kết nối.
Nếu quá trình triển khai thiết bị khai báo tính năng android.hardware.vr.high_performance
, thì các quá trình đó:
- [C-1-1] PHẢI hỗ trợ Bluetooth 4.2 và Bluetooth LE Data Length Extension.
Android hỗ trợ Bluetooth và Bluetooth năng lượng thấp.
Nếu việc triển khai thiết bị bao gồm việc hỗ trợ Bluetooth và Bluetooth năng lượng thấp, thì các thiết bị đó:
- [C-2-1] PHẢI khai báo các tính năng nền tảng có liên quan (tương ứng là
android.hardware.bluetooth
vàandroid.hardware.bluetooth_le
) và triển khai các API nền tảng. - NÊN triển khai các hồ sơ Bluetooth có liên quan như A2DP, AVRCP, OBEX, HFP, v.v. cho phù hợp với thiết bị.
Nếu triển khai hỗ trợ Bluetooth năng lượng thấp, thiết bị sẽ:
- [C-3-1] PHẢI khai báo tính năng phần cứng
android.hardware.bluetooth_le
. - [C-3-2] PHẢI bật các API Bluetooth dựa trên GATT (hồ sơ thuộc tính chung) như mô tả trong tài liệu SDK và android.bluetooth.
- [C-3-3] PHẢI báo cáo giá trị chính xác cho
BluetoothAdapter.isOffloadedFilteringSupported()
để cho biết liệu logic lọc cho các lớp API ScanFilter có được triển khai hay không. - [C-3-4] PHẢI báo cáo giá trị chính xác cho
BluetoothAdapter.isMultipleAdvertisementSupported()
để cho biết liệu có hỗ trợ Quảng cáo tiết kiệm năng lượng hay không. - NÊN hỗ trợ việc chuyển logic lọc sang chipset bluetooth khi triển khai ScanFilter API.
- NÊN hỗ trợ việc chuyển quá trình quét hàng loạt sang chipset Bluetooth.
-
PHẢI hỗ trợ nhiều quảng cáo với ít nhất 4 vị trí.
-
[SR] BẠN NÊN triển khai thời gian chờ Địa chỉ riêng tư có thể phân giải (RPA) không quá 15 phút và xoay vòng địa chỉ khi hết thời gian chờ để bảo vệ quyền riêng tư của người dùng.
Nếu việc triển khai thiết bị hỗ trợ Bluetooth LE và sử dụng Bluetooth LE để quét vị trí, thì các thiết bị đó:
- [C-4-1] PHẢI cung cấp cho người dùng khả năng bật/tắt giá trị được đọc thông qua API Hệ thống
BluetoothAdapter.isBleScanAlwaysAvailable()
.
7.4.4. Giao tiếp trường gần
Triển khai trên thiết bị:
- PHẢI có bộ thu phát và phần cứng liên quan cho công nghệ Giao tiếp phạm vi gần (NFC).
- [C-0-1] PHẢI triển khai các API
android.nfc.NdefMessage
vàandroid.nfc.NdefRecord
ngay cả khi các API này không hỗ trợ NFC hoặc khai báo tính năngandroid.hardware.nfc
vì các lớp này đại diện cho định dạng trình bày dữ liệu độc lập với giao thức.
Nếu triển khai phần cứng NFC trên thiết bị và dự định cung cấp phần cứng đó cho các ứng dụng bên thứ ba, thì thiết bị đó phải:
- [C-1-1] PHẢI báo cáo tính năng
android.hardware.nfc
từ phương thứcandroid.content.pm.PackageManager.hasSystemFeature()
. - PHẢI có khả năng đọc và ghi tin nhắn NDEF thông qua các tiêu chuẩn NFC sau:
- [C-1-2] PHẢI có khả năng hoạt động như một trình đọc/ghi của NFC Forum (theo định nghĩa của thông số kỹ thuật NFC Forum NFCForum-TS-DigitalProtocol-1.0) thông qua các tiêu chuẩn NFC sau:
- NfcA (ISO14443-3A)
- NfcB (ISO14443-3B)
- NfcF (JIS X 6319-4)
- IsoDep (ISO 14443-4)
- Loại thẻ NFC Forum 1, 2, 3, 4, 5 (do NFC Forum xác định)
-
[SR] NÊN có khả năng đọc và ghi tin nhắn NDEF cũng như dữ liệu thô thông qua các tiêu chuẩn NFC sau. Xin lưu ý rằng mặc dù các tiêu chuẩn NFC được nêu là RẤT NÊN, nhưng Định nghĩa về khả năng tương thích cho phiên bản trong tương lai dự kiến sẽ thay đổi các tiêu chuẩn này thành PHẢI. Các tiêu chuẩn này không bắt buộc trong phiên bản này nhưng sẽ bắt buộc trong các phiên bản sau này. Các thiết bị hiện có và mới chạy phiên bản Android này nên đáp ứng các yêu cầu này ngay từ bây giờ để có thể nâng cấp lên các bản phát hành nền tảng trong tương lai.
-
[C-1-3] PHẢI có khả năng truyền và nhận dữ liệu qua các tiêu chuẩn và giao thức ngang hàng sau:
- ISO 18092
- LLCP 1.2 (do NFC Forum xác định)
- SDP 1.0 (do NFC Forum xác định)
- Giao thức đẩy NDEF
- SNEP 1.0 (do NFC Forum xác định)
- [C-1-4] PHẢI hỗ trợ Android Beam và NÊN bật Android Beam theo mặc định.
- [C-1-5] PHẢI có thể gửi và nhận bằng Android Beam khi Android Beam được bật hoặc một chế độ P2p NFC độc quyền khác được bật.
- [C-1-6] PHẢI triển khai máy chủ mặc định SNEP. Các thông báo NDEF hợp lệ mà máy chủ SNEP mặc định nhận được PHẢI được gửi đến các ứng dụng bằng cách sử dụng ý định
android.nfc.ACTION_NDEF_DISCOVERED
. Việc tắt tính năng Android Beam trong phần cài đặt KHÔNG ĐƯỢC tắt tính năng gửi thông báo NDEF đến. - [C-1-7] PHẢI tuân thủ ý định
android.settings.NFCSHARING_SETTINGS
để hiển thị chế độ cài đặt chia sẻ NFC. - [C-1-8] PHẢI triển khai máy chủ NPP. Thông báo mà máy chủ NPP nhận được PHẢI được xử lý giống như máy chủ mặc định SNEP.
- [C-1-9] PHẢI triển khai ứng dụng SNEP và cố gắng gửi NDEF P2P đi đến máy chủ SNEP mặc định khi bật Android Beam. Nếu không tìm thấy máy chủ SNEP mặc định, thì ứng dụng PHẢI cố gắng gửi đến máy chủ NPP.
- [C-1-10] PHẢI cho phép các hoạt động trên nền trước đặt thông báo NDEF P2P đi bằng
android.nfc.NfcAdapter.setNdefPushMessage
,android.nfc.NfcAdapter.setNdefPushMessageCallback
vàandroid.nfc.NfcAdapter.enableForegroundNdefPush
. - NÊN sử dụng cử chỉ hoặc xác nhận trên màn hình, chẳng hạn như "Chạm để truyền", trước khi gửi thông báo NDEF P2P đi.
- [C-1-11] PHẢI hỗ trợ chuyển đổi Kết nối NFC sang Bluetooth khi thiết bị hỗ trợ Cấu hình đẩy đối tượng Bluetooth.
- [C-1-12] PHẢI hỗ trợ chuyển đổi kết nối sang Bluetooth khi sử dụng
android.nfc.NfcAdapter.setBeamPushUris
, bằng cách triển khai thông số kỹ thuật "Chuyển đổi kết nối phiên bản 1.2" và "Ghép nối đơn giản bảo mật qua Bluetooth bằng NFC phiên bản 1.0" của NFC Forum. Việc triển khai như vậy PHẢI triển khai dịch vụ LLCP chuyển đổi có tên dịch vụ là "urn:nfc:sn:handover" để trao đổi yêu cầu chuyển đổi/chọn bản ghi qua NFC và PHẢI sử dụng Hồ sơ đẩy đối tượng Bluetooth để chuyển dữ liệu Bluetooth thực tế. Vì lý do cũ (để vẫn tương thích với các thiết bị Android 4.1), quá trình triển khai VẪN NÊN chấp nhận các yêu cầu GET SNEP để trao đổi yêu cầu chuyển giao/chọn bản ghi qua NFC. Tuy nhiên, bản thân quá trình triển khai KHÔNG NÊN gửi các yêu cầu GET SNEP để thực hiện việc chuyển đổi kết nối. - [C-1-13] PHẢI thăm dò ý kiến về tất cả các công nghệ được hỗ trợ khi ở chế độ khám phá NFC.
- PHẢI ở chế độ khám phá NFC khi thiết bị ở trạng thái thức, màn hình đang hoạt động và màn hình khoá đã mở khoá.
- PHẢI có khả năng đọc mã vạch và URL (nếu được mã hoá) của các sản phẩm Mã vạch NFC mỏng.
Xin lưu ý rằng các đường liên kết công khai không có sẵn cho các thông số kỹ thuật của JIS, ISO và NFC Forum được trích dẫn ở trên.
Android hỗ trợ chế độ Giả lập thẻ dựa trên máy chủ (HCE) NFC.
Nếu quá trình triển khai thiết bị bao gồm một chipset bộ điều khiển NFC có thể hỗ trợ HCE (đối với NfcA và/hoặc NfcB) và hỗ trợ định tuyến Mã ứng dụng (AID), thì các thiết bị đó:
- [C-2-1] PHẢI báo cáo hằng số tính năng
android.hardware.nfc.hce
. - [C-2-2] PHẢI hỗ trợ API NFC HCE như được xác định trong SDK Android.
Nếu việc triển khai thiết bị bao gồm một chipset bộ điều khiển NFC có thể hỗ trợ HCE cho NfcF và triển khai tính năng này cho các ứng dụng bên thứ ba, thì thiết bị đó:
- [C-3-1] PHẢI báo cáo hằng số tính năng
android.hardware.nfc.hcef
. - [C-3-2] PHẢI triển khai API mô phỏng thẻ NfcF như được xác định trong SDK Android.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ NFC chung như mô tả trong phần này và hỗ trợ các công nghệ MIFARE (MIFARE Classic, MIFARE Ultralight, NDEF trên MIFARE Classic) ở vai trò trình đọc/ghi, thì các thiết bị đó:
- [C-4-1] PHẢI triển khai các API Android tương ứng theo tài liệu của SDK Android.
- [C-4-2] PHẢI báo cáo tính năng
com.nxp.mifare
từ phương thứcandroid.content.pm.PackageManager.hasSystemFeature
(). Xin lưu ý rằng đây không phải là tính năng Android tiêu chuẩn và do đó không xuất hiện dưới dạng hằng số trong lớpandroid.content.pm.PackageManager
.
7.4.5. Khả năng mạng tối thiểu
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ một hoặc nhiều hình thức kết nối dữ liệu. Cụ thể, việc triển khai thiết bị PHẢI hỗ trợ ít nhất một tiêu chuẩn dữ liệu có tốc độ 200 Kbit/giây trở lên. Ví dụ về các công nghệ đáp ứng yêu cầu này bao gồm EDGE, HSPA, EV-DO, 802.11g, Ethernet và Bluetooth PAN.
- CẦN hỗ trợ ít nhất một tiêu chuẩn dữ liệu không dây phổ biến, chẳng hạn như 802.11 (Wi-Fi), khi tiêu chuẩn kết nối mạng vật lý (chẳng hạn như Ethernet) là kết nối dữ liệu chính.
- CÓ THỂ triển khai nhiều hình thức kết nối dữ liệu.
- [C-0-2] PHẢI bao gồm ngăn xếp mạng IPv6 và hỗ trợ giao tiếp IPv6 bằng các API được quản lý, chẳng hạn như
java.net.Socket
vàjava.net.URLConnection
, cũng như các API gốc, chẳng hạn như ổ cắmAF_INET6
. - [C-0-3] PHẢI bật IPv6 theo mặc định.
- PHẢI đảm bảo rằng giao tiếp IPv6 cũng đáng tin cậy như IPv4, ví dụ:
- [C-0-4] PHẢI duy trì kết nối IPv6 ở chế độ nghỉ.
- [C-0-5] Việc giới hạn tốc độ KHÔNG ĐƯỢC làm thiết bị mất kết nối IPv6 trên bất kỳ mạng nào tuân thủ IPv6 sử dụng thời gian tồn tại của RA ít nhất là 180 giây.
- [C-0-6] PHẢI cung cấp cho các ứng dụng bên thứ ba khả năng kết nối IPv6 trực tiếp với mạng khi kết nối với mạng IPv6, mà không có bất kỳ hình thức dịch địa chỉ hoặc cổng nào diễn ra cục bộ trên thiết bị. Cả API được quản lý (chẳng hạn như
Socket#getLocalAddress
hoặcSocket#getLocalPort
) và API NDK (chẳng hạn nhưgetsockname()
hoặcIPV6_PKTINFO
) đều PHẢI trả về địa chỉ IP và cổng thực sự được dùng để gửi và nhận gói trên mạng.
Cấp độ hỗ trợ IPv6 bắt buộc phụ thuộc vào loại mạng, như trong các yêu cầu sau.
Nếu việc triển khai thiết bị hỗ trợ Wi-Fi, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ hoạt động chỉ IPv6 và ngăn xếp kép trên Wi-Fi.
Nếu việc triển khai thiết bị hỗ trợ Ethernet, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ hoạt động của ngăn xếp kép trên Ethernet.
Nếu việc triển khai thiết bị hỗ trợ Dữ liệu di động, thì các thiết bị đó:
- PHẢI hỗ trợ hoạt động IPv6 (chỉ IPv6 và có thể là ngăn xếp kép) trên mạng di động.
Nếu việc triển khai thiết bị hỗ trợ nhiều loại mạng (ví dụ: Wi-Fi và dữ liệu di động), thì họ:
- [C-3-1] PHẢI đồng thời đáp ứng các yêu cầu trên trên mỗi mạng khi thiết bị đồng thời kết nối với nhiều loại mạng.
7.4.6. Cài đặt đồng bộ hóa
Triển khai trên thiết bị:
- [C-0-1] BẮT BUỘC phải bật chế độ cài đặt tự động đồng bộ hoá chính theo mặc định để phương thức
getMasterSyncAutomatically()
trả về giá trị "true".
7.4.7. Trình tiết kiệm dữ liệu
Nếu việc triển khai thiết bị bao gồm một kết nối có đo lượng dữ liệu, thì đó là:
- [SR] NÊN cung cấp chế độ tiết kiệm dữ liệu.
Nếu việc triển khai thiết bị cung cấp chế độ tiết kiệm dữ liệu, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ tất cả API trong lớp
ConnectivityManager
như mô tả trong tài liệu SDK - [C-1-2] PHẢI cung cấp giao diện người dùng trong phần cài đặt để xử lý ý định
Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS
, cho phép người dùng thêm hoặc xoá ứng dụng khỏi danh sách cho phép.
Nếu không cung cấp chế độ tiết kiệm dữ liệu, thì các hoạt động triển khai thiết bị sẽ:
- [C-2-1] PHẢI trả về giá trị
RESTRICT_BACKGROUND_STATUS_DISABLED
choConnectivityManager.getRestrictBackgroundStatus()
- [C-2-2] KHÔNG ĐƯỢC truyền tin
ConnectivityManager.ACTION_RESTRICT_BACKGROUND_CHANGED
. - [C-2-3] PHẢI có một hoạt động xử lý ý định
Settings.ACTION_IGNORE_BACKGROUND_DATA_RESTRICTIONS_SETTINGS
nhưng CÓ THỂ triển khai hoạt động đó dưới dạng không hoạt động.
7.4.8. Phần tử bảo mật
Nếu các phương thức triển khai thiết bị hỗ trợ các phần tử bảo mật có khả năng sử dụng Open Mobile API và cung cấp các phần tử đó cho ứng dụng bên thứ ba, thì các phương thức đó:
- [C-1-1] PHẢI liệt kê các trình đọc Secure Element hiện có khi phương thức
android.se.omapi.SEService.getReaders()
được gọi.
7.5. Camera
Nếu việc triển khai thiết bị bao gồm ít nhất một máy ảnh, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC phải khai báo cờ tính năng
android.hardware.camera.any
. - [C-1-2] Ứng dụng PHẢI có thể đồng thời phân bổ 3 bitmap RGBA_8888 bằng kích thước của hình ảnh do cảm biến máy ảnh có độ phân giải lớn nhất trên thiết bị tạo ra, trong khi máy ảnh đang mở để mục đích xem trước cơ bản và chụp ảnh tĩnh.
7.5.1. Máy ảnh mặt sau
Máy ảnh mặt sau là máy ảnh nằm ở cạnh của thiết bị đối diện với màn hình; tức là máy ảnh này chụp hình ảnh ở phía xa của thiết bị, giống như máy ảnh truyền thống.
Triển khai trên thiết bị:
- PHẢI có máy ảnh mặt sau.
Nếu việc triển khai thiết bị bao gồm ít nhất một máy ảnh mặt sau, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC báo cáo cờ tính năng
android.hardware.camera
vàandroid.hardware.camera.any
. - [C-1-2] PHẢI có độ phân giải tối thiểu là 2 megapixel.
- PHẢI triển khai tính năng tự động lấy nét bằng phần cứng hoặc tự động lấy nét bằng phần mềm trong trình điều khiển máy ảnh (trong suốt đối với phần mềm ứng dụng).
- CÓ THỂ có phần cứng lấy nét cố định hoặc EDOF (độ sâu trường mở rộng).
- CÓ THỂ có đèn flash.
Nếu máy ảnh có đèn flash:
- [C-2-1] Đèn flash KHÔNG ĐƯỢC sáng trong khi một thực thể
android.hardware.Camera.PreviewCallback
đã được đăng ký trên nền tảng xem trước của Camera, trừ phi ứng dụng đã bật đèn flash một cách rõ ràng bằng cách bật các thuộc tínhFLASH_MODE_AUTO
hoặcFLASH_MODE_ON
của đối tượngCamera.Parameters
. Xin lưu ý rằng quy tắc ràng buộc này không áp dụng cho ứng dụng máy ảnh hệ thống tích hợp sẵn của thiết bị, mà chỉ áp dụng cho các ứng dụng của bên thứ ba sử dụngCamera.PreviewCallback
.
7.5.2. Máy ảnh mặt trước
Máy ảnh mặt trước là máy ảnh nằm ở cùng một bên của thiết bị với màn hình; tức là máy ảnh thường dùng để chụp hình người dùng, chẳng hạn như cho hội nghị truyền hình và các ứng dụng tương tự.
Triển khai trên thiết bị:
- CÓ THỂ có máy ảnh mặt trước.
Nếu việc triển khai thiết bị bao gồm ít nhất một máy ảnh mặt trước, thì các thiết bị đó:
- [C-1-1] BẮT BUỘC báo cáo cờ tính năng
android.hardware.camera.any
vàandroid.hardware.camera.front
. - [C-1-2] PHẢI có độ phân giải tối thiểu là VGA (640x480 pixel).
- [C-1-3] KHÔNG ĐƯỢC sử dụng máy ảnh mặt trước làm mặc định cho Camera API và KHÔNG ĐƯỢC định cấu hình API để coi máy ảnh mặt trước là máy ảnh mặt sau mặc định, ngay cả khi đó là máy ảnh duy nhất trên thiết bị.
- [C-1-4] Bản xem trước của máy ảnh PHẢI được phản chiếu theo chiều ngang so với hướng do ứng dụng chỉ định khi ứng dụng hiện tại đã yêu cầu rõ ràng rằng màn hình Máy ảnh phải được xoay thông qua lệnh gọi đến phương thức
android.hardware.Camera.setDisplayOrientation()
. Ngược lại, bản xem trước PHẢI được phản chiếu dọc theo trục ngang mặc định của thiết bị khi ứng dụng hiện tại không yêu cầu rõ ràng việc xoay màn hình Máy ảnh thông qua lệnh gọi đến phương thứcandroid.hardware.Camera.setDisplayOrientation()
. - [C-1-5] KHÔNG ĐƯỢC phản chiếu luồng video hoặc hình ảnh tĩnh đã chụp cuối cùng được trả về lệnh gọi lại ứng dụng hoặc được cam kết lưu vào bộ nhớ phương tiện.
- [C-1-6] PHẢI phản chiếu hình ảnh mà postview hiển thị theo cách tương tự như luồng hình ảnh xem trước của máy ảnh.
- CÓ THỂ bao gồm các tính năng (chẳng hạn như tự động lấy nét, đèn flash, v.v.) có sẵn cho máy ảnh mặt sau như mô tả trong mục 7.5.1.
Nếu người dùng có thể xoay chế độ triển khai thiết bị (chẳng hạn như tự động thông qua gia tốc kế hoặc theo cách thủ công thông qua dữ liệu đầu vào của người dùng):
- [C-2-1] Bản xem trước của máy ảnh PHẢI được phản chiếu theo chiều ngang so với hướng hiện tại của thiết bị.
7.5.3. Máy ảnh gắn ngoài
Triển khai trên thiết bị:
- CÓ THỂ hỗ trợ máy ảnh bên ngoài không nhất thiết phải luôn kết nối.
Nếu việc triển khai thiết bị bao gồm việc hỗ trợ máy ảnh bên ngoài, thì các thiết bị đó:
- [C-1-1] PHẢI khai báo cờ tính năng nền tảng
android.hardware.camera.external
vàandroid.hardware camera.any
. - [C-1-2] PHẢI hỗ trợ USB Video Class (UVC 1.0 trở lên) nếu máy ảnh bên ngoài kết nối thông qua cổng máy chủ USB.
- [C-1-3] PHẢI vượt qua các bài kiểm thử CTS về máy ảnh khi kết nối với thiết bị máy ảnh bên ngoài thực tế. Bạn có thể xem thông tin chi tiết về quy trình kiểm thử CTS của máy ảnh tại source.android.com.
- PHẢI hỗ trợ các phương thức nén video như MJPEG để cho phép chuyển các luồng không được mã hoá chất lượng cao (tức là luồng hình ảnh thô hoặc được nén độc lập).
- CÓ THỂ hỗ trợ nhiều máy ảnh.
- CÓ THỂ hỗ trợ mã hoá video dựa trên máy ảnh.
Nếu máy ảnh hỗ trợ tính năng mã hoá video:
- [C-2-1] Thiết bị phải truy cập được luồng không mã hoá / MJPEG đồng thời (độ phân giải QVGA trở lên).
7.5.4. Hành vi của Camera API
Android bao gồm hai gói API để truy cập vào máy ảnh, API android.hardware.camera2 mới hơn hiển thị chế độ điều khiển máy ảnh cấp thấp cho ứng dụng, bao gồm cả luồng chụp/truyền trực tuyến không sao chép hiệu quả và các chế độ điều khiển theo khung hình về độ phơi sáng, độ lợi, độ lợi cân bằng trắng, chuyển đổi màu, loại bỏ nhiễu, làm sắc nét và nhiều chế độ khác.
Gói API cũ,android.hardware.Camera
, được đánh dấu là không dùng nữa trong Android 5.0 nhưng vẫn có sẵn để các ứng dụng sử dụng. Việc triển khai thiết bị Android PHẢI đảm bảo tiếp tục hỗ trợ API như mô tả trong phần này và trong SDK Android.
Tất cả các tính năng phổ biến giữa lớp android.hardware.Camera không dùng nữa và gói android.hardware.camera2 mới hơn PHẢI có hiệu suất và chất lượng tương đương trong cả hai API. Ví dụ: với các chế độ cài đặt tương đương, tốc độ và độ chính xác của tính năng tự động lấy nét phải giống nhau, đồng thời chất lượng của hình ảnh được chụp phải giống nhau. Các tính năng phụ thuộc vào ngữ nghĩa khác nhau của hai API không bắt buộc phải có tốc độ hoặc chất lượng phù hợp, nhưng PHẢI khớp gần nhất có thể.
Việc triển khai thiết bị PHẢI triển khai các hành vi sau đây cho các API liên quan đến máy ảnh, cho tất cả máy ảnh có sẵn. Triển khai trên thiết bị:
- [C-0-1] PHẢI sử dụng
android.hardware.PixelFormat.YCbCr_420_SP
cho dữ liệu xem trước được cung cấp cho lệnh gọi lại ứng dụng khi ứng dụng chưa bao giờ gọiandroid.hardware.Camera.Parameters.setPreviewFormat(int)
. - [C-0-2] PHẢI ở định dạng mã hoá NV21 khi một ứng dụng đăng ký một thực thể
android.hardware.Camera.PreviewCallback
và hệ thống gọi phương thứconPreviewFrame()
và định dạng xem trước là YCbCr_420_SP, dữ liệu trong byte[] được truyền vàoonPreviewFrame()
. Tức là NV21 PHẢI là giá trị mặc định. - [C-0-3] PHẢI hỗ trợ định dạng YV12 (như được biểu thị bằng hằng số
android.graphics.ImageFormat.YV12
) cho bản xem trước của máy ảnh cho cả máy ảnh trước và sau choandroid.hardware.Camera
. (Máy quay và bộ mã hoá video phần cứng có thể sử dụng bất kỳ định dạng pixel gốc nào, nhưng việc triển khai thiết bị PHẢI hỗ trợ chuyển đổi sang YV12.) - [C-0-4] PHẢI hỗ trợ các định dạng
android.hardware.ImageFormat.YUV_420_888
vàandroid.hardware.ImageFormat.JPEG
dưới dạng đầu ra thông qua APIandroid.media.ImageReader
cho các thiết bịandroid.hardware.camera2
quảng cáo chức năngREQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE
trongandroid.request.availableCapabilities
. - [C-0-5] VẪN PHẢI triển khai đầy đủ Camera API có trong tài liệu SDK Android, bất kể thiết bị có tính năng tự động lấy nét bằng phần cứng hay các tính năng khác. Ví dụ: các máy ảnh không có tính năng tự động lấy nét VẪN PHẢI gọi mọi thực thể
android.hardware.Camera.AutoFocusCallback
đã đăng ký (mặc dù điều này không liên quan đến máy ảnh không có tính năng tự động lấy nét). Xin lưu ý rằng điều này áp dụng cho máy ảnh mặt trước; ví dụ: mặc dù hầu hết máy ảnh mặt trước không hỗ trợ tính năng tự động lấy nét, nhưng các lệnh gọi lại API vẫn phải được "giả mạo" như mô tả. - [C-0-6] PHẢI nhận dạng và tuân thủ từng tên tham số được xác định là hằng số trên lớp
android.hardware.Camera.Parameters
. Ngược lại, việc triển khai thiết bị KHÔNG ĐƯỢC tuân thủ hoặc nhận dạng các hằng số chuỗi được truyền đến phương thứcandroid.hardware.Camera.setParameters()
, ngoại trừ các hằng số được ghi nhận là hằng số trênandroid.hardware.Camera.Parameters
. Tức là, việc triển khai thiết bị PHẢI hỗ trợ tất cả các thông số Máy ảnh chuẩn nếu phần cứng cho phép và KHÔNG ĐƯỢC hỗ trợ các loại thông số Máy ảnh tuỳ chỉnh. Ví dụ: các hoạt động triển khai thiết bị hỗ trợ chụp ảnh bằng kỹ thuật hình ảnh dải động cao (HDR) PHẢI hỗ trợ tham số máy ảnhCamera.SCENE_MODE_HDR
. - [C-0-7] PHẢI báo cáo cấp độ hỗ trợ thích hợp bằng thuộc tính
android.info.supportedHardwareLevel
như mô tả trong SDK Android và báo cáo cờ tính năng khung thích hợp. - [C-0-8] CŨNG PHẢI khai báo các chức năng của máy ảnh riêng lẻ của
android.hardware.camera2
thông qua thuộc tínhandroid.request.availableCapabilities
và khai báo cờ tính năng thích hợp; PHẢI xác định cờ tính năng nếu bất kỳ thiết bị máy ảnh nào được đính kèm đều hỗ trợ tính năng đó. - [C-0-9] PHẢI truyền phát ý định
Camera.ACTION_NEW_PICTURE
bất cứ khi nào máy ảnh chụp một bức ảnh mới và mục nhập của bức ảnh đó đã được thêm vào kho phương tiện. - [C-0-10] PHẢI truyền phát ý định
Camera.ACTION_NEW_VIDEO
bất cứ khi nào máy ảnh ghi lại một video mới và mục nhập của ảnh đã được thêm vào kho phương tiện. - [C-SR] Bạn NÊN hỗ trợ thiết bị máy ảnh logic liệt kê chức năng
CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA
, cho các thiết bị có nhiều máy ảnh hướng về cùng một hướng, bao gồm từng máy ảnh thực tế hướng về hướng đó, miễn là khung hỗ trợ loại máy ảnh thực tế vàCameraCharacteristics.INFO_SUPPORTED_HARDWARE_LEVEL
cho máy ảnh thực tế làLIMITED
,FULL
hoặcLEVEL_3
.
7.5.5. Hướng máy ảnh
Nếu việc triển khai thiết bị có máy ảnh mặt trước hoặc mặt sau, thì(các) máy ảnh đó:
- [C-1-1] PHẢI được định hướng để kích thước dài của máy ảnh phù hợp với kích thước dài của màn hình. Tức là khi thiết bị được giữ theo hướng ngang, máy ảnh PHẢI chụp ảnh theo hướng ngang. Điều này áp dụng bất kể hướng tự nhiên của thiết bị; tức là áp dụng cho cả thiết bị chính theo hướng ngang và thiết bị chính theo hướng dọc.
7.6. Bộ nhớ và dung lượng lưu trữ
7.6.1. Bộ nhớ và dung lượng lưu trữ tối thiểu
Triển khai trên thiết bị:
- [C-0-1] PHẢI có Trình quản lý tải xuống mà các ứng dụng CÓ THỂ sử dụng để tải tệp dữ liệu xuống và các ứng dụng này PHẢI có khả năng tải các tệp riêng lẻ có kích thước tối thiểu 100 MB xuống vị trí "bộ nhớ đệm" mặc định.
7.6.2. Bộ nhớ dùng chung của ứng dụng
Triển khai trên thiết bị:
- [C-0-1] PHẢI cung cấp bộ nhớ để các ứng dụng chia sẻ, còn gọi là "bộ nhớ ngoài dùng chung", "bộ nhớ dùng chung của ứng dụng" hoặc theo đường dẫn Linux "/sdcard" mà bộ nhớ đó được gắn vào.
- [C-0-2] PHẢI được định cấu hình với bộ nhớ dùng chung được gắn theo mặc định, nói cách khác là "trực tiếp", bất kể bộ nhớ được triển khai trên thành phần bộ nhớ trong hay phương tiện bộ nhớ có thể tháo rời (ví dụ: khe cắm thẻ Secure Digital).
- [C-0-3] PHẢI gắn bộ nhớ dùng chung của ứng dụng trực tiếp trên đường dẫn Linux
sdcard
hoặc đưa vào một đường liên kết tượng trưng Linux từsdcard
đến điểm gắn thực tế. - [C-0-4] PHẢI thực thi quyền
android.permission.WRITE_EXTERNAL_STORAGE
trên bộ nhớ dùng chung này như được ghi nhận trong SDK. Nếu không, mọi ứng dụng có được quyền đó PHẢI ghi được vào bộ nhớ dùng chung.
Việc triển khai thiết bị CÓ THỂ đáp ứng các yêu cầu trên bằng một trong những cách sau:
- Bộ nhớ có thể tháo rời mà người dùng có thể truy cập, chẳng hạn như khe cắm thẻ Secure Digital (SD).
- Một phần bộ nhớ trong (không thể tháo rời) được triển khai trong Dự án nguồn mở Android (AOSP).
Nếu việc triển khai thiết bị sử dụng bộ nhớ có thể tháo rời để đáp ứng các yêu cầu trên, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai một thông báo ngắn hoặc giao diện người dùng bật lên để cảnh báo người dùng khi không có phương tiện lưu trữ nào được lắp vào khe.
- [C-1-2] PHẢI có phương tiện lưu trữ được định dạng FAT (ví dụ: thẻ SD) hoặc phải cho thấy trên hộp và tài liệu khác có sẵn tại thời điểm mua rằng phương tiện lưu trữ phải được mua riêng.
Nếu việc triển khai thiết bị sử dụng một phần bộ nhớ không thể tháo rời để đáp ứng các yêu cầu trên, thì thiết bị đó:
- NÊN sử dụng cách triển khai AOSP của bộ nhớ dùng chung của ứng dụng nội bộ.
- CÓ THỂ chia sẻ dung lượng lưu trữ với dữ liệu riêng tư của ứng dụng.
Nếu quá trình triển khai thiết bị bao gồm nhiều đường dẫn bộ nhớ dùng chung (chẳng hạn như cả khe cắm thẻ SD và bộ nhớ trong dùng chung), thì các đường dẫn đó:
- [C-2-1] PHẢI chỉ cho phép các ứng dụng Android được cài đặt sẵn và đặc quyền có quyền
WRITE_EXTERNAL_STORAGE
ghi vào bộ nhớ ngoài phụ, ngoại trừ khi ghi vào các thư mục dành riêng cho gói của ứng dụng hoặc trongURI
được trả về bằng cách kích hoạt ý địnhACTION_OPEN_DOCUMENT_TREE
.
Nếu việc triển khai thiết bị có cổng USB hỗ trợ chế độ thiết bị ngoại vi USB, thì các thiết bị đó:
- [C-3-1] PHẢI cung cấp cơ chế truy cập vào dữ liệu trên bộ nhớ dùng chung của ứng dụng từ máy tính lưu trữ.
- NÊN hiển thị nội dung từ cả hai đường dẫn bộ nhớ một cách minh bạch thông qua dịch vụ quét nội dung đa phương tiện của Android và
android.provider.MediaStore
. - CÓ THỂ sử dụng bộ nhớ khối lượng lớn USB, nhưng PHẢI sử dụng Giao thức truyền nội dung nghe nhìn để đáp ứng yêu cầu này.
Nếu việc triển khai thiết bị có cổng USB với chế độ thiết bị ngoại vi USB và hỗ trợ Giao thức truyền nội dung đa phương tiện, thì các thiết bị đó:
- PHẢI tương thích với máy chủ MTP Android tham chiếu, Android File Transfer.
- NÊN báo cáo loại thiết bị USB là 0x00.
- NÊN báo cáo tên giao diện USB là "MTP".
7.6.3. Bộ nhớ thích ứng
Nếu thiết bị dự kiến là thiết bị di động (không giống như TV), thì việc triển khai thiết bị sẽ là:
- [SR] NÊN triển khai bộ nhớ có thể sử dụng ở một vị trí ổn định lâu dài, vì việc vô tình ngắt kết nối các bộ nhớ này có thể khiến dữ liệu bị mất/hỏng.
Nếu cổng thiết bị lưu trữ có thể tháo rời nằm ở vị trí ổn định lâu dài, chẳng hạn như trong ngăn pin hoặc nắp bảo vệ khác, thì việc triển khai thiết bị sẽ:
- [SR] BẠN NÊN triển khai bộ nhớ thích ứng.
7.7. USB
Nếu triển khai thiết bị có cổng USB, thì các thiết bị đó:
- PHẢI hỗ trợ chế độ thiết bị ngoại vi USB và PHẢI hỗ trợ chế độ máy chủ USB.
7.7.1. Chế độ thiết bị ngoại vi USB
Nếu việc triển khai thiết bị bao gồm một cổng USB hỗ trợ chế độ ngoại vi:
- [C-1-1] Cổng PHẢI kết nối được với máy chủ USB có cổng USB loại A hoặc loại C tiêu chuẩn.
- [C-1-2] PHẢI báo cáo chính xác giá trị của
iSerialNumber
trong chỉ số mô tả thiết bị chuẩn USB thông quaandroid.os.Build.SERIAL
. - [C-1-3] PHẢI phát hiện bộ sạc 1,5A và 3,0A theo tiêu chuẩn điện trở Type-C và PHẢI phát hiện các thay đổi trong quảng cáo nếu bộ sạc hỗ trợ USB Type-C.
- [SR] Cổng PHẢI sử dụng kiểu dáng USB micro-B, micro-AB hoặc Type-C. Các thiết bị Android hiện tại và mới NÊN đáp ứng những yêu cầu này để có thể nâng cấp lên các bản phát hành nền tảng trong tương lai.
- [SR] Cổng PHẢI nằm ở cuối thiết bị (theo hướng tự nhiên) hoặc bật tính năng xoay màn hình phần mềm cho tất cả ứng dụng (bao gồm cả màn hình chính) để màn hình vẽ chính xác khi thiết bị được định hướng với cổng ở dưới cùng. Bạn NÊN đáp ứng những yêu cầu này đối với các thiết bị Android hiện có và mới để có thể nâng cấp lên các bản phát hành nền tảng trong tương lai.
- [SR] NÊN triển khai tính năng hỗ trợ để vẽ dòng điện 1,5 A trong quá trình truyền tin và lưu lượng truy cập HS như được chỉ định trong thông số kỹ thuật về sạc pin qua USB, bản sửa đổi 1.2. Các thiết bị Android hiện tại và mới NÊN đáp ứng những yêu cầu này để có thể nâng cấp lên các bản phát hành nền tảng trong tương lai.
- [SR] KHÔNG NÊN hỗ trợ các phương thức sạc độc quyền sửa đổi điện áp Vbus ngoài mức mặc định hoặc thay đổi vai trò của nguồn/đầu vào vì điều này có thể dẫn đến các vấn đề về khả năng tương tác với bộ sạc hoặc thiết bị hỗ trợ các phương thức Cung cấp nguồn qua USB tiêu chuẩn. Mặc dù điều này được gọi là "RẤT NÊN", nhưng trong các phiên bản Android trong tương lai, chúng tôi có thể YÊU CẦU tất cả thiết bị loại C hỗ trợ khả năng tương tác đầy đủ với bộ sạc loại C tiêu chuẩn.
- [SR] NÊN hỗ trợ tính năng Cấp nguồn cho dữ liệu và hoán đổi vai trò nguồn khi chúng hỗ trợ USB Type-C và chế độ máy chủ USB.
- NÊN hỗ trợ tính năng Cung cấp nguồn điện để sạc điện áp cao và hỗ trợ các Chế độ thay thế như hiển thị ra ngoài.
- NÊN triển khai API và thông số kỹ thuật của Phụ kiện mở Android (AOA) như được ghi nhận trong tài liệu SDK Android.
Nếu triển khai thiết bị bao gồm cổng USB và triển khai quy cách AOA, thì các thiết bị đó:
- [C-2-1] PHẢI khai báo hỗ trợ tính năng phần cứng
android.hardware.usb.accessory
. - [C-2-2] Lớp bộ nhớ khối lượng lớn USB PHẢI bao gồm chuỗi "android" ở cuối chuỗi
iInterface
mô tả giao diện của bộ nhớ khối lượng lớn USB
7.7.2. Chế độ máy chủ USB
Nếu việc triển khai thiết bị bao gồm một cổng USB hỗ trợ chế độ máy chủ, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai API máy chủ USB Android như được ghi nhận trong SDK Android và PHẢI khai báo hỗ trợ tính năng phần cứng
android.hardware.usb.host
. - [C-1-2] PHẢI triển khai tính năng hỗ trợ để kết nối các thiết bị ngoại vi USB tiêu chuẩn, nói cách khác, các thiết bị đó PHẢI:
- Có cổng loại C trên thiết bị hoặc đi kèm(các) cáp điều chỉnh cổng độc quyền trên thiết bị thành cổng USB loại C tiêu chuẩn (thiết bị USB Type-C).
- Có cổng loại A trên thiết bị hoặc vận chuyển kèm theo(các) cáp chuyển đổi cổng độc quyền trên thiết bị thành cổng USB loại A tiêu chuẩn.
- Có cổng micro-AB trên thiết bị. Cổng này PHẢI đi kèm với cáp thích ứng với cổng loại A tiêu chuẩn.
- [C-1-3] KHÔNG ĐƯỢC vận chuyển kèm theo bộ chuyển đổi từ cổng USB loại A hoặc cổng micro-AB sang cổng loại C (ổ cắm).
- [SR] NÊN triển khai lớp âm thanh USB như được ghi nhận trong tài liệu SDK Android.
- PHẢI hỗ trợ sạc thiết bị ngoại vi USB đã kết nối khi ở chế độ máy chủ; quảng cáo dòng điện nguồn ít nhất là 1,5A như được chỉ định trong phần Thông số kết thúc của Thông số kỹ thuật của cáp và đầu nối USB Type-C Bản sửa đổi 1.2 đối với đầu nối USB Type-C hoặc sử dụng phạm vi dòng điện đầu ra của Cổng hạ nguồn sạc(CDP) như được chỉ định trong Thông số kỹ thuật sạc pin USB, bản sửa đổi 1.2 đối với đầu nối Micro-AB.
- NÊN triển khai và hỗ trợ các tiêu chuẩn USB Type-C.
Nếu việc triển khai thiết bị bao gồm cổng USB hỗ trợ chế độ máy chủ và lớp âm thanh USB, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ lớp USB HID.
- [C-2-2] PHẢI hỗ trợ tính năng phát hiện và liên kết các trường dữ liệu HID sau đây được chỉ định trong Bảng sử dụng USB HID và Yêu cầu sử dụng lệnh thoại với các hằng số
KeyEvent
như bên dưới:- Trang sử dụng (0xC) Mã sử dụng (0x0CD):
KEYCODE_MEDIA_PLAY_PAUSE
- Trang sử dụng (0xC) Mã sử dụng (0x0E9):
KEYCODE_VOLUME_UP
- Trang sử dụng (0xC) Mã sử dụng (0x0EA):
KEYCODE_VOLUME_DOWN
- Trang sử dụng (0xC) Mã sử dụng (0x0CF):
KEYCODE_VOICE_ASSIST
- Trang sử dụng (0xC) Mã sử dụng (0x0CD):
Nếu việc triển khai thiết bị bao gồm một cổng USB hỗ trợ chế độ máy chủ và Khung truy cập bộ nhớ (SAF), thì các thiết bị đó:
- [C-3-1] PHẢI nhận dạng mọi thiết bị MTP (Giao thức truyền phương tiện) được kết nối từ xa và cho phép truy cập vào nội dung của các thiết bị đó thông qua ý định
ACTION_GET_CONTENT
,ACTION_OPEN_DOCUMENT
vàACTION_CREATE_DOCUMENT
. .
Nếu việc triển khai thiết bị bao gồm một cổng USB hỗ trợ chế độ máy chủ và USB Type-C, thì các thiết bị đó:
- [C-4-1] PHẢI triển khai chức năng Cổng hai vai trò như được xác định trong quy cách USB Type-C (mục 4.5.1.3.3).
- [SR] NÊN hỗ trợ DisplayPort, PHẢI hỗ trợ Tốc độ dữ liệu USB SuperSpeed và NÊN hỗ trợ tính năng Cấp nguồn để hoán đổi vai trò dữ liệu và nguồn.
- [SR] KHÔNG NÊN hỗ trợ Chế độ phụ kiện bộ chuyển đổi âm thanh như mô tả trong Phụ lục A của Bản sửa đổi 1.2 về quy cách cáp và đầu nối USB Type-C.
- NÊN triển khai mô hình Try.* phù hợp nhất với kiểu dáng thiết bị. Ví dụ: thiết bị cầm tay PHẢI triển khai mô hình Try.SNK.
7.8. Âm thanh
7.8.1. Micrô
Nếu việc triển khai thiết bị bao gồm micrô, thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo hằng số tính năng
android.hardware.microphone
. - [C-1-2] PHẢI đáp ứng các yêu cầu về bản ghi âm trong mục 5.4.
- [C-1-3] PHẢI đáp ứng các yêu cầu về độ trễ âm thanh trong mục 5.6.
- [SR] NÊN hỗ trợ tính năng ghi âm gần siêu âm như mô tả trong mục 7.8.3.
Nếu bỏ qua micrô trong quá trình triển khai thiết bị, thì các thiết bị đó:
- [C-2-1] KHÔNG ĐƯỢC báo cáo hằng số tính năng
android.hardware.microphone
. - [C-2-2] PHẢI triển khai API ghi âm âm thanh ở chế độ không hoạt động theo mục 7.
7.8.2. Đầu ra âm thanh
Nếu việc triển khai thiết bị bao gồm loa hoặc cổng đầu ra âm thanh/đa phương tiện cho thiết bị ngoại vi đầu ra âm thanh, chẳng hạn như giắc âm thanh 3,5 mm 4 dây hoặc cổng chế độ máy chủ USB sử dụng lớp âm thanh USB, thì các thiết bị đó:
- [C-1-1] PHẢI báo cáo hằng số tính năng
android.hardware.audio.output
. - [C-1-2] PHẢI đáp ứng các yêu cầu về phát âm thanh trong mục 5.5.
- [C-1-3] PHẢI đáp ứng các yêu cầu về độ trễ âm thanh trong mục 5.6.
- [SR] NÊN hỗ trợ chế độ phát gần siêu âm như mô tả trong mục 7.8.3.
Nếu việc triển khai thiết bị không bao gồm loa hoặc cổng đầu ra âm thanh, thì các thiết bị đó:
- [C-2-1] KHÔNG ĐƯỢC báo cáo tính năng
android.hardware.audio.output
. - [C-2-2] PHẢI triển khai các API liên quan đến Đầu ra âm thanh ở chế độ không hoạt động.
Trong mục đích của phần này, "cổng đầu ra" là một giao diện vật lý, chẳng hạn như giắc âm thanh 3,5 mm, HDMI hoặc cổng chế độ máy chủ USB có lớp âm thanh USB. Tính năng hỗ trợ đầu ra âm thanh qua các giao thức dựa trên sóng vô tuyến như Bluetooth, WiFi hoặc mạng di động không đủ điều kiện để được coi là "cổng đầu ra".
7.8.2.1. Cổng âm thanh tương tự
Để tương thích với tai nghe và các phụ kiện âm thanh khác sử dụng đầu cắm âm thanh 3,5 mm trên hệ sinh thái Android, nếu việc triển khai thiết bị bao gồm một hoặc nhiều cổng âm thanh tương tự, thì các cổng đó phải:
- [C-SR] Bạn NÊN dùng ít nhất một cổng âm thanh là giắc âm thanh 3,5 mm 4 dây.
Nếu việc triển khai thiết bị có giắc âm thanh 3,5 mm 4 dây, thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ phát âm thanh qua tai nghe nổi và tai nghe nổi có micrô.
- [C-1-2] PHẢI hỗ trợ giắc cắm âm thanh TRRS theo thứ tự chân cắm CTIA.
- [C-1-3] PHẢI hỗ trợ tính năng phát hiện và liên kết với mã phím cho 3 dải trở kháng tương đương sau đây giữa micrô và dây dẫn nối đất trên giắc cắm âm thanh:
-
70 ohm trở xuống:
KEYCODE_HEADSETHOOK
-
210-290 ohm:
KEYCODE_VOLUME_UP
-
360-680 ohm:
KEYCODE_VOLUME_DOWN
-
70 ohm trở xuống:
- [C-1-4] PHẢI kích hoạt
ACTION_HEADSET_PLUG
khi cắm phích cắm, nhưng chỉ sau khi tất cả các tiếp điểm trên phích cắm chạm vào các đoạn tương ứng trên giắc cắm. - [C-1-5] PHẢI có khả năng điều khiển ít nhất 150mV ± 10% điện áp đầu ra trên trở kháng loa 32 ohm.
- [C-1-6] PHẢI có điện áp lệch micrô từ 1,8V đến 2,9V.
- [C-1-7] PHẢI phát hiện và liên kết với mã phím cho phạm vi trở kháng tương đương sau đây giữa micrô và dây dẫn nối đất trên phích cắm âm thanh:
-
110-180 ohm:
KEYCODE_VOICE_ASSIST
-
110-180 ohm:
- [C-SR] Bạn NÊN hỗ trợ các phích cắm âm thanh theo thứ tự chân cắm OMTP.
- [C-SR] Bạn NÊN hỗ trợ tính năng ghi âm từ tai nghe âm thanh nổi có micrô.
Nếu việc triển khai thiết bị có giắc âm thanh 3,5 mm 4 dây và hỗ trợ micrô, đồng thời truyền android.intent.action.HEADSET_PLUG
với micrô giá trị bổ sung được đặt thành 1, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ tính năng phát hiện micrô trên phụ kiện âm thanh đã cắm.
7.8.3. Sóng siêu âm gần
Âm thanh gần siêu âm là băng tần từ 18,5 kHz đến 20 kHz.
Triển khai trên thiết bị:
- PHẢI báo cáo chính xác khả năng hỗ trợ âm thanh gần siêu âm thông qua API AudioManager.getProperty như sau:
Nếu PROPERTY_SUPPORT_MIC_NEAR_ULTRASOUND
là "true", thì nguồn âm thanh VOICE_RECOGNITION
và UNPROCESSED
PHẢI đáp ứng các yêu cầu sau:
- [C-1-1] Độ nhạy trung bình của micrô trong dải tần số từ 18,5 kHz đến 20 kHz PHẢI thấp hơn độ nhạy ở 2 kHz không quá 15 dB.
- [C-1-2] Tỷ lệ tín hiệu/nhiễu không cân bằng của micrô trên 18,5 kHz đến 20 kHz đối với âm tần 19 kHz ở -26 dBFS PHẢI không thấp hơn 50 dB.
Nếu PROPERTY_SUPPORT_SPEAKER_NEAR_ULTRASOUND
là "true":
- [C-2-1] Độ nhạy trung bình của loa trong dải tần số 18,5 kHz – 20 kHz PHẢI thấp hơn độ nhạy ở 2 kHz ít nhất 40 dB.
7.9. Thực tế ảo
Android bao gồm các API và cơ sở để xây dựng các ứng dụng "Thực tế ảo" (VR), bao gồm cả trải nghiệm VR chất lượng cao trên thiết bị di động. Việc triển khai thiết bị PHẢI triển khai đúng cách các API và hành vi này, như được nêu chi tiết trong phần này.
7.9.1. Chế độ thực tế ảo
Android hỗ trợ Chế độ thực tế ảo, một tính năng xử lý việc kết xuất thông báo theo chế độ nổi và vô hiệu hoá các thành phần giao diện người dùng hệ thống đơn mắt trong khi ứng dụng thực tế ảo có tiêu điểm người dùng.
7.9.2. Chế độ thực tế ảo – Hiệu suất cao
Nếu các phương thức triển khai thiết bị hỗ trợ chế độ VR, thì các phương thức đó:
- [C-1-1] PHẢI có ít nhất 2 lõi vật lý.
- [C-1-2] PHẢI khai báo tính năng
android.hardware.vr.high_performance
. - [C-1-3] PHẢI hỗ trợ chế độ hiệu suất cao bền vững.
- [C-1-4] PHẢI hỗ trợ OpenGL ES 3.2.
- [C-1-5] PHẢI hỗ trợ
android.hardware.vulkan.level
0. - PHẢI hỗ trợ
android.hardware.vulkan.level
1 trở lên. - [C-1-6] PHẢI triển khai
EGL_KHR_mutable_render_buffer
,EGL_ANDROID_front_buffer_auto_refresh
,EGL_ANDROID_get_native_client_buffer
,EGL_KHR_fence_sync
,EGL_KHR_wait_sync
,EGL_IMG_context_priority
,EGL_EXT_protected_content
,EGL_EXT_image_gl_colorspace
và hiển thị các tiện ích trong danh sách các tiện ích EGL có sẵn. - [C-1-8] PHẢI triển khai
GL_EXT_multisampled_render_to_texture2
,GL_OVR_multiview
,GL_OVR_multiview2
,GL_OVR_multiview_multisampled_render_to_texture
,GL_EXT_protected_textures
và hiển thị các tiện ích trong danh sách tiện ích GL hiện có. - [C-SR] Bạn NÊN triển khai
GL_EXT_external_buffer
,GL_EXT_EGL_image_array
và hiển thị các tiện ích trong danh sách các tiện ích GL hiện có. - [C-SR] RẤT NÊN hỗ trợ Vulkan 1.1.
- [C-SR] Bạn NÊN triển khai
VK_ANDROID_external_memory_android_hardware_buffer
,VK_GOOGLE_display_timing
,VK_KHR_shared_presentable_image
và hiển thị trong danh sách các tiện ích Vulkan hiện có. - [C-SR] Bạn NÊN hiển thị ít nhất một gia đình hàng đợi Vulkan, trong đó
flags
chứa cảVK_QUEUE_GRAPHICS_BIT
vàVK_QUEUE_COMPUTE_BIT
, đồng thờiqueueCount
phải có ít nhất 2. - [C-1-7] GPU và màn hình PHẢI có thể đồng bộ hoá quyền truy cập vào vùng đệm trước dùng chung để hiển thị nội dung VR ở tốc độ 60 khung hình/giây với hai ngữ cảnh kết xuất mà không có hiện tượng rách hình ảnh.
- [C-1-9] PHẢI triển khai tính năng hỗ trợ cho cờ
AHardwareBuffer
AHARDWAREBUFFER_USAGE_GPU_DATA_BUFFER
,AHARDWAREBUFFER_USAGE_SENSOR_DIRECT_DATA
vàAHARDWAREBUFFER_USAGE_PROTECTED_CONTENT
như mô tả trong NDK. - [C-1-10] PHẢI triển khai tính năng hỗ trợ cho
AHardwareBuffer
bằng bất kỳ tổ hợp nào của cờ sử dụngAHARDWAREBUFFER_USAGE_GPU_COLOR_OUTPUT
,AHARDWAREBUFFER_USAGE_GPU_SAMPLED_IMAGE
,AHARDWAREBUFFER_USAGE_PROTECTED_CONTENT
cho ít nhất các định dạng sau:AHARDWAREBUFFER_FORMAT_R5G6B5_UNORM
,AHARDWAREBUFFER_FORMAT_R8G8B8A8_UNORM
,AHARDWAREBUFFER_FORMAT_R10G10B10A2_UNORM
,AHARDWAREBUFFER_FORMAT_R16G16B16A16_FLOAT
. - [C-SR] Bạn NÊN hỗ trợ việc phân bổ
AHardwareBuffer
có nhiều lớp, cờ và định dạng được chỉ định trong C-1-10. - [C-1-11] PHẢI hỗ trợ giải mã H.264 ở độ phân giải tối thiểu 3840 x 2160 với tốc độ 30 khung hình/giây, được nén ở tốc độ trung bình 40 Mb/giây (tương đương với 4 phiên bản 1920 x 1080 với tốc độ 30 khung hình/giây – 10 Mb/giây hoặc 2 phiên bản 1920 x 1080 với tốc độ 60 khung hình/giây – 20 Mb/giây).
- [C-1-12] PHẢI hỗ trợ HEVC và VP9, PHẢI có khả năng giải mã ít nhất 1920 x 1080 ở tốc độ 30 khung hình/giây được nén ở tốc độ trung bình 10 Mb/giây và NÊN có khả năng giải mã 3840 x 2160 ở tốc độ 30 khung hình/giây-20 Mb/giây (tương đương với 4 phiên bản 1920 x 1080 ở tốc độ 30 khung hình/giây-5 Mb/giây).
- [C-1-13] PHẢI hỗ trợ API
HardwarePropertiesManager.getDeviceTemperatures
và trả về giá trị chính xác cho nhiệt độ trên da. - [C-1-14] PHẢI có màn hình tích hợp và độ phân giải PHẢI tối thiểu là 1920 x 1080.
- [C-SR] NÊN có độ phân giải màn hình tối thiểu là 2560 x 1440.
- [C-1-15] Màn hình PHẢI cập nhật ít nhất 60 Hz khi ở Chế độ thực tế ảo.
- [C-1-17] Màn hình PHẢI hỗ trợ chế độ độ bền thấp với độ bền ≤ 5 mili giây, độ bền được xác định là khoảng thời gian một pixel phát ra ánh sáng.
- [C-1-18] PHẢI hỗ trợ Bluetooth 4.2 và Bluetooth LE Data Length Extension mục 7.4.3.
- [C-1-19] PHẢI hỗ trợ và báo cáo đúng cách Loại kênh trực tiếp cho tất cả các loại cảm biến mặc định sau:
-
TYPE_ACCELEROMETER
-
TYPE_ACCELEROMETER_UNCALIBRATED
-
TYPE_GYROSCOPE
-
TYPE_GYROSCOPE_UNCALIBRATED
-
TYPE_MAGNETIC_FIELD
-
TYPE_MAGNETIC_FIELD_UNCALIBRATED
-
- [C-SR] Bạn NÊN hỗ trợ loại kênh trực tiếp
TYPE_HARDWARE_BUFFER
cho tất cả các loại kênh trực tiếp được liệt kê ở trên. - [C-1-21] PHẢI đáp ứng các yêu cầu liên quan đến con quay hồi chuyển, gia tốc kế và từ kế cho
android.hardware.hifi_sensors
, như được chỉ định trong mục 7.3.9. - [C-SR] NÊN hỗ trợ tính năng
android.hardware.sensor.hifi_sensors
. - [C-1-22] PHẢI có độ trễ chuyển động từ đầu đến cuối đến photon không cao hơn 28 mili giây.
- [C-SR] Bạn NÊN có độ trễ chuyển động đến photon toàn diện không cao hơn 20 mili giây.
- [C-1-23] PHẢI có tỷ lệ khung hình đầu tiên, tức là tỷ lệ giữa độ sáng của các pixel trên khung hình đầu tiên sau khi chuyển đổi từ màu đen sang màu trắng và độ sáng của các pixel màu trắng ở trạng thái ổn định, ít nhất là 85%.
- [C-SR] NÊN có tỷ lệ khung hình đầu tiên ít nhất là 90%.
- CÓ THỂ cung cấp một lõi dành riêng cho ứng dụng trên nền trước và CÓ THỂ hỗ trợ API
Process.getExclusiveCores
để trả về số lượng lõi CPU dành riêng cho ứng dụng trên nền trước hàng đầu.
Nếu lõi độc quyền được hỗ trợ, thì lõi đó:
- [C-2-1] PHẢI không cho phép bất kỳ quy trình không gian người dùng nào khác chạy trên đó (ngoại trừ trình điều khiển thiết bị mà ứng dụng sử dụng), nhưng CÓ THỂ cho phép một số quy trình hạt nhân chạy khi cần.
8. Hiệu suất và nguồn điện
Một số tiêu chí về hiệu suất và công suất tối thiểu rất quan trọng đối với trải nghiệm người dùng và ảnh hưởng đến các giả định cơ sở mà nhà phát triển sẽ có khi phát triển ứng dụng.
8.1. Tính nhất quán của trải nghiệm người dùng
Người dùng cuối có thể được cung cấp giao diện người dùng mượt mà nếu có một số yêu cầu tối thiểu nhất định để đảm bảo tốc độ khung hình và thời gian phản hồi nhất quán cho các ứng dụng và trò chơi. Việc triển khai thiết bị, tuỳ thuộc vào loại thiết bị, CÓ THỂ có các yêu cầu có thể đo lường được đối với độ trễ giao diện người dùng và việc chuyển đổi tác vụ như mô tả trong mục 2.
8.2. Hiệu suất truy cập I/O tệp
Việc cung cấp một đường cơ sở chung cho hiệu suất truy cập tệp nhất quán trên bộ nhớ dữ liệu riêng tư của ứng dụng (phân vùng /data
) cho phép nhà phát triển ứng dụng đặt ra kỳ vọng phù hợp để giúp thiết kế phần mềm của họ. Việc triển khai thiết bị, tuỳ thuộc vào loại thiết bị, CÓ THỂ có một số yêu cầu nhất định được mô tả trong phần 2 đối với các thao tác đọc và ghi sau:
- Hiệu suất ghi tuần tự. Đo lường bằng cách ghi một tệp 256 MB bằng vùng đệm ghi 10 MB.
- Hiệu suất ghi ngẫu nhiên. Đo lường bằng cách ghi một tệp 256 MB bằng vùng đệm ghi 4 KB.
- Hiệu suất đọc tuần tự. Đo lường bằng cách đọc tệp 256 MB bằng vùng đệm ghi 10 MB.
- Hiệu suất đọc ngẫu nhiên. Đo lường bằng cách đọc tệp 256 MB bằng vùng đệm ghi 4 KB.
8.3. Chế độ tiết kiệm pin
Nếu việc triển khai thiết bị bao gồm các tính năng để cải thiện khả năng quản lý nguồn điện của thiết bị có trong AOSP hoặc mở rộng các tính năng có trong AOSP, thì các tính năng đó:
- [C-1-1] KHÔNG ĐƯỢC sai khác với cách triển khai AOSP đối với các thuật toán kích hoạt, bảo trì, đánh thức và sử dụng chế độ cài đặt hệ thống chung của chế độ Trạng thái chờ ứng dụng và chế độ tiết kiệm pin Ngủ.
- [C-1-2] KHÔNG ĐƯỢC sai khác với cách triển khai AOSP để sử dụng chế độ cài đặt chung nhằm quản lý việc điều tiết công việc, chuông báo và mạng cho các ứng dụng trong mỗi bộ chứa cho chế độ Chờ ứng dụng.
- [C-1-3] KHÔNG ĐƯỢC khác với cách triển khai AOSP về số lượng Nhóm chế độ chờ ứng dụng dùng cho Chế độ chờ ứng dụng.
- [C-1-4] PHẢI triển khai Bộ chứa chế độ chờ ứng dụng và Chế độ nghỉ như mô tả trong phần Quản lý nguồn.
- [C-1-5] PHẢI trả về
true
choPowerManager.isPowerSaveMode()
khi thiết bị ở chế độ tiết kiệm pin. - [C-SR] NÊN cung cấp cho người dùng khả năng bật và tắt tính năng tiết kiệm pin.
- [C-SR] Bạn NÊN cung cấp cho người dùng khả năng hiển thị tất cả Ứng dụng được miễn trừ khỏi chế độ Chờ ứng dụng và Chế độ nghỉ tiết kiệm pin.
Ngoài các chế độ tiết kiệm pin, việc triển khai thiết bị Android CÓ THỂ triển khai bất kỳ hoặc tất cả 4 trạng thái tiết kiệm pin theo định nghĩa của Giao diện cấu hình và nguồn điện nâng cao (ACPI).
Nếu quá trình triển khai thiết bị triển khai các trạng thái nguồn S4 như được xác định bởi ACPI, thì các trạng thái đó:
- [C-1-1] PHẢI chỉ chuyển sang trạng thái này sau khi người dùng thực hiện một hành động rõ ràng để đưa thiết bị vào trạng thái không hoạt động (ví dụ: bằng cách đóng nắp là một phần vật lý của thiết bị hoặc tắt xe hoặc tivi) và trước khi người dùng kích hoạt lại thiết bị (ví dụ: bằng cách mở nắp hoặc bật lại xe hoặc tivi).
Nếu quá trình triển khai thiết bị triển khai các trạng thái nguồn S3 theo định nghĩa của ACPI, thì các trạng thái đó:
-
[C-2-1] PHẢI đáp ứng C-1-1 ở trên, hoặc PHẢI chỉ chuyển sang trạng thái S3 khi các ứng dụng bên thứ ba không cần tài nguyên hệ thống (ví dụ: màn hình, CPU).
Ngược lại, PHẢI thoát khỏi trạng thái S3 khi các ứng dụng bên thứ ba cần tài nguyên hệ thống, như mô tả trên SDK này.
Ví dụ: trong khi các ứng dụng bên thứ ba yêu cầu giữ màn hình bật thông qua
FLAG_KEEP_SCREEN_ON
hoặc giữ CPU chạy thông quaPARTIAL_WAKE_LOCK
, thiết bị KHÔNG ĐƯỢC chuyển sang trạng thái S3, trừ phi như mô tả trong C-1-1, người dùng đã thực hiện hành động rõ ràng để đưa thiết bị vào trạng thái không hoạt động. Ngược lại, tại thời điểm một tác vụ mà các ứng dụng bên thứ ba triển khai thông qua JobScheduler được kích hoạt hoặc Firebase Cloud Messaging được phân phối đến các ứng dụng bên thứ ba, thiết bị PHẢI thoát khỏi trạng thái S3 trừ phi người dùng đã đặt thiết bị ở trạng thái không hoạt động. Đây không phải là ví dụ toàn diện và AOSP triển khai các tín hiệu đánh thức mở rộng để kích hoạt chế độ đánh thức từ trạng thái này.
8.4. Kế toán mức tiêu thụ điện năng
Việc tính toán và báo cáo chính xác hơn về mức tiêu thụ điện năng sẽ cung cấp cho nhà phát triển ứng dụng cả các biện pháp khuyến khích và công cụ để tối ưu hoá kiểu sử dụng điện năng của ứng dụng.
Triển khai trên thiết bị:
- [SR] BẠN NÊN cung cấp hồ sơ năng lượng cho mỗi thành phần xác định giá trị tiêu thụ hiện tại cho mỗi thành phần phần cứng và mức hao pin gần đúng do các thành phần gây ra theo thời gian như được ghi nhận trong trang web Dự án nguồn mở Android.
- [SR] BẠN NÊN báo cáo tất cả giá trị tiêu thụ năng lượng theo đơn vị milliampe giờ (mAh).
- [SR] NÊN báo cáo mức tiêu thụ điện năng của CPU theo UID của mỗi quy trình. Dự án nguồn mở Android đáp ứng yêu cầu này thông qua việc triển khai mô-đun hạt nhân
uid_cputime
. - [SR] NÊN cung cấp mức sử dụng năng lượng này cho nhà phát triển ứng dụng thông qua lệnh shell
adb shell dumpsys batterystats
. - NÊN được phân bổ cho chính thành phần phần cứng nếu không thể phân bổ mức sử dụng năng lượng của thành phần phần cứng cho một ứng dụng.
8.5. Hiệu suất nhất quán
Hiệu suất có thể biến động mạnh đối với các ứng dụng chạy trong thời gian dài và có hiệu suất cao, do các ứng dụng khác chạy ở chế độ nền hoặc do CPU điều tiết do giới hạn nhiệt độ. Android bao gồm các giao diện lập trình để khi thiết bị có khả năng, ứng dụng trên cùng ở chế độ nền trước có thể yêu cầu hệ thống tối ưu hoá việc phân bổ tài nguyên để giải quyết những biến động như vậy.
Triển khai trên thiết bị:
-
[C-0-1] PHẢI báo cáo chính xác việc hỗ trợ Chế độ hiệu suất cao bền vững thông qua phương thức API
PowerManager.isSustainedPerformanceModeSupported()
. -
PHẢI hỗ trợ Chế độ hiệu suất cao bền vững.
Nếu việc triển khai thiết bị báo cáo hỗ trợ Chế độ hiệu suất cao bền vững, thì các thiết bị đó:
- [C-1-1] PHẢI cung cấp cho ứng dụng trên cùng ở chế độ nền trước một mức hiệu suất nhất quán trong ít nhất 30 phút khi ứng dụng yêu cầu.
- [C-1-2] PHẢI tuân thủ API
Window.setSustainedPerformanceMode()
và các API liên quan khác.
Nếu quá trình triển khai thiết bị bao gồm hai hoặc nhiều lõi CPU, thì các lõi đó:
- NÊN cung cấp ít nhất một lõi độc quyền mà ứng dụng trên cùng ở nền trước có thể đặt trước.
Nếu việc triển khai thiết bị hỗ trợ việc đặt trước một lõi dành riêng cho ứng dụng trên nền trước hàng đầu, thì các thiết bị đó:
- [C-2-1] PHẢI báo cáo thông qua phương thức API
Process.getExclusiveCores()
số nhận dạng của các nhân độc quyền mà ứng dụng trên nền trước hàng đầu có thể đặt trước. - [C-2-2] PHẢI không cho phép bất kỳ quy trình không gian người dùng nào (ngoại trừ trình điều khiển thiết bị mà ứng dụng sử dụng) chạy trên các nhân độc quyền, nhưng CÓ THỂ cho phép một số quy trình hạt nhân chạy khi cần.
Nếu việc triển khai thiết bị không hỗ trợ lõi độc quyền, thì các thiết bị đó:
- [C-3-1] PHẢI trả về danh sách trống thông qua phương thức API
Process.getExclusiveCores()
.
9. Khả năng tương thích của mô hình bảo mật
Triển khai trên thiết bị:
-
[C-0-1] PHẢI triển khai mô hình bảo mật nhất quán với mô hình bảo mật của nền tảng Android như được xác định trong tài liệu tham khảo về Quyền và bảo mật trong các API trong tài liệu dành cho nhà phát triển Android.
-
[C-0-2] PHẢI hỗ trợ cài đặt các ứng dụng tự ký mà không yêu cầu thêm bất kỳ quyền/chứng chỉ nào của bên thứ ba/cơ quan nào. Cụ thể, các thiết bị tương thích PHẢI hỗ trợ các cơ chế bảo mật được mô tả trong các tiểu mục sau.
9.1. Quyền
Triển khai trên thiết bị:
-
[C-0-1] PHẢI hỗ trợ mô hình quyền trên Android như được xác định trong tài liệu dành cho nhà phát triển Android. Cụ thể, các ứng dụng này PHẢI thực thi từng quyền được xác định như mô tả trong tài liệu SDK; không được bỏ qua, thay đổi hoặc bỏ qua bất kỳ quyền nào.
-
CÓ THỂ thêm các quyền khác, miễn là chuỗi mã nhận dạng quyền mới không nằm trong không gian tên
android.\*
. -
[C-0-2] Quyền có
protectionLevel
làPROTECTION_FLAG_PRIVILEGED
CHỈ ĐƯỢC cấp cho các ứng dụng được cài đặt sẵn trong(các) đường dẫn đặc quyền của hình ảnh hệ thống và trong tập hợp con của các quyền được liệt kê trong danh sách cho phép rõ ràng cho mỗi ứng dụng. Việc triển khai AOSP đáp ứng yêu cầu này bằng cách đọc và tuân thủ các quyền được liệt kê trong danh sách cho phép cho mỗi ứng dụng từ các tệp trong đường dẫnetc/permissions/
và sử dụng đường dẫnsystem/priv-app
làm đường dẫn đặc quyền.
Các quyền có mức độ bảo vệ nguy hiểm là quyền khi bắt đầu chạy. Các ứng dụng có targetSdkVersion
> 22 sẽ yêu cầu các quyền này trong thời gian chạy.
Triển khai trên thiết bị:
- [C-0-3] PHẢI hiển thị một giao diện chuyên dụng để người dùng quyết định có cấp các quyền khi bắt đầu chạy được yêu cầu hay không, đồng thời cung cấp một giao diện để người dùng quản lý các quyền khi bắt đầu chạy.
- [C-0-4] PHẢI có một và chỉ một phương thức triển khai cả hai giao diện người dùng.
- [C-0-5] KHÔNG ĐƯỢC cấp bất kỳ quyền nào trong thời gian chạy cho các ứng dụng được cài đặt sẵn, trừ phi:
- Bạn có thể lấy sự đồng ý của người dùng trước khi ứng dụng sử dụng dữ liệu đó.
- Các quyền khi bắt đầu chạy được liên kết với một mẫu ý định mà ứng dụng được cài đặt sẵn được đặt làm trình xử lý mặc định.
- [C-0-6] PHẢI chỉ cấp quyền
android.permission.RECOVER_KEYSTORE
cho các ứng dụng hệ thống đăng ký một Tác nhân khôi phục được bảo mật đúng cách. Tác nhân khôi phục được bảo mật đúng cách được xác định là một tác nhân phần mềm trên thiết bị đồng bộ hoá với bộ nhớ từ xa ngoài thiết bị, được trang bị phần cứng bảo mật có khả năng bảo vệ tương đương hoặc mạnh hơn so với nội dung mô tả trong Dịch vụ Google Cloud Key Vault để ngăn chặn các cuộc tấn công bằng phương thức brute-force (tấn công bằng cách thử mọi mật khẩu có thể) vào yếu tố tri thức trên màn hình khoá.
Nếu việc triển khai thiết bị bao gồm một ứng dụng được cài đặt sẵn hoặc muốn cho phép ứng dụng bên thứ ba truy cập vào số liệu thống kê về mức sử dụng, thì thiết bị đó:
- [SR] NÊN cung cấp cơ chế mà người dùng có thể truy cập để cấp hoặc thu hồi quyền truy cập vào số liệu thống kê về mức sử dụng nhằm phản hồi ý định
android.settings.ACTION_USAGE_ACCESS_SETTINGS
cho các ứng dụng khai báo quyềnandroid.permission.PACKAGE_USAGE_STATS
.
Nếu việc triển khai thiết bị có ý định không cho phép bất kỳ ứng dụng nào (bao gồm cả ứng dụng cài đặt sẵn) truy cập vào số liệu thống kê về mức sử dụng, thì các thiết bị đó:
- [C-1-1] VẪN PHẢI có một hoạt động xử lý mẫu ý định
android.settings.ACTION_USAGE_ACCESS_SETTINGS
nhưng PHẢI triển khai hoạt động đó dưới dạng không hoạt động, tức là có hành vi tương đương như khi người dùng bị từ chối quyền truy cập.
9.2. UID và cách ly quy trình
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ mô hình hộp cát ứng dụng Android, trong đó mỗi ứng dụng chạy dưới dạng một UID kiểu Unix duy nhất và trong một quy trình riêng biệt.
- [C-0-2] PHẢI hỗ trợ chạy nhiều ứng dụng dưới cùng một mã nhận dạng người dùng Linux, miễn là các ứng dụng đó được ký và tạo đúng cách, như được xác định trong Tài liệu tham khảo về bảo mật và quyền.
9.3. Quyền đối với hệ thống tệp
Triển khai trên thiết bị:
- [C-0-1] PHẢI hỗ trợ mô hình quyền truy cập tệp Android như được xác định trong Tài liệu tham khảo về bảo mật và quyền.
9.4. Môi trường thực thi thay thế
Việc triển khai thiết bị PHẢI duy trì tính nhất quán của mô hình bảo mật và quyền của Android, ngay cả khi các thiết bị đó bao gồm các môi trường thời gian chạy thực thi ứng dụng bằng một số phần mềm hoặc công nghệ khác ngoài Định dạng thực thi Dalvik hoặc mã gốc. Hay nói cách khác:
-
[C-0-1] Môi trường thời gian chạy thay thế PHẢI là ứng dụng Android và tuân thủ mô hình bảo mật Android tiêu chuẩn, như mô tả ở nơi khác trong mục 9.
-
[C-0-2] KHÔNG ĐƯỢC cấp quyền truy cập vào các tài nguyên được bảo vệ bằng các quyền không được yêu cầu trong tệp
AndroidManifest.xml
của môi trường thời gian chạy thông qua cơ chế <uses-permission
>. -
[C-0-3] Môi trường thời gian chạy thay thế KHÔNG ĐƯỢC cho phép các ứng dụng sử dụng các tính năng được bảo vệ bằng các quyền của Android chỉ dành cho ứng dụng hệ thống.
-
[C-0-4] Mô hình hộp cát Android và các ứng dụng đã cài đặt sử dụng môi trường thời gian chạy thay thế PHẢI tuân thủ mô hình hộp cát Android và KHÔNG ĐƯỢC sử dụng lại hộp cát của bất kỳ ứng dụng nào khác đã cài đặt trên thiết bị, ngoại trừ thông qua các cơ chế tiêu chuẩn của Android về mã nhận dạng người dùng dùng chung và chứng chỉ ký.
-
[C-0-5] Môi trường thời gian chạy thay thế KHÔNG ĐƯỢC chạy bằng, cấp hoặc được cấp quyền truy cập vào hộp cát tương ứng với các ứng dụng Android khác.
-
[C-0-6] KHÔNG được chạy môi trường thời gian chạy thay thế bằng, cấp hoặc cấp cho các ứng dụng khác bất kỳ đặc quyền nào của người dùng cấp cao (gốc) hoặc của bất kỳ mã nhận dạng người dùng nào khác.
-
[C-0-7] Khi các tệp
.apk
của môi trường thời gian chạy thay thế được đưa vào hình ảnh hệ thống của quá trình triển khai thiết bị, tệp đó PHẢI được ký bằng một khoá khác với khoá dùng để ký các ứng dụng khác đi kèm với quá trình triển khai thiết bị. -
[C-0-8] Khi cài đặt ứng dụng, môi trường thời gian chạy thay thế PHẢI có được sự đồng ý của người dùng đối với các quyền trên Android mà ứng dụng sử dụng.
-
[C-0-9] Khi một ứng dụng cần sử dụng tài nguyên thiết bị có quyền tương ứng trên Android (chẳng hạn như Máy ảnh, GPS, v.v.), môi trường thời gian chạy thay thế PHẢI thông báo cho người dùng rằng ứng dụng sẽ có thể truy cập vào tài nguyên đó.
-
[C-0-10] Khi môi trường thời gian chạy không ghi lại các chức năng của ứng dụng theo cách này, môi trường thời gian chạy PHẢI liệt kê tất cả các quyền mà chính môi trường thời gian chạy nắm giữ khi cài đặt bất kỳ ứng dụng nào sử dụng môi trường thời gian chạy đó.
-
Thời gian chạy thay thế NÊN cài đặt ứng dụng thông qua
PackageManager
vào các hộp cát Android riêng biệt (mã nhận dạng người dùng Linux, v.v.). -
Môi trường thời gian chạy thay thế CÓ THỂ cung cấp một hộp cát Android duy nhất do tất cả ứng dụng sử dụng môi trường thời gian chạy thay thế chia sẻ.
9.5. Hỗ trợ nhiều người dùng
Android có tính năng hỗ trợ nhiều người dùng và hỗ trợ tách biệt hoàn toàn người dùng.
- Việc triển khai thiết bị CÓ THỂ nhưng KHÔNG NÊN cho phép nhiều người dùng nếu họ sử dụng phương tiện có thể tháo rời làm bộ nhớ ngoài chính.
Nếu việc triển khai thiết bị bao gồm nhiều người dùng, thì họ:
- [C-1-1] PHẢI đáp ứng các yêu cầu sau đây liên quan đến việc hỗ trợ nhiều người dùng.
- [C-1-2] BẮT BUỘC triển khai mô hình bảo mật nhất quán với mô hình bảo mật của nền tảng Android cho mỗi người dùng như được xác định trong tài liệu tham khảo về Quyền và bảo mật trong API.
- [C-1-3] PHẢI có các thư mục bộ nhớ ứng dụng dùng chung (còn gọi là
/sdcard
) riêng biệt và tách biệt cho mỗi phiên bản người dùng. - [C-1-4] PHẢI đảm bảo rằng các ứng dụng do một người dùng cụ thể sở hữu và chạy thay mặt cho người dùng đó không thể liệt kê, đọc hoặc ghi vào các tệp do người dùng khác sở hữu, ngay cả khi dữ liệu của cả hai người dùng được lưu trữ trên cùng một phương tiện hoặc hệ thống tệp.
- [C-1-5] PHẢI mã hoá nội dung của thẻ SD khi bật chế độ nhiều người dùng bằng cách sử dụng khoá chỉ được lưu trữ trên phương tiện không thể tháo rời mà chỉ hệ thống mới có thể truy cập nếu việc triển khai thiết bị sử dụng phương tiện có thể tháo rời cho các API bộ nhớ ngoài. Vì điều này sẽ khiến máy tính lưu trữ không đọc được nội dung nghe nhìn, nên việc triển khai thiết bị sẽ yêu cầu chuyển sang MTP hoặc một hệ thống tương tự để cấp cho máy tính lưu trữ quyền truy cập vào dữ liệu của người dùng hiện tại.
Nếu việc triển khai thiết bị bao gồm nhiều người dùng và không khai báo cờ tính năng android.hardware.telephony
, thì các thiết bị đó:
- [C-2-1] PHẢI hỗ trợ hồ sơ bị hạn chế, một tính năng cho phép chủ sở hữu thiết bị quản lý người dùng khác và các quyền của họ trên thiết bị. Với hồ sơ bị hạn chế, chủ sở hữu thiết bị có thể nhanh chóng thiết lập các môi trường riêng biệt để người dùng khác làm việc, đồng thời có thể quản lý các quy định hạn chế chi tiết hơn trong các ứng dụng có trong những môi trường đó.
Nếu việc triển khai thiết bị bao gồm nhiều người dùng và khai báo cờ tính năng android.hardware.telephony
, thì các thiết bị đó:
- [C-3-1] KHÔNG ĐƯỢC hỗ trợ hồ sơ bị hạn chế nhưng PHẢI tuân thủ cách triển khai các chế độ kiểm soát của AOSP để cho phép /tắt người dùng khác truy cập vào cuộc gọi thoại và tin nhắn SMS.
9.6. Cảnh báo về tin nhắn dịch vụ
Android hỗ trợ cảnh báo người dùng về mọi tin nhắn SMS đặc biệt gửi đi. Tin nhắn SMS cao cấp là tin nhắn văn bản được gửi đến một dịch vụ đã đăng ký với nhà mạng và có thể tính phí người dùng.
Nếu các hoạt động triển khai thiết bị khai báo hỗ trợ android.hardware.telephony
, thì các hoạt động đó:
- [C-1-1] PHẢI cảnh báo người dùng trước khi gửi tin nhắn SMS đến các số được xác định bằng biểu thức chính quy được xác định trong tệp
/data/misc/sms/codes.xml
trên thiết bị. Dự án nguồn mở Android cấp trên cung cấp phương thức triển khai đáp ứng yêu cầu này.
9.7. Tính năng bảo mật
Việc triển khai thiết bị PHẢI đảm bảo tuân thủ các tính năng bảo mật trong cả nhân và nền tảng như mô tả dưới đây.
Hộp cát Android bao gồm các tính năng sử dụng hệ thống kiểm soát truy cập bắt buộc (MAC) của Security-Enhanced Linux (SELinux), hộp cát seccomp và các tính năng bảo mật khác trong hạt nhân Linux. Triển khai trên thiết bị:
- [C-0-1] PHẢI duy trì khả năng tương thích với các ứng dụng hiện có, ngay cả khi SELinux hoặc bất kỳ tính năng bảo mật nào khác được triển khai bên dưới khung Android.
- [C-0-2] KHÔNG ĐƯỢC có giao diện người dùng hiển thị khi một lỗi vi phạm bảo mật được phát hiện và bị tính năng bảo mật triển khai bên dưới khung Android chặn thành công, nhưng CÓ THỂ có giao diện người dùng hiển thị khi một lỗi vi phạm bảo mật chưa bị chặn xảy ra dẫn đến việc khai thác thành công.
- [C-0-3] KHÔNG ĐƯỢC cho phép người dùng hoặc nhà phát triển ứng dụng định cấu hình SELinux hoặc bất kỳ tính năng bảo mật nào khác được triển khai bên dưới khung Android.
- [C-0-4] KHÔNG ĐƯỢC cho phép một ứng dụng có thể ảnh hưởng đến một ứng dụng khác thông qua API (chẳng hạn như API Quản trị thiết bị) để định cấu hình một chính sách làm hỏng khả năng tương thích.
- [C-0-5] PHẢI chia khung nội dung nghe nhìn thành nhiều quy trình để có thể cấp quyền truy cập cho từng quy trình theo cách hẹp hơn như mô tả trên trang web Dự án nguồn mở Android.
- [C-0-6] PHẢI triển khai cơ chế hộp cát cho ứng dụng hạt nhân cho phép lọc các lệnh gọi hệ thống bằng chính sách có thể định cấu hình từ các chương trình đa luồng. Dự án nguồn mở Android ngược dòng đáp ứng yêu cầu này thông qua việc bật seccomp-BPF với tính năng đồng bộ hoá nhóm luồng (TSYNC) như mô tả trong phần Cấu hình hạt nhân của source.android.com.
Tính toàn vẹn của hạt nhân và các tính năng tự bảo vệ là yếu tố không thể thiếu trong tính bảo mật của Android. Triển khai trên thiết bị:
- [C-0-7] PHẢI triển khai biện pháp bảo vệ chống tràn bộ đệm ngăn xếp nhân (ví dụ:
CONFIG_CC_STACKPROTECTOR_STRONG
). - [C-0-8] PHẢI triển khai các biện pháp bảo vệ bộ nhớ hạt nhân nghiêm ngặt, trong đó mã có thể thực thi chỉ có thể đọc, dữ liệu chỉ có thể đọc không thể thực thi và không thể ghi, còn dữ liệu có thể ghi không thể thực thi (ví dụ:
CONFIG_DEBUG_RODATA
hoặcCONFIG_STRICT_KERNEL_RWX
). - [C-0-9] PHẢI triển khai tính năng kiểm tra giới hạn kích thước đối tượng tĩnh và động của các bản sao giữa không gian người dùng và không gian hạt nhân (ví dụ:
CONFIG_HARDENED_USERCOPY
) trên các thiết bị ban đầu được vận chuyển bằng API cấp 28 trở lên. - [C-0-10] KHÔNG ĐƯỢC thực thi bộ nhớ không gian người dùng khi thực thi ở chế độ hạt nhân (ví dụ: PXN phần cứng hoặc được mô phỏng qua
CONFIG_CPU_SW_DOMAIN_PAN
hoặcCONFIG_ARM64_SW_TTBR0_PAN
) trên các thiết bị ban đầu được vận chuyển bằng API cấp 28 trở lên. - [C-0-11] KHÔNG ĐƯỢC đọc hoặc ghi bộ nhớ không gian người dùng trong hạt nhân bên ngoài các API truy cập usercopy thông thường (ví dụ: PAN phần cứng hoặc được mô phỏng thông qua
CONFIG_CPU_SW_DOMAIN_PAN
hoặcCONFIG_ARM64_SW_TTBR0_PAN
) trên các thiết bị ban đầu được vận chuyển bằng API cấp 28 trở lên. - [C-0-12] PHẢI triển khai tính năng tách biệt bảng trang hạt nhân trên tất cả thiết bị ban đầu được vận chuyển với API cấp 28 trở lên (ví dụ:
CONFIG_PAGE_TABLE_ISOLATION
hoặc `CONFIG_UNMAP_KERNEL_AT_EL0). - [SR] NÊN giữ dữ liệu hạt nhân chỉ được ghi trong quá trình khởi chạy và đánh dấu là chỉ có thể đọc sau khi khởi chạy (ví dụ:
__ro_after_init
). - [SR] NÊN TUYỆT ĐỐI tạo bố cục ngẫu nhiên cho mã nhân và bộ nhớ, đồng thời tránh các trường hợp rò rỉ có thể làm hỏng tính ngẫu nhiên (ví dụ:
CONFIG_RANDOMIZE_BASE
với entropy của trình tải khởi động thông qua/chosen/kaslr-seed Device Tree node
hoặcEFI_RNG_PROTOCOL
).
Nếu quá trình triển khai thiết bị sử dụng nhân hệ điều hành Linux, thì các thiết bị đó:
- [C-1-1] PHẢI triển khai SELinux.
- [C-1-2] PHẢI đặt SELinux thành chế độ thực thi toàn cục.
- [C-1-3] PHẢI định cấu hình tất cả miền ở chế độ thực thi. Không được phép sử dụng miền ở chế độ cho phép, bao gồm cả miền dành riêng cho một thiết bị/nhà cung cấp.
- [C-1-4] KHÔNG ĐƯỢC sửa đổi, bỏ qua hoặc thay thế các quy tắc neverallow có trong thư mục system/sepolicy được cung cấp trong Dự án nguồn mở Android (AOSP) ngược dòng và chính sách PHẢI biên dịch với tất cả các quy tắc neverallow hiện có, cho cả miền AOSP SELinux cũng như miền dành riêng cho thiết bị/nhà cung cấp.
- [C-1-5] PHẢI chạy các ứng dụng bên thứ ba nhắm đến API cấp 28 trở lên trong hộp cát SELinux cho mỗi ứng dụng với các quy định hạn chế SELinux cho mỗi ứng dụng trên thư mục dữ liệu riêng tư của mỗi ứng dụng.
- NÊN giữ lại chính sách SELinux mặc định được cung cấp trong thư mục system/sepolicy của Dự án nguồn mở Android ngược dòng và chỉ thêm vào chính sách này cho cấu hình dành riêng cho thiết bị của họ.
Nếu việc triển khai thiết bị đã được triển khai trên một phiên bản Android cũ và không thể đáp ứng các yêu cầu [C-1-1] và [C-1-5] thông qua bản cập nhật phần mềm hệ thống, thì các yêu cầu này CÓ THỂ được miễn trừ.
Nếu quá trình triển khai thiết bị sử dụng nhân hệ điều hành không phải Linux, thì các thiết bị đó:
- [C-2-1] PHẢI sử dụng hệ thống kiểm soát quyền truy cập bắt buộc tương đương với SELinux.
Android chứa nhiều tính năng phòng thủ chuyên sâu, là yếu tố không thể thiếu trong việc bảo mật thiết bị.
Triển khai trên thiết bị:
- [C-SR] KHUYẾN CÁO KHÔNG nên tắt tính năng Kiểm soát tính toàn vẹn của luồng (CFI) hoặc Xoá lỗi tràn số nguyên (IntSan) trên các thành phần đã bật tính năng này.
- [C-SR] NÊN bật cả CFI và IntSan cho mọi thành phần không gian người dùng nhạy cảm về bảo mật khác như giải thích trong CFI và IntSan.
9.8. Quyền riêng tư
9.8.1. Nhật ký sử dụng
Android lưu trữ nhật ký lựa chọn của người dùng và quản lý nhật ký đó bằng UsageStatsManager.
Triển khai trên thiết bị:
- [C-0-1] PHẢI giữ lại nhật ký hoạt động của người dùng đó trong một khoảng thời gian hợp lý.
- [SR] Bạn NÊN giữ nguyên khoảng thời gian lưu giữ 14 ngày được định cấu hình theo mặc định trong quá trình triển khai AOSP.
Android lưu trữ các sự kiện hệ thống bằng cách sử dụng giá trị nhận dạng StatsLog
và quản lý nhật ký đó thông qua StatsManager
và API Hệ thống IncidentManager
.
Triển khai trên thiết bị:
- [C-0-2] BẮT BUỘC chỉ bao gồm các trường được đánh dấu bằng
DEST_AUTOMATIC
trong báo cáo sự cố do lớp API hệ thốngIncidentManager
tạo. - [C-0-3] KHÔNG ĐƯỢC sử dụng giá trị nhận dạng sự kiện hệ thống để ghi nhật ký bất kỳ sự kiện nào khác ngoài những sự kiện được mô tả trong tài liệu SDK
StatsLog
. Nếu các sự kiện hệ thống bổ sung được ghi lại, thì các sự kiện đó CÓ THỂ sử dụng một giá trị nhận dạng nguyên tử khác trong khoảng từ 100.000 đến 200.000.
9.8.2. Đang ghi âm
Triển khai trên thiết bị:
- [C-0-1] KHÔNG ĐƯỢC tải trước hoặc phân phối các thành phần phần mềm gốc có chức năng gửi thông tin cá nhân của người dùng (ví dụ: thao tác nhấn phím, văn bản hiển thị trên màn hình) ra khỏi thiết bị mà không có sự đồng ý của người dùng hoặc thông báo rõ ràng đang diễn ra.
Nếu quá trình triển khai thiết bị bao gồm chức năng trong hệ thống để ghi lại nội dung hiển thị trên màn hình và/hoặc ghi lại luồng âm thanh phát trên thiết bị, thì các chức năng đó:
- [C-1-1] PHẢI có thông báo liên tục cho người dùng bất cứ khi nào chức năng này được bật và đang chủ động chụp/ghi lại.
Nếu quá trình triển khai thiết bị bao gồm một thành phần được bật sẵn, có thể ghi âm thanh môi trường xung quanh để suy luận thông tin hữu ích về ngữ cảnh của người dùng, thì các thiết bị đó:
- [C-2-1] KHÔNG ĐƯỢC lưu trữ trong bộ nhớ cố định trên thiết bị hoặc truyền ra khỏi thiết bị âm thanh thô đã ghi hoặc bất kỳ định dạng nào có thể chuyển đổi trở lại thành âm thanh gốc hoặc gần giống với bản sao, trừ khi có sự đồng ý rõ ràng của người dùng.
9.8.3. Khả năng kết nối
Nếu việc triển khai thiết bị có cổng USB hỗ trợ chế độ thiết bị ngoại vi USB, thì các thiết bị đó:
- [C-1-1] PHẢI hiển thị giao diện người dùng yêu cầu người dùng đồng ý trước khi cho phép truy cập vào nội dung của bộ nhớ dùng chung qua cổng USB.
9.8.4. Lưu lượng truy cập mạng
Triển khai trên thiết bị:
- [C-0-1] PHẢI cài đặt trước cùng một chứng chỉ gốc cho kho Tổ chức phát hành chứng chỉ (CA) đáng tin cậy của hệ thống như được cung cấp trong Dự án nguồn mở Android ngược dòng.
- [C-0-2] PHẢI vận chuyển với kho CA gốc của người dùng trống.
- [C-0-3] PHẢI hiển thị cảnh báo cho người dùng cho biết lưu lượng truy cập mạng có thể được theo dõi khi thêm CA gốc của người dùng.
Nếu lưu lượng truy cập của thiết bị được định tuyến thông qua VPN, thì việc triển khai thiết bị sẽ:
- [C-1-1] PHẢI hiển thị cảnh báo cho người dùng cho biết:
- Lưu lượng truy cập mạng đó có thể được giám sát.
- Lưu lượng truy cập mạng đó đang được định tuyến thông qua ứng dụng VPN cụ thể cung cấp VPN.
Nếu việc triển khai thiết bị có một cơ chế, được bật sẵn theo mặc định, giúp định tuyến lưu lượng truy cập dữ liệu mạng thông qua máy chủ proxy hoặc cổng VPN (ví dụ: tải trước dịch vụ VPN đã cấp android.permission.CONTROL_VPN
), thì các cơ chế đó:
- [C-2-1] PHẢI yêu cầu người dùng đồng ý trước khi bật cơ chế đó, trừ phi Trình điều khiển chính sách thiết bị bật VPN đó thông qua
DevicePolicyManager.setAlwaysOnVpnPackage()
. Trong trường hợp này , người dùng không cần phải đồng ý riêng, nhưng PHẢI được thông báo.
Nếu việc triển khai thiết bị triển khai một tính năng hỗ trợ người dùng để bật/tắt chức năng "VPN luôn bật" của ứng dụng VPN bên thứ ba, thì các tính năng đó:
- [C-3-1] BẮT BUỘC tắt tính năng hỗ trợ người dùng này đối với các ứng dụng không hỗ trợ dịch vụ VPN luôn bật trong tệp
AndroidManifest.xml
thông qua việc đặt thuộc tínhSERVICE_META_DATA_SUPPORTS_ALWAYS_ON
thànhfalse
.
9.9. Mã hoá bộ nhớ dữ liệu
Nếu hiệu suất mã hoá theo Tiêu chuẩn mã hoá nâng cao (AES), được đo bằng công nghệ AES hiệu quả nhất có trên thiết bị (ví dụ: Tiện ích mã hoá ARM), cao hơn 50 MiB/giây, thì việc triển khai thiết bị sẽ:
- [C-1-1] PHẢI hỗ trợ tính năng mã hoá bộ nhớ dữ liệu của dữ liệu riêng tư của ứng dụng (phân vùng
/data
), cũng như phân vùng bộ nhớ dùng chung của ứng dụng (phân vùng/sdcard
) nếu đó là một phần vĩnh viễn, không thể tháo rời của thiết bị, ngoại trừ các phương thức triển khai thiết bị thường được chia sẻ (ví dụ: TV). - [C-1-2] PHẢI bật tính năng mã hoá bộ nhớ dữ liệu theo mặc định tại thời điểm người dùng hoàn tất trải nghiệm thiết lập ban đầu, ngoại trừ các phương thức triển khai thiết bị thường được chia sẻ (ví dụ: TV).
Nếu hiệu suất mã hoá AES ở mức 50 MiB/giây trở xuống, thì việc triển khai thiết bị CÓ THỂ sử dụng Adiantum-XChaCha12-AES thay vì dạng AES được liệt kê trong bất kỳ mục nào sau đây: AES-256-XTS trong Mục 9.9.2 [C-1-5]; AES-256 ở chế độ CBS-CTS trong Mục 9.9.2 [C-1-6]; AES trong Mục 9.9.3 [C-1-1]; AES trong Mục 9.9.3 [C-1-3].
Nếu quá trình triển khai thiết bị đã được khởi chạy trên một phiên bản Android cũ và không thể đáp ứng yêu cầu thông qua bản cập nhật phần mềm hệ thống, thì các thiết bị đó CÓ THỂ được miễn trừ khỏi các yêu cầu nêu trên.
Triển khai trên thiết bị:
- PHẢI đáp ứng yêu cầu mã hoá bộ nhớ dữ liệu nêu trên thông qua việc triển khai tính năng Mã hoá dựa trên tệp (FBE).
9.9.1. Khởi động trực tiếp
Triển khai trên thiết bị:
-
[C-0-1] PHẢI triển khai các API chế độ Khởi động trực tiếp ngay cả khi các API đó không hỗ trợ tính năng Mã hoá bộ nhớ.
-
[C-0-2] Bạn VẪN PHẢI truyền phát Ý định
ACTION_LOCKED_BOOT_COMPLETED
vàACTION_USER_UNLOCKED
để báo hiệu cho các ứng dụng nhận biết tính năng Khởi động trực tiếp rằng người dùng có thể sử dụng các vị trí lưu trữ được mã hoá của thiết bị (DE) và được mã hoá thông tin xác thực (CE).
9.9.2. Mã hoá dựa trên tệp
Nếu các phương thức triển khai thiết bị hỗ trợ FBE, thì các phương thức đó:
- [C-1-1] PHẢI khởi động mà không yêu cầu người dùng cung cấp thông tin xác thực và cho phép các ứng dụng nhận biết chế độ Khởi động trực tiếp truy cập vào bộ nhớ được mã hoá của thiết bị (DE) sau khi thông báo
ACTION_LOCKED_BOOT_COMPLETED
được truyền. - [C-1-2] PHẢI chỉ cho phép truy cập vào bộ nhớ được mã hoá dành cho thông tin đăng nhập (CE) sau khi người dùng mở khoá thiết bị bằng cách cung cấp thông tin đăng nhập (ví dụ: mã xác thực, mã PIN, hình mở khoá hoặc vân tay) và thông báo
ACTION_USER_UNLOCKED
được truyền tin. - [C-1-3] KHÔNG ĐƯỢC cung cấp bất kỳ phương thức nào để mở khoá bộ nhớ được bảo vệ bằng CE mà không có thông tin xác thực do người dùng cung cấp hoặc khoá uỷ thác đã đăng ký.
- [C-1-4] PHẢI hỗ trợ tính năng Xác minh quy trình khởi động và đảm bảo rằng các khoá DE được liên kết bằng mật mã với gốc đáng tin cậy của phần cứng thiết bị.
- [C-1-5] PHẢI hỗ trợ mã hoá nội dung tệp bằng AES-256-XTS. AES-256-XTS là Tiêu chuẩn mã hoá nâng cao có độ dài khoá 256 bit, hoạt động ở chế độ XTS. Độ dài đầy đủ của khoá XTS là 512 bit.
-
[C-1-6] PHẢI hỗ trợ mã hoá tên tệp bằng AES-256 ở chế độ CBC-CTS.
-
Các khoá bảo vệ vùng lưu trữ CE và DE:
-
[C-1-7] PHẢI được liên kết bằng phương thức mã hoá với Kho khoá dựa trên phần cứng.
- [C-1-8] Khoá CE PHẢI được liên kết với thông tin xác thực màn hình khoá của người dùng.
- [C-1-9] Khoá CE PHẢI được liên kết với mật mã mặc định khi người dùng chưa chỉ định thông tin xác thực màn hình khoá.
-
[C-1-10] PHẢI là duy nhất và khác biệt, nói cách khác, không có khoá CE hoặc DE của người dùng nào khớp với khoá CE hoặc DE của người dùng nào khác.
-
[C-1-11] BẮT BUỘC phải sử dụng các thuật toán mã hoá, độ dài khoá và chế độ được hỗ trợ bắt buộc theo mặc định.
-
[C-SR] NÊN mã hoá siêu dữ liệu hệ thống tệp, chẳng hạn như kích thước tệp, quyền sở hữu, chế độ và Thuộc tính mở rộng (xattr) bằng khoá được liên kết bằng phương thức mã hoá với gốc phần cứng đáng tin cậy của thiết bị.
-
NÊN cho các ứng dụng thiết yếu được cài đặt sẵn (ví dụ: Chuông báo, Điện thoại, Messenger) biết về tính năng Khởi động trực tiếp.
- CÓ THỂ hỗ trợ các thuật toán mật mã thay thế, độ dài khoá và chế độ để mã hoá nội dung tệp và tên tệp.
Dự án nguồn mở Android ngược dòng cung cấp cách triển khai ưu tiên cho tính năng này dựa trên tính năng mã hoá ext4 của nhân Linux.
9.9.3. Mã hoá toàn bộ ổ đĩa
Nếu việc triển khai thiết bị hỗ trợ tính năng mã hoá toàn bộ đĩa (FDE), thì các thiết bị đó:
- [C-1-1] PHẢI sử dụng AES ở chế độ được thiết kế để lưu trữ (ví dụ: XTS hoặc CBC-ESSIV) và có độ dài khoá mã hoá từ 128 bit trở lên.
- [C-1-2] PHẢI sử dụng mật mã mặc định để gói khoá mã hoá và KHÔNG ĐƯỢC ghi khoá mã hoá vào bộ nhớ bất cứ lúc nào mà không được mã hoá.
- [C-1-3] PHẢI mã hoá khoá mã hoá theo mặc định bằng AES, trừ phi người dùng chọn không sử dụng một cách rõ ràng, ngoại trừ khi khoá đang được sử dụng, với thông tin đăng nhập màn hình khoá được kéo giãn bằng thuật toán kéo giãn chậm (ví dụ: PBKDF2 hoặc scrypt).
- [C-1-4] Thuật toán kéo giãn mật khẩu mặc định ở trên PHẢI được liên kết bằng phương thức mã hoá với kho khoá đó khi người dùng chưa chỉ định thông tin xác thực màn hình khoá hoặc đã tắt tính năng sử dụng mật mã để mã hoá và thiết bị cung cấp kho khoá được hỗ trợ phần cứng.
- [C-1-5] KHÔNG ĐƯỢC gửi khoá mã hoá ra khỏi thiết bị (ngay cả khi được gói bằng mật khẩu người dùng và/hoặc khoá liên kết phần cứng).
Dự án nguồn mở Android ngược dòng cung cấp phương thức triển khai ưu tiên cho tính năng này, dựa trên tính năng dm-crypt của nhân Linux.
9.10. Tính toàn vẹn của thiết bị
Các yêu cầu sau đây đảm bảo tính minh bạch về trạng thái tính toàn vẹn của thiết bị. Triển khai trên thiết bị:
-
[C-0-1] PHẢI báo cáo chính xác thông qua phương thức API hệ thống
PersistentDataBlockManager.getFlashLockState()
về việc trạng thái trình tải khởi động có cho phép cài đặt ROM hình ảnh hệ thống hay không. Trạng tháiFLASH_LOCK_UNKNOWN
được dành riêng cho các hoạt động triển khai thiết bị nâng cấp từ một phiên bản Android cũ hơn, trong đó phương thức API hệ thống mới này không tồn tại. -
[C-0-2] PHẢI hỗ trợ tính năng Xác minh quy trình khởi động để đảm bảo tính toàn vẹn của thiết bị.
Nếu quá trình triển khai thiết bị đã bắt đầu mà không hỗ trợ tính năng Khởi động được xác minh trên một phiên bản Android cũ và không thể thêm tính năng hỗ trợ cho tính năng này bằng bản cập nhật phần mềm hệ thống, thì các thiết bị đó CÓ THỂ được miễn trừ khỏi yêu cầu này.
Xác minh quy trình khởi động là một tính năng đảm bảo tính toàn vẹn của phần mềm thiết bị. Nếu việc triển khai thiết bị hỗ trợ tính năng này, thì các thiết bị đó sẽ:
- [C-1-1] PHẢI khai báo cờ tính năng nền tảng
android.software.verified_boot
. - [C-1-2] PHẢI thực hiện quy trình xác minh trên mọi trình tự khởi động.
- [C-1-3] PHẢI bắt đầu xác minh từ một khoá phần cứng không thể thay đổi, là gốc của niềm tin và đi đến phân vùng hệ thống.
- [C-1-4] PHẢI triển khai từng giai đoạn xác minh để kiểm tra tính toàn vẹn và tính xác thực của tất cả các byte trong giai đoạn tiếp theo trước khi thực thi mã trong giai đoạn tiếp theo.
- [C-1-5] PHẢI sử dụng các thuật toán xác minh mạnh mẽ như các đề xuất hiện tại của NIST đối với thuật toán băm (SHA-256) và kích thước khoá công khai (RSA-2048).
- [C-1-6] KHÔNG ĐƯỢC cho phép khởi động hoàn tất khi xác minh hệ thống không thành công, trừ phi người dùng đồng ý thử khởi động, trong trường hợp này, KHÔNG ĐƯỢC sử dụng dữ liệu từ bất kỳ khối bộ nhớ nào chưa được xác minh.
- [C-1-7] KHÔNG ĐƯỢC cho phép sửa đổi các phân vùng đã xác minh trên thiết bị, trừ phi người dùng đã mở khoá trình tải khởi động một cách rõ ràng.
- [C-SR] Nếu có nhiều khối riêng biệt trong thiết bị (ví dụ: đài phát thanh, bộ xử lý hình ảnh chuyên biệt), bạn NÊN xác minh mọi giai đoạn khi khởi động trong quá trình khởi động của từng khối đó.
- [C-1-8] PHẢI sử dụng bộ nhớ chống can thiệp: để lưu trữ thông tin về việc trình tải khởi động có được mở khoá hay không. Bộ nhớ có khả năng phát hiện hành vi can thiệp có nghĩa là trình tải khởi động có thể phát hiện xem bộ nhớ có bị can thiệp từ bên trong Android hay không.
- [C-1-9] PHẢI nhắc người dùng trong khi sử dụng thiết bị và yêu cầu xác nhận thực tế trước khi cho phép chuyển đổi từ chế độ khoá trình tải khởi động sang chế độ mở khoá trình tải khởi động.
- [C-1-10] PHẢI triển khai tính năng bảo vệ tính năng khôi phục cho các phân vùng mà Android sử dụng (ví dụ: khởi động, phân vùng hệ thống) và sử dụng bộ nhớ chống can thiệp để lưu trữ siêu dữ liệu dùng để xác định phiên bản hệ điều hành tối thiểu được phép.
- [C-SR] Bạn NÊN xác minh tất cả tệp APK của ứng dụng đặc quyền bằng một chuỗi tin cậy bắt nguồn từ
/system
, được bảo vệ bằng tính năng Xác minh quy trình khởi động. - [C-SR] Bạn NÊN xác minh mọi cấu phần phần mềm có thể thực thi mà ứng dụng đặc quyền tải từ bên ngoài tệp APK (chẳng hạn như mã được tải động hoặc mã được biên dịch) trước khi thực thi các cấu phần phần mềm đó hoặc KHÔNG NÊN thực thi các cấu phần phần mềm đó.
- NÊN triển khai tính năng bảo vệ tính năng khôi phục cho mọi thành phần có phần mềm cơ sở ổn định (ví dụ: modem, máy ảnh) và NÊN sử dụng bộ nhớ chống can thiệp để lưu trữ siêu dữ liệu dùng để xác định phiên bản tối thiểu được phép.
Nếu việc triển khai thiết bị đã bắt đầu mà không hỗ trợ C-1-8 đến C-1-10 trên một phiên bản Android cũ và không thể thêm tính năng hỗ trợ cho các yêu cầu này bằng bản cập nhật phần mềm hệ thống, thì các thiết bị đó CÓ THỂ được miễn trừ các yêu cầu này.
Dự án nguồn mở Android ngược dòng cung cấp cách triển khai ưu tiên cho tính năng này trong kho lưu trữ external/avb/
. Kho lưu trữ này có thể được tích hợp vào trình tải khởi động dùng để tải Android.
Triển khai trên thiết bị:
- [C-R] NÊN hỗ trợ Android Protected Confirmation API.
Nếu việc triển khai thiết bị hỗ trợ API Xác nhận được bảo vệ của Android, thì các thiết bị đó:
- [C-3-1] PHẢI báo cáo
true
cho APIConfirmationPrompt.isSupported()
. - [C-3-2] PHẢI đảm bảo rằng phần cứng bảo mật kiểm soát toàn bộ màn hình theo cách mà hệ điều hành Android không thể chặn màn hình đó nếu phần cứng bảo mật không phát hiện.
- [C-3-3] PHẢI đảm bảo rằng phần cứng bảo mật có toàn quyền kiểm soát màn hình cảm ứng.
9.11. Khoá và thông tin xác thực
Hệ thống Kho khoá Android cho phép nhà phát triển ứng dụng lưu trữ khoá mã hoá trong một vùng chứa và sử dụng khoá đó trong các hoạt động mã hoá thông qua API KeyChain hoặc API Kho khoá. Triển khai trên thiết bị:
- [C-0-1] PHẢI cho phép nhập hoặc tạo ít nhất 8.192 khoá.
- [C-0-2] Quy trình xác thực màn hình khoá PHẢI giới hạn số lần thử và PHẢI có thuật toán thời gian đợi luỹ thừa. Sau 150 lần thử không thành công, thời gian trễ PHẢI là ít nhất 24 giờ cho mỗi lần thử.
- KHÔNG được giới hạn số lượng khoá có thể tạo
Khi việc triển khai thiết bị hỗ trợ màn hình khoá bảo mật, thiết bị sẽ:
- [C-1-1] PHẢI sao lưu quá trình triển khai kho khoá bằng một môi trường thực thi riêng biệt.
- [C-1-2] PHẢI triển khai các thuật toán mã hoá RSA, AES, ECDSA và HMAC cũng như các hàm băm thuộc nhóm MD5, SHA1 và SHA-2 để hỗ trợ đúng cách các thuật toán được hỗ trợ của hệ thống Kho khoá Android trong một khu vực được tách biệt an toàn với mã chạy trên hạt nhân trở lên. Tính năng tách biệt an toàn PHẢI chặn tất cả cơ chế tiềm ẩn mà theo đó mã nhân hoặc không gian người dùng có thể truy cập vào trạng thái nội bộ của môi trường tách biệt, bao gồm cả DMA. Dự án nguồn mở Android (AOSP) thượng nguồn đáp ứng yêu cầu này bằng cách triển khai Trusty, nhưng một giải pháp khác dựa trên ARM TrustZone hoặc một phương thức triển khai bảo mật đã được bên thứ ba xem xét về việc tách biệt dựa trên trình điều khiển ảo hoá thích hợp là các lựa chọn thay thế.
- [C-1-3] PHẢI thực hiện quy trình xác thực màn hình khoá trong môi trường thực thi riêng biệt và chỉ cho phép sử dụng các khoá liên kết với quy trình xác thực khi quy trình này thành công. Thông tin xác thực màn hình khoá PHẢI được lưu trữ theo cách chỉ cho phép môi trường thực thi tách biệt thực hiện xác thực màn hình khoá. Dự án nguồn mở Android cấp trên cung cấp Lớp trừu tượng phần cứng (HAL) của Gatekeeper và Trusty. Bạn có thể sử dụng các lớp này để đáp ứng yêu cầu này.
- [C-1-4] PHẢI hỗ trợ chứng thực khoá, trong đó khoá ký chứng thực được bảo vệ bằng phần cứng bảo mật và quá trình ký được thực hiện trong phần cứng bảo mật. Khoá ký chứng thực PHẢI được chia sẻ trên đủ số lượng thiết bị để tránh việc khoá được dùng làm giá trị nhận dạng thiết bị. Một cách để đáp ứng yêu cầu này là chia sẻ cùng một khoá chứng thực,trừ phi bạn sản xuất ít nhất 100.000 đơn vị của một SKU nhất định. Nếu sản xuất hơn 100.000 đơn vị của một SKU, bạn CÓ THỂ sử dụng một khoá khác cho mỗi 100.000 đơn vị.
- [C-1-5] PHẢI cho phép người dùng chọn thời gian chờ Chế độ ngủ để chuyển đổi từ trạng thái mở khoá sang trạng thái khoá, với thời gian chờ tối thiểu cho phép lên đến 15 giây.
Xin lưu ý rằng nếu quá trình triển khai thiết bị đã được khởi chạy trên một phiên bản Android cũ hơn, thì thiết bị đó sẽ được miễn yêu cầu phải có kho khoá được hỗ trợ bởi một môi trường thực thi riêng biệt và hỗ trợ tính năng chứng thực khoá, trừ phi thiết bị đó khai báo tính năng android.hardware.fingerprint
yêu cầu kho khoá được hỗ trợ bởi một môi trường thực thi riêng biệt.
9.11.1. Màn hình khoá bảo mật
Việc triển khai AOSP tuân theo mô hình xác thực theo tầng, trong đó phương thức xác thực chính dựa trên nhà máy kiến thức có thể được hỗ trợ bằng phương thức xác thực sinh trắc học phụ mạnh hoặc phương thức xác thực phụ yếu hơn.
Triển khai trên thiết bị:
- [C-SR] Bạn NÊN đặt một trong những phương thức sau làm phương thức xác thực chính:
- Mã PIN dạng số
- Mật khẩu gồm chữ và số
- Một mẫu vuốt trên lưới gồm đúng 3x3 dấu chấm
Xin lưu ý rằng các phương thức xác thực ở trên được gọi là phương thức xác thực chính được đề xuất trong tài liệu này.
Nếu quá trình triển khai thiết bị thêm hoặc sửa đổi các phương thức xác thực chính được đề xuất và sử dụng một phương thức xác thực mới làm cách an toàn để khoá màn hình, thì phương thức xác thực mới đó:
- [C-2-1] PHẢI là phương thức xác thực người dùng như mô tả trong phần Yêu cầu xác thực người dùng để sử dụng khoá.
- [C-2-2] PHẢI mở khoá tất cả khoá để ứng dụng của nhà phát triển bên thứ ba sử dụng khi người dùng mở khoá màn hình khoá bảo mật. Ví dụ: tất cả khoá PHẢI có sẵn cho ứng dụng của nhà phát triển bên thứ ba thông qua các API có liên quan, chẳng hạn như
createConfirmDeviceCredentialIntent
vàsetUserAuthenticationRequired
.
Nếu việc triển khai thiết bị thêm hoặc sửa đổi các phương thức xác thực để mở khoá màn hình khoá nếu dựa trên một bí mật đã biết và sử dụng một phương thức xác thực mới được coi là cách an toàn để khoá màn hình:
- [C-3-1] Độ hỗn loạn của độ dài đầu vào ngắn nhất được phép PHẢI lớn hơn 10 bit.
- [C-3-2] Độ hỗn loạn tối đa của tất cả dữ liệu đầu vào có thể phải lớn hơn 18 bit.
- [C-3-3] Phương thức xác thực mới KHÔNG ĐƯỢC thay thế bất kỳ phương thức xác thực chính được đề xuất nào (tức là mã PIN, hình mở khoá, mật khẩu) được triển khai và cung cấp trong AOSP.
- [C-3-4] BẠN PHẢI tắt phương thức xác thực mới khi ứng dụng Trình kiểm soát chính sách thiết bị (DPC) đã đặt chính sách chất lượng mật khẩu thông qua phương thức
DevicePolicyManager.setPasswordQuality()
với hằng số chất lượng nghiêm ngặt hơnPASSWORD_QUALITY_SOMETHING
.
Nếu việc triển khai thiết bị thêm hoặc sửa đổi các phương thức xác thực chính được đề xuất để mở khoá màn hình khoá và sử dụng một phương thức xác thực mới dựa trên sinh trắc học để được coi là một cách an toàn để khoá màn hình, thì phương thức mới đó:
- [C-4-1] PHẢI đáp ứng tất cả các yêu cầu được mô tả trong mục 7.3.10.2.
- [C-4-2] PHẢI có cơ chế dự phòng để sử dụng một trong các phương thức xác thực chính được đề xuất dựa trên khoá bí mật đã biết.
- [C-4-3] PHẢI tắt và chỉ cho phép phương thức xác thực chính được đề xuất mở khoá màn hình khi ứng dụng Bộ điều khiển chính sách thiết bị (DPC) đã đặt chính sách tính năng keguard bằng cách gọi phương thức
DevicePolicyManager.setKeyguardDisabledFeatures()
, với bất kỳ cờ sinh trắc học nào được liên kết (tức làKEYGUARD_DISABLE_BIOMETRICS
,KEYGUARD_DISABLE_FINGERPRINT
,KEYGUARD_DISABLE_FACE
hoặcKEYGUARD_DISABLE_IRIS
). - [C-4-4] PHẢI yêu cầu người dùng xác thực chính được đề xuất (ví dụ: mã PIN, hình mở khoá, mật khẩu) ít nhất một lần trong vòng 72 giờ.
- [C-4-5] PHẢI có tỷ lệ chấp nhận sai bằng hoặc cao hơn tỷ lệ yêu cầu đối với cảm biến vân tay như mô tả trong phần 7.3.10, nếu không PHẢI tắt và chỉ cho phép phương thức xác thực chính được đề xuất để mở khoá màn hình khi ứng dụng Trình điều khiển chính sách thiết bị (DPC) đã đặt chính sách chất lượng mật khẩu thông qua phương thức
DevicePolicyManager.setPasswordQuality()
với hằng số chất lượng hạn chế hơnPASSWORD_QUALITY_BIOMETRIC_WEAK
. - [C-SR] Bạn NÊN có tỷ lệ chấp nhận giả mạo và giả mạo bằng hoặc cao hơn yêu cầu đối với cảm biến vân tay như mô tả trong mục 7.3.10.
- [C-4-6] PHẢI có quy trình xử lý an toàn để khi hệ điều hành hoặc hạt nhân bị xâm phạm, không thể chèn dữ liệu trực tiếp để xác thực sai dưới dạng người dùng.
- [C-4-7] PHẢI được ghép nối với một hành động xác nhận rõ ràng (ví dụ: nhấn nút) để cho phép truy cập vào khoá kho khoá nếu ứng dụng đặt
true
choKeyGenParameterSpec.Built.setUserAuthenticationRequired()
và dữ liệu sinh trắc học là thụ động (ví dụ: khuôn mặt hoặc mống mắt không có tín hiệu rõ ràng về ý định). - [C-SR] Bạn NÊN bảo mật thao tác xác nhận cho dữ liệu sinh trắc học thụ động để hệ điều hành hoặc hạt nhân bị xâm phạm không thể giả mạo thao tác đó. Ví dụ: điều này có nghĩa là thao tác xác nhận dựa trên nút vật lý được định tuyến thông qua một chân đầu vào/đầu ra (GPIO) đa năng chỉ có đầu vào của một phần tử bảo mật (SE) không thể được điều khiển bằng bất kỳ phương tiện nào khác ngoài thao tác nhấn nút vật lý.
Nếu phương thức xác thực sinh trắc học không đáp ứng tỷ lệ chấp nhận hành vi giả mạo và mạo danh như mô tả trong mục 7.3.10:
- [C-5-1] BẮT BUỘC phải tắt các phương thức này nếu ứng dụng Trình điều khiển chính sách thiết bị (DPC) đã đặt chính sách chất lượng mật khẩu thông qua phương thức
DevicePolicyManager.setPasswordQuality()
với hằng số chất lượng nghiêm ngặt hơnPASSWORD_QUALITY_BIOMETRIC_WEAK
. - [C-5-2] Người dùng PHẢI được yêu cầu xác thực chính được đề xuất (ví dụ: mã PIN, hình mở khoá, mật khẩu) sau khoảng thời gian chờ 4 giờ khi không hoạt động. Thời gian chờ khi ở trạng thái rảnh sẽ được đặt lại sau khi xác nhận thành công thông tin đăng nhập của thiết bị.
- [C-5-3] Các phương thức KHÔNG được coi là màn hình khoá bảo mật và PHẢI đáp ứng các yêu cầu bắt đầu bằng C-8 trong phần bên dưới.
Nếu việc triển khai thiết bị thêm hoặc sửa đổi các phương thức xác thực để mở khoá màn hình khoá và một phương thức xác thực mới dựa trên mã thông báo thực hoặc vị trí:
- [C-6-1] Các phương thức này PHẢI có cơ chế dự phòng để sử dụng một trong các phương thức xác thực chính được đề xuất dựa trên khoá bí mật đã biết và đáp ứng các yêu cầu để được coi là màn hình khoá bảo mật.
- [C-6-2] BẮT BUỘC phải tắt phương thức mới và chỉ cho phép một trong các phương thức xác thực chính được đề xuất để mở khoá màn hình khi ứng dụng Bộ điều khiển chính sách thiết bị (DPC) đã đặt chính sách bằng phương thức
DevicePolicyManager.setKeyguardDisabledFeatures(KEYGUARD_DISABLE_TRUST_AGENTS)
hoặc phương thứcDevicePolicyManager.setPasswordQuality()
có hằng số chất lượng hạn chế hơnPASSWORD_QUALITY_UNSPECIFIED
. - [C-6-3] Người dùng PHẢI được yêu cầu xác thực bằng một trong các phương thức xác thực chính được đề xuất (ví dụ: mã PIN, hình mở khoá, mật khẩu) ít nhất một lần trong vòng 72 giờ.
- [C-6-4] Phương thức mới KHÔNG ĐƯỢC coi là màn hình khoá bảo mật và PHẢI tuân theo các quy tắc ràng buộc nêu trong C-8 bên dưới.
Nếu các phương thức triển khai thiết bị có màn hình khoá bảo mật và bao gồm một hoặc nhiều tác nhân tin cậy triển khai API Hệ thống TrustAgentService
, thì các phương thức đó:
- [C-7-1] PHẢI có chỉ báo rõ ràng trong trình đơn cài đặt và trên màn hình khoá khi phương thức khoá thiết bị bị trì hoãn hoặc có thể được(các) tác nhân tin cậy mở khoá. Ví dụ: AOSP đáp ứng yêu cầu này bằng cách hiển thị nội dung mô tả văn bản cho "Chế độ cài đặt tự động khoá" và "Nút nguồn khoá tức thì" trong trình đơn cài đặt và một biểu tượng dễ phân biệt trên màn hình khoá.
- [C-7-2] PHẢI tuân thủ và triển khai đầy đủ tất cả API của tác nhân tin cậy trong lớp
DevicePolicyManager
, chẳng hạn như hằng sốKEYGUARD_DISABLE_TRUST_AGENTS
. - [C-7-3] KHÔNG ĐƯỢC triển khai đầy đủ hàm
TrustAgentService.addEscrowToken()
trên thiết bị được dùng làm thiết bị cá nhân chính (ví dụ: thiết bị cầm tay), nhưng CÓ THỂ triển khai đầy đủ hàm này trên các thiết bị triển khai thường được chia sẻ (ví dụ: Android Television hoặc thiết bị ô tô). - [C-7-4] PHẢI mã hoá tất cả mã thông báo đã lưu trữ do
TrustAgentService.addEscrowToken()
thêm vào. - [C-7-5] KHÔNG ĐƯỢC lưu trữ khoá mã hoá trên cùng một thiết bị mà khoá đó được sử dụng. Ví dụ: khoá được lưu trữ trên điện thoại được phép mở khoá tài khoản người dùng trên TV.
- [C-7-6] PHẢI thông báo cho người dùng về các tác động bảo mật trước khi bật mã thông báo ký gửi để giải mã bộ nhớ dữ liệu.
- [C-7-7] PHẢI có cơ chế dự phòng để sử dụng một trong các phương thức xác thực chính được đề xuất.
- [C-7-8] Người dùng PHẢI được thử thách bằng một trong các phương thức xác thực chính được đề xuất (ví dụ: mã PIN, hình mở khoá, mật khẩu) ít nhất một lần trong vòng 72 giờ.
- [C-7-9] Người dùng PHẢI được yêu cầu xác thực bằng một trong các phương thức xác thực chính được đề xuất (ví dụ: mã PIN, hình mở khoá, mật khẩu) sau khoảng thời gian chờ 4 giờ khi không hoạt động. Thời gian chờ khi ở trạng thái rảnh sẽ được đặt lại sau khi xác nhận thành công thông tin đăng nhập của thiết bị.
- [C-7-10] KHÔNG ĐƯỢC coi là màn hình khoá bảo mật và PHẢI tuân theo các quy tắc ràng buộc được liệt kê trong C-8 bên dưới.
Nếu việc triển khai thiết bị thêm hoặc sửa đổi các phương thức xác thực để mở khoá màn hình khoá không phải là màn hình khoá bảo mật như mô tả ở trên và sử dụng một phương thức xác thực mới để mở khoá màn hình khoá:
- [C-8-1] BẠN PHẢI tắt phương thức mới khi ứng dụng Trình kiểm soát chính sách thiết bị (DPC) đã đặt chính sách chất lượng mật khẩu thông qua phương thức
DevicePolicyManager.setPasswordQuality()
với hằng số chất lượng hạn chế hơnPASSWORD_QUALITY_UNSPECIFIED
. - [C-8-2] Họ KHÔNG ĐƯỢC đặt lại bộ hẹn giờ hết hạn mật khẩu do
DevicePolicyManager.setPasswordExpirationTimeout()
đặt. - [C-8-3] Các ứng dụng KHÔNG ĐƯỢC xác thực quyền truy cập vào kho khoá khi ứng dụng đặt
true
choKeyGenParameterSpec.Builder.setUserAuthenticationRequired()
).
9.11.2. StrongBox
Hệ thống Kho khoá Android cho phép nhà phát triển ứng dụng lưu trữ khoá mã hoá trong một bộ xử lý bảo mật chuyên dụng cũng như môi trường thực thi riêng biệt như mô tả ở trên.
Triển khai trên thiết bị:
- [C-SR] RẤT NÊN hỗ trợ StrongBox.
Nếu hoạt động triển khai thiết bị hỗ trợ StrongBox, thì các thiết bị đó:
-
[C-1-1] PHẢI khai báo FEATURE_STRONGBOX_KEYSTORE.
-
[C-1-2] PHẢI cung cấp phần cứng bảo mật chuyên dụng dùng để sao lưu kho khoá và xác thực người dùng một cách an toàn.
-
[C-1-3] PHẢI có một CPU riêng biệt không chia sẻ bộ nhớ đệm, DRAM, bộ xử lý đồng thời hoặc các tài nguyên cốt lõi khác với bộ xử lý ứng dụng (AP).
-
[C-1-4] PHẢI đảm bảo rằng mọi thiết bị ngoại vi được chia sẻ với AP không thể thay đổi quá trình xử lý của StrongBox theo bất kỳ cách nào hoặc lấy bất kỳ thông tin nào từ StrongBox. AP CÓ THỂ tắt hoặc chặn quyền truy cập vào StrongBox.
-
[C-1-5] PHẢI có đồng hồ nội bộ với độ chính xác hợp lý (+-10%) và không bị AP can thiệp.
-
[C-1-6] PHẢI có trình tạo số ngẫu nhiên thực sự tạo ra đầu ra được phân phối đồng đều và không thể đoán trước.
-
[C-1-7] PHẢI có khả năng chống can thiệp, bao gồm cả khả năng chống xâm nhập vật lý và sự cố.
-
[C-1-8] PHẢI có khả năng chống kênh bên, bao gồm cả khả năng chống rò rỉ thông tin qua kênh bên nguồn điện, thời gian, bức xạ điện từ và bức xạ nhiệt.
-
[C-1-9] PHẢI có bộ nhớ an toàn để đảm bảo tính bảo mật, tính toàn vẹn, tính xác thực, tính nhất quán và tính mới của nội dung. Không được phép đọc hoặc thay đổi bộ nhớ, ngoại trừ trường hợp các API StrongBox cho phép.
-
Để xác thực việc tuân thủ [C-1-3] thông qua [C-1-9], các hoạt động triển khai thiết bị phải:
- [C-1-10] PHẢI bao gồm phần cứng được chứng nhận theo Cấu hình bảo vệ IC bảo mật BSI-CC-PP-0084-2014 hoặc được đánh giá bởi một phòng thí nghiệm kiểm thử được công nhận trên toàn quốc, kết hợp với việc đánh giá lỗ hổng có khả năng tấn công cao theo Common Criteria Application of Attack Potential to Smartcards (Cách áp dụng các tiêu chí chung về khả năng tấn công cho thẻ thông minh).
- [C-1-11] PHẢI bao gồm phần mềm được đánh giá bởi một phòng thí nghiệm kiểm thử được công nhận trên toàn quốc, trong đó có đánh giá lỗ hổng có khả năng tấn công cao theo Common Criteria Application of Attack Potential to Smartcards (Công cụ đánh giá khả năng tấn công trên thẻ thông minh theo Tiêu chí chung).
- [C-SR] Bạn NÊN đưa vào phần cứng được đánh giá bằng Mục tiêu bảo mật, Mức độ đảm bảo đánh giá (EAL) 5, được tăng cường bằng AVA_VAN.5. Chứng nhận EAL 5 có thể trở thành yêu cầu trong một bản phát hành trong tương lai.
-
[C-SR] NÊN có khả năng chống tấn công nội bộ (IAR), tức là người nội bộ có quyền truy cập vào khoá ký firmware không thể tạo firmware khiến StrongBox rò rỉ thông tin bí mật, bỏ qua các yêu cầu bảo mật chức năng hoặc cho phép truy cập vào dữ liệu nhạy cảm của người dùng. Bạn nên triển khai IAR theo cách chỉ cho phép cập nhật chương trình cơ sở khi mật khẩu của người dùng chính được cung cấp thông qua HAL IAuthSecret.
9.12. Xóa dữ liệu
Tất cả các cách triển khai trên thiết bị:
- [C-0-1] PHẢI cung cấp cho người dùng một cơ chế để thực hiện thao tác "Đặt lại dữ liệu về trạng thái ban đầu".
- [C-0-2] PHẢI xoá tất cả dữ liệu do người dùng tạo. Tức là tất cả dữ liệu ngoại trừ những dữ liệu sau:
- Hình ảnh hệ thống
- Mọi tệp hệ điều hành mà hình ảnh hệ thống yêu cầu
- [C-0-3] PHẢI xoá dữ liệu theo cách đáp ứng các tiêu chuẩn ngành có liên quan, chẳng hạn như NIST SP800-88.
- [C-0-4] PHẢI kích hoạt quy trình "Đặt lại dữ liệu gốc" ở trên khi ứng dụng Trình kiểm soát chính sách thiết bị của người dùng chính gọi API
DevicePolicyManager.wipeData()
. - CÓ THỂ cung cấp tuỳ chọn xoá dữ liệu nhanh chỉ thực hiện việc xoá dữ liệu logic.
9.13. Chế độ khởi động an toàn
Android cung cấp Chế độ khởi động an toàn, cho phép người dùng khởi động vào một chế độ chỉ cho phép chạy các ứng dụng hệ thống được cài đặt sẵn và tắt tất cả ứng dụng bên thứ ba. Chế độ này, còn gọi là "Chế độ khởi động an toàn", cho phép người dùng gỡ cài đặt các ứng dụng bên thứ ba có khả năng gây hại.
Các phương thức triển khai thiết bị là:
- [SR] BẠN NÊN triển khai Chế độ khởi động an toàn.
Nếu triển khai Chế độ khởi động an toàn, thì các thiết bị sẽ:
-
[C-1-1] PHẢI cung cấp cho người dùng lựa chọn để chuyển sang Chế độ khởi động an toàn theo cách không bị gián đoạn bởi các ứng dụng bên thứ ba được cài đặt trên thiết bị, ngoại trừ trường hợp ứng dụng bên thứ ba là Trình điều khiển chính sách thiết bị và đã đặt cờ
UserManager.DISALLOW_SAFE_BOOT
thành đúng. -
[C-1-2] PHẢI cung cấp cho người dùng khả năng gỡ cài đặt mọi ứng dụng bên thứ ba trong Chế độ an toàn.
-
NÊN cung cấp cho người dùng lựa chọn chuyển sang Chế độ khởi động an toàn từ trình đơn khởi động bằng quy trình làm việc khác với quy trình khởi động bình thường.
9.14. Tách biệt hệ thống trên xe ô tô
Dự kiến, các thiết bị Android Automotive sẽ trao đổi dữ liệu với các hệ thống con quan trọng của xe bằng cách sử dụng HAL của xe để gửi và nhận thông báo qua mạng xe, chẳng hạn như bus CAN.
Bạn có thể bảo mật hoạt động trao đổi dữ liệu bằng cách triển khai các tính năng bảo mật bên dưới các lớp khung Android để ngăn chặn hành vi tương tác độc hại hoặc ngoài ý muốn với các hệ thống con này.
9.15. Gói thuê bao
"Gói thuê bao" đề cập đến thông tin chi tiết về gói mối quan hệ thanh toán do nhà mạng di động cung cấp thông qua SubscriptionManager.setSubscriptionPlans()
.
Tất cả các cách triển khai trên thiết bị:
- [C-0-1] PHẢI chỉ trả về gói thuê bao cho ứng dụng của nhà mạng di động đã cung cấp gói thuê bao đó ban đầu.
- [C-0-2] KHÔNG ĐƯỢC sao lưu hoặc tải gói thuê bao lên từ xa.
- [C-0-3] CHỈ được cho phép ghi đè, chẳng hạn như
SubscriptionManager.setSubscriptionOverrideCongested()
, từ ứng dụng của nhà mạng di động hiện đang cung cấp các gói thuê bao hợp lệ.
10. Kiểm thử khả năng tương thích của phần mềm
Việc triển khai thiết bị PHẢI vượt qua tất cả các bài kiểm thử được mô tả trong phần này. Tuy nhiên, xin lưu ý rằng không có gói kiểm thử phần mềm nào hoàn toàn toàn diện. Vì lý do này, những người triển khai thiết bị NÊN thực hiện ít thay đổi nhất có thể đối với tài liệu tham khảo và cách triển khai Android ưu tiên có trong Dự án nguồn mở Android. Điều này sẽ giảm thiểu nguy cơ phát sinh lỗi gây ra sự không tương thích, đòi hỏi phải làm lại và có thể phải cập nhật thiết bị.
10.1. Bộ kiểm thử khả năng tương thích
Triển khai trên thiết bị:
-
[C-0-1] PHẢI vượt qua Bộ kiểm thử tính tương thích với Android (CTS) có trong Dự án nguồn mở Android, bằng cách sử dụng phần mềm vận chuyển chính thức trên thiết bị.
-
[C-0-2] PHẢI đảm bảo khả năng tương thích trong trường hợp không rõ ràng trong CTS và đối với mọi hoạt động triển khai lại các phần của mã nguồn tham chiếu.
CTS được thiết kế để chạy trên một thiết bị thực. Giống như mọi phần mềm khác, chính CTS cũng có thể chứa lỗi. CTS sẽ được tạo phiên bản độc lập với Định nghĩa về khả năng tương thích này và có thể phát hành nhiều bản sửa đổi của CTS cho Android 9.
Triển khai trên thiết bị:
-
[C-0-3] PHẢI vượt qua phiên bản CTS mới nhất có sẵn tại thời điểm hoàn tất phần mềm thiết bị.
-
NÊN sử dụng phương thức triển khai tham chiếu trong cây Nguồn mở Android càng nhiều càng tốt.
10.2. Trình xác minh CTS
Trình xác minh CTS đi kèm với Bộ kiểm thử khả năng tương thích và được người vận hành chạy để kiểm thử chức năng mà hệ thống tự động không thể kiểm thử, chẳng hạn như hoạt động chính xác của máy ảnh và cảm biến.
Triển khai trên thiết bị:
- [C-0-1] PHẢI thực thi chính xác tất cả các trường hợp hiện hành trong trình xác minh CTS.
Công cụ xác minh CTS có các bài kiểm thử cho nhiều loại phần cứng, bao gồm cả một số phần cứng không bắt buộc.
Triển khai trên thiết bị:
- [C-0-2] PHẢI vượt qua tất cả các bài kiểm thử cho phần cứng mà thiết bị có; ví dụ: nếu một thiết bị có gia tốc kế, thì thiết bị đó PHẢI thực thi chính xác trường hợp kiểm thử Gia tốc kế trong Trình xác minh CTS.
Bạn CÓ THỂ bỏ qua hoặc loại bỏ các trường hợp kiểm thử cho các tính năng được ghi chú là không bắt buộc trong Tài liệu định nghĩa về khả năng tương thích này.
- [C-0-2] Mọi thiết bị và mọi bản dựng PHẢI chạy đúng cách Trình xác minh CTS, như đã lưu ý ở trên. Tuy nhiên, vì nhiều bản dựng rất giống nhau, nên người triển khai thiết bị không cần phải chạy rõ ràng Trình xác minh CTS trên các bản dựng chỉ khác nhau ở những điểm nhỏ. Cụ thể, việc triển khai thiết bị khác với việc triển khai đã vượt qua Trình xác minh CTS chỉ bằng bộ ngôn ngữ, thương hiệu, v.v. ĐƯỢC phép bỏ qua quy trình kiểm thử Trình xác minh CTS.
11. Phần mềm có thể cập nhật
-
[C-0-1] Quá trình triển khai thiết bị PHẢI bao gồm một cơ chế để thay thế toàn bộ phần mềm hệ thống. Cơ chế này không cần thực hiện nâng cấp "trực tiếp", tức là có thể cần phải khởi động lại thiết bị. Bạn có thể sử dụng bất kỳ phương thức nào, miễn là phương thức đó có thể thay thế toàn bộ phần mềm được cài đặt sẵn trên thiết bị. Ví dụ: Bất kỳ phương pháp nào sau đây đều đáp ứng yêu cầu này:
- Tải xuống "qua mạng không dây (OTA)" với bản cập nhật ngoại tuyến thông qua việc khởi động lại.
- Cập nhật "Có dây" qua USB từ máy tính lưu trữ.
- Cập nhật "ngoại tuyến" thông qua việc khởi động lại và cập nhật từ một tệp trên bộ nhớ có thể tháo rời.
-
[C-0-2] Cơ chế cập nhật được sử dụng PHẢI hỗ trợ các bản cập nhật mà không xoá dữ liệu người dùng. Tức là cơ chế cập nhật PHẢI giữ lại dữ liệu riêng tư của ứng dụng và dữ liệu dùng chung của ứng dụng. Xin lưu ý rằng phần mềm Android ngược dòng có một cơ chế cập nhật đáp ứng yêu cầu này.
Nếu việc triển khai thiết bị bao gồm tính năng hỗ trợ kết nối dữ liệu không đo lượng dữ liệu như hồ sơ 802.11 hoặc Bluetooth PAN (Mạng khu vực cá nhân), thì các thiết bị đó:
- [C-1-1] PHẢI hỗ trợ tính năng tải xuống OTA bằng bản cập nhật ngoại tuyến thông qua việc khởi động lại.
Đối với các hoạt động triển khai thiết bị đang chạy Android 6.0 trở lên, cơ chế cập nhật PHẢI hỗ trợ việc xác minh rằng hình ảnh hệ thống là tệp nhị phân giống với kết quả dự kiến sau khi cập nhật qua OTA. Việc triển khai OTA dựa trên khối trong Dự án nguồn mở Android ngược dòng, được thêm vào kể từ Android 5.1, đáp ứng yêu cầu này.
Ngoài ra, việc triển khai thiết bị PHẢI hỗ trợ bản cập nhật hệ thống A/B. AOSP triển khai tính năng này bằng cách sử dụng HAL điều khiển khởi động.
Nếu phát hiện lỗi trong quá trình triển khai thiết bị sau khi thiết bị đó được phát hành nhưng trong thời gian sử dụng hợp lý của sản phẩm (được xác định sau khi tham khảo ý kiến của Nhóm tương thích Android) ảnh hưởng đến khả năng tương thích của các ứng dụng bên thứ ba, thì:
- [C-2-1] Bên triển khai thiết bị PHẢI khắc phục lỗi thông qua bản cập nhật phần mềm có sẵn và có thể áp dụng theo cơ chế vừa mô tả.
Android có các tính năng cho phép ứng dụng Chủ sở hữu thiết bị (nếu có) kiểm soát việc cài đặt bản cập nhật hệ thống. Nếu hệ thống con cập nhật hệ thống cho thiết bị báo cáo android.software.device_admin, thì các thiết bị đó:
- [C-3-1] PHẢI triển khai hành vi được mô tả trong lớp SystemUpdatePolicy.
12. Nhật ký thay đổi tài liệu
Dưới đây là nội dung tóm tắt về các thay đổi đối với Định nghĩa về khả năng tương thích trong bản phát hành này:
Dưới đây là nội dung tóm tắt về các thay đổi đối với từng phần:
- Giới thiệu
- Loại thiết bị
- Phần mềm
- Đóng gói ứng dụng
- Nội dung đa phương tiện
- Công cụ và tuỳ chọn dành cho nhà phát triển
- Khả năng tương thích với phần cứng
- Hiệu suất và nguồn điện
- Mô hình bảo mật
- Kiểm thử khả năng tương thích của phần mềm
- Phần mềm có thể cập nhật
- Nhật ký thay đổi về tài liệu
- Liên hệ với chúng tôi
12.1. Mẹo xem nhật ký thay đổi
Các thay đổi được đánh dấu như sau:
-
CDD
Các thay đổi quan trọng đối với các yêu cầu về khả năng tương thích. -
Tài liệu
Các thay đổi liên quan đến giao diện hoặc bản dựng.
Để xem hiệu quả nhất, hãy thêm các tham số URL pretty=full
và no-merges
vào URL nhật ký thay đổi.
13. Liên hệ với chúng tôi
Bạn có thể tham gia diễn đàn về khả năng tương thích với Android để yêu cầu làm rõ hoặc nêu bất kỳ vấn đề nào mà bạn cho rằng tài liệu không đề cập đến.