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

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à kiểm thử ứ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 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
  • 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.
  • 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 đó ở 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 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.