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

2026-05-01

  Bản phát hành 1.8.1 của Home API (Beta công khai)  

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

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 trung tâm Google, Cast, Tất cả các 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
• Phần mềm thiết bị trung tâm của 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
• Matter phiên bản: hỗ trợ thử nghiệm cho 1.5.0

Tính năng mới

• Đặc điểm 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

• Có thể không thiết lập được thiết bị Matter.
• Đèn Philips BLE không hiển thị trạng thái chính xác.
• Độ trễ gây ra tình trạng mạng không ổn định và thời gian phản hồi chậm.

Vấn đề đã biết

• Không thể thiết lập một số thiết bị bằng Google TV Streamer (4K).
• Khi trung tâm 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ị có nhiều phần dưới dạng nhiều ô.

2026-04-10

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

Ứng dụng mẫu

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

2026-04-09

  Home APIs Phiên bản thử nghiệm công khai 1.8  

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

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 trung tâm Google, Cast, Tất cả các 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
• Phần mềm thiết bị trung tâm của 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
• Matter phiên bản: hỗ trợ thử nghiệm cho 1.5.0

Tính năng mới

• Các quy trình tự động hoá được đề xuất trong Automations API.
• Hỗ trợ các thiết bị có 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 Device API.
• 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ị che khuất bởi một tiêu đề. Người dùng có thể không quay lại được hoặc không thấy các phần tử chính trên giao diện người dùng.
• Một trung tâm Android TV có thể báo cáo sai rằng các thiết bị Matter đang ở trạng thái "Không kết nối mạng".

Vấn đề đã biết

• Có thể không thiết lập được thiết bị Matter.

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 sửa các lỗi và nâng cao chất lượng của phiên bản beta cho Home API Android SDK.

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 Google Hub, Cast, Tất cả các hub 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
• Phần mềm thiết bị trung tâm của 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
• Matter phiên bản: hỗ trợ thử nghiệm cho 1.5.0

Tính năng mới

• Chọn sử dụng Camera và Doorbell Analytics trong Device API.
• Thời gian kết nối gần đây nhất của Camera và Chuông cửa trong Device API.
• Trạng thái kết nối của Camera và Chuông cửa trong Device API.
• Các yêu cầu nguyên tử của bộ điều nhiệt trong Device API.

Các thay đổi đáng chú ý khác

• Đã xoá chế độ không có trung tâm.

Ứng dụng mẫu

• Ứng dụng mẫu Home APIs Android phiên bản 1.7.1. Hãy xem thông tin 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 trong nhà/ngoài trời (dùng pin hoặc có dây) và Nest Doorbell (dùng pin, thế hệ thứ 2), bạn sẽ không thấy lựa chọn "Thời gian còn lại của pin" trong phần Cài đặt pin.
• Chế độ cài đặt thời lượng chuông sẽ bị bỏ qua.
• Đèn Philips BLE xuất hiện không chính xác là "Đang kết nối mạng" ngay cả khi thiết bị thực sự không 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 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ị che khuất bởi một tiêu đề. Người dùng có thể không quay lại được hoặc không thấy các phần tử 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 OOBE ở Chế độ liên kết.
• Có thể không thiết lập được thiết bị Matter.
• Một trung tâm Android TV có thể báo cáo sai rằng các thiết bị Matter đang ở trạng thái Ngoại tuyến.
• Phiên bản phần mềm chính xác có thể không xuất hiện cho phiên bản phần mềm hiện tại của thiết bị camera.
• Thanh trượt trên 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 Chime Duration (Thời lượng chuông), thiết bị sẽ không phát chuông trong khoảng thời gian đã chỉ định.

2026-02-13

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

Ứng dụng mẫu

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

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 sửa các lỗi và nâng cao chất lượng của phiên bản beta cho Home API Android SDK.

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 Google Hub, Cast, Tất cả các trung tâm dựa trên Cast khác: 3.77.510748
• Chương trình cơ sở của trung tâm Google, Fuchsia: 29.20251023.103.2100
• Phần mềm thiết bị trung tâm của 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
• Matter phiên bản: hỗ trợ thử nghiệm cho 1.5.0

Tính năng mới

• Tính năng 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ố tính năng tự động hoá hiện có thể thực thi cục bộ trong Automations API.
• Cho phép 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ủ đề về camera và chuông cửa trong Device API.
• Tính năng 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 Device API.
• Mức pin của Camera và chuông cửa trong Device API.
• Số sê-ri của camera và chuông cửa trong Device API.
• Mô hình 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 Device API.
• API khoá-giá trị tuỳ chỉnh trong Device API.
• Truy vấn quyền cho phép một ứng dụng xác định những loại thiết bị mà người dùng đã cấp quyền truy cập trong Permissions API.

Các 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.
• Công cụ tạo mã đóng gói cho các đặc điểm tuỳ chỉnh đã thay đổi đối với 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 điểm của họ sau khi tích hợp SDK 1.7.

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

• History API luôn trả về một nextPageToken, gây ra một vòng lặp vô hạn.
• Lỗi "User cancelled Permission flow" (Người dùng huỷ quy trình cấp quyền) xảy ra khi bạn 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 trong nhà/ngoài trời (dùng pin hoặc có dây) và Nest Doorbell (dùng pin, thế hệ thứ 2), bạn sẽ không thấy lựa chọn "Thời gian còn lại của pin" trong phần Cài đặt pin.
• Chế độ cài đặt thời lượng chuông sẽ bị bỏ qua.
• Đèn Philips BLE xuất hiện không chính xác là "Đang kết nối mạng" ngay cả khi thiết bị thực sự không kết nối mạng. Giải pháp: Đừ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 đồ Target Device State Service (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 sửa các lỗi và nâng cao chất lượng của phiên bản beta cho Home API Android SDK.

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
• Phần mềm thiết bị trung tâm của 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 của Automation API. Thêm tính năng hỗ trợ đặc điểm Thời tiết trong các điều kiện và thao tác bắt đầu tự động hoá.
• Hỗ trợ nhiều chức năng hơn cho thiết bị Camera và Chuông cửa: Các chế độ cài đặt mới (Cảnh đêm, Đèn LED trạng thái, Khung hình, Hướng, Độ nhạy, Thời lượng sự kiện, Chuô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ần 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 độc lập.
• Hub Activation API để khám phá và kích hoạt các trung tâm.

Các thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung chế độ cài đặt Camera, các chế độ tự động hoá được xác định trước, chế độ 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 thời gian dài sử dụng. Giải pháp: Khởi động lại trung tâm.
• Có thể không thiết lập được thiết bị Matter.
• Lỗi "Người dùng đã huỷ quy trình cấp quyền" xuất hiện khi bạn cố gắng thêm một tài khoản mới vào Ứng dụng mẫu cho Android. Giải pháp: Thêm Tài khoản Google thông qua phần cài đặt của thiết bị Android.
• Camera an ninh có dây onn của Walmart được uỷ quyền bằng SDK Android Home API không thể phát trực tiếp qua Ứng dụng Google Home.
• Các camera được thiết lập trong ứng dụng Home APIs 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 công khai beta 1.5.1 của Home API  

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

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

• Dịch vụ Google Play: 25.41.30
• Chương trình cơ sở của Google Hub, Cast: 3.76.495998
• Chương trình cơ sở của Google Hub, 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

• Hub activation API (API kích hoạt trung tâm) cho phép bạn khám phá và kích hoạt một trung tâm Google Home trong Structure API bằng cách lập trình.

Các 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, Truyền trực tiếp, Nói chuyện hai chiều) và việc 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ị trên 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ợ các thiết bị Camera, chứa các bản sửa lỗi và nâng cao chất lượng beta cho SDK Android 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 Google Hub, Cast: 3.76.492738
• Chương trình cơ sở của Google Hub, 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, điều kiện khởi động, điều kiện và hành động chấp nhận các cấu trúc Matter làm tham số trong Automation API.
• Đã thêm loại thiết bị camera vào Device API (Phát trực tiếp, nói chuyện hai chiều, Bắt đầu/dừng ghi hình).

Các thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung tính năng Hỗ trợ camera, Thiết lập 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ị xoá bắt buộc, sẽ có một khoảng thời gian 5 phút mà bạn không thể điều khiển một số thiết bị. Sau 5 phút, bạn có thể điều khiển các thiết bị trở lại.
• Sau khi người dùng chọn một màu trong chế độ cài sẵn hoặc trong công cụ chọn nhiệt độ màu, Đèn màu mở rộng sẽ không cập nhật màu.

Vấn đề đã biết

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

2025-08-29

  Home API Phiên bản thử nghiệm công khai 1.4.1  

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

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

• Dịch vụ Google Play: 25.33.32
• Chương trình cơ sở của Google Hub, Cast: 3.76.495998
• Chương trình cơ sở của Google Hub, 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ị có nhiều nguồn trong Device API.

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 chế độ cho máy điều nhiệt mà chế độ đó không được hỗ trợ.

Vấn đề đã biết

• Khi trung tâm đang hoạt động bị xoá bắt buộc, sẽ có một khoảng thời gian 5 phút mà bạn không thể điều khiển một số thiết bị. Sau 5 phút, bạn có thể điều khiển các thiết bị trở lại.

2025-07-31

  Home API Phiên bản thử nghiệm công khai 1.4.0  

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

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 Google Hub, 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 của các quy trình tự động hoá trong Automation API.
• Khả năng xoá thiết bị Matter theo phương thức có lập trình trong Device API.
• Xoá 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 cấp cho ứng dụng.

Các thay đổi đáng chú ý khác

• Ứng dụng mẫu Android sẽ xoá các thiết bị chỉ có 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

• Các thiết bị hút bụi đã được gắn vào đế sạc sẽ 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 APIs không thể điều khiển các thiết bị. Giải pháp tạm thời: Đóng ứng dụng và đợi ít nhất 10 giây.

2025-06-26

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

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

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

• Dịch vụ Google Play: 25.23.31
• Phần mềm trung tâm Google, Cast, Google Home, Google Home Mini và Google Nest Mini: 3.75.468362
• Phần mềm cơ sở của trung tâm Google, Cast, Google Nest Audio: 3.75.476451
• Chương trình cơ sở của trung tâm Google, Fuchsia: 26.20250116.103.2900
• SDK Android: 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 2 cấu phần phần mềm riêng biệt: Khung SDK Home API (play-services-home-17.0.0.aar) và các đặc điểm SDK cũng như các loại thiết bị (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.

Các 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.
• Ứng dụng mẫu Android bổ sung: Cập nhật các cấu phần phần mềm SDK để bao gồm play-services-home-17.0.0 và play-services-home-types-17.0.0.

Vấn đề đã biết

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

2025-06-05

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

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

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 Google Hub, Fuchsia: 26.20250116.103.2201
• SDK Android: 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

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

Các thay đổi đáng chú ý khác

• Ứng dụng mẫu Android bổ sung các chức năng để ghi nhật ký 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à hiển thị biểu tượng FailedPreconditionException khi tạo quy trình tự động hoá nếu bạn chưa đặt vị trí nhà 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ó mạng. Trạng thái này hiện được biểu thị là đang trực tuyến.

Vấn đề đã biết

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

2025-05-12

  Home APIs Phiên bản thử nghiệm công khai 1.3  

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

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 Google Hub, Fuchsia: 26.20250116.103.2201
• SDK Android: 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

• Thêm tính năng hỗ trợ cho các trình khởi chạy 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 chạy định kỳ dựa trên thời gian thực, thời gian mặt trời và các điều kiện dựa trên lịch, bằng cách sử dụng biểu thức cron.
• Thêm khả năng đổi tên thiết bị trong Device API.
• Thêm khả năng đổi tên phòng trong Structure API.

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

• Độ trễ khi đ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 trung tâm về trạng thái ban đầu, các thiết bị có thể ở 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 bạn chưa đặt địa chỉ nhà riêng trong ứng dụng Google Home. Giải pháp: Kiểm tra để đảm bảo địa chỉ nhà riêng xuất hiện bằng Discovery API trước khi cố gắng tạo quy trình tự động hoá.

2025-04-09

  Home API Phiên bản beta công khai 1.2.1  

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

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

• Dịch vụ Google Play: 25.09.33
• Phiên bản tối thiểu của chương trình cơ sở cho trung tâm Google:
  • Truyền: 3.75.468222
  • Fuchsia: 24.20241009.103.1900601¹
• SDK Android: 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 phát hành công khai và sẽ có trên tất cả các thiết bị muộn 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 các đối tượng từ Home Graph.
• Automation API
  • Thêm chế độ hỗ trợ cho bộ lọc thực thể, cho phép các quy trình tự động hoá chọn thiết bị một cách linh hoạt dựa trên tiêu chí được chỉ định trong quy trình tự động hoá.
• Device API
  • Thông tin thiết bị trên đám mây hiện có trong BasicInformationTrait.

Vấn đề đã biết

• Có thể xảy ra tình trạng tăng độ trễ khi điều khiển thiết bị khi chuyển từ Wi-Fi sang mạng di động.
• Sau khi bạn đặt lại trung tâm về trạng thái ban đầu, các thiết bị có thể ở 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ì HomeException với code 14: UNKNOWN và thông báo "No route found" (Không tìm thấy tuyến đường) sẽ được gửi.
• 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ể dẫn đến việc không có thiết bị nào được trả về.

2025-03-14

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

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

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 trung tâm Google:
  • 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
• androidx.core phiên bản tối thiểu của thư viện: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại và cụm thiết bị Matter tạm thời không được hỗ trợ.

Tính năng mới

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

Vấn đề đã biết

• Có thể xảy ra tình trạng tăng độ trễ khi điều khiển thiết bị khi chuyển từ Wi-Fi sang mạng di động.
• Sau khi bạn đặt lại trung tâm về trạng thái ban đầu, các thiết bị có thể ở 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ì HomeException với code 14: UNKNOWN và thông báo "No route found" (Không tìm thấy tuyến đường) sẽ được gửi.
  • Giải pháp: Chỉ gọi Discovery API khi bạn thực sự cần các đề xuất tự động hoá. Không tìm nạp trước và lưu vào bộ nhớ đệm các thực thể đề xuất. Kiểm tra xem một thực thể có đang trực tuyến 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ể dẫn đến việc không có thiết bị nào được trả về.

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

• Lần đầu tiên một ứng dụng Home APIs gọi HomeManager.structures() sau khi được 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 ấn tượng sai lầm 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ể gặp phải thời gian chờ lâu.
• Người dùng bắt đầu quy trình thiết lập từ ứng dụng Camera phải quét mã QR hai lần để hoàn tất quy trình thiết lập Matter.
• Trong một cấu trúc chứa hơn 200 thiết bị, Discovery API có thể chỉ trả về không có đề xuất nào.

2025-01-29

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

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

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 trung tâm Google:
  • 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
• androidx.core phiên bản tối thiểu của thư viện: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại và cụm thiết bị Matter tạm thời không được hỗ trợ.

Tính năng mới

• Streaming API:
  • Cung cấp luồng sự kiện thông báo về các cấu trúc, phòng và thiết bị đã được thêm, thay đổi và xoá.
  • Xem phần Đăng ký nhận sự kiện về mối quan hệ giữa các thực thể.
• API theo lô (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 một 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ể gặp phải thời gian chờ lâu.
• Người dùng bắt đầu quy trình thiết lập từ ứng dụng Camera phải quét mã QR hai lần để hoàn tất quy trình thiết lập Matter.
• Trong một cấu trúc chứa hơn 200 thiết bị, Discovery API có thể chỉ trả về không có đề xuất 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.
• Các thiết bị Google TV có thể không hoạt động đối với những 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:
  • Các thiết bị Matter có thể xuất hiện ở trạng thái ngoại tuyến 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 các 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 một 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 các thiết bị không báo cáo trạng thái cho Google.
  • Giải pháp: 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 về việc khởi chạy API Home.

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

2025-01-07

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

Trong giai đoạn thử nghiệm beta 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 tạo và kiểm thử ứng dụng của mình.

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 beta cho SDK Android Home API, bao gồm cả khả năng hỗ trợ tốt hơn cho các thiết bị Google Nest Audio và 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 trung tâm Google:
  • Phiên bản Cast: 3.74.444798
  • Phiên bản Fuchsia tối thiểu: 22.20240805.103.161
• SDK Android: 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
• androidx.core phiên bản tối thiểu của thư viện: 1.10.0
• Phiên bản Matter: 1.3.0.0
  • Lưu ý: Các loại và cụm thiết bị Matter tạm thời 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.
  • Giải pháp: Chạy lại quy trình cấp quyền hoặc khởi động lại ứng dụng.
• Các thiết bị Google TV có thể không hoạt động đối với những 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:
  • Các thiết bị Matter có thể xuất hiện ở trạng thái không 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 các 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 một 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 các thiết bị không báo cáo trạng thái cho Google.
  • Giải pháp: 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 thiết lập có thể không thành công nếu ứng dụng bị thu nhỏ trong quá trình này.
  • Giải pháp: Sử dụng suppressHalfSheetNotification() API để chặn thông báo nửa màn hình khi bạn dùng Commissioning API trong ứng dụng.
• Vấn đề về phía máy chủ có thể khiến các câu lệnh bắt đầu Ok Google không hoạt động trong các quy trình tự động hoá.
• Khi sử dụng một trung tâm chạy Fuchsia mà không có thiết bị Matter nào trong cấu trúc, nếu trung tâm ở trạng thái không hoạt động trong hơn 3 giờ, thì việc thiết lập 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 bạn đặt lại dữ liệu về trạng thái ban đầu cho một trung tâm, các lệnh đối với những thiết bị mới được thiết lập có thể không hoạt động mặc dù thiết bị được báo cáo là đang trực tuyến.