یادداشت‌های انتشار iOS SDK APIهای خانگی

2025-09-26

این نسخه پشتیبانی از دستگاه‌های دوربین را معرفی می‌کند، حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK بهبود می‌بخشد.

حداقل نسخه ها

• iOS: iOS 17.0+، Xcode 15.3+
• برای راه اندازی موضوع: iOS 17.6+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.76.495998
  • نسخه مین فوشیا: 27.20250422.103.3600
• iOS SDK: home_platform_ios_1.5.0.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه موضوع: 1.4.1.0

ویژگی های جدید

• API دستگاه
• نوع دستگاه دوربین اضافه شد. ویژگی های زیر برای دوربین ها برای زنگ در نیز موجود است:
  • پخش زنده دوربین
  • مکالمه دو طرفه دوربین
  • دوربین شروع و ضبط را متوقف می کند
• برنامه نمونه iOS
  • پشتیبانی از نوع دستگاه دوربین:
    • پخش زنده دوربین.
    • مکالمه دو طرفه دوربین
    • دوربین شروع و ضبط را متوقف می کند.
    • مجوزهای نوع دستگاه محدود شده است.
  • پشتیبانی از فعال سازی هاب

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• هنگام راه اندازی یک دستگاه Matter-over-Thread با استفاده از iOS Home API خطایی رخ می دهد.
  • راه حل: روتر Thread border را از طریق iOS GHA در همان گوشی اضافه کنید.

رفع مشکلات شناخته شده

• هنگام ایجاد یک اتوماسیون و یک نوع دستگاه ناشناخته به اشتباه به عنوان گزینه قابل انتخاب ظاهر می شود، خطایی رخ می دهد.

2025-08-28

این نسخه حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• iOS: iOS 17.0+، Xcode 15.3+
• برای راه اندازی موضوع: iOS 17.6+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.76.495998
  • نسخه مین فوشیا: 27.20250422.103.3600
• iOS SDK: home_platform_ios_1.4.1.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه موضوع: 1.4.1.0

ویژگی های جدید

• API دستگاه
• یک DecommissionIneligibleReason جدید برای تلاش برای از کار انداختن یک دستگاه چند منبع تعریف شده است. دستگاه های چند منبع را ببینید .

برنامه نمونه iOS

• کنترل ترموستات اضافه شد.

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• هنگام راه اندازی یک دستگاه Matter-over-Thread با استفاده از iOS Home API خطایی رخ می دهد.
  • راه حل: روتر Thread border را از طریق iOS GHA در همان گوشی اضافه کنید.

30-07-2025

این نسخه حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• iOS: iOS 17.0+، Xcode 15.3+
• برای راه اندازی موضوع: iOS 17.6+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• iOS SDK: home_platform_ios_1.4.0.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه اصلی: 1.4.0.0

ویژگی های جدید

• API دستگاه
  • قابلیت حذف برنامه نویسی دستگاه Matter. به حذف یک دستگاه مراجعه کنید.

برنامه نمونه iOS

• دستگاه های Matter-only را حذف کنید.

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• هنگام راه اندازی یک دستگاه Matter-over-Thread با استفاده از iOS Home API خطایی رخ می دهد.
  • راه حل: روتر Thread border را از طریق iOS GHA در همان گوشی اضافه کنید.

08-07-2025

با سیستم‌افزار Cast نسخه 3.76.479819، Nest WiFi Pro اکنون می‌تواند به‌عنوان یک مرکز API Home عمل کند.

2025-06-26

این نسخه حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• iOS: iOS 16.4+، Xcode 15.3+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• iOS SDK: home_platform_ios_1.3.2.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه اصلی: 1.4.0.0

ویژگی های جدید

• SDK
• از بررسی مجوزها پشتیبانی می کند
• راهنمای نوع دستگاه ترموستات اضافه شد

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• هنگام راه اندازی یک دستگاه Matter-over-Thread با استفاده از iOS Home API خطایی رخ می دهد.
  • راه حل: روتر Thread border را از طریق iOS GHA در همان گوشی اضافه کنید.

رفع مشکلات شناخته شده

• ترموستات های پشتیبانی شده توسط Cloud-to-Cloud ممکن است کار نکنند.

05-06-2025

این نسخه حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK به connectedhomeip اضافه می شود
• iOS: iOS 16.4+، Xcode 15.3+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• iOS SDK: home_platform_ios_1.3.0.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه اصلی: 1.4.0.0

ویژگی های جدید

• برنامه نمونه خارجی
• ویرایشگر عمومی اضافه شد
• از تغییر نام اتاق و دستگاه پشتیبانی می کند

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ترموستات های پشتیبانی شده توسط Cloud-to-Cloud ممکن است کار نکنند.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• هنگام راه اندازی یک دستگاه Matter-over-Thread با استفاده از iOS Home API خطایی رخ می دهد.
  • راه حل: روتر Thread border را از طریق iOS GHA در همان گوشی اضافه کنید.

رفع مشکلات شناخته شده

• نسخه iOS GHA ممکن است هنگام تغییر شبکه از محلی به Wi-Fi یا جابه‌جایی بین برنامه‌ها از کار بیفتد.

09-05-2025

این نسخه حاوی رفع اشکال است و کیفیت بتا را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK به connectedhomeip اضافه می شود
• iOS: iOS 16.4+، Xcode 15.3+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• iOS SDK: home_platform_ios_1.3.0.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه اصلی: 1.4.0.0

ویژگی های جدید

• API دستگاه
• پشتیبانی از تغییر نام HomeDevice
• API ساختار
• پشتیبانی از تغییر نام Room

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• ترموستات های پشتیبانی شده توسط Cloud-to-Cloud ممکن است کار نکنند.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• نسخه iOS GHA ممکن است هنگام تغییر شبکه از محلی به Wi-Fi یا جابه‌جایی بین برنامه‌ها از کار بیفتد.

رفع مشکلات شناخته شده

• هنگام اعطای مجوز در نسخه iOS برنامه Google Home، دکمه‌های «بیشتر بدانید» و «بازگشت» ممکن است پاسخگو نباشند.
  • راه حل: برای باز کردن پیوند بیشتر در مرورگر سیستم، روی پیوند بیشتر بدانید یا برای خروج از نما روی دکمه بستن در بالا سمت چپ ضربه بزنید.
• پخش کننده اصلی ویدیو ممکن است در برنامه نمونه کار نکند.
• ممکن است کنترل انواع دستگاه‌های پوشاننده پنجره که توسط Cloud-to-Cloud پشتیبانی می‌شوند کار نکند.
• لغو مجوز هنگامی که برنامه Google Home باز است، برنامه را از کار می‌اندازد.

09-04-2025

در طول بتای توسعه‌دهنده عمومی، همه توسعه‌دهندگان می‌توانند شروع به ساخت و آزمایش برنامه‌های iOS خود کنند.

این نسخه حاوی رفع اشکال است و کیفیت دسترسی عمومی (GA) را برای Home APIs iOS SDK افزایش می‌دهد.

حداقل نسخه ها

• 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK به connectedhomeip اضافه می شود
• iOS: iOS 16.4+، Xcode 15.3+
• حداقل نسخه سیستم عامل هاب گوگل:
  • نسخه بازیگران: 3.75.456944
  • نسخه کوتاه فوشیا: 24.20241009.103.1900601
• iOS SDK: home_platform_ios_1.0_1.zip
• نسخه حداقل برنامه Google Home: با هر نسخه ای کار می کند
• نسخه اصلی: 1.4.0.0
  • توجه: انواع و خوشه‌های دستگاه Provisional Matter پشتیبانی نمی‌شوند.

مسائل شناخته شده

• ممکن است تأخیر کنترل دستگاه هنگام جابجایی از Wi-Fi به شبکه تلفن همراه افزایش یابد.
• هنگام اعطای مجوز در نسخه iOS برنامه Google Home، دکمه‌های «بیشتر بدانید» و «بازگشت» ممکن است پاسخگو نباشند.
  • راه حل: برای باز کردن پیوند بیشتر در مرورگر سیستم، روی پیوند بیشتر بدانید یا برای خروج از نما روی دکمه بستن در بالا سمت چپ ضربه بزنید.
• لغو مجوز هنگامی که برنامه Google Home باز است، برنامه را از کار می‌اندازد.
• پخش کننده اصلی ویدیو ممکن است در برنامه نمونه کار نکند.
• ترموستات های پشتیبانی شده توسط Cloud-to-Cloud ممکن است کار نکنند.
• ممکن است کنترل انواع دستگاه‌های فن با پشتیبانی Cloud-to-Cloud در برنامه نمونه کار نکند.
• ممکن است کنترل انواع دستگاه‌های پوشاننده پنجره که توسط Cloud-to-Cloud پشتیبانی می‌شوند کار نکند.
• نسخه iOS GHA ممکن است هنگام تغییر شبکه از محلی به Wi-Fi یا جابه‌جایی بین برنامه‌ها از کار بیفتد.

رفع مشکلات شناخته شده

• نامگذاری و تغییر نام دستگاه پشتیبانی نمی شود.
• برای راه اندازی، اولین دستگاه Matter در یک ساختار باید با استفاده از برنامه Google Home iOS راه اندازی شود. APIهای Home در حال حاضر قادر به ایجاد یک پارچه جدید نیستند، فقط به بافت موجود برای ساختارهای ایجاد شده قبل از سال 2023 اضافه می‌کنند. ساختارهایی که پس از سال 2023 ایجاد شده‌اند تحت تأثیر این موضوع قرار نمی‌گیرند.