การแสดงข้อมูลและการระบุแหล่งที่มา

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

ซึ่งทำได้ 2 วิธีดังนี้

  1. การระบุแหล่งที่มาขั้นพื้นฐาน
  2. การระบุแหล่งที่มาในด้านการศึกษา

การระบุแหล่งที่มาพื้นฐาน

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

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

คุณไม่จำเป็นต้องขอสิทธิ์ที่ละเอียดอ่อน เช่น QUERY_ALL_PACKAGES เพื่อดึงข้อมูลนี้ ตัวอย่างต่อไปนี้แสดงวิธีดึงป้ายกำกับและไอคอนแอปสำหรับแพ็กเกจที่ระบุจาก PackageManager

fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
    return try {
      val pm = context.packageManager
      val appInfo = pm.getApplicationInfo(packageName, 0)
      val label = pm.getApplicationLabel(appInfo)
      val icon = pm.getApplicationIcon(appInfo)
      label to icon
    } catch (e: PackageManager.NameNotFoundException){
      null to null
    }
}

ยูทิลิตี้นี้ช่วยยืนยันการระบุแหล่งที่มาที่เหมาะสมโดยการแสดงทั้งชื่อแอป และไอคอนควบคู่ไปกับข้อมูล ดูการใช้งานในตัวอย่าง HealthConnectManager.kt

การระบุแหล่งที่มาพื้นฐานสำหรับข้อมูลการอ่าน
รูปที่ 1: การระบุแหล่งที่มาพื้นฐานสำหรับข้อมูลการอ่าน

การระบุแหล่งที่มาด้วยการศึกษา

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

การระบุแหล่งที่มาในรายละเอียดกิจกรรมและหน้าจอรายงานในแอปพาร์ทเนอร์ การระบุแหล่งที่มาในหน้าจอข้อมูลเชิงลึกในแอปพาร์ทเนอร์
รูปที่ 2: การระบุแหล่งที่มาที่มีการเปลี่ยนแปลงด้านการศึกษา

การระบุแหล่งที่มาในรายละเอียดกิจกรรมและหน้าจอรายงานในแอปพาร์ทเนอร์ การระบุแหล่งที่มาในหน้าจอข้อมูลเชิงลึกในแอปพาร์ทเนอร์

การซิงค์ข้อมูล

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

สถานะการซิงค์ข้อมูลที่แสดง
รูปที่ 3: สถานะการซิงค์ข้อมูลที่แสดง