การเชื่อมตัวเลือกการแจ้งเตือน

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

หลีกเลี่ยงการแจ้งเตือนซ้ำ

เมื่อคุณสร้างการแจ้งเตือนจากแหล่งที่มาภายนอก เช่น จาก Firebase Cloud Messaging แอปโทรศัพท์และแอปสมาร์ทวอทช์จะแสดงการแจ้งเตือนของตนเองบนนาฬิกาได้ เพื่อหลีกเลี่ยงการทำซ้ำ ให้ปิดใช้การเชื่อมต่อในแอปสมาร์ทวอทช์แบบเป็นโปรแกรม

ใช้แท็กบริดจ์

หากต้องการบริดจ์การแจ้งเตือนบางรายการที่แอปโทรศัพท์สร้างไปยังนาฬิกาเมื่อติดตั้งแอปสมาร์ทวอทช์ ให้ตั้งค่าแท็กบริดจ์

ตั้งค่าแท็กบริดจ์ในการแจ้งเตือนโดยใช้เมธอด setBridgeTag(String) ดังที่แสดงในตัวอย่างโค้ดต่อไปนี้

val notification = NotificationCompat.Builder(context, channelId)
    // ... set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setBridgeTag("tagOne")
    )
    .build()

ปิดใช้การเชื่อมต่อ

คุณสามารถปิดใช้การเชื่อมต่อสำหรับการแจ้งเตือนบางรายการหรือทั้งหมดได้ เราขอแนะนำให้คุณเลือกปิดใช้การเชื่อมต่อบริดจ์

ปิดใช้การเชื่อมต่อสำหรับการแจ้งเตือนบางรายการเท่านั้น

คุณสามารถปิดใช้การเชื่อมต่อแบบไดนามิก และเลือกอนุญาตการแจ้งเตือนบางรายการตามแท็กได้ เช่น หากต้องการปิดใช้การบริดจ์สำหรับการแจ้งเตือนทั้งหมด ยกเว้นการแจ้งเตือนที่ติดแท็กเป็น tagOne, tagTwo หรือ tagThree ให้ใช้ออบเจ็กต์ BridgingConfig ดังที่แสดงในตัวอย่างต่อไปนี้

// In this example, bridging is only enabled for tagOne, tagTwo and tagThree.
BridgingManager.fromContext(context).setConfig(
    BridgingConfig.Builder(context, isBridgingEnabled = false)
        .addExcludedTags(listOf("tagOne", "tagTwo", "tagThree"))
        .build()
)

ปิดใช้การเชื่อมต่อสำหรับการแจ้งเตือนทั้งหมด (ไม่แนะนำ)

หากต้องการป้องกันการบริดจ์การแจ้งเตือนทั้งหมดจากแอปโทรศัพท์ ให้ใช้รายการ <meta-data> ในไฟล์ Manifest ของแอปสมาร์ทวอทช์ ดังที่แสดงในตัวอย่างต่อไปนี้

<!-- Beware, this can have unintended consequences before the user is signed-in -->
<meta-data
    android:name="com.google.android.wearable.notificationBridgeMode"
    android:value="NO_BRIDGING" />

ตั้งค่ารหัสการปิดเพื่อซิงค์การแจ้งเตือนที่คล้ายกัน

เมื่อคุณป้องกันการเชื่อมต่อด้วยฟีเจอร์โหมดการเชื่อมต่อ การปิดการแจ้งเตือนจะไม่ซิงค์ในอุปกรณ์ของผู้ใช้

อย่างไรก็ตาม หากมีการสร้างการแจ้งเตือนที่คล้ายกันทั้งในโทรศัพท์และนาฬิกา คุณต้องการให้ปิดการแจ้งเตือนทั้ง 2 รายการเมื่อผู้ใช้ปิดการแจ้งเตือนรายการใดรายการหนึ่ง

ใน NotificationCompat.WearableExtender คุณสามารถตั้งค่ารหัสที่ไม่ซ้ำกันทั่วโลกเพื่อให้เมื่อผู้ใช้ปิดการแจ้งเตือน การแจ้งเตือนอื่นๆ ที่มีรหัสเดียวกันในนาฬิกาที่จับคู่ไว้จะถูกปิดไปด้วย

คลาส NotificationCompat.WearableExtender มีเมธอดที่ช่วยให้คุณใช้รหัสการปิดได้ ดังที่แสดงในตัวอย่างต่อไปนี้

เมื่อผู้ใช้ปิดการแจ้งเตือน การแจ้งเตือนอื่นๆ ทั้งหมดที่มีรหัสการปิดเดียวกันจะถูกปิดในนาฬิกาและในโทรศัพท์ หากต้องการดึงข้อมูลรหัสการปิด ให้ใช้ getDismissalId()

ในตัวอย่างต่อไปนี้ มีการระบุรหัสที่ไม่ซ้ำกันทั่วโลกสำหรับการแจ้งเตือนใหม่ ดังนั้นการปิดการแจ้งเตือนจึงซิงค์กัน

val notification = NotificationCompat.Builder(context, channelId)
    // ... set other fields ...
    .extend(
        NotificationCompat.WearableExtender()
            .setDismissalId("abc123")
    )
    .build()

การแจ้งเตือนในเครื่องเท่านั้น

นอกจากนี้ คุณยังใช้ setLocalOnly() เพื่อให้การแจ้งเตือนแสดงเฉพาะในโทรศัพท์เพื่อป้องกันการแจ้งเตือนซ้ำได้ด้วย

อย่างไรก็ตาม ให้ใช้วิธีนี้เฉพาะในกรณีที่การแจ้งเตือนต้องปรากฏเฉพาะในอุปกรณ์ที่สร้างการแจ้งเตือนเท่านั้น ซึ่งรวมถึงอุปกรณ์ Wear OS, อุปกรณ์ที่สวมใส่ได้อื่นๆ และอุปกรณ์ที่เชื่อมต่ออื่นๆ การแจ้งเตือนในเครื่องเท่านั้นจะไม่เชื่อมโยง แม้ว่าแอปของคุณจะไม่ได้ติดตั้งในนาฬิกาก็ตาม

เมื่อสร้างแอป Wear OS และแอปโทรศัพท์ที่สร้างการแจ้งเตือนทั้งคู่ อย่าใช้วิธีนี้เพื่อหลีกเลี่ยงการแจ้งเตือนซ้ำ แต่ให้ใช้ตัวเลือกการเชื่อมต่อแทน

เช่น ใช้การแจ้งเตือนเฉพาะในเครื่องเมื่อผู้ใช้ดาวน์โหลดไฟล์ในโทรศัพท์ และการแจ้งเตือนระบุว่าการดาวน์โหลดเสร็จสมบูรณ์แล้ว

เมื่อไม่ได้เชื่อมต่อการแจ้งเตือน

ระบบจะไม่เชื่อมต่อการแจ้งเตือนประเภทต่อไปนี้

ข้อควรพิจารณาในการนำไปใช้งานสำหรับการแจ้งเตือนที่เชื่อมโยง

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

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

ข้อควรพิจารณาในการออกแบบ

การแจ้งเตือนของ Wear OS มีหลักเกณฑ์การออกแบบของตัวเอง ดูข้อมูลเพิ่มเติมได้ที่หลักเกณฑ์การออกแบบ Wear OS