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

2025-03-14

  Home APIs รุ่นเบต้าสาธารณะ 1.2.0  

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

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

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

ฟีเจอร์ใหม่

  • Automation API:
    • รองรับช่วงวันที่และวันที่บางส่วนในเงื่อนไขการทำงานอัตโนมัติ ดูหัวข้อใช้วันที่กับระหว่าง
    • ในรุ่นก่อนหน้า Discovery API จะแสดงผล NumberSetConstraint สำหรับช่องบิตแมปบางช่องในเมื่อควรจะแสดงผล BitmapConstraint ตอนนี้ช่องเหล่านี้จะแสดงBitmapConstraintตามปกติ ซึ่งใช้ได้กับบิตแมป optionsMask และ optionsOverride ในคำสั่งลักษณะ LevelControl เท่านั้น

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

  • เวลาในการตอบสนองของการควบคุมอุปกรณ์อาจเพิ่มขึ้นเมื่อเปลี่ยนจาก Wi-Fi เป็นเครือข่ายมือถือ
  • หลังจากรีเซ็ตฮับเป็นค่าเริ่มต้น อุปกรณ์อาจดูเหมือนออฟไลน์
  • หากเรียก Discovery API ก่อนการเริ่มต้นหรือก่อนที่การเริ่มต้นจะเสร็จสมบูรณ์ ระบบจะแสดง HomeException ที่มี code 14: UNKNOWN และข้อความ "ไม่พบเส้นทาง"
    • วิธีแก้ปัญหา: เรียก Discovery API เฉพาะเมื่อคุณต้องการผู้สมัครแบบอัตโนมัติเท่านั้น อย่าดึงข้อมูลล่วงหน้าและแคชเอนทิตีที่เป็นไปได้ ตรวจสอบว่าเอนทิตีออนไลน์อยู่หรือไม่ก่อนที่จะเรียกใช้เมธอด Discovery API กับเอนทิตีนั้น
  • ในสภาพแวดล้อมที่มีโครงสร้างและผู้ใช้หลายคน การสลับระหว่างโครงสร้างและผู้ใช้อาจส่งผลให้ไม่มีอุปกรณ์แสดงขึ้นมา

ปัญหาที่ทราบซึ่งได้รับการแก้ไขแล้ว

  • ครั้งแรกที่แอป Home APIs เรียก HomeManager.structures() หลังจากเปิดใช้งาน แอปจะได้รับโครงสร้าง 0 รายการ แม้ว่าจะมีโครงสร้างอย่างน้อย 1 รายการก็ตาม ซึ่งทำให้เข้าใจผิดว่าไม่มีโครงสร้างที่เชื่อมโยงกับบัญชี Google
  • เมื่อโหลด สร้าง และแก้ไขการทำงานอัตโนมัติ ผู้ใช้อาจต้องรอนาน
  • ผู้ใช้ที่เริ่มขั้นตอนการตั้งค่าจากแอปกล้องจะต้องสแกนคิวอาร์โค้ด 2 ครั้งเพื่อทำให้การจัดเตรียมอุปกรณ์ Matter เสร็จสมบูรณ์
  • ในโครงสร้างที่มีอุปกรณ์มากกว่า 200 เครื่อง Discovery API อาจไม่แสดงอุปกรณ์ที่ตรงกับเกณฑ์

2025-01-29

  Home APIs รุ่นเบต้าสาธารณะ 1.1.0  

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

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

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

ฟีเจอร์ใหม่

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

  • เมื่อโหลด สร้าง และแก้ไขการทำงานอัตโนมัติ ผู้ใช้อาจต้องรอนาน
  • ผู้ใช้ที่เริ่มขั้นตอนการตั้งค่าจากแอปกล้องจะต้องสแกนคิวอาร์โค้ด 2 ครั้งเพื่อทำให้การจัดเตรียมอุปกรณ์ Matter เสร็จสมบูรณ์
  • ในโครงสร้างที่มีอุปกรณ์มากกว่า 200 เครื่อง Discovery API อาจไม่แสดงอุปกรณ์ที่ตรงกับเกณฑ์

ปัญหาที่ทราบซึ่งได้รับการแก้ไขแล้ว

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

2025-01-14

คำแนะนำที่อัปเดตสำหรับการเริ่มต้นใช้งาน Home API

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

2025-01-07

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

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

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นที่พร้อมให้บริการแก่ผู้ใช้ทั่วไป (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 ออฟไลน์
  • หลังจากรีเซ็ตข้อมูลเป็นค่าเริ่มต้นสำหรับฮับแล้ว คำสั่งที่ส่งไปยังอุปกรณ์ที่เพิ่งติดตั้งใช้งานอาจไม่สำเร็จ แม้ว่าอุปกรณ์จะรายงานว่าออนไลน์ก็ตาม