Ghi chú phát hành SDK iOS của API Home

2025-10-22

  Trang chủ API Bản phát hành Beta công khai 1.5.1  

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 beta cho Home APIs iOS SDK.

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

  • iOS: iOS 17.0 trở lên, Xcode 15.3 trở lên
    • Đối với việc đưa Matter vào sử dụng: iOS 17.6 trở lên
  • 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.76.495998
    • Phiên bản tối thiểu Fuchsia: 27.20250422.103.3600
  • SDK iOS: home_platform_ios_1.5.1.zip
  • 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 vật chất: 1.4.1.0

Tính năng mới

  • API cấu trúc
    • 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 pháp có lập trình. Xem API kích hoạt Hub trên iOS.

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.
  • 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp thay thế: Thêm bộ định tuyến đường viền Thread thông qua iOS GHA trên cùng một điện thoại.

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

  • Khi sử dụng Ứng dụng mẫu, chương trình phát trực tiếp sẽ bị sập bất ngờ.

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 Home APIs iOS SDK.

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

  • iOS: iOS 17.0 trở lên, Xcode 15.3 trở lên
    • Đối với việc đưa Matter vào sử dụng: iOS 17.6 trở lên
  • 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.76.495998
    • Phiên bản tối thiểu Fuchsia: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.5.0.zip
  • 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 vật chất: 1.4.1.0

Tính năng mới

  • API thiết bị
    • Đã thêm Loại thiết bị máy ảnh. Các tính năng sau đây dành cho camera cũng có sẵn cho chuông cửa:
      • Phát trực tiếp trên camera
      • Tính năng nói chuyện hai chiều của camera
      • Bắt đầu và dừng ghi hình bằng camera
  • Ứng dụng mẫu iOS
    • Hỗ trợ cho loại thiết bị Camera:
      • Phát trực tiếp trên camera.
      • Tính năng nói chuyện hai chiều của camera.
      • Máy ảnh bắt đầu và dừng ghi hình.
      • Quyền bị hạn chế đối với loại thiết bị.
    • Hỗ trợ kích hoạt Hub.

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.
  • 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp thay thế: Thêm bộ định tuyến đường viền Thread thông qua iOS GHA trên cùng một điện thoại.

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

  • Đã xảy ra lỗi khi tạo một quy trình tự động hoá và một loại thiết bị không xác định xuất hiện không chính xác dưới dạng một lựa chọn có thể chọn.

2025-08-28

  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 Home API iOS SDK.

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

  • iOS: iOS 17.0 trở lên, Xcode 15.3 trở lên
    • Đối với việc đưa Matter vào sử dụng: iOS 17.6 trở lên
  • 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.76.495998
    • Phiên bản Fuchsia tối thiểu: 27.20250422.103.3600
  • iOS SDK: home_platform_ios_1.4.1.zip
  • 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 Matter: 1.4.1.0

Tính năng mới

Ứng dụng mẫu iOS

  • Đã thêm chế độ điều khiển máy điều nhiệt.

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.
  • 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp: Thêm bộ định tuyến biên Thread thông qua GHA trên iOS trên cùng một điện thoại.

2025-07-30

  Bản phát hành thử nghiệm công khai 1.4.0 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 Home API iOS SDK.

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

Tính năng mới

  • Device API
    • Khả năng lập trình để loại bỏ thiết bị Matter. Xem Xóa thiết bị.

Ứng dụng mẫu iOS

  • Xoá các thiết bị chỉ hỗ trợ Matter.

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.
  • 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp: Thêm bộ định tuyến biên Thread thông qua GHA trên iOS trên cùng một điện thoại.

2025-07-08

Với phiên bản phần mềm Cast 3.76.479819, Nest WiFi Pro hiện có thể hoạt động như một trung tâm API Home.

2025-06-26

  Home API phiên bản 1.3.2 (Bản thử nghiệm công khai)  

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 beta cho Home APIs iOS SDK.

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

  • iOS: iOS 16.4 trở lên, Xcode 15.3 trở lên
  • 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
  • iOS SDK: home_platform_ios_1.3.2.zip
  • 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 vật chất: 1.4.0.0

Tính năng mới

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.
  • 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp thay thế: Thêm bộ định tuyến đường viền Thread thông qua iOS GHA trên cùng một điện thoại.

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

  • Máy điều nhiệt được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt động.

2025-06-05

  Bản phát hành thử nghiệm công khai 1.3.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 Home API iOS SDK.

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

  • Tích hợp lên connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4 trở lên, Xcode 15.3 trở lên
  • 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 tối thiểu Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.0.zip
  • 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 Matter: 1.4.0.0

Tính năng mới

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.
  • Bộ điều nhiệt được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt động.
  • Tính năng kiểm soát 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.
  • Đã xảy ra lỗi khi thiết lập một thiết bị Matter-over-Thread bằng iOS Home API.
    • Giải pháp thay thế: Thêm bộ định tuyến đường viền Thread thông qua iOS GHA trên cùng một điện thoại.

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

  • Phiên bản iOS của GHA có thể bị lỗi khi thay đổi mạng từ mạng cục bộ sang Wi-Fi hoặc khi chuyển đổi giữa các ứng dụng.

2025-05-09

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

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 Home API iOS SDK.

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

  • Tích hợp lên connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4 trở lên, Xcode 15.3 trở lên
  • 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 tối thiểu Fuchsia: 24.20241009.103.1900601
  • iOS SDK: home_platform_ios_1.3.0.zip
  • 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 vật chất: 1.4.0.0

Tính năng mới

  • Device API
  • Structure API
    • Hỗ trợ thay đổi tên Room

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.
  • Bộ điều nhiệt được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt độ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.
  • Phiên bản iOS của GHA có thể gặp sự cố trong quá trình thay đổi mạng từ mạng cục bộ sang Wi-Fi hoặc chuyển đổi giữa các ứng dụng.

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

  • Khi bạn cấp quyền trong phiên bản iOS của Ứng dụng Google Home, các nút Tìm hiểu thêm và nút quay lại có thể không phản hồi.
    • Giải pháp: Nhấn và giữ đường liên kết Tìm hiểu thêm để mở đường liên kết này trong trình duyệt hệ thống hoặc nhấn vào nút đóng ở phía trên bên trái để thoát khỏi chế độ xem.
  • Trình phát video cơ bản có thể không hoạt động trong ứng dụng mẫu.
  • Tính năng điều khiển các loại thiết bị che cửa sổ được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt động.
  • Việc thu hồi quyền khi ứng dụng Google Home đang mở sẽ khiến ứng dụng gặp sự cố.

2025-04-09

  Bản phát hành beta công khai của API iOS 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 tạo và kiểm thử ứng dụng iOS.

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 cung cấp công khai (GA) cho Home APIs iOS SDK.

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

  • Tích hợp lên connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK
  • iOS: iOS 16.4 trở lên, Xcode 15.3 trở lên
  • 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
  • iOS SDK: home_platform_ios_1.0_1.zip
  • 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 Matter: 1.4.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

  • 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.
  • Khi bạn cấp quyền trong phiên bản iOS của Ứng dụng Google Home, các nút Tìm hiểu thêm và nút quay lại có thể không phản hồi.
    • Giải pháp: Nhấn và giữ đường liên kết Tìm hiểu thêm để mở đường liên kết này trong trình duyệt hệ thống hoặc nhấn vào nút đóng ở phía trên bên trái để thoát khỏi chế độ xem.
  • Việc thu hồi quyền khi ứng dụng Google Home đang mở sẽ khiến ứng dụng gặp sự cố.
  • Trình phát video cơ bản có thể không hoạt động trong ứng dụng mẫu.
  • Máy điều nhiệt được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt động.
  • Tính năng kiểm soát 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.
  • Tính năng điều khiển các loại thiết bị che cửa sổ được hỗ trợ bởi Cloud-to-Cloud có thể không hoạt động.
  • Phiên bản iOS của GHA có thể gặp sự cố trong quá trình thay đổi mạng từ mạng cục bộ sang Wi-Fi hoặc chuyển đổi giữa các ứng dụng.

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

  • Không hỗ trợ đặt tên và đổi tên thiết bị.
  • Để đưa vào vận hành, thiết bị Matter đầu tiên trong một công trình cần được đưa vào vận hành bằng ứng dụng Google Home trên iOS. API Home hiện không có khả năng tạo ra một kết cấu mới, mà chỉ có thể thêm vào một kết cấu hiện có cho các công trình được xây dựng trước năm 2023. Những cấu trúc được tạo sau năm 2023 sẽ không bị ảnh hưởng bởi vấn đề này.