Ghi chú phát hành SDK Android cho API Home

2026-10-22

  Bản phát hành rộng rãi 1.11.1 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng GA cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.40.32
• Chương trình cơ sở của Google Hub, Cast, Nest WiFi Pro: 3.78.556638
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.79.558061
• Chương trình cơ sở của Google Hub, Fuchsia: 31.20260429.103.8713700
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_1_11_1.zip
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Hỗ trợ tạo, cập nhật và xoá các đường cong chiếu sáng tự động để điều chỉnh độ sáng và nhiệt độ màu trong suốt cả ngày trên các phòng hoặc thiết bị chiếu sáng cụ thể.
• Bổ sung hướng dẫn về cách nền tảng xử lý việc xoá dữ liệu người dùng tự động khi người dùng rời khỏi một nhà hoặc xoá Tài khoản Google của họ, cũng như cách người dùng có thể xuất dữ liệu bằng Google Takeout.
• Hỗ trợ định cấu hình và truy xuất ngôn ngữ của ứng dụng bằng setLocale() và getLocale() cho các quy trình giao diện người dùng do SDK lưu trữ, cùng với các trường văn bản được bản địa hoá (localizedTexts và localizedBodies) trong các sự kiện trên đám mây về chú thích bằng AI và bản tóm tắt do AI tạo.
• Hỗ trợ kiểm soát DeviceGroup dưới dạng một thực thể duy nhất thông qua các phần loại thiết bị, cũng như kiểm tra tư cách thành viên nhóm trên từng thiết bị và lệnh theo lô trên các thành viên nhóm.

Những thay đổi đáng chú ý khác

• Tài liệu tham khảo về Kotlin API đã được cập nhật.

Vấn đề đã biết

• Sau khi camera được tắt rồi bật lại, trạng thái kết nối của camera có thể được báo cáo là PARTIAL_ONLINE thay vì ONLINE. Tất cả các tính năng của camera trên đám mây vẫn hoạt động bình thường, ngoại trừ việc ngừng hoạt động của Matter.

2026-09-23

  Bản phát hành GA 1.11 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng GA cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.36.25
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.548779
• Chương trình cơ sở của thiết bị trung tâm Google, Cast, Tất cả các thiết bị trung tâm khác dựa trên Cast: 3.79.550760
• Chương trình cơ sở của trung tâm Google, Fuchsia: 31.20260429.103.8712702
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_11
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

warning Thông tin cập nhật quan trọng warning

• Kể từ bản phát hành phiên bản 1.11, Home API yêu cầu Kotlin 2.4.0. Nếu đang biên dịch một ứng dụng Home API bằng phiên bản Kotlin cũ hơn, bạn phải sử dụng tuỳ chọn trình biên dịch -Xskip-metadata-version-check để loại bỏ các lỗi liên quan đến siêu dữ liệu.
• Kể từ bản phát hành phiên bản 1.11, để duy trì khả năng hỗ trợ cho Kotlin Coroutine mới nhất, nhà phát triển phải cập nhật tệp gradle để nhập thư viện kotlinx.coroutines. Nếu bạn không cập nhật, lỗi thời gian chạy chặn sẽ xảy ra đối với tất cả ứng dụng Kotlin sử dụng Home API.

Tính năng mới

• Bạn có thể tạo nhóm thiết bị theo một cấu trúc duy nhất. Nhóm thiết bị đại diện cho một tập hợp thiết bị do người dùng xác định.

Những thay đổi đáng chú ý khác

• Tài liệu tham khảo về Kotlin API đã được cập nhật.

2026-09-16

Chúng tôi đã ra mắt hai máy chủ MCP mới. Home MCP cho phép các tác nhân cá nhân tương tác với nhà thông minh của bạn một cách an toàn, trong khi Home Developer MCP cung cấp tài liệu từ Trung tâm nhà phát triển Home và các tài nguyên nhà thông minh khác để các tác nhân bạn yêu thích tìm kiếm và truy vấn.

Tính năng mới

• Hướng dẫn sử dụng MCP cho nhà
• Hướng dẫn sử dụng MCP dành cho nhà phát triển nhà thông minh

2026-09-16

Ứng dụng mẫu Android cho các API cho Home đã được cập nhật cho bản phát hành các API cho Home 1.10.1.

Ứng dụng mẫu

• Hãy xem bản phát hành v1.10.1 trên GitHub để biết toàn bộ ghi chú phát hành.

2026-08-28

  Các API cho Home GA (giai đoạn phát hành rộng rãi) bản phát hành 1.10.1  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng GA cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.34.30
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.548779
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.79.547681
• Chương trình cơ sở của trung tâm Google, Fuchsia: 31.20260429.103.8712702
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10_1
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

warning Thông tin cập nhật quan trọng warning

• Kể từ bản phát hành phiên bản 1.11, để duy trì khả năng hỗ trợ cho Kotlin Coroutine mới nhất, nhà phát triển phải cập nhật tệp gradle để nhập thư viện kotlinx.coroutines. Nếu bạn không cập nhật, lỗi thời gian chạy chặn sẽ xảy ra đối với tất cả ứng dụng Kotlin sử dụng Home API.

Tính năng mới

• API Tự động hoá hiện hỗ trợ các tham số lệnh động.
• Logic If/else hiện đã được hỗ trợ trong Automation API.

Những thay đổi đáng chú ý khác

• Tài liệu tham khảo về Kotlin API đã được cập nhật.

2026-08-07

Ứng dụng mẫu Android cho các API cho Home đã được cập nhật cho bản phát hành các API cho Home 1.10.

Ứng dụng mẫu

• Hãy xem bản phát hành GitHub phiên bản 1.10 để biết ghi chú phát hành đầy đủ.

2026-08-03

  Bản phát hành GA (giai đoạn phát hành rộng rãi) 1.10 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cấp SDK Android của Home API lên chất lượng GA.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.28.31
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.78.540761
• Chương trình cơ sở của trung tâm Google, Fuchsia: 30.20260121.103.1602904
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.260317.003
• Android SDK: home.android.sdk_GHP_1_10
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

2026-07-09

Cờ forceLaunch không còn được dùng nữa. Các ứng dụng nên chuyển sang enum ForcePermissionFlow để chỉ định hành vi của giao diện người dùng yêu cầu đồng ý.

Thay đổi sắp tới

• API không dùng nữa: Phương thức requestPermissions(forceLaunch: Boolean, ...) không còn được dùng nữa trong SDK Google Home cho Android.
• Bước di chuyển: Thay thế cờ boolean bằng ForcePermissionFlow.FORCE_LAUNCH (cho true) hoặc ForcePermissionFlow.DO_NOT_FORCE_LAUNCH (cho false).

2026-07-08

Hiện đã có hướng dẫn về thiết bị bộ định tuyến biên cho Android.

Nội dung mới

• Hướng dẫn về thiết bị bộ định tuyến biên cho Android hiện đã có.

2026-07-07

Ứng dụng mẫu Home API cho Android đã được cập nhật cho bản phát hành Home API 1.9.1.

Ứng dụng mẫu

• Hãy xem bản phát hành v1.9.1 trên GitHub để biết toàn bộ ghi chú phát hành.

2026-06-26

  Bản phát hành phiên bản thử nghiệm công khai 1.9.1 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.24.22
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.78.538123
• Chương trình cơ sở của trung tâm Google, Fuchsia: 30.20260121.103.1602904
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_1_9_1.zip
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Camera và chuông cửa: Trạng thái thay pin
• Hỗ trợ ảnh chụp nhanh của Camera và Chuông cửa để dùng làm bản xem trước trong quá trình thiết lập Vùng hoạt động và Chế độ xem trực tiếp.

Khắc phục các vấn đề đã biết

• Tính năng Ghép nối nhanh không hỗ trợ các mẫu thiết bị Google Nest Cam Outdoor (dùng dây, thế hệ thứ 2), Google Nest Cam Indoor (dùng dây, thế hệ thứ 3) và Chuông cửa (dùng dây, thế hệ thứ 3).

2026-06-09

Ứng dụng mẫu Home API cho Android đã được cập nhật cho bản phát hành Home API 1.9.0.

Ứng dụng mẫu

• Hãy xem bản phát hành GitHub phiên bản 1.9.0 để biết toàn bộ ghi chú phát hành.

2026-05-29

  Bản phát hành phiên bản thử nghiệm công khai 1.9 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.20.31
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của Google Hub, Cast, tất cả các thiết bị trung tâm khác dựa trên Cast: 3.78.526062
• Chương trình cơ sở của trung tâm Google, Fuchsia: 30.20260121.103.1602904
• Chương trình cơ sở của trung tâm Google, Google TV Streamer (4k): UTTK.250729.004 (14748786)
• Android SDK: home.android.sdk_GHP_1_9
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Chế độ cài đặt camera và chuông cửa: Loại ngàm gắn camera
• Chế độ cài đặt camera và chuông cửa: Thông báo có khách
• Chế độ cài đặt camera và chuông cửa: Lựa chọn ưu tiên về chất lượng sự kiện phát trực tiếp
• Tính năng Trả lời nhanh của chuông cửa
• Gợi ý cấu trúc nhà để cho phép đối tác chọn trước cấu trúc nhà cho quy trình cấp quyền
• Hỗ trợ thiết bị nhiều thành phần trong quy trình tự động hoá
• Nội dung cập nhật cho các đặc điểm tuỳ chỉnh sau đây của Google: ExtendedFanControl, ExtendedThermostat
• Nội dung cập nhật cho các đặc điểm sau đây của Matter: ArmDisarm, FanControl, Thermostat, ThermostatFanControl, ThermostatUserInterfaceConfiguration

Vấn đề đã biết

• Tính năng Ghép nối nhanh không hỗ trợ các mẫu thiết bị Google Nest Cam Outdoor (dùng dây, thế hệ thứ 2), Google Nest Cam Indoor (dùng dây, thế hệ thứ 3) và Chuông cửa (dùng dây, thế hệ thứ 3).

2026-05-26

Ứng dụng mẫu Home API cho Android đã được cập nhật cho bản phát hành Home API 1.8.1.

Ứng dụng mẫu

• Hãy xem bản phát hành v1.8.1 trên GitHub để biết toàn bộ ghi chú phát hành.

2026-05-01

  Bản phát hành phiên bản thử nghiệm công khai 1.8.1 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.16.31
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của Google Hub, Cast, tất cả các thiết bị trung tâm khác dựa trên Cast: 3.78.526062
• Chương trình cơ sở của trung tâm Google, Fuchsia: 30.20260121.103.1602802
• Chương trình cơ sở của trung tâm Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_1
• Ứng dụng Google Home: phiên bản 4.8 trở lên
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Đặc điểm của máy điều nhiệt hiện hỗ trợ các chức năng Đọc/Cập nhật, Bật/Tắt và Hẹn giờ

Khắc phục các vấn đề đã biết

• Quá trình uỷ quyền thiết bị Matter có thể không thành công.
• Đèn Philips BLE không hiển thị đúng trạng thái.
• Độ trễ khiến mạng không ổn định và thời gian phản hồi chậm.

Vấn đề đã biết

• Không thể uỷ quyền một số thiết bị bằng Google TV Streamer, 4K.
• Khi trung tâm điều khiển là Nest Wifi Pro, Google Nest Hub hoặc Google Nest Hub Max, ứng dụng Google Home sẽ hiển thị các thiết bị nhiều phần dưới dạng nhiều ô.

2026-04-10

Ứng dụng mẫu Android cho các API cho Home đã được cập nhật cho bản phát hành các API cho Home 1.8.

Ứng dụng mẫu

• Hãy xem bản phát hành v1.8.0 trên GitHub để biết toàn bộ ghi chú phát hành.

2026-04-09

  Bản phát hành phiên bản thử nghiệm công khai 1.8 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.12.32
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của Google Hub, Cast, tất cả các thiết bị trung tâm khác dựa trên Cast: 3.78.526062
• Chương trình cơ sở của trung tâm Google, Fuchsia: 29.20251023.103.2101601
• Chương trình cơ sở của trung tâm Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_8_0
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Quy trình tự động hoá được đề xuất trong Automations API.
• Hỗ trợ thiết bị nhiều phần trong Device API.
• Thiết lập Vùng hoạt động của camera và chuông cửa trong Device API.
• Thiết lập tính năng phát hiện âm thanh của camera và chuông cửa trong API thiết bị.
• Chế độ ghi hình của camera và chuông cửa (CVR/EVR/Không có nhật ký) trong Device API.

Khắc phục các vấn đề đã biết

• Không thể thay đổi đơn vị nhiệt độ (C/F) của Google Nest Learning Thermostat (thế hệ thứ 4).
• Trong phiên bản di động của Google Home dành cho web, biểu tượng trên cùng và nút quay lại bị tiêu đề che khuất. Người dùng có thể không quay lại được hoặc không thấy các thành phần chính trên giao diện người dùng.
• Trung tâm Android TV có thể báo cáo không chính xác rằng các thiết bị Matter đang "Ngoại tuyến".

Vấn đề đã biết

• Quá trình uỷ quyền thiết bị Matter có thể không thành công.

2026-03-13

  Bản phát hành thử nghiệm công khai 1.7.1 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play:
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.78.518349
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.78.516526
• Chương trình cơ sở của trung tâm Google, Fuchsia: 29.20251023.103.2201
• Chương trình cơ sở của trung tâm Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7_1
• Ứng dụng Google Home: 1.7.1
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Chọn sử dụng tính năng Phân tích camera và chuông cửa trong API Thiết bị.
• Thời gian kết nối gần đây nhất của Camera và Chuông cửa trong API Thiết bị.
• Trạng thái kết nối của camera và chuông cửa trong Device API.
• Yêu cầu cơ bản về máy điều nhiệt trong API Thiết bị.

Những thay đổi đáng chú ý khác

• Chế độ không có trung tâm đã bị xoá.

Ứng dụng mẫu

• Ứng dụng mẫu Home API cho Android phiên bản 1.7.1. Hãy xem bản phát hành trên GitHub để biết thông tin chi tiết.

Khắc phục các vấn đề đã biết

• Đối với Nest Cam Indoor/Outdoor (pin hoặc có dây) và Nest Doorbell (pin, thế hệ thứ 2), lựa chọn "Thời lượng pin còn lại" không có trong phần Cài đặt pin.
• Chế độ cài đặt thời lượng chuông báo sẽ bị bỏ qua.
• Đèn Philips BLE xuất hiện không chính xác là "Trực tuyến" ngay cả khi thiết bị thực sự không có kết nối mạng.

Vấn đề đã biết

• Không thể thay đổi đơn vị nhiệt độ (C/F) của Google Nest Learning Thermostat (thế hệ thứ 4).
• Có thể xảy ra tình trạng chậm trễ về độ ổn định của mạng và khả năng phản hồi của thiết bị.
• Trong phiên bản di động của Google Home dành cho web, biểu tượng trên cùng và nút quay lại bị tiêu đề che khuất. Người dùng có thể không quay lại được hoặc không thấy các thành phần chính trên giao diện người dùng.
• Thiết bị trung tâm có thể bị kẹt ở trạng thái "Đang kết nối..." sau khi thiết lập OOBE Chế độ liên kết.
• Quá trình uỷ quyền thiết bị Matter có thể không thành công.
• Trung tâm Android TV có thể báo cáo không chính xác rằng các thiết bị Matter đang Ngoại tuyến.
• Phiên bản phần mềm chính xác có thể không xuất hiện trong phần Phiên bản phần mềm hiện tại của thiết bị camera.
• Thanh trượt giao diện người dùng của Máy điều nhiệt cho thấy nhiệt độ nằm ngoài phạm vi.
• Khi bạn đặt Thời lượng chuông báo, thiết bị sẽ không phát chuông báo trong khoảng thời gian đã chỉ định.

2026-02-13

Ứng dụng mẫu Home API cho Android đã được cập nhật cho bản phát hành Home API 1.7.

Ứng dụng mẫu

• Hãy xem bản phát hành v1.7.0 trên GitHub để biết toàn bộ ghi chú phát hành.

2026-02-09

  Bản phát hành thử nghiệm công khai 1.7 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 26.02.34
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.76.508025
• Chương trình cơ sở của trung tâm Google, Cast, Tất cả các trung tâm khác dựa trên Cast: 3.77.510748
• Chương trình cơ sở của trung tâm Google, Fuchsia: 29.20251023.103.2100
• Chương trình cơ sở của trung tâm Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_7
• Ứng dụng Google Home: 1.7
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0
• Phiên bản Matter: hỗ trợ thử nghiệm cho phiên bản 1.5.0

Tính năng mới

• Quy trình tự động hoá cục bộ: dựa trên các điều kiện như khả năng kết nối, loại thiết bị và đặc điểm, một số quy trình tự động hoá hiện có thể thực thi cục bộ trong Automations API.
• Bật trải nghiệm dùng ngay khi mở hộp (OOBE) của camera trong các ứng dụng trong Device API.
• Chủ đề chuông cửa và camera trong API thiết bị.
• Trình tiết kiệm pin tự động cho camera và chuông cửa trong Device API.
• Lựa chọn ưu tiên về mức sử dụng pin của camera và chuông cửa trong Device API.
• Trạng thái sạc pin của camera và chuông cửa trong API Thiết bị.
• Mức pin của camera và chuông cửa trong API Thiết bị.
• Số sê-ri của camera và chuông cửa trong Device API.
• Mẫu camera và chuông cửa trong Device API.
• Phiên bản phần mềm của camera và chuông cửa trong API Thiết bị.
• API khoá-giá trị tuỳ chỉnh trong API thiết bị.
• Truy vấn quyền cho phép ứng dụng xác định loại thiết bị nào đã được người dùng cấp quyền truy cập trong Permissions API.

Những thay đổi đáng chú ý khác

• HomeException.unsupported đã được thay thế bằng HomeException.unimplemented để phù hợp với mã lỗi tiêu chuẩn.
• Trình tạo mã đóng gói cho các đặc điểm tuỳ chỉnh đã thay đổi trong bản phát hành 1.7. Những nhà phát triển có đặc điểm tuỳ chỉnh cần biên dịch lại các đặc điểm đó sau khi tích hợp SDK 1.7.

Khắc phục các vấn đề đã biết

• API Nhật ký luôn trả về nextPageToken, gây ra vòng lặp vô hạn.
• Lỗi "Người dùng đã huỷ quy trình cấp quyền" xảy ra khi cố gắng đăng nhập vào một tài khoản mới.

Vấn đề đã biết

• Đối với Nest Cam Indoor/Outdoor (pin hoặc có dây) và Nest Doorbell (pin, thế hệ thứ 2), lựa chọn "Thời lượng pin còn lại" không có trong phần Cài đặt pin.
• Chế độ cài đặt thời lượng chuông báo sẽ bị bỏ qua.
• Đèn Philips BLE xuất hiện không chính xác là "Trực tuyến" ngay cả khi thiết bị thực sự không có kết nối mạng. Cách giải quyết: Đừng chỉ dựa vào trạng thái trực tuyến của Loại thiết bị nhà thông minh (SHDT). Thay vào đó, hãy sử dụng bản đồ Dịch vụ trạng thái thiết bị mục tiêu (TDSS) cho các thiết bị có nguồn LOCAL_SYNC.

2025-12-22

  Bản phát hành thử nghiệm công khai 1.6 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.47.30
• Chương trình cơ sở của trung tâm Google, Cast, Nest WiFi Pro: 3.75.479819
• Chương trình cơ sở của thiết bị trung tâm Google, Cast, Tất cả các thiết bị trung tâm khác dựa trên Cast: 3.77.505721
• Chương trình cơ sở của trung tâm Google, Fuchsia: 28.20250723.103.2100300
• Chương trình cơ sở của trung tâm Google, Google TV Streamer, 4K: UTTK.250729.004
• Android SDK: home.android.sdk_GHP_1_6
• Ứng dụng Google Home: 1.6
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0

Tính năng mới

• Hỗ trợ đặc điểm Thời tiết trong Automation API. Thêm tính năng hỗ trợ cho đặc điểm Thời tiết trong các điều kiện và điều kiện khởi động của quy trình tự động hoá.
• Hỗ trợ thêm nhiều tính năng cho thiết bị Camera và Chuông cửa: Các chế độ cài đặt mới (Chế độ nhìn ban đêm, Đèn LED trạng thái, Khung nhìn, Hướng, Độ nhạy, Thời lượng sự kiện, Chuông báo).
• Tính năng Đăng nhập bằng Google do ứng dụng khởi tạo để đơn giản hoá quy trình trải nghiệm người dùng và loại bỏ các bước kiểm tra người dùng đang hoạt động.
• Chế độ không có trung tâm cho phép người dùng thiết lập và điều khiển một số thiết bị Matter mà không cần trung tâm riêng.
• API kích hoạt trung tâm để khám phá và kích hoạt trung tâm.

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung chế độ cài đặt Camera, tính năng tự động hoá được xác định trước, hỗ trợ Quạt và Loa.

Vấn đề đã biết

• Các chế độ điều khiển thiết bị ngừng hoạt động sau một thời gian dài sử dụng. Cách giải quyết: Khởi động lại trung tâm.
• Quá trình uỷ quyền thiết bị Matter có thể không thành công.
• Lỗi "Người dùng đã huỷ quy trình cấp quyền" xuất hiện khi cố gắng thêm tài khoản mới trong Ứng dụng mẫu cho Android. Cách giải quyết: Thêm Tài khoản Google thông qua phần cài đặt thiết bị Android.
• Một camera an ninh có dây onn của Walmart được uỷ quyền bằng SDK API Home của Android không thể phát trực tiếp qua ứng dụng Google Home.
• Camera được uỷ quyền trong các ứng dụng Home API không thể bắt đầu phiên phát trực tiếp từ ứng dụng Google Home.

2025-10-23

  Bản phát hành thử nghiệm công khai 1.5.1 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.41.30
• Chương trình cơ sở của trung tâm Google, Cast: 3.76.495998
• Chương trình cơ sở của trung tâm Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5_1
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0

Tính năng mới

• API kích hoạt trung tâm cho phép bạn khám phá và kích hoạt trung tâm Google Home theo phương thức lập trình trong API cấu trúc.

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung tính năng hỗ trợ Loại thiết bị chuông cửa (Bật/Tắt, Phát trực tiếp, Nói chuyện hai chiều) và triển khai API kích hoạt trung tâm.

Khắc phục các vấn đề đã biết

• Ứng dụng mẫu không hiển thị chính xác trạng thái thiết bị trong Chế độ xem thiết bị.

2025-09-26

  Bản phát hành thử nghiệm công khai 1.5.0 của Home API  

Bản phát hành này hỗ trợ thiết bị Camera, sửa lỗi và nâng cao chất lượng bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.37.31
• Chương trình cơ sở của trung tâm Google, Cast: 3.76.492738
• Chương trình cơ sở của trung tâm Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_5
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.1.0

Tính năng mới

• Giờ đây, các điều kiện khởi động, điều kiện và hành động chấp nhận cấu trúc Matter làm tham số trong Automation API.
• Đã thêm loại thiết bị camera vào API Thiết bị (Sự kiện phát trực tiếp, Nói chuyện hai chiều, Bắt đầu/dừng ghi).

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung tính năng hỗ trợ cho Camera, uỷ quyền cho nhiều quản trị viên, tự động hoá OnOff được xác định trước.

Khắc phục các vấn đề đã biết

• Khi trung tâm đang hoạt động bị buộc xoá, bạn sẽ không thể điều khiển một số thiết bị trong vòng 5 phút. Sau 5 phút, khả năng điều khiển thiết bị sẽ được khôi phục.
• Sau khi người dùng chọn một màu từ giá trị đặt trước hoặc từ bộ chọn nhiệt độ màu, Đèn màu mở rộng không cập nhật được màu.

Vấn đề đã biết

• Độ trễ điều khiển thiết bị có thể tăng lên khi chuyển từ Wi-Fi sang mạng di động.
• Ứng dụng mẫu có thể không kiểm soát được các loại thiết bị Quạt được hỗ trợ bởi Cloud-to-cloud.

2025-08-29

  Bản phát hành thử nghiệm công khai 1.4.1 của Home API  

Bản phát hành này chứa các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.33.32
• Chương trình cơ sở của trung tâm Google, Cast: 3.76.495998
• Chương trình cơ sở của trung tâm Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_1
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.0.0

Tính năng mới

• Một DecommissionIneligibleReason mới được xác định để cố gắng ngừng hoạt động một thiết bị đa nguồn trong API Thiết bị.

Khắc phục các vấn đề đã biết

• Ứng dụng mẫu Android gặp sự cố khi người dùng cố gắng đặt máy điều nhiệt ở chế độ không được hỗ trợ.

Vấn đề đã biết

• Khi trung tâm đang hoạt động bị buộc xoá, bạn sẽ không thể điều khiển một số thiết bị trong vòng 5 phút. Sau 5 phút, khả năng điều khiển thiết bị sẽ được khôi phục.

2025-07-31

  Home APIs phiên bản thử nghiệm công khai 1.4.0  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản beta cho SDK Android của các API cho Home.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.28.34
• Chương trình cơ sở của trung tâm Google, Cast: 3.76.486931
• Chương trình cơ sở của trung tâm Google, Fuchsia: 27.20250422.103.3600
• Android SDK: home.android.sdk_1_4_0
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.0.0

Tính năng mới

• Bạn có thể giới hạn số lần thực thi quy trình tự động hoá trong Automation API.
• Khả năng xoá thiết bị Matter theo phương thức lập trình trong API Thiết bị.
• Đã xóa các thành viên HomeDevice không dùng nữa (trait(), isInRoom, isInStructure).
• Home.hasPermissions() hiện kết hợp cả quyền truy cập vào cấu trúc OAuth và quyền cho ứng dụng.

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android xoá các thiết bị chỉ hỗ trợ Matter, đổi tên thiết bị, thay thế các lệnh gọi API không dùng nữa.

Khắc phục các vấn đề đã biết

• Thiết bị hút bụi đã được gắn vào đế sạc không đăng ký trạng thái Đã gắn vào đế sạc.

Vấn đề đã biết

• Sau khi đăng xuất khỏi điện thoại rồi đăng nhập lại, ứng dụng Home API không thể điều khiển thiết bị. Cách giải quyết: Đóng ứng dụng và đợi ít nhất 10 giây.

2025-06-26

  Bản phát hành thử nghiệm công khai 1.3.2 của Home API  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.23.31
• Chương trình cơ sở của trung tâm Google, Cast, Google Home, Google Home Mini và Google Nest Mini: 3.75.468362
• Chương trình cơ sở của trung tâm Google, Cast, Google Nest Audio: 3.75.476451
• Chương trình cơ sở của Google Hub, Fuchsia: 26.20250116.103.2900
• Android SDK: home.android.sdk_1_3_2
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.0.0

Tính năng mới

• Cấu phần phần mềm SDK đã được chia thành hai cấu phần phần mềm riêng biệt: Khung SDK các API cho Home (play-services-home-17.0.0.aar) cũng như các đặc điểm và loại thiết bị SDK (play-services-home-types-17.0.0.aar). Kể từ bản phát hành này, nhà phát triển cần đưa cả hai cấu phần phần mềm vào đường dẫn thư viện thời gian biên dịch và thời gian chạy của dự án.

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung: Người dùng có thể ngắt kết nối và thu hồi quyền của ứng dụng.
• Bổ sung cho Ứng dụng mẫu Android: Cập nhật cấu phần phần mềm SDK để thêm play-services-home-17.0.0 và play-services-home-types-17.0.0.

Vấn đề đã biết

• Thiết bị hút bụi đã được gắn vào đế sạc không đăng ký trạng thái Đã gắn vào đế sạc.

2025-06-05

  Bản phát hành phiên bản thử nghiệm công khai 1.3.1 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.19.32
• Chương trình cơ sở của Google Hub, Cast: 3.75.468222
• Chương trình cơ sở của trung tâm Google, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202505_EAP_1_3_1_RC06
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.0.0

Tính năng mới

• Ra mắt đặc điểm SyntheticSwitch giúp đơn giản hoá việc xử lý các sự kiện do thiết bị Công tắc Matter tạo ra và cho phép công tắc kích hoạt trình khởi động tự động hoá.
• Đặc điểm ExtendedDoorLock có một thay đổi có thể gây lỗi: kiểu dữ liệu của trường user_id đã được thay đổi từ String thành Long. Bạn cần biên dịch lại các ứng dụng sử dụng đặc điểm này.

Những thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung các hàm để ghi lại trạng thái của cấu trúc, thiết bị, loại, đặc điểm và quy trình tự động hoá để giúp bạn gỡ lỗi dễ dàng hơn.

Khắc phục các vấn đề đã biết

• Ứng dụng Google Home gặp sự cố với FailedPreconditionException khi tạo quy trình tự động hoá nếu vị trí nhà không được đặt trong ứng dụng Google Home.
• Trong Ứng dụng mẫu Android, một thiết bị có connectivityState PARTIALLY_ONLINE trước đây được hiển thị là không có kết nối mạng. Trạng thái này hiện được biểu thị là trực tuyến.

Vấn đề đã biết

• Trong Ứng dụng mẫu Android, đôi khi bạn phải nhấn vào nút Tạo quy trình tự động hoá nhiều lần để kích hoạt.

2025-05-12

  Bản phát hành phiên bản thử nghiệm công khai 1.3 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.16.33
• Chương trình cơ sở của Google Hub, Cast: 3.75.468222
• Chương trình cơ sở của trung tâm Google, Fuchsia: 26.20250116.103.2201
• Android SDK: home.android.sdk_202504_EAP_1_3_RC00
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: hoạt động với mọi phiên bản
• Phiên bản Matter: 1.4.0.0

Tính năng mới

• Bổ sung tính năng hỗ trợ cho các điều kiện khởi động sự kiện định kỳ theo lịch trong Automation API, cho phép nhà phát triển tạo các quy trình tự động hoá chạy định kỳ dựa trên thời gian đồng hồ, thời gian mặt trời và các điều kiện dựa trên lịch, sử dụng biểu thức cron.
• Thêm khả năng đổi tên thiết bị trong API Thiết bị.
• Thêm khả năng đổi tên phòng trong Structure API.

Khắc phục các vấn đề đã biết

• Độ trễ điều khiển thiết bị có thể tăng lên khi chuyển từ Wi-Fi sang mạng di động.
• Sau khi bạn đặt lại một trung tâm về trạng thái ban đầu, các thiết bị có thể có trạng thái ngoại tuyến.

Vấn đề đã biết

• Ứng dụng Google Home gặp sự cố với FailedPreconditionException khi tạo quy trình tự động hoá nếu vị trí nhà riêng chưa được đặt trong ứng dụng Google Home. Cách giải quyết: Kiểm tra để đảm bảo địa chỉ nhà riêng có trong Discovery API trước khi tạo quy trình tự động hoá.

2025-04-09

  Bản phát hành phiên bản thử nghiệm công khai 1.2.1 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Dịch vụ Google Play: 25.09.33
• Phiên bản chương trình cơ sở tối thiểu của Google Hub:
  • Cast: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• Android SDK: home.android.sdk_202503_EAP_1_2_1_RC02
• Ứng dụng Google Home: hoạt động với mọi phiên bản
• Thư viện androidx.core: 1.10.0
• Phiên bản Matter: 1.4.0.0

^{1. Bản dựng này hiện đang được triển khai cho môi trường phát hành chính thức và sẽ có trên tất cả thiết bị chậm nhất vào ngày 22 tháng 4 năm 2025.}

Tính năng mới

• Cải thiện hiệu suất khi tải đối tượng từ Home Graph.
• Automation API
  • Bổ sung tính năng hỗ trợ cho bộ lọc thực thể, cho phép quy trình tự động hoá chọn thiết bị một cách linh động dựa trên tiêu chí được chỉ định trong quy trình tự động hoá.
• Device API
  • Thông tin về thiết bị từ đám mây đến đám mây hiện có trong BasicInformationTrait.

Vấn đề đã biết

• Độ trễ điều khiển thiết bị có thể tăng lên khi chuyển từ Wi-Fi sang mạng di động.
• Sau khi bạn đặt lại một trung tâm về trạng thái ban đầu, các thiết bị có thể có trạng thái ngoại tuyến.

Khắc phục các vấn đề đã biết

• Nếu Discovery API được gọi trước khi khởi chạy hoặc trước khi quá trình khởi chạy hoàn tất, thì hệ thống sẽ gửi một HomeException có code 14: UNKNOWN và thông báo "No route found." (Không tìm thấy tuyến đường).
• Trong môi trường có nhiều cấu trúc và nhiều người dùng, việc chuyển đổi giữa các cấu trúc và người dùng có thể khiến hệ thống không trả về thiết bị nào.

2025-03-14

  Bản phát hành phiên bản thử nghiệm công khai 1.2.0 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Phiên bản tối thiểu của Dịch vụ Google Play: 25.06.32
• Phiên bản chương trình cơ sở tối thiểu của Google Hub:
  • Phiên bản Cast: 3.75.456944
  • Phiên bản Fuchsia tối thiểu: 24.20241009.103.1900601
• Android SDK: home.android.sdk_1_2_0_RC06
• Phiên bản tối thiểu của ứng dụng Google Home: hoạt động với mọi phiên bản
• Phiên bản tối thiểu của thư viện androidx.core: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại thiết bị và cụm thiết bị tạm thời của Matter không được hỗ trợ.

Tính năng mới

• Automation API:
  • Hỗ trợ phạm vi ngày và ngày không đầy đủ trong các điều kiện tự động hoá. Xem phần Sử dụng ngày với between.
  • Trong các bản phát hành trước, Discovery API trả về một NumberSetConstraint cho một số trường bitmap, trong khi lẽ ra phải trả về một BitmapConstraint. Các trường này hiện trả về một BitmapConstraint như dự kiến. Tính năng này chỉ áp dụng cho bitmap optionsMask và optionsOverride trong các lệnh đặc điểm LevelControl.

Vấn đề đã biết

• Độ trễ điều khiển thiết bị có thể tăng lên khi chuyển từ Wi-Fi sang mạng di động.
• Sau khi bạn đặt lại một trung tâm về trạng thái ban đầu, các thiết bị có thể có trạng thái ngoại tuyến.
• Nếu Discovery API được gọi trước khi khởi chạy hoặc trước khi quá trình khởi chạy hoàn tất, thì hệ thống sẽ gửi một HomeException có code 14: UNKNOWN và thông báo "No route found." (Không tìm thấy tuyến đường).
  • Cách giải quyết: Chỉ gọi Discovery API khi bạn thực sự cần các ứng viên tự động hoá. Đừng tìm nạp trước và lưu các thực thể đề xuất vào bộ nhớ đệm. Kiểm tra xem một thực thể có đang kết nối mạng hay không trước khi gọi các phương thức Discovery API trên thực thể đó.
• Trong môi trường có nhiều cấu trúc và nhiều người dùng, việc chuyển đổi giữa các cấu trúc và người dùng có thể khiến hệ thống không trả về thiết bị nào.

Khắc phục các vấn đề đã biết

• Lần đầu tiên một ứng dụng các API cho Home gọi HomeManager.structures() sau khi khởi chạy, ứng dụng đó sẽ nhận được 0 cấu trúc, ngay cả khi có một hoặc nhiều cấu trúc. Điều này tạo ra ấn tượng không chính xác rằng không có cấu trúc nào được liên kết với Tài khoản Google.
• Khi tải, tạo và chỉnh sửa quy trình tự động hoá, người dùng có thể phải chờ đợi lâu.
• Người dùng bắt đầu quy trình thiết lập từ ứng dụng Máy ảnh phải quét mã QR hai lần để hoàn tất quy trình uỷ quyền Matter.
• Trong một cấu trúc chứa hơn 200 thiết bị, Discovery API có thể không trả về ứng viên nào.

2025-01-29

  Bản phát hành phiên bản thử nghiệm công khai 1.1.0 của các API cho Home  

Bản phát hành này có các bản sửa lỗi và nâng cao chất lượng của phiên bản thử nghiệm cho SDK Android của Home API.

Phiên bản tối thiểu

• Phiên bản tối thiểu của Dịch vụ Google Play: 25.02.32
• Phiên bản chương trình cơ sở tối thiểu của Google Hub:
  • Phiên bản Cast: 3.75.456944
  • Phiên bản Fuchsia tối thiểu: 24.20241009.103.1900500
• Android SDK: home.android.sdk_202412_EAP_1_1_RC04
• Phiên bản tối thiểu của ứng dụng Google Home: hoạt động với mọi phiên bản
• Phiên bản tối thiểu của thư viện androidx.core: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại thiết bị và cụm thiết bị tạm thời của Matter không được hỗ trợ.

Tính năng mới

• API truyền trực tuyến:
  • Cung cấp luồng sự kiện thông báo về các nhà, phòng và thiết bị đã được thêm, thay đổi và xoá.
  • Xem phần Đăng ký nhận thông báo về sự kiện mối quan hệ giữa các thực thể.
• Batching API (Thử nghiệm):
  • Cho phép nhà phát triển gửi nhiều lệnh theo lô được thực thi đồng thời.
  • Xem phần Gửi nhiều lệnh cùng lúc.

Vấn đề đã biết

• Khi tải, tạo và chỉnh sửa quy trình tự động hoá, người dùng có thể phải chờ đợi lâu.
• Người dùng bắt đầu quy trình thiết lập từ ứng dụng Máy ảnh phải quét mã QR hai lần để hoàn tất quy trình uỷ quyền Matter.
• Trong một cấu trúc chứa hơn 200 thiết bị, Discovery API có thể không trả về ứng viên nào.

Khắc phục các vấn đề đã biết

• Việc chuyển đổi Tài khoản Google đã đăng nhập có thể không thành công và dẫn đến lỗi.
• Thiết bị Google TV có thể không hoạt động với các quy trình tự động hoá sử dụng đặc điểm MediaPlayback.
• Trong một nhà chỉ có một trung tâm điều khiển của Google:
  • Thiết bị Matter có thể xuất hiện ở trạng thái không có kết nối mạng trong ứng dụng Google Home.
  • Trợ lý Google không thể điều khiển các thiết bị Matter.
  • Màn hình thông minh không thể điều khiển thiết bị Matter hoặc hiển thị trạng thái của bất kỳ thiết bị Matter nào.
• Đối với một số thiết bị, ứng dụng có thể không phải lúc nào cũng phản ánh trạng thái chính xác và ứng dụng của bạn có thể báo cáo trạng thái khác với trạng thái do một ứng dụng của Google báo cáo, chẳng hạn như ứng dụng Google Home. Điều này thường là do thiết bị không báo cáo trạng thái cho Google.
  • Cách giải quyết: Kiểm tra trạng thái bằng một ứng dụng Google để giải quyết tình trạng không khớp.

2025-01-14

Cập nhật hướng dẫn khởi chạy các API cho Home.

Chúng tôi đã làm rõ hơn rằng một thực thể của Home phải được khởi chạy dưới dạng một singleton ngữ cảnh. Điều này đảm bảo trải nghiệm người dùng mượt mà hơn trong ứng dụng của bạn và tránh lỗi với các phiên không hợp lệ.

2025-01-07

  Bản phát hành phiên bản thử nghiệm công khai của các API cho Home  

Trong giai đoạn thử nghiệm công khai dành cho nhà phát triển, tất cả nhà phát triển đều có thể bắt đầu xây dựng và thử nghiệm ứng dụng của mình.

Bản phát hành này bao gồm các bản sửa lỗi và nâng cao chất lượng bản thử nghiệm beta cho SDK Android của các API cho Home, bao gồm cả việc cải thiện khả năng hỗ trợ cho Google Nest Audio và thiết bị Google TV.

Phiên bản tối thiểu

• Phiên bản tối thiểu của Dịch vụ Google Play: 24.45.34
• Phiên bản chương trình cơ sở tối thiểu của Google Hub:
  • Phiên bản Cast: 3.74.444798
  • Phiên bản Fuchsia tối thiểu: 22.20240805.103.161
• Android SDK: home.android.sdk_202411_EAP_1_0_1_RC00
• Phiên bản tối thiểu của ứng dụng Google Home (GHA): hoạt động với mọi phiên bản
• Phiên bản tối thiểu của thư viện androidx.core: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại thiết bị và cụm thiết bị tạm thời của Matter không được hỗ trợ.

Vấn đề đã biết

• Việc chuyển đổi Tài khoản Google đã đăng nhập có thể không thành công và dẫn đến lỗi.
  • Cách giải quyết: Chạy lại quy trình cấp quyền hoặc khởi động lại ứng dụng.
• Thiết bị Google TV có thể không hoạt động với các quy trình tự động hoá sử dụng đặc điểm MediaPlayback.
• Trong một cấu trúc chỉ chứa một trung tâm Google:
  • Thiết bị Matter có thể xuất hiện ở trạng thái không có kết nối mạng trong ứng dụng Google Home (GHA).
  • Trợ lý Google không thể điều khiển các thiết bị Matter.
  • Màn hình thông minh không thể điều khiển thiết bị Matter hoặc hiển thị trạng thái của bất kỳ thiết bị Matter nào.
• Đối với một số thiết bị, ứng dụng có thể không phải lúc nào cũng phản ánh trạng thái chính xác và ứng dụng của bạn có thể báo cáo trạng thái khác với trạng thái do một ứng dụng của Google báo cáo, chẳng hạn như ứng dụng Google Home (GHA). Điều này thường là do thiết bị không báo cáo trạng thái cho Google.
  • Cách giải quyết: Kiểm tra trạng thái bằng một ứng dụng Google để giải quyết tình trạng không khớp.

Khắc phục các vấn đề đã biết

• Quá trình uỷ quyền có thể không thành công nếu ứng dụng bị thu nhỏ trong quá trình này.
  • Cách giải quyết: Sử dụng suppressHalfSheetNotification() API để chặn thông báo nửa trang khi dùng Commissioning API trong ứng dụng của bạn.
• Sự cố phía máy chủ có thể khiến các điều kiện khởi động OkGoogle không hoạt động trong quy trình tự động hoá.
• Khi sử dụng một trung tâm chạy Fuchsia không có thiết bị Matter nào trong cấu trúc, nếu trung tâm đó ở trạng thái rảnh trong hơn 3 giờ, thì việc uỷ quyền cho thiết bị Matter đầu tiên sẽ khiến thiết bị Matter đó chuyển sang trạng thái ngoại tuyến.
• Sau khi đặt lại dữ liệu về trạng thái ban đầu cho một trung tâm, các lệnh đến thiết bị mới được uỷ quyền có thể không thực hiện được mặc dù thiết bị được báo cáo là đang kết nối mạng.