วางแผนสำหรับผู้ใช้การเริ่มต้นใช้งาน

แอปจำนวนมากมีขั้นตอนการเริ่มต้นใช้งานที่กำหนดเองสำหรับเวิร์กโฟลว์ เช่น การให้ความรู้แก่ผู้ใช้เกี่ยวกับฟีเจอร์ของแอปหรือการขอความยินยอมของผู้ใช้ หากต้องการสร้างขั้นตอนการเชื่อมต่อที่ราบรื่น แอปของคุณยังใช้ Matchmaking API เพื่อแจ้งให้ผู้ใช้เชื่อมต่อแอปอื่นๆ ที่เขียนข้อมูลซึ่งแอปของคุณได้รับการกำหนดค่าให้อ่านได้

หากต้องการรวมขั้นตอนการเริ่มต้นใช้งานที่กำหนดเอง ให้กำหนดค่า Health Connect เพื่อเปิดใช้โดยอัตโนมัติหลังจากได้รับสิทธิ์ อย่างไรก็ตาม โปรดทราบว่า Matchmaking API ไม่รองรับทริกเกอร์นี้ โดยเพิ่มข้อมูลต่อไปนี้ลงในไฟล์ Manifest

<!-- 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>

ผู้ใช้อาจเริ่มการเชื่อมต่อกับแอปของคุณโดยตรงจากแอป Health Connect แทนที่จะเริ่มจากภายในแอปของคุณ

การรองรับเวอร์ชัน

หากต้องการรองรับทั้งอุปกรณ์ที่ใช้ Android เวอร์ชันก่อน 14 และ Android 14 ขึ้นไป ให้ทำดังนี้

• แนวทางที่แนะนำ: สร้างกิจกรรมการเริ่มต้นใช้งานรายการเดียวที่จัดการทั้ง 2 สถานการณ์ ใช้นามแฝงของกิจกรรมตามที่แสดงในตัวอย่างเพื่อยืนยันความเข้ากันได้ใน Android เวอร์ชันต่างๆ

• แนวทางอื่น: ส่งออกกิจกรรม 2 รายการแยกกัน รายการละ 1 เวอร์ชันสำหรับ Android แต่ละเวอร์ชัน วิธีนี้อาจทำให้การบำรุงรักษามีความซับซ้อนมากขึ้น

ข้อกำหนดของกิจกรรมที่ส่งออก

เมื่อผู้ใช้พยายามเชื่อมต่อแอปกับ Health Connect ระบบจะเปิดใช้งานกิจกรรมที่ส่งออก กิจกรรมนี้ต้องดำเนินการต่อไปนี้

• แสดงการให้ความรู้แก่ผู้ใช้ที่เกี่ยวข้อง เช่น อธิบายว่ามีการเขียนหรืออ่านข้อมูลใด
• ขอให้ผู้ใช้ให้ความยินยอมหากจำเป็น
• ส่งคำขอสิทธิ์ไปยัง Health Connect
• ดำเนินการตามตรรกะอื่นๆ ที่เฉพาะเจาะจงกับแอปพลิเคชัน เช่น การตั้งเวลา Worker ที่ทำงานเป็นระยะ
• เมื่อเสร็จแล้ว ให้ผู้ใช้ปิดกิจกรรม

สำหรับแอปที่ไม่ได้ส่งออกกิจกรรมการเริ่มต้นใช้งาน Health Connect จะนำผู้ใช้ไปยังหน้าจอจัดการสิทธิ์แทนเมื่อผู้ใช้พยายามเชื่อมต่อแอป ซึ่งอาจเป็นที่ยอมรับได้สำหรับแอปที่การให้สิทธิ์เป็นข้อกำหนดเบื้องต้นเพียงอย่างเดียวเพื่อให้การผสานรวมทำงานได้

โปรดทราบว่ากิจกรรมการเตรียมความพร้อมผู้ใช้งานใหม่อาจเปิดตัวมากกว่า 1 ครั้ง เช่น หากผู้ใช้เพิกถอนสิทธิ์เข้าถึงแอปของคุณในภายหลัง แล้วเชื่อมต่อแอปอีกครั้ง