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

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

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

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

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

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

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

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

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

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

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

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