บันทึกประจำรุ่นของ Home APIs Android SDK

2025-01-07

  รุ่นเบต้าสาธารณะของ Home API  

ในช่วงเบต้าสำหรับนักพัฒนาแอปแบบสาธารณะ นักพัฒนาแอปทุกคนจะเริ่มสร้างและทดสอบแอปได้

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป (GA) สำหรับ Home APIs Android SDK รวมถึงการรองรับอุปกรณ์ Google Nest Audio และ Google TV ที่ดีขึ้น

เวอร์ชันต่ำสุด

  • เวอร์ชันขั้นต่ำของบริการ Google Play: 24.45.34
  • เวอร์ชันขั้นต่ำของเฟิร์มแวร์ Google Hub
    • เวอร์ชันแคสต์: 3.74.444798
    • เวอร์ชัน Fuchsia ขั้นต่ำ: 22.20240805.103.161
  • Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
  • แอป Google Home (GHA) เวอร์ชันต่ำสุด: ใช้ได้กับทุกเวอร์ชัน
  • androidx.core เวอร์ชันต่ำสุดของไลบรารี: 1.10.0
  • เวอร์ชัน Matter: 1.3.0.0
    • หมายเหตุ: ระบบไม่รองรับประเภทอุปกรณ์และคลัสเตอร์ Matter ชั่วคราว

ปัญหาที่ทราบ

  • การเปลี่ยนบัญชี Google ที่เข้าสู่ระบบอาจไม่สำเร็จและทำให้เกิดข้อผิดพลาด
    • วิธีแก้ปัญหา: เรียกใช้ขั้นตอนการขอสิทธิ์อีกครั้งหรือรีสตาร์ทแอป
  • อุปกรณ์ Google TV อาจไม่ทํางานกับการทำงานอัตโนมัติที่ใช้ลักษณะ MediaPlayback
  • ในโครงสร้างที่มีเพียง Google Hub ให้ทำดังนี้
    • อุปกรณ์ Matter อาจดูเหมือนออฟไลน์ในแอป Google Home (GHA)
    • Google Assistant ควบคุมอุปกรณ์ Matter ไม่ได้
    • จออัจฉริยะไม่สามารถควบคุมอุปกรณ์ Matter หรือแสดงสถานะของอุปกรณ์ Matter
  • สำหรับอุปกรณ์บางเครื่อง แอปอาจไม่ได้แสดงสถานะที่ถูกต้องเสมอไป และแอปของคุณอาจรายงานสถานะที่แตกต่างจากที่แอป Google รายงาน เช่น แอป Google Home (GHA) ซึ่งมักเกิดจากอุปกรณ์ไม่ได้รายงานสถานะไปยัง Google
    • วิธีแก้ปัญหา: การตรวจสอบสถานะด้วยแอป Google จะแก้ไขการจับคู่ที่ไม่ตรงกัน

แก้ไขปัญหาที่ทราบ

  • การจัดเตรียมอาจไม่สำเร็จหากมีการย่อแอประหว่างกระบวนการ
    • วิธีแก้ปัญหา: ใช้ suppressHalfSheetNotification() API เพื่อระงับการแจ้งเตือนแบบครึ่งหน้าจอเมื่อใช้ Commissioning API ในแอป
  • ปัญหาฝั่งเซิร์ฟเวอร์อาจทำให้เงื่อนไขเริ่มต้น OkGoogle ไม่ทำงานในการทํางานอัตโนมัติ
  • เมื่อใช้ฮับที่ใช้ Fuchsia ซึ่งไม่มีอุปกรณ์ Matter ในโครงสร้าง หากฮับไม่ได้ใช้งานนานกว่า 3 ชั่วโมง การจัดเตรียมอุปกรณ์ Matter ตัวแรกจะทำให้อุปกรณ์ Matter ออฟไลน์
  • หลังจากรีเซ็ตข้อมูลเป็นค่าเริ่มต้นสำหรับฮับแล้ว คำสั่งที่ส่งไปยังอุปกรณ์ที่เพิ่งติดตั้งใช้งานอาจไม่สำเร็จ แม้ว่าอุปกรณ์จะรายงานว่าออนไลน์ก็ตาม