ค้นหาอุปกรณ์ในเครือข่ายโดยใช้ Data Layer API

อุปกรณ์อาจสร้างการเชื่อมต่ออินเทอร์เน็ตโดยตรงโดยใช้ Wi-Fi หรือการเชื่อมต่อเครือข่ายมือถือ หรือโดยอ้อมผ่านอุปกรณ์บลูทูธที่จับคู่ไว้

โหนดที่เข้าถึงได้และอยู่ใกล้เคียง

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

อุปกรณ์จะถือว่าอยู่ใกล้เคียงหากสามารถเชื่อมต่อได้โดยตรงผ่านบลูทูธโดยไม่ต้องใช้ระบบคลาวด์

กิจกรรมที่ส่งผลต่อเวลาในการเชื่อมต่ออีกครั้ง

ในบางกรณี อุปกรณ์อาจใช้เวลาถึง 4 นาทีในการเชื่อมต่ออีกครั้ง สถานการณ์เหล่านี้ ได้แก่

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

ค้นหาอุปกรณ์ทั้งหมดโดยใช้ไคลเอ็นต์โหนด

ออบเจ็กต์ NodeClient จะระบุและประกาศไปยังรายการอุปกรณ์ที่ใช้ Android ซึ่งเชื่อมต่อกับเครือข่าย โดยไม่คำนึงถึงความสามารถของอุปกรณ์แต่ละเครื่อง แอปทั้งหมดในอุปกรณ์จะได้รับการแจ้งเตือนเหตุการณ์เหล่านี้ เช่น อุปกรณ์ใหม่ที่เข้าร่วมเครือข่ายหรืออุปกรณ์ที่มีอยู่ซึ่งออฟไลน์ไป

คลาส NodeClient มีประโยชน์อย่างยิ่งสำหรับการค้นหาอุปกรณ์ที่ไม่ได้ติดตั้งแอปของคุณ

หากต้องการลงทะเบียนสำหรับเหตุการณ์การเชื่อมต่อและการยกเลิกการเชื่อมต่ออุปกรณ์ คุณสามารถใช้คลาส DataLayerAppHelper ของ Horologist ได้ ซึ่งจะแสดง connectedAndInstalledNodes Flow เพื่อสังเกตสถานะการเชื่อมต่อ นอกจากนี้ เมธอด connectedNodes() จะแสดงรายการอุปกรณ์ที่เชื่อมต่อ โดยรวมข้อมูลจากทั้ง NodeClient และ CapabilityClient ไว้ในออบเจ็กต์เดียว

ค้นหาอุปกรณ์ที่เฉพาะเจาะจงโดยใช้ไคลเอ็นต์ความสามารถ

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

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

หากต้องการกำหนดความสามารถ ณ เวลาที่สร้าง ให้ประกาศทรัพยากร string-array ชื่อ android_wear_capabilities ใน res/values/wear.xml ดังที่แสดงในระบุชื่อความสามารถสำหรับการตรวจหาแอป หากต้องการป้องกันไม่ให้การลดขนาดทรัพยากรนำ android_wear_capabilities ออกเนื่องจากไม่ได้ใช้ ให้ระบุ tools:keep="@array/android_wear_capabilities" ในไฟล์เก็บแยกต่างหากในไดเรกทอรี res/raw/ (เช่น res/raw/keep.xml) แทนที่จะระบุใน res/values/wear.xml ดูไวยากรณ์ของไฟล์เก็บรักษาได้ที่หัวข้อปรับแต่งทรัพยากรที่จะเก็บรักษา

ตรวจสอบความสามารถใหม่ๆ ของแอป

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

ตรวจสอบว่าอุปกรณ์ Wear OS เป็นอุปกรณ์เดียวในเครือข่ายหรือไม่

คุณสามารถใช้ CapabilityClient เพื่อตรวจสอบว่าแอปต้องทำงานในโหมดสแตนด์อโลนหรือไม่เนื่องจากไม่มีอุปกรณ์ที่ทำงานด้วยระบบ Android เครื่องอื่นอยู่ใกล้เคียง เมื่อส่ง FILTER_ALL เข้าไป อุปกรณ์อื่นๆ จะไม่ปรากฏในผลการค้นหา