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

2026-05-01

  Home API เวอร์ชันเบต้าแบบสาธารณะ 1.8.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

ฟีเจอร์ใหม่

  • ตอนนี้ลักษณะตัวควบคุมอุณหภูมิรองรับความสามารถในการอ่าน/อัปเดต เปิด/ปิด และตัวจับเวลาแล้ว

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

  • การจัดเตรียมอุปกรณ์ Matter อาจไม่สำเร็จ
  • ไฟ BLE ของ Philips แสดงสถานะไม่ถูกต้อง
  • เวลาในการตอบสนองทำให้เครือข่ายไม่เสถียรและใช้เวลาตอบสนองนาน

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

  • เปิดใช้อุปกรณ์บางอย่างโดยใช้ Google TV Streamer 4K ไม่ได้
  • เมื่อฮับเป็น Nest Wifi Pro, Google Nest Hub หรือ Google Nest Hub Max แอป Google Home จะแสดงอุปกรณ์แบบหลายส่วนเป็นหลายการ์ด

2026-04-10

เราได้อัปเดตแอปตัวอย่าง Android ของ Home API สำหรับการเปิดตัว Home API 1.8 แล้ว

แอปตัวอย่าง

2026-04-09

  เปิดตัว Home API เวอร์ชันเบต้าสาธารณะ 1.8  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 26.12.32
  • เฟิร์มแวร์ของฮับ Google, Cast, Nest Wifi Pro: 3.78.518349
  • เฟิร์มแวร์ของฮับ Google, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.78.526062
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 29.20251023.103.2101601
  • เฟิร์มแวร์ฮับของ Google, Google TV Streamer, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_8_0
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0
  • เวอร์ชัน Matter: รองรับ 1.5.0 ในเวอร์ชันทดลอง

ฟีเจอร์ใหม่

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

  • เปลี่ยนหน่วยอุณหภูมิ (C/F) ของ Google Nest Learning Thermostat (รุ่นที่ 4) ไม่ได้
  • ใน Google Home สำหรับเว็บเวอร์ชันสำหรับมือถือ ไอคอนด้านบนและปุ่มย้อนกลับจะถูกซ่อนไว้ด้วยส่วนหัว ผู้ใช้อาจย้อนกลับหรือดูองค์ประกอบสำคัญของอินเทอร์เฟซผู้ใช้ไม่ได้
  • ฮับ Android TV อาจรายงานอุปกรณ์ Matter เป็น "ออฟไลน์" อย่างไม่ถูกต้อง

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

  • การจัดเตรียมอุปกรณ์ Matter อาจไม่สำเร็จ

2026-03-13

  เปิดตัว Home API เวอร์ชันเบต้าสาธารณะ 1.7.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play:
  • เฟิร์มแวร์ของฮับ Google, Cast, Nest Wifi Pro: 3.78.518349
  • เฟิร์มแวร์ของฮับ Google, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.78.516526
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 29.20251023.103.2201
  • เฟิร์มแวร์ฮับของ Google, Google TV Streamer, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7_1
  • แอป Google Home: 1.7.1
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0
  • เวอร์ชัน Matter: รองรับ 1.5.0 ในเวอร์ชันทดลอง

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • เราได้นำโหมดที่ไม่มีฮับออกแล้ว

แอปตัวอย่าง

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

  • สำหรับ Nest Cam Indoor/Outdoor (แบบใช้แบตเตอรี่หรือแบบใช้สาย) และ Nest Doorbell (แบบใช้แบตเตอรี่ รุ่นที่ 2) ตัวเลือก "เวลาแบตเตอรี่ที่เหลือ" จะไม่อยู่ในการตั้งค่าแบตเตอรี่
  • ระบบจะไม่สนใจการตั้งค่าระยะเวลาเสียงกริ่ง
  • ไฟ BLE ของ Philips ปรากฏเป็น "ออนไลน์" อย่างไม่ถูกต้องแม้ว่าอุปกรณ์จะออฟไลน์อยู่ก็ตาม

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

  • เปลี่ยนหน่วยอุณหภูมิ (C/F) ของ Google Nest Learning Thermostat (รุ่นที่ 4) ไม่ได้
  • อาจมีความล่าช้าในด้านความเสถียรของเครือข่ายและการตอบสนองของอุปกรณ์
  • ใน Google Home สำหรับเว็บเวอร์ชันสำหรับมือถือ ไอคอนด้านบนและปุ่มย้อนกลับจะถูกซ่อนไว้ด้วยส่วนหัว ผู้ใช้อาจย้อนกลับหรือดูองค์ประกอบสำคัญของอินเทอร์เฟซผู้ใช้ไม่ได้
  • ฮับอาจค้างอยู่ในสถานะ "กำลังเชื่อมต่อ..." หลังจาก OOBE ในโหมดที่เชื่อมโยง
  • การจัดเตรียมอุปกรณ์ Matter อาจไม่สำเร็จ
  • ฮับ Android TV อาจรายงานอุปกรณ์ Matter ว่าออฟไลน์อย่างไม่ถูกต้อง
  • เวอร์ชันซอฟต์แวร์ที่ถูกต้องอาจไม่ปรากฏสำหรับเวอร์ชันซอฟต์แวร์อุปกรณ์กล้องปัจจุบัน
  • แถบเลื่อน UI ของตัวควบคุมอุณหภูมิจะแสดงอุณหภูมิที่อยู่นอกช่วง
  • เมื่อตั้งค่าระยะเวลาการแจ้งเตือน อุปกรณ์จะไม่ส่งเสียงแจ้งเตือนตามระยะเวลาที่ระบุ

2026-02-13

เราได้อัปเดตแอปตัวอย่าง Android ของ Home APIs สำหรับการเปิดตัว Home APIs 1.7 แล้ว

แอปตัวอย่าง

2026-02-09

  เปิดตัว Home API เวอร์ชันเบต้าสาธารณะ 1.7  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 26.02.34
  • เฟิร์มแวร์ฮับของ Google, Cast, Nest Wifi Pro: 3.76.508025
  • เฟิร์มแวร์ของฮับ Google, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.77.510748
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 29.20251023.103.2100
  • เฟิร์มแวร์ฮับของ Google, Google TV Streamer, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_7
  • แอป Google Home: 1.7
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0
  • เวอร์ชัน Matter: รองรับ 1.5.0 ในเวอร์ชันทดลอง

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

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

  • History API จะแสดงผล nextPageToken เสมอ ซึ่งทำให้เกิดลูปที่ไม่มีที่สิ้นสุด
  • ข้อผิดพลาด "ผู้ใช้ยกเลิกโฟลว์การให้สิทธิ์" จะเกิดขึ้นเมื่อพยายามเข้าสู่ระบบบัญชีใหม่

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

  • สำหรับ Nest Cam Indoor/Outdoor (แบบใช้แบตเตอรี่หรือแบบใช้สาย) และ Nest Doorbell (แบบใช้แบตเตอรี่ รุ่นที่ 2) ตัวเลือก "เวลาแบตเตอรี่ที่เหลือ" จะไม่อยู่ในการตั้งค่าแบตเตอรี่
  • ระบบจะไม่สนใจการตั้งค่าระยะเวลาเสียงกริ่ง
  • ไฟ BLE ของ Philips ปรากฏเป็น "ออนไลน์" อย่างไม่ถูกต้องแม้ว่าอุปกรณ์จะออฟไลน์อยู่ก็ตาม วิธีแก้ปัญหา: อย่าพึ่งพาเฉพาะสถานะออนไลน์ของประเภทอุปกรณ์สมาร์ทโฮม (SHDT) แต่ให้ใช้แผนที่บริการสถานะอุปกรณ์เป้าหมาย (TDSS) สำหรับอุปกรณ์ที่มีแหล่งที่มาเป็น LOCAL_SYNC

2025-12-22

  Home API เวอร์ชันเบต้าสาธารณะ 1.6  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.47.30
  • เฟิร์มแวร์ของ Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • เฟิร์มแวร์ของฮับ Google, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.77.505721
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 28.20250723.103.2100300
  • เฟิร์มแวร์ฮับของ Google, Google TV Streamer, 4K: UTTK.250729.004
  • Android SDK: home.android.sdk_GHP_1_6
  • แอป Google Home: 1.6
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android เพิ่มการตั้งค่ากล้อง การทำงานอัตโนมัติที่กำหนดไว้ล่วงหน้า การรองรับพัดลมและลำโพง

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

  • การควบคุมอุปกรณ์หยุดทำงานหลังจากใช้งานเป็นเวลานาน วิธีแก้ปัญหาชั่วคราว: รีสตาร์ทฮับ
  • การจัดสรรอุปกรณ์ Matter อาจไม่สำเร็จ
  • ข้อผิดพลาด "ผู้ใช้ยกเลิกโฟลว์สิทธิ์" จะปรากฏขึ้นเมื่อพยายามเพิ่มบัญชีใหม่ในแอปตัวอย่างสำหรับ Android วิธีแก้ปัญหา: เพิ่มบัญชี Google ผ่านการตั้งค่าอุปกรณ์ Android
  • กล้องรักษาความปลอดภัยแบบใช้สายของ Walmart onn ที่ติดตั้งใช้งานโดยใช้ SDK ของ Android Home API จะไลฟ์สดผ่านแอป Google Home ไม่ได้
  • กล้องที่เปิดใช้ในแอปที่ใช้ Home API จะไม่สามารถเริ่มเซสชันการไลฟ์สดจากแอป Google Home ได้

2025-10-23

  เปิดตัว Home API เวอร์ชันเบต้าแบบสาธารณะ 1.5.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.41.30
  • เฟิร์มแวร์ฮับของ Google, Cast: 3.76.495998
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5_1
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android เพิ่มการรองรับประเภทอุปกรณ์กริ่งประตู (เปิด/ปิด, สตรีมแบบสด, การพูดแบบ 2 ทาง) และการใช้งาน Hub Activation API

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

  • แอปตัวอย่างแสดงสถานะอุปกรณ์ในมุมมองอุปกรณ์ไม่ถูกต้อง

2025-09-26

  เปิดตัว Home API เวอร์ชันเบต้าแบบสาธารณะ 1.5.0  

รุ่นนี้รองรับอุปกรณ์กล้อง มีการแก้ไขข้อบกพร่อง และ ปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.37.31
  • เฟิร์มแวร์ฮับของ Google, Cast: 3.76.492738
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_5
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • เวอร์ชัน Matter: 1.4.1.0

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android เพิ่มการรองรับกล้อง การจัดสรรผู้ดูแลระบบหลายคน และOnOffการทำงานอัตโนมัติที่กำหนดไว้ล่วงหน้า

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

  • เมื่อบังคับนำฮับที่ใช้งานอยู่ออก จะมีช่วงเวลา 5 นาทีที่คุณควบคุมอุปกรณ์บางอย่างไม่ได้ หลังจากผ่านไป 5 นาที ระบบจะคืนสิทธิ์ในการควบคุมอุปกรณ์
  • หลังจากที่ผู้ใช้เลือกสีจากค่าที่กำหนดล่วงหน้าหรือจากตัวเลือกอุณหภูมิสีแล้ว ไฟสีแบบขยายจะอัปเดตสีไม่สำเร็จ

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

  • เวลาในการตอบสนองของระบบควบคุมอุปกรณ์อาจเพิ่มขึ้นเมื่อเปลี่ยนจาก Wi-Fi เป็นเครือข่ายมือถือ
  • การควบคุมอุปกรณ์ประเภทพัดลมที่รองรับโดย Cloud-to-Cloud อาจไม่ทำงานในแอปตัวอย่าง

2025-08-29

  เปิดตัว Home API เวอร์ชันเบต้าแบบสาธารณะ 1.4.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.33.32
  • เฟิร์มแวร์ฮับของ Google, Cast: 3.76.495998
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_1
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • Matter เวอร์ชัน: 1.4.0.0

ฟีเจอร์ใหม่

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

  • แอปตัวอย่าง Android จะขัดข้องเมื่อผู้ใช้พยายามตั้งค่าเทอร์โมสตัทเป็นโหมดที่ไม่รองรับ

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

  • เมื่อบังคับนำฮับที่ใช้งานอยู่ออก จะมีช่วงเวลา 5 นาทีที่คุณควบคุมอุปกรณ์บางอย่างไม่ได้ หลังจากผ่านไป 5 นาที ระบบจะคืนสิทธิ์ในการควบคุมอุปกรณ์

2025-07-31

  เปิดตัว Home API เวอร์ชันเบต้าสาธารณะ 1.4.0  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของรุ่นเบต้าสำหรับ Home APIs Android SDK

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.28.34
  • เฟิร์มแวร์ฮับของ Google, Cast: 3.76.486931
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 27.20250422.103.3600
  • Android SDK: home.android.sdk_1_4_0
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • Matter เวอร์ชัน: 1.4.0.0

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android จะลบอุปกรณ์ที่ใช้ Matter เท่านั้น เปลี่ยนชื่ออุปกรณ์ และแทนที่การเรียก API ที่เลิกใช้งานแล้ว

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

  • อุปกรณ์เครื่องดูดฝุ่นที่อยู่ที่แท่นชาร์จจะไม่ลงทะเบียนสถานะ "อยู่ที่แท่นชาร์จ"

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

  • หลังจากออกจากระบบโทรศัพท์และกลับเข้าสู่ระบบแล้ว แอป Home APIs จะควบคุมอุปกรณ์ไม่ได้ วิธีแก้ปัญหาชั่วคราว: ปิดแอปและรออย่างน้อย 10 วินาที

2025-06-26

  Home API เวอร์ชันเบต้าแบบสาธารณะ 1.3.2  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.23.31
  • เฟิร์มแวร์ฮับของ Google, Cast, Google Home, Google Home Mini และ Google Nest Mini: 3.75.468362
  • เฟิร์มแวร์ฮับของ Google, Cast, Google Nest Audio: 3.75.476451
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 26.20250116.103.2900
  • Android SDK: home.android.sdk_1_3_2
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • Matter เวอร์ชัน: 1.4.0.0

ฟีเจอร์ใหม่

  • เราได้แบ่งอาร์ติแฟกต์ SDK ออกเป็น 2 อาร์ติแฟกต์แยกกัน ได้แก่ เฟรมเวิร์ก Home APIs SDK (play-services-home-17.0.0.aar) และลักษณะของ SDK รวมถึงประเภทอุปกรณ์ (play-services-home-types-17.0.0.aar) ตั้งแต่รุ่นนี้เป็นต้นไป นักพัฒนาซอฟต์แวร์จะต้องรวมทั้ง 2 อาร์ติแฟกต์ไว้ในเส้นทางไลบรารีเวลาคอมไพล์และรันไทม์ของโปรเจ็กต์

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android เพิ่ม: ผู้ใช้สามารถยกเลิกการเชื่อมต่อและเพิกถอนสิทธิ์จากแอปได้
  • แอปตัวอย่าง Android เพิ่มสิ่งต่อไปนี้: อัปเดตอาร์ติแฟกต์ SDK ให้มี play-services-home-17.0.0 และ play-services-home-types-17.0.0

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

  • อุปกรณ์เครื่องดูดฝุ่นที่อยู่ที่แท่นชาร์จจะไม่ลงทะเบียนสถานะ "อยู่ที่แท่นชาร์จ"

05-06-2025

  Home API รุ่นเบต้าแบบสาธารณะ 1.3.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.19.32
  • เฟิร์มแวร์ของ Google Hub, Cast: 3.75.468222
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • Matter เวอร์ชัน: 1.4.0.0

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่ควรทราบ

  • แอปตัวอย่าง Android จะเพิ่มฟังก์ชันเพื่อบันทึกสถานะของโครงสร้าง อุปกรณ์ ประเภท ลักษณะ และการทำงานอัตโนมัติเพื่อให้แก้ไขข้อบกพร่องได้ง่ายขึ้น

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

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

  • ในแอปตัวอย่าง Android บางครั้งปุ่มสร้างการทำงานอัตโนมัติอาจต้องแตะหลายครั้งเพื่อทริกเกอร์

2025-05-12

  เปิดตัว Home API เวอร์ชันเบต้าสาธารณะ 1.3  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.16.33
  • เฟิร์มแวร์ของ Google Hub, Cast: 3.75.468222
  • เฟิร์มแวร์ฮับของ Google, Fuchsia: 26.20250116.103.2201
  • Android SDK: home.android.sdk_202504_EAP_1_3_RC00
  • แอป Google Home: ใช้งานได้กับทุกเวอร์ชัน
  • androidx.core ไลบรารี: ใช้งานได้กับทุกเวอร์ชัน
  • Matter เวอร์ชัน: 1.4.0.0

ฟีเจอร์ใหม่

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

  • เวลาในการตอบสนองของระบบควบคุมอุปกรณ์อาจเพิ่มขึ้นเมื่อเปลี่ยนจาก Wi-Fi เป็นเครือข่ายมือถือ
  • หลังจากรีเซ็ตฮับเป็นค่าเริ่มต้นแล้ว อุปกรณ์อาจปรากฏเป็นออฟไลน์

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

2025-04-09

  เปิดตัว Home API เวอร์ชันเบต้าแบบสาธารณะ 1.2.1  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • บริการ Google Play: 25.09.33
  • เวอร์ชันเฟิร์มแวร์ขั้นต่ำของฮับ Google
    • แคสต์: 3.75.468222
    • Fuchsia: 24.20241009.103.19006011
  • Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
  • แอป Google Home: ใช้ได้กับทุกเวอร์ชัน
  • androidx.core library: 1.10.0
  • เวอร์ชัน Matter: 1.4.0.0
1. ปัจจุบันเรากำลังเปิดตัวบิลด์นี้ในเวอร์ชันที่ใช้งานจริง และจะพร้อมให้บริการใน อุปกรณ์ทุกเครื่องภายในวันที่ 22 เมษายน 2025

ฟีเจอร์ใหม่

  • ปรับปรุงประสิทธิภาพเมื่อโหลดออบเจ็กต์จาก Home Graph
  • Automation API
    • เพิ่มการรองรับ ตัวกรองเอนทิตี ซึ่งช่วยให้การทำงานอัตโนมัติเลือกอุปกรณ์แบบไดนามิกได้ตาม เกณฑ์ที่ระบุในการทำงานอัตโนมัติ
  • Device API
    • ตอนนี้ข้อมูลอุปกรณ์แบบคลาวด์ต่อคลาวด์พร้อมใช้งานใน BasicInformationTrait แล้ว

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

  • เวลาในการตอบสนองของระบบควบคุมอุปกรณ์อาจเพิ่มขึ้นเมื่อเปลี่ยนจาก Wi-Fi เป็นเครือข่ายมือถือ
  • หลังจากรีเซ็ตฮับเป็นค่าเริ่มต้นแล้ว อุปกรณ์อาจปรากฏเป็นออฟไลน์

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

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

2025-03-14

  เปิดตัว Home API รุ่นเบต้าสาธารณะ 1.2.0  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

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

ฟีเจอร์ใหม่

  • 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 API เวอร์ชันเบต้าสาธารณะ 1.1.0  

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้าสำหรับ Android SDK ของ Home API

เวอร์ชันขั้นต่ำ

  • เวอร์ชันขั้นต่ำของบริการ Google Play: 25.02.32
  • เวอร์ชันเฟิร์มแวร์ขั้นต่ำของฮับ Google
    • เวอร์ชัน 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 ให้ทำดังนี้
    • อุปกรณ์ Matter อาจปรากฏเป็นออฟไลน์ใน แอป Google Home
    • Google Assistant ควบคุมอุปกรณ์ Matter ไม่ได้
    • จออัจฉริยะไม่สามารถควบคุมอุปกรณ์ Matter หรือแสดงสถานะของอุปกรณ์ Matter ใดๆ ได้
  • สำหรับอุปกรณ์บางเครื่อง แอปอาจไม่แสดงสถานะที่ถูกต้องเสมอไป และ แอปอาจรายงานสถานะที่แตกต่างจากที่แอปของ Google รายงาน เช่น แอป Google Home ซึ่งโดยปกติแล้ว สาเหตุเกิดจากอุปกรณ์ไม่ได้รายงานสถานะไปยัง Google
    • วิธีแก้ปัญหา: การตรวจสอบสถานะด้วยแอป Google จะช่วยแก้ไขความไม่ตรงกันได้

2025-01-14

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

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

2025-01-07

  เปิดตัว Home API เวอร์ชันเบต้าแบบสาธารณะ  

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

รุ่นนี้มีการแก้ไขข้อบกพร่องและปรับปรุงคุณภาพของเวอร์ชันเบต้า สำหรับ Android SDK ของ Home API ซึ่งรวมถึงการรองรับอุปกรณ์ Google Nest Audio และ Google TV ที่ดียิ่งขึ้น

เวอร์ชันขั้นต่ำ

  • เวอร์ชันขั้นต่ำของบริการ Google Play: 24.45.34
  • เวอร์ชันเฟิร์มแวร์ขั้นต่ำของฮับ Google
    • เวอร์ชัน Cast: 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 ให้ทำดังนี้
    • อุปกรณ์ Matter อาจปรากฏเป็นออฟไลน์ในแอป Google Home (GHA)
    • Google Assistant ควบคุมอุปกรณ์ Matter ไม่ได้
    • จออัจฉริยะไม่สามารถควบคุมอุปกรณ์ Matter หรือแสดงสถานะของอุปกรณ์ Matter ได้
  • สำหรับอุปกรณ์บางอย่าง แอปอาจไม่แสดงสถานะที่ถูกต้องเสมอไป และแอปของคุณอาจ รายงานสถานะที่แตกต่างจากที่แอปของ Google รายงาน เช่น แอป Google Home (GHA) โดยปกติแล้วสาเหตุเกิดจากอุปกรณ์ไม่ได้รายงานสถานะไปยัง Google
    • วิธีแก้ปัญหา: การตรวจสอบสถานะด้วยแอป Google จะช่วยแก้ไขความไม่ตรงกันได้

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

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