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

bookmark_border Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

2025-03-14

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

Bản phát hành này bao gồm các bản sửa lỗi và cải thiện chất lượng của phiên bản phát hành công khai (GA) cho SDK Android của API Home.

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 tối thiểu của chương trình cơ sở Google Hub:
  • Phiên bản Cast: 3.75.456944
  • Phiên bản Fuchsia tối thiểu: 24.20241009.103.1900601
• SDK Android: 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ị 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à một phần ngày trong điều kiện tự động hoá. Xem phần Sử dụng ngày có từ giữa.
  • Trong các bản phát hành trước, API Khám phá đã trả về một NumberSetConstraint cho một số trường bitmap khi đáng lẽ phải trả về BitmapConstraint. Các trường này hiện trả về một BitmapConstraint như dự kiến. Điều này chỉ giới hạn ở bitmap optionsMask và optionsOverride trong các lệnh đặc điểm LevelControl.

Vấn đề đã biết

• Độ trễ của tính năng đ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 đặt lại về trạng thái ban đầu, thiết bị có thể có vẻ như không có kết nối mạng.
• Nếu API Khám phá đượ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 "Không tìm thấy tuyến đường" sẽ được gửi.
  • Giải pháp: Chỉ gọi API Khám phá 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 các thực thể đề xuất vào bộ nhớ đệm. Kiểm tra xem một thực thể có trực tuyến hay không trước khi gọi các phương thức API Khám phá trên thực thể đó.
• Trong môi trường chứa 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 không có thiết bị nào được trả về.

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

• Trong lần đầu tiên gọi HomeManager.structures() sau khi khởi chạy, ứng dụng Home API sẽ không nhận được cấu trúc nào, 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, người dùng có thể phải chờ lâu.
• Những người dùng bắt đầu quy trình thiết lập từ ứng dụng Máy ảnh đã 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ị, API Khám phá có thể không trả về đề xuất nào.

2025-01-29

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

Bản phát hành này bao gồm các bản sửa lỗi và cải thiện chất lượng của phiên bản phát hành công khai (GA) cho SDK Android của API Home.

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 tối thiểu của chương trình cơ sở Google Hub:
  • Phiên bản Cast: 3.75.456944
  • Phiên bản Fuchsia tối thiểu: 24.20241009.103.1900500
• SDK Android: 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ị Matter tạm thời 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 cấu trúc, phòng và thiết bị đã được thêm, thay đổi và xoá.
  • Xem phần Đăng ký sự kiện liên quan đến thực thể.
• API xử lý hàng loạt (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, người dùng có thể phải chờ lâu.
• Những người dùng bắt đầu quy trình thiết lập từ ứng dụng Máy ảnh đã 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ị, API Khám phá có thể không trả về đề 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 với các tính năng tự động sử dụng thuộc tính MediaPlayback.
• Trong 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 chính xác trạng thái 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 ứ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.
  • Giải pháp: Kiểm tra trạng thái bằng một ứng dụng của Google sẽ giải quyết sự không khớp.

2025-01-14

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

Chúng tôi đã làm rõ hơn rằng phiên bản của Trang chủ phải được khởi chạy dưới dạng singleton ngữ cảnh. Điều này giúp đảm bảo trải nghiệm người dùng mượt mà hơn trong ứng dụng 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 thử nghiệm công khai của API Home  

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 xây dựng và thử nghiệm ứng dụng.

Bản phát hành này bao gồm các bản sửa lỗi và cải thiện chất lượng của phiên bản phát hành công khai (GA) cho SDK Android của API Home, bao gồm cả tính năng hỗ trợ nâng cao 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 tối thiểu của chương trình cơ sở Google Hub:
  • 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
• 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 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 với các tính năng tự động sử dụng thuộc tính MediaPlayback.
• Trong 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 (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 không phải lúc nào cũng phản ánh chính xác trạng thái 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 ứ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.
  • Giải pháp: Kiểm tra trạng thái bằng một ứng dụng của Google sẽ giải quyết sự 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.
  • Giải pháp: Sử dụng suppressHalfSheetNotification() API để ngăn thông báo nửa trang khi sử dụng API uỷ quyền trong ứng dụng.
• Vấn đề phía máy chủ có thể khiến trình khởi động OkGoogle không hoạt động trong các quy trình tự động.
• 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 này ở trạng thái rảnh trong hơn 3 giờ, thì việc đưa thiết bị Matter đầu tiên vào hoạt động sẽ khiến thiết bị Matter đó bị ngắt kết nối.
• 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 gửi đến thiết bị mới được uỷ quyền có thể không thành công mặc dù thiết bị được báo cáo là đang trực tuyến.