Hồ sơ thiết bị đồng hành

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.

Lời nhắc trong hộp thoại hồ sơ thiết bị đồng hồ

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áo

BIND_NOTIFICATION_LISTENER_SERVICE
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình có khả năng hiển thị thông báo (thiết bị sử dụng phản hồi xúc giác thay vì màn hình)
  • Cung cấp trải nghiệm thông báo dành cho người dùng, chẳng hạn như hiển thị thông báo của điện thoại trên màn hình thiết bị đồng hành.
Phone
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có micrô và loa tích hợp sẵn để hỗ trợ trò chuyện bằng giọng nói
  • Có màn hình hiển thị thông tin người gọi
  • Mang đến trải nghiệm gọi điện thoại dành cho người dùng (ứng dụng đồng hành) cuộc gọi điện thoại qua cầu nối)
SMS
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị tin nhắn SMS
  • Cung cấp trải nghiệm SMS dành cho người dùng
Contacts
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Sử dụng thông tin liên hệ trong trải nghiệm gọi điện hoặc nhắn tin
Calendar
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Cung cấp trải nghiệm lịch dành cho người dùng trên đồng hồ
Nearby devices
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Mang đến trải nghiệm ghép nối/kết nối trực tiếp với người dùng trên đồng hồ
eSIM provisioning
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Cung cấp trải nghiệm dành cho người dùng để quản lý các dịch vụ của người đăng ký từ nhà mạng trên đồng hồ
Managing ongoing calls
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có micrô và loa tích hợp sẵn để hỗ trợ trò chuyện bằng giọng nói
  • Có màn hình hiển thị thông tin người gọi
  • Mang đến trải nghiệm gọi điện thoại dành cho người dùng (ứng dụng đồng hành) cuộc gọi điện thoại qua cầu nối)

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áo

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình có khả năng hiển thị thông báo (thiết bị sử dụng phản hồi xúc giác thay vì màn hình)
  • Cung cấp trải nghiệm thông báo dành cho người dùng, chẳng hạn như hiển thị thông báo của điện thoại trên màn hình thiết bị đồng hành.
  • Đăng thông báo qua điện thoại để quản lý thiết bị, ví dụ: khi thiết bị kính được kết nối hoặc khi một tính năng cụ thể được bật.
Phone
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có micrô và loa tích hợp sẵn để hỗ trợ trò chuyện bằng giọng nói
  • Có màn hình hiển thị thông tin người gọi
  • Mang đến trải nghiệm gọi điện thoại dành cho người dùng (ứng dụng đồng hành) cuộc gọi điện thoại qua cầu nối)
SMS
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị tin nhắn SMS
  • Cung cấp trải nghiệm SMS dành cho người dùng
Contacts
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Sử dụng thông tin liên hệ trong trải nghiệm gọi điện hoặc nhắn tin
Microphone
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Mang đến cho người dùng trải nghiệm sử dụng micrô trên kính
Nearby devices
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có màn hình hiển thị
  • Mang đến cho người dùng trải nghiệm ghép nối/kết nối trực tiếp trên kính
Managing ongoing calls
  • Là thiết bị có kết nối Bluetooth và/hoặc Wi-Fi
  • Có micrô và loa tích hợp sẵn để hỗ trợ trò chuyện bằng giọng nói
  • Có màn hình hiển thị thông tin người gọi
  • Mang đến trải nghiệm gọi điện thoại dành cho người dùng (ứng dụng đồng hành) cuộc gọi điện thoại qua cầu nối)

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:

  1. Gọi phương thức setDeviceProfile.

  2. Truyền một hồ sơ (ví dụ: DEVICE_PROFILE_WATCH khi xây dựng AssociationRequest.

Đố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.

  1. Truy xuất chứng chỉ bằng lệnh sau:

    keytool  -printcert -jarfile PATH/TO/APK

  2. 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>

  3. 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/.