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

2026-10-22

  Home API เวอร์ชัน GA 1.11.1  

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

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

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่น่าสนใจ

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

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

2026-09-23

  Home API เวอร์ชัน GA 1.11  

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

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

ข้อมูลอัปเดตที่สำคัญ

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่น่าสนใจ

2026-09-16

เราได้เปิดตัวเซิร์ฟเวอร์ MCP ใหม่ 2 รายการ MCP สำหรับบ้านช่วยให้ตัวแทนส่วนบุคคลโต้ตอบกับสมาร์ทโฮมของคุณได้อย่างปลอดภัย ส่วน MCP สำหรับนักพัฒนาแอปสมาร์ทโฮมจะทำให้เอกสารประกอบจากศูนย์นักพัฒนาแอปสมาร์ทโฮมและแหล่งข้อมูลสมาร์ทโฮมอื่นๆ พร้อมใช้งานสำหรับตัวแทนที่คุณชื่นชอบในการค้นหาและค้นข้อมูล

ฟีเจอร์ใหม่

2026-09-16

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

แอปตัวอย่าง

2026-08-28

  Home API เวอร์ชัน GA 1.10.1  

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

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

ข้อมูลอัปเดตที่สำคัญ

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่น่าสนใจ

2026-08-07

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

แอปตัวอย่าง

2026-08-03

  Home API เวอร์ชัน GA 1.10  

รุ่นนี้มีการแก้ไขข้อบกพร่องและโปรโมต Android SDK ของ Home API เป็นคุณภาพระดับ GA

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

2026-07-09

เลิกใช้งานแฟล็ก forceLaunch แล้ว แอปพลิเคชันควรเปลี่ยนไปใช้ enum ForcePermissionFlow เพื่อระบุลักษณะการทำงานของ UI ความยินยอม

การเปลี่ยนแปลงที่กำลังจะเกิดขึ้น

2026-07-08

คู่มืออุปกรณ์ Border Router สำหรับ Android เผยแพร่แล้ว

เนื้อหาใหม่

2026-07-07

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

แอปตัวอย่าง

2026-06-26

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.9.1  

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

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

ฟีเจอร์ใหม่

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

  • อุปกรณ์รุ่น Google Nest Cam Outdoor (แบบใช้สาย, รุ่นที่ 2), Google Nest Cam Indoor (แบบใช้สาย, รุ่นที่ 3) และ Doorbell (แบบใช้สาย, รุ่นที่ 3) ไม่รองรับการจัดเตรียมด้วยฟีเจอร์จับคู่ด่วน

2026-06-09

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

แอปตัวอย่าง

2026-05-29

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.9  

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

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

ฟีเจอร์ใหม่

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

  • อุปกรณ์รุ่น Google Nest Cam Outdoor (แบบใช้สาย, รุ่นที่ 2), Google Nest Cam Indoor (แบบใช้สาย, รุ่นที่ 3) และ Doorbell (แบบใช้สาย, รุ่นที่ 3) ไม่รองรับการจัดเตรียมด้วยฟีเจอร์จับคู่ด่วน

2026-05-26

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

แอปตัวอย่าง

2026-05-01

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.8.1  

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

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

ฟีเจอร์ใหม่

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

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

  • การจัดเตรียมอุปกรณ์ 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  

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

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

  • บริการ Google Play: 26.12.32
  • เฟิร์มแวร์ของ Google Hub, Cast, Nest Wifi Pro: 3.78.518349
  • เฟิร์มแวร์ Google Hub, Cast, ฮับที่ใช้ Cast อื่นๆ ทั้งหมด: 3.78.526062
  • เฟิร์มแวร์ Google Hub, Fuchsia: 29.20251023.103.2101601
  • เฟิร์มแวร์ของ Google Hub, 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  

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

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

  • บริการ Google Play:
  • เฟิร์มแวร์ของ Google Hub, Cast, Nest Wifi Pro: 3.78.518349
  • เฟิร์มแวร์ของ Google Hub, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.78.516526
  • เฟิร์มแวร์ Google Hub, Fuchsia: 29.20251023.103.2201
  • เฟิร์มแวร์ของ Google Hub, 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 แบบทดลอง

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่น่าสนใจ

  • นำโหมด Hubless ออกแล้ว

แอปตัวอย่าง

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

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

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

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

2026-02-13

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

แอปตัวอย่าง

2026-02-09

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.7  

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

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

  • บริการ Google Play: 26.02.34
  • เฟิร์มแวร์ของฮับ Google, Cast, Nest Wifi Pro: 3.76.508025
  • เฟิร์มแวร์ Google Hub, Cast, ฮับที่ใช้ Cast อื่นๆ ทั้งหมด: 3.77.510748
  • เฟิร์มแวร์ Google Hub, Fuchsia: 29.20251023.103.2100
  • เฟิร์มแวร์ของ Google Hub, 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) เพียงอย่างเดียว แต่ให้ใช้การจับคู่ Target Device State Service (TDSS) สำหรับอุปกรณ์ที่มีแหล่งที่มาเป็น LOCAL_SYNC แทน

2025-12-22

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.6  

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

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

  • บริการ Google Play: 25.47.30
  • เฟิร์มแวร์ของ Google Hub, Cast, Nest Wifi Pro: 3.75.479819
  • เฟิร์มแวร์ของ Google Hub, Cast, ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.77.505721
  • เฟิร์มแวร์ Google Hub, Fuchsia: 28.20250723.103.2100300
  • เฟิร์มแวร์ของ Google Hub, 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 ที่เปิดใช้งานโดยใช้ Android Home APIs SDK ไม่สามารถไลฟ์สดผ่านแอป Google Home ได้
  • กล้องที่คอมมิชชันในแอป Home API จะเริ่มเซสชันไลฟ์สดจากแอป Google Home ไม่ได้

2025-10-23

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.5.1  

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

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

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

ฟีเจอร์ใหม่

การเปลี่ยนแปลงอื่นๆ ที่น่าสนใจ

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

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

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

2025-09-26

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.5.0  

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

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

  • บริการ Google Play: 25.37.31
  • เฟิร์มแวร์ของ Google Hub, Cast: 3.76.492738
  • เฟิร์มแวร์ Google Hub, 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 เป็นเครือข่ายมือถือ
  • การควบคุมประเภทอุปกรณ์พัดลมที่รองรับโดยระบบจากระบบคลาวด์สู่ระบบคลาวด์อาจไม่ทำงานในแอปตัวอย่าง

2025-08-29

  Home API เวอร์ชันเบต้าสำหรับผู้ใช้ทั่วไป 1.4.1  

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

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

  • บริการ Google Play: 25.33.32
  • เฟิร์มแวร์ Google Hub, Cast: 3.76.495998
  • เฟิร์มแวร์ Google Hub, 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  

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

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

  • บริการ Google Play: 25.28.34
  • เฟิร์มแวร์ Google Hub, Cast: 3.76.486931
  • เฟิร์มแวร์ Google Hub, 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 API จะควบคุมอุปกรณ์ไม่ได้ วิธีแก้ปัญหา: ปิดแอปและรออย่างน้อย 10 วินาที

2025-06-26

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.3.2  

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

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

  • บริการ Google Play: 25.23.31
  • เฟิร์มแวร์ Google Hub, Cast, Google Home, Google Home Mini และ Google Nest Mini: 3.75.468362
  • เฟิร์มแวร์ Google Hub, Cast, Google Nest Audio: 3.75.476451
  • เฟิร์มแวร์ Google Hub, 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  

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

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

  • บริการ Google Play: 25.19.32
  • เฟิร์มแวร์ Google Hub, Cast: 3.75.468222
  • เฟิร์มแวร์ Google Hub, 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  

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

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

  • บริการ Google Play: 25.16.33
  • เฟิร์มแวร์ Google Hub, Cast: 3.75.468222
  • เฟิร์มแวร์ Google Hub, 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  

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

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

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

ฟีเจอร์ใหม่

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

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

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

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

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

2025-03-14

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.2.0  

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

2025-01-29

  Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป 1.1.0  

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

2025-01-14

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

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

2025-01-07

  การเปิดตัว Home API รุ่นเบต้าสำหรับผู้ใช้ทั่วไป  

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

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

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

  • บริการ Google Play เวอร์ชันขั้นต่ำ: 24.45.34
  • เวอร์ชันขั้นต่ำของเฟิร์มแวร์ Google Hub
    • เวอร์ชัน 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 ในแอป
  • ปัญหาฝั่งเซิร์ฟเวอร์อาจทำให้เงื่อนไขเริ่มต้น OkGoogle ไม่ทำงานในการทำงานอัตโนมัติ
  • เมื่อใช้ฮับที่ใช้ Fuchsia ซึ่งไม่มีอุปกรณ์ Matter ในบ้าน หากปล่อยฮับไว้โดยไม่มีการใช้งานนานกว่า 3 ชั่วโมง การคอมมิชชันอุปกรณ์ Matter เครื่องแรกจะส่งผลให้อุปกรณ์ Matter ออฟไลน์
  • หลังจากรีเซ็ตข้อมูลเป็นค่าเริ่มต้นสำหรับฮับแล้ว คำสั่งไปยังอุปกรณ์ที่เพิ่งเริ่มใช้งานอาจไม่สำเร็จแม้ว่าอุปกรณ์จะรายงานว่าออนไลน์อยู่ก็ตาม