Hồ sơ thiết bị đồng hành (ra mắt trong Android 12) là một tính năng cho phép các ứng dụng đồng hành yêu cầu một tập hợp các quyền dành riêng cho loại thiết bị đồng hành, ví dụ: đồng hồ thông minh. Sử dụng chế độ đồng hành hồ sơ thiết bị của bạn giúp đơn giản hoá quá trình đăng ký bằng cách cho phép các ứng dụng hiển thị một lời nhắc duy nhất cho người dùng trên thiết bị di động của họ để yêu cầu một nhóm thay vì nhiều lời nhắc yêu cầu cấp quyền riêng lẻ. Việc này có thể giúp bạn thiết lập đơn giản hơn và tăng tỷ lệ chọn tham gia cho ứng dụng đồng hành.
Để sử dụng hồ sơ thiết bị đồng hành, ứng dụng đồng hành phải đáp ứng những yêu cầu sau các yêu cầu:
- Quản lý thiết bị đồng hành (ví dụ: đồng hồ thông minh).
- Có các tính năng của ứng dụng hoặc gọi API Android yêu cầu tất cả các quyền đã xác định cho hồ sơ thiết bị đồng hành.
Mỗi hồ sơ thiết bị đồng hành tương ứng với một vai trò trong Android. Để biết thêm thông tin về các quyền và vai trò tương ứng trên Android của từng quyền hồ sơ khác, hãy xem hồ sơ thiết bị đồng hành cho các ứng dụng bên thứ ba.
Để biết thêm thông tin về các thiết bị đồng hành, hãy xem Ghép nối thiết bị đồng hành.
Hành vi của thiết bị
Phần này mô tả hành vi của thiết bị khi sử dụng hồ sơ thiết bị đồng hành.
Khi người dùng chấp nhận yêu cầu liên kết với một ứng dụng đồng hành
thiết bị,
CompanionDeviceManager
(CDM) sẽ chỉ định vai trò trong hồ sơ thiết bị (ví dụ: đồng hồ) cho
đồng hành
ứng dụng của bạn, cấp tất cả các quyền được xác định cho vai trò hồ sơ được chỉ định đó.
Hình 1 cho thấy ví dụ về một ứng dụng yêu cầu cấp quyền cho
COMPANION_DEVICE_WATCH
hồ sơ thiết bị của bạn.
Hình 1. Hộp thoại yêu cầu cấp quyền cho hồ sơ thiết bị đồng hồ.
Khi người dùng xoá dữ liệu gói trong phần Cài đặt hoặc xoá tất cả trên thiết bị trong ứng dụng đồng hành, CDM thu hồi cấu hình trong khi ứng dụng không chạy ở nền trước cũng như không có nền trước dịch vụ đang chạy. Việc thu hồi hồ sơ cũng sẽ thu hồi tất cả thông tin đã xác định quyền cho hồ sơ.
Sau khi người dùng chấp nhận yêu cầu cấp quyền cho một ứng dụng cụ thể hồ sơ thiết bị của bạn, người dùng có thể thu hồi từng quyền đã cấp. Khi người dùng thu hồi quyền, ứng dụng vẫn được liên kết với thiết bị đồng hành nhưng một số tính năng có thể không sử dụng được. Nếu ứng dụng cần có quyền để hoạt động, ứng dụng phải yêu cầu thông qua yêu cầu quyền.
Hồ sơ thiết bị đồng hành cho các ứng dụng bên thứ ba
Hồ sơ trên đồng hồ
Hồ sơ đồng hồ được ra mắt trên Android 12.
Bảng sau đây mô tả các quyền được xác định cho
COMPANION_DEVICE_WATCH
và các yêu cầu đối với việc sử dụng các cấu hình đó.
Quyền | Các yêu cầu về thiết bị và ứng dụng đồng hành |
---|---|
Thông báoBIND_NOTIFICATION_LISTENER_SERVICE
|
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
Hồ sơ kính
Hồ sơ Kính mát được ra mắt trong Android 14.
Bảng sau đây mô tả các quyền được xác định cho
COMPANION_DEVICE_GLASSES
và các yêu cầu đối với việc sử dụng các cấu hình đó.
Quyền | Yêu cầu về thiết bị và ứng dụng đồng hành |
---|---|
Thông báoBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
Triển khai
Đối với các nhà phát triển bên thứ ba triển khai ứng dụng đồng hành yêu cầu
DEVICE_PROFILE_WATCH
cấu hình, hãy làm như sau:
Gọi phương thức
setDeviceProfile
.Truyền một hồ sơ (ví dụ:
DEVICE_PROFILE_WATCH
khi xây dựngAssociationRequest
.
Thiết bị được sản xuất để bỏ qua việc hiển thị hộp thoại đồng ý của người dùng
Đối với nhà sản xuất thiết bị triển khai ứng dụng đồng hành với một hãy sử dụng các cấu hình hệ thống Android bắt buộc sau đây để chứng nhận ứng dụng đồng hành, cho phép ứng dụng bỏ qua việc hiển thị sự đồng ý của người dùng cho người dùng.
Truy xuất chứng chỉ bằng lệnh sau:
keytool -printcert -jarfile PATH/TO/APK
Thay thế tên gói và chứng chỉ như minh hoạ sau đây dữ liệu đầu vào mẫu trong tệp cấu hình:
<!-- A list of packages managing companion device(s) by the same manufacturers as the main device. It will not create the association without prompting if the association has been called multiple times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts are parallel arrays. --> <string-array name="config_companionDevicePackages" translatable="false"> <item>YOUR_COMPANION_APP_PACKAGE_NAME</item> </string-array> <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the main device. It will fall back to showing a prompt if the association has been called multiple times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage are parallel arrays. Example: "1A:2B:3C:4D" --> <string-array name="config_companionDeviceCerts" translatable="false"> <item>YOUR_COMPANION_APP_CERTIFICATE</item> </string-array>
Sử dụng
AssociationRequest
để tạo yêu cầu liên kết với một thiết bị đồng hành.
Xác nhận kết quả
Để kiểm thử hành vi của tính năng hồ sơ thiết bị đồng hành, hãy sử dụng CTS
thử nghiệm ở
cts/tests/tests/companion/
.