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

เราขอแนะนำวิธีการต่อไปนี้ในการเตรียมความพร้อมผู้ใช้ให้เข้าสู่แอปของคุณ

เริ่มต้นใช้งานแอป

แอปจำนวนมากมีขั้นตอนการเริ่มต้นใช้งานที่กำหนดเอง เช่น การให้ความรู้เกี่ยวกับฟีเจอร์หรือการขอให้ผู้ใช้ดำเนินการ ความยินยอม ขอแนะนำให้นักพัฒนาแอปส่งออกกิจกรรมการเริ่มต้นใช้งาน ที่ Health Connect เปิดขึ้นเมื่อผู้ใช้โต้ตอบกับแอปสำหรับ เป็นครั้งแรก โดยให้เพิ่มข้อมูลต่อไปนี้ในไฟล์ 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.ACTION_SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

โปรดทราบว่าฟีเจอร์นี้ยังไม่พร้อมใช้งานใน Android 14 แต่จะพร้อมให้บริการเร็วๆ นี้

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

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

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

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