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

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

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ó thể các thiết bị Matter sẽ 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 vấn đề 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à 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 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ó thể các thiết bị Matter sẽ 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 vấn đề 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.