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

2026-02-09

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

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

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

• บริการ Google Play: 26.02.34
• เวอร์ชันเฟิร์มแวร์ขั้นต่ำของฮับ Google
  • แคสต์
    • Nest Wifi Pro: 3.76.508025
    • ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.77.510748
  • Fuchsia: 29.20251023.103.2100
  • 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 โดยรองรับเวอร์ชันทดลองสำหรับ 1.5.0

ฟีเจอร์ใหม่

• API การทำงานอัตโนมัติ
  • การทำงานอัตโนมัติในพื้นที่: การทำงานอัตโนมัติบางอย่างอาจทำงานในพื้นที่ได้แล้วในตอนนี้โดยอิงตามเงื่อนไขต่างๆ เช่น การเชื่อมต่อ ประเภทอุปกรณ์ และลักษณะ
• Device API
  • การเปิดใช้ประสบการณ์ใช้งานครั้งแรก (OOBE) ของกล้องในแอป
  • ฟีเจอร์ใหม่ของอุปกรณ์กล้องและกริ่งประตู

    ดูรายละเอียดได้ที่คู่มืออุปกรณ์กล้องสำหรับ Android และคู่มืออุปกรณ์กริ่งประตูสำหรับ Android

  • การตั้งค่า
    • ธีมเสียงกริ่ง
    • โหมดประหยัดแบตเตอรี่อัตโนมัติ
    • ค่ากำหนดการใช้งานแบตเตอรี่
  • สถานะของอุปกรณ์
    • สถานะการชาร์จแบตเตอรี่
    • ระดับแบตเตอรี่
  • ข้อมูลอุปกรณ์
    • หมายเลขซีเรียล
    • โมเดล
    • เวอร์ชันซอฟต์แวร์

Permissions API

• การค้นหาสิทธิ์ช่วยให้ แอปกำหนดประเภทอุปกรณ์ที่ผู้ใช้ให้สิทธิ์เข้าถึงได้

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

• HomeException.unsupported ถูกแทนที่ด้วย HomeException.unimplemented เพื่อให้สอดคล้องกับรหัสข้อผิดพลาดมาตรฐาน
• เครื่องมือสร้างโค้ดที่แพ็กเกจไว้สำหรับลักษณะที่กำหนดเองมีการเปลี่ยนแปลงสำหรับรุ่น 1.7 นักพัฒนาแอปที่มีลักษณะที่กำหนดเองจะต้องคอมไพล์ลักษณะอีกครั้งเมื่อผสานรวม SDK 1.7 แล้ว

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

• 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  

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

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

• บริการ Google Play: 25.47.30
• เวอร์ชันเฟิร์มแวร์ขั้นต่ำของฮับ Google
  • แคสต์
    • Nest Wifi Pro: 3.75.479819
    • ฮับอื่นๆ ทั้งหมดที่ใช้ Cast: 3.77.505721
  • Fuchsia: 28.20250723.103.2100300
  • 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

ฟีเจอร์ใหม่

• Automation API
  • การรองรับลักษณะสภาพอากาศ

    เพิ่มการรองรับลักษณะสภาพอากาศในเงื่อนไขเริ่มต้นและเงื่อนไขของการทำงานอัตโนมัติ ดูการเริ่มต้นตามสภาพอากาศ

• Device API
  • การรองรับความสามารถของอุปกรณ์กล้องและกริ่งประตูเพิ่มเติม
    • การตั้งค่าใหม่
      • เปิด/ปิดภาพกลางคืน
      • ความสว่างของไฟ LED แสดงสถานะ
      • วิวพอร์ตของกล้อง
      • การวางแนวรูปภาพ
      • ความไวในการปลุกระบบ
      • ระยะเวลาสูงสุดของเหตุการณ์
      • เสียงกริ่ง

      ดูข้อมูลเพิ่มเติมได้ที่คู่มืออุปกรณ์กล้องสำหรับ Android

• การเชื่อมต่อ
  • การลงชื่อเข้าใช้ด้วย Google ที่แอปเริ่มต้น ซึ่งช่วยให้แอปเริ่มต้น HomeClient ด้วยข้อมูลบัญชี Google เพื่อปรับปรุงขั้นตอน UX และไม่จำเป็นต้องตรวจสอบว่าผู้ใช้รายใดกำลังเรียกใช้แอป

  • โหมดไม่ใช้ฮับ

    ตอนนี้ผู้ใช้สามารถเริ่มต้นใช้งานและควบคุมอุปกรณ์ Matter บางอย่างได้โดยไม่ต้องใช้ฮับแบบสแตนด์อโลน

• Structure API
  • Hub Activation API ใหม่ ช่วยให้แอปค้นพบและเปิดใช้งานฮับได้

• ตัวอย่างแอป Android
  • การตั้งค่ากล้องและกริ่งประตู
    • เปิด/ปิดไมโครโฟน
    • เปิด/ปิดการบันทึกเสียง
  • การทำงานอัตโนมัติที่กำหนดไว้ล่วงหน้า
  • เพิ่มการรองรับประเภทอุปกรณ์พัดลมและลำโพง
• Google Sign-In ที่แอปเริ่มต้น

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

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

2025-10-23

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

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

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

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

ฟีเจอร์ใหม่

• Structure API
  • Hub Activation API ช่วยให้คุณค้นหาและเปิดใช้งานฮับ Google Home ได้โดยใช้โปรแกรม ดูAPI การเปิดใช้งานฮับใน Android
    
• ตัวอย่างแอป Android
  • การรองรับประเภทอุปกรณ์กริ่งประตูสำหรับ
    • OnOff
    • ไลฟ์สด
    • การพูดแบบ 2 ทาง
  • Hub Activation API: เปิดใช้งานฮับ

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

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

2025-09-26

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

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

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

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

ฟีเจอร์ใหม่

• Automation API
  • ตอนนี้เงื่อนไขเริ่มต้น เงื่อนไข และการดำเนินการยอมรับโครงสร้าง Matter เป็นพารามิเตอร์แล้ว
• Device API
  • เพิ่มประเภทอุปกรณ์กล้อง ฟีเจอร์กล้องต่อไปนี้ยังพร้อมให้บริการ สำหรับอุปกรณ์ประเภทกริ่งประตูด้วย
  • ไลฟ์สดจากกล้อง
  • การพูดแบบ 2 ทางของกล้อง
  • กล้องเริ่มและหยุดบันทึก
• ตัวอย่างแอป Android
  • การรองรับประเภทอุปกรณ์กล้อง
    • ไลฟ์สดจากกล้อง
    • การพูดแบบ 2 ทางของกล้อง
    • กล้องเริ่มและหยุดบันทึก
    • สิทธิ์สำหรับอุปกรณ์ประเภทต่างๆ ที่ถูกจำกัด
  • การจัดสรรผู้ดูแลระบบหลายคน (แชร์อุปกรณ์ที่จัดสรร)
  • OnOffการทำงานอัตโนมัติที่กำหนดไว้ล่วงหน้า

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

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

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

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

2025-09-08

เราได้เผยแพร่แอปตัวอย่างสำหรับ Android เวอร์ชัน 1.4.1 แล้ว

ฟีเจอร์ใหม่

• สร้าง เปลี่ยนชื่อ อัปเดต และลบห้อง
• การจัดเตรียมอุปกรณ์ใน Fabric ของ Matter ของบุคคลที่สาม

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

• ตอนนี้ลิงก์หน้าการเพิกถอนสิทธิ์ใช้งานได้แล้ว

2025-08-29

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

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

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

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

ฟีเจอร์ใหม่

• Device API
  • มีการกำหนด DecommissionIneligibleReason ใหม่สำหรับการพยายาม เลิกใช้งานอุปกรณ์แบบหลายแหล่งที่มา ดู อุปกรณ์แบบหลายแหล่งที่มา

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

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

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

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

2025-07-31

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

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

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

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

ฟีเจอร์ใหม่

• Automation API
  • คุณจำกัดการทำงานอัตโนมัติให้ดำเนินการได้สูงสุดตามจำนวนครั้งที่กำหนด ดู จำกัดจำนวน การดำเนินการ

• Device API
  • ความสามารถในการนำอุปกรณ์ Matter ออกโดยใช้โปรแกรม ดูหัวข้อ นำอุปกรณ์ออก
  • ระบบได้นำสมาชิก HomeDevice ที่เลิกใช้งานแล้วต่อไปนี้ออกแล้ว
    1. HomeDevice.trait() ดู เข้าถึงอุปกรณ์และข้อมูลเมตาของอุปกรณ์สำหรับ Android
    2. HomeDevice.isInRoom ใช้ HomeDevice.roomId แทน
    3. HomeDevice.isInStructure ใช้ HomeDevice.structureId แทน
• Structure API
  • ขณะนี้ Home.hasPermissions() ได้รวมทั้งสถานะการให้สิทธิ์ OAuth สำหรับผู้ใช้ (สิทธิ์เข้าถึงโครงสร้าง) และการให้สิทธิ์ของแอปพลิเคชัน ไว้ด้วยกัน
• ตัวอย่างแอป Android
  • แทนที่การเรียก API ที่เลิกใช้งานแล้ว
  • เปลี่ยนชื่ออุปกรณ์
  • ลบอุปกรณ์ที่ใช้ Matter เท่านั้น

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

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

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

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

2025-07-08

เฟิร์มแวร์ Cast เวอร์ชัน 3.76.479819 ทำให้ Nest Wifi Pro ทำหน้าที่เป็น ฮับ Home API ได้แล้ว

2025-06-26

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

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

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

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

ฟีเจอร์ใหม่

• อาร์ติแฟกต์ SDK แบ่งออกเป็น 2 อาร์ติแฟกต์แยกกัน ดังนี้
  • เฟรมเวิร์ก SDK ของ Home API (play-services-home-17.0.0.aar)
  • ลักษณะ SDK และประเภทอุปกรณ์ (play-services-home-types-17.0.0.aar)

  ตั้งแต่รุ่นนี้เป็นต้นไป นักพัฒนาแอปจะต้องรวมทั้ง 2 อาร์ติแฟกต์ไว้ในเส้นทางไลบรารีของโปรเจ็กต์ทั้งในเวลาคอมไพล์และรันไทม์

แอปตัวอย่าง 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
  • แคสต์: 3.75.468222
  • 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

ฟีเจอร์ใหม่

ลักษณะ

• ขอแนะนำ SyntheticSwitch ลักษณะที่ช่วยลดความซับซ้อนในการจัดการเหตุการณ์ที่สร้างขึ้นโดยอุปกรณ์สวิตช์ Matter และช่วยให้ สวิตช์ทริกเกอร์เงื่อนไขเริ่มต้นของการทำงานอัตโนมัติได้
• ลักษณะ ExtendedDoorLock มีการเปลี่ยนแปลงที่ทำให้ใช้งานไม่ได้ โดยมีการเปลี่ยนประเภทข้อมูลของฟิลด์ user_id จาก String เป็น Long ดู
  • ExtendedDoorLockTrait.LockStateChange.user_id
  • ExtendedDoorLockTrait.PrivacyModeActor.user_id

  แอปที่ใช้ลักษณะนี้ต้องคอมไพล์ใหม่

แอปตัวอย่าง Android

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

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

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

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

• แอป Google Home ขัดข้องพร้อมFailedPreconditionExceptionเมื่อสร้าง การทำงานอัตโนมัติหากไม่ได้ตั้งค่าตำแหน่งบ้านในแอป Google Home (GHA) (ดูเปลี่ยนที่อยู่บ้านใน Google เพื่อดูวิธีตั้งค่าตำแหน่งบ้าน)
• ในแอปตัวอย่าง Android ก่อนหน้านี้ อุปกรณ์ที่มี connectivityState PARTIALLY_ONLINE จะแสดงต่อผู้ใช้เป็นออฟไลน์ ตอนนี้สถานะนี้จะแสดงเป็นออนไลน์

2025-05-12

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

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

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

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

ฟีเจอร์ใหม่

• Automation API
  • เพิ่มการรองรับ เงื่อนไขเริ่มต้นของกิจกรรมที่กำหนดเวลาที่เกิดซ้ำ ซึ่งช่วยให้นักพัฒนาแอปสร้างการทำงานอัตโนมัติที่ ทำงานเป็นระยะๆ ตามเวลาในนาฬิกา เวลาสุริยะ และเงื่อนไขตามปฏิทินได้โดยใช้ นิพจน์ cron
• Device API
  • เพิ่มความสามารถในการเปลี่ยนชื่ออุปกรณ์ ดู เปลี่ยนชื่อ อุปกรณ์
• Structure API
  • เพิ่มความสามารถในการเปลี่ยนชื่อห้อง ดูหัวข้อ เปลี่ยนชื่อห้อง

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

แอป Google Home ขัดข้องพร้อมข้อความ FailedPreconditionException เมื่อสร้าง การทำงานอัตโนมัติหากไม่ได้ตั้งค่าตำแหน่งบ้านในแอป Google Home (GHA) (ดูวิธีตั้งค่าได้ที่เปลี่ยนที่อยู่บ้านใน Google)

• วิธีแก้ปัญหา: ตรวจสอบว่ามีที่อยู่บ้านโดยใช้ Discovery API ก่อนที่จะพยายามสร้างการทำงานอัตโนมัติ

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

• เวลาในการตอบสนองของระบบควบคุมอุปกรณ์อาจเพิ่มขึ้นเมื่อเปลี่ยนจาก 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.1900601¹
• 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 ชั่วคราว

ฟีเจอร์ใหม่

• Streaming API:
  • แสดงสตรีมเหตุการณ์ที่แจ้งเตือนเกี่ยวกับโครงสร้าง ห้อง และอุปกรณ์ที่ เพิ่ม เปลี่ยนแปลง และนำออก
  • ดู สมัครรับข้อมูลเหตุการณ์ ความสัมพันธ์ของเอนทิตี
• Batching API (ทดลอง):
  • ช่วยให้นักพัฒนาแอปส่งคำสั่งหลายรายการเป็นชุดซึ่ง ดำเนินการพร้อมกันได้
  • ดูหัวข้อ ส่งคำสั่งหลายรายการพร้อมกัน

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

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