Nhiều ứng dụng có quy trình làm quen tuỳ chỉnh cho các quy trình công việc, chẳng hạn như hướng dẫn người dùng về các tính năng của ứng dụng hoặc yêu cầu sự đồng ý của người dùng. Để tạo một quy trình kết nối liền mạch, ứng dụng của bạn cũng có thể sử dụng Matchmaking API để nhắc người dùng kết nối các ứng dụng khác có thể ghi dữ liệu mà ứng dụng của bạn được định cấu hình để đọc.
Để thêm một quy trình làm quen tuỳ chỉnh, hãy định cấu hình Health Connect để tự động khởi chạy quy trình đó sau khi được cấp quyền. Tuy nhiên, xin lưu ý rằng Matchmaking API không hỗ trợ điều kiện kích hoạt này. Để thực hiện việc này, hãy thêm nội dung sau vào tệp kê khai:
<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
android:name=".OnboardingActivity"
android:exported="true"
android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING">
<intent-filter>
<action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
</intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
android:name="UAndAboveOnboardingActivity"
android:exported="true"
android:targetActivity=".OnboardingActivity"
android:permission="android.permission.health.START_ONBOARDING">
<intent-filter>
<action android:name="android.health.connect.action.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Người dùng có thể bắt đầu kết nối với ứng dụng của bạn ngay từ ứng dụng Health Connect, thay vì từ bên trong ứng dụng của bạn.
Hỗ trợ phiên bản
Để hỗ trợ cả thiết bị chạy Android 14 trở lên và thiết bị chạy phiên bản trước Android 14:
Phương pháp được đề xuất: Tạo một hoạt động duy nhất để bắt đầu sử dụng, xử lý cả hai trường hợp. Sử dụng một bí danh hoạt động, như trong ví dụ,để xác minh khả năng tương thích trên các phiên bản Android.
Phương pháp thay thế: Xuất 2 hoạt động riêng biệt, một hoạt động cho mỗi phiên bản Android. Phương pháp này có thể làm tăng độ phức tạp của việc bảo trì.
Yêu cầu đối với hoạt động được xuất
Khi một người dùng cố gắng kết nối ứng dụng của bạn với Health Connect, hoạt động đã xuất sẽ được khởi chạy. Hoạt động này phải thực hiện những việc sau:
- Hiện mọi hướng dẫn có liên quan cho người dùng, chẳng hạn như giải thích loại dữ liệu được ghi hoặc được đọc.
- Yêu cầu người dùng đồng ý nếu cần.
- Gửi yêu cầu quyền đến Health Connect.
- Thực hiện mọi logic khác dành riêng cho ứng dụng, chẳng hạn như lên lịch cho một trình thực thi định kỳ.
- Sau khi hoàn tất, hãy cho phép người dùng đóng hoạt động đó.
Đối với các ứng dụng không xuất hoạt động làm quen với ứng dụng, Health Connect sẽ đưa người dùng đến màn hình Quản lý quyền sau khi người dùng cố gắng kết nối ứng dụng đó. Điều này có thể chấp nhận được đối với các ứng dụng mà quyền được cấp là điều kiện tiên quyết duy nhất để quá trình tích hợp diễn ra.
Lưu ý rằng người dùng có thể khởi chạy hoạt động làm quen với ứng dụng nhiều lần, chẳng hạn như nếu sau đó người dùng thu hồi các quyền đối với ứng dụng rồi kết nối lại.