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

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 quy trình thiết lập Matter: 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.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 Matter: 1.4.1.0

Tính năng mới

  • Device API
    • Đã thêm loại thiết bị camera. Các tính năng sau đây dành cho camera cũng có trên 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ợ 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

    • 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.

    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

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

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 quy trình thiết lập Matter: 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

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

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 xoá thiết bị Matter theo phương thức lập trình. Xem phần Xoá 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 Home API.

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 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 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.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 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.
  • 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.

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 công khai thử nghiệm 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ổng hợp thành 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.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

  • Ứng dụng mẫu bên ngoài
    • Đã thêm Generic Editor (Trình chỉnh sửa chung)
    • Hỗ trợ đổi tên phòng và thiết bị

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.
  • Máy đ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.
  • Đã 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.

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

  • 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.

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 với 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.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

  • 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.
  • Máy đ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 ở trên cùng bên trái để thoát khỏi chế độ xem.
  • Basic Video Player 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 thử nghiệm công khai iOS 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 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 API iOS SDK.

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

  • Tích hợp với 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 ở trên cùng 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ố.
  • Basic Video Player 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.
  • 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.
  • 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ị.
  • Để thiết lập, bạn cần thiết lập thiết bị Matter đầu tiên trong một cấu trúc bằng Ứng dụng Google Home trên iOS. Các API Home hiện không thể tạo một cấu trúc mới, mà chỉ có thể thêm vào cấu trúc hiện có cho các cấu trúc được tạo 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.