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

۲۰۲۵-۱۲-۲۲

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۷.۰+، ایکس‌کد ۱۵.۳+
• برای راه‌اندازی Matter: iOS 17.6+
• حداقل نسخه‌های فریمور گوگل هاب:
  • بازیگران:
    • نست وای‌فای پرو: ۳.۷۵.۴۷۹۸۱۹
    • سایر هاب‌های مبتنی بر کست: 3.77.505721
  • فوشیا: 28.20250723.103.2100300
  • پخش‌کننده گوگل تی‌وی، 4K: UTTK.250729.004
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.6.0
• حداقل نسخه برنامه گوگل هوم: ۱.۶
• نسخه ماده: ۱.۴.۱.۰

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

• API اتوماسیون
  • پشتیبانی از فیلترهای موجودیت اضافه شده است که به اتوماسیون‌ها اجازه می‌دهد دستگاه‌ها را بر اساس معیارهای مشخص شده در اتوماسیون، به صورت پویا انتخاب کنند.
  • پشتیبانی از ویژگی آب و هوا در شروع‌کننده‌ها و شرایط اتوماسیون اضافه شد. به Starter based on weather مراجعه کنید.
• رابط برنامه‌نویسی دستگاه
  • پشتیبانی از قابلیت‌های بیشتر دوربین و زنگ درب
    • تنظیمات جدید:
      • دید در شب روشن/خاموش.
      • روشنایی LED وضعیت.
      • دریچه دید دوربین.
      • جهت گیری تصویر.
      • حساسیت به بیدار شدن از خواب.
      • حداکثر طول رویداد
      • صدای زنگوله می‌آید.

      برای اطلاعات بیشتر به راهنمای دستگاه دوربین برای iOS مراجعه کنید.

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

• نمونه اپلیکیشن iOS
  • پشتیبانی از تنظیمات بیشتر
    • دوربین:
      • میکروفون روشن/خاموش.
      • ضبط صدا روشن/خاموش.
      • جهت گیری تصویر.
      • دید در شب روشن/خاموش.
      • میزان صدای بلندگوی دوربین.
      • روشنایی LED وضعیت.
    • زنگ در:
      • میکروفون روشن/خاموش.
      • ضبط صدا روشن/خاموش.
      • جهت گیری تصویر.
      • دید در شب روشن/خاموش.
      • میزان صدای بلندگوی دوربین.
      • روشنایی LED وضعیت.
      • صدای زنگوله می‌آید.
  • SDK را به طور پیش‌فرض با استفاده از Swift Package Manager ادغام می‌کند.

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

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

۲۰۲۵-۱۰-۲۲

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۷.۰+، ایکس‌کد ۱۵.۳+
• برای راه‌اندازی Matter: iOS 17.6+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.76.495998
  • نسخه حداقل فوشیا: ۲۷.۲۰۲۵۰۴۲۲.۱۰۳.۳۶۰۰
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.5.1.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۱.۰

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

• ساختار API
  • API فعال‌سازی هاب به شما امکان می‌دهد تا به صورت برنامه‌نویسی شده، هاب گوگل هوم را کشف و فعال کنید. به API فعال‌سازی هاب در iOS مراجعه کنید.
    

مشکلات شناخته شده

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

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

• هنگام استفاده از برنامه Sample، پخش زنده به طور غیرمنتظره‌ای از کار می‌افتاد.

۲۰۲۵-۰۹-۲۶

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۷.۰+، ایکس‌کد ۱۵.۳+
• برای راه‌اندازی Matter: iOS 17.6+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.76.495998
  • نسخه حداقل فوشیا: ۲۷.۲۰۲۵۰۴۲۲.۱۰۳.۳۶۰۰
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.5.0.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۱.۰

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

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

مشکلات شناخته شده

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

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

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

۲۰۲۵-۰۸-۲۸

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۷.۰+، ایکس‌کد ۱۵.۳+
• برای راه‌اندازی Matter: iOS 17.6+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.76.495998
  • نسخه حداقل فوشیا: ۲۷.۲۰۲۵۰۴۲۲.۱۰۳.۳۶۰۰
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.4.1.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۱.۰

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

• رابط برنامه‌نویسی دستگاه
• یک DecommissionIneligibleReason جدید برای تلاش برای از رده خارج کردن یک دستگاه چند منبعی تعریف شده است. به Multi-source devices مراجعه کنید .

نمونه اپلیکیشن iOS

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

مشکلات شناخته شده

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

۲۰۲۵-۰۷-۳۰

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۷.۰+، ایکس‌کد ۱۵.۳+
• برای راه‌اندازی Matter: iOS 17.6+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.75.456944
  • نسخه حداقل فوشیا: 24.20241009.103.1900601
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.4.0.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۰.۰

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

• رابط برنامه‌نویسی دستگاه
  • امکان حذف برنامه‌ای یک دستگاه Matter. به بخش حذف یک دستگاه مراجعه کنید.

نمونه اپلیکیشن iOS

• دستگاه‌های فقط-متد-را حذف کنید.

مشکلات شناخته شده

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

۲۰۲۵-۰۷-۰۸

با نسخه ۳.۷۶.۴۷۹۸۱۹ از فریمور کست، نست وای‌فای پرو اکنون می‌تواند به عنوان یک هاب رابط برنامه‌نویسی کاربردی خانگی (Home APIs) عمل کند.

۲۰۲۵-۰۶-۲۶

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

حداقل نسخه‌ها

• آی‌او‌اس: آی‌او‌اس ۱۶.۴+، ایکس‌کد ۱۵.۳+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.75.456944
  • نسخه حداقل فوشیا: 24.20241009.103.1900601
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.3.2.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۰.۰

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

• SDK
• پشتیبانی از بررسی مجوزها

مشکلات شناخته شده

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

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

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

۲۰۲۵-۰۶-۰۵

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

حداقل نسخه‌ها

• به connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK متصل می‌شود
• آی‌او‌اس: آی‌او‌اس ۱۶.۴+، ایکس‌کد ۱۵.۳+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.75.456944
  • نسخه حداقل فوشیا: 24.20241009.103.1900601
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.3.0.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۰.۰

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

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

مشکلات شناخته شده

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

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

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

۲۰۲۵-۰۵-۰۹

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

حداقل نسخه‌ها

• به connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK متصل می‌شود
• آی‌او‌اس: آی‌او‌اس ۱۶.۴+، ایکس‌کد ۱۵.۳+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.75.456944
  • نسخه حداقل فوشیا: 24.20241009.103.1900601
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.3.0.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۰.۰

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

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

مشکلات شناخته شده

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

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

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

۲۰۲۵-۰۴-۰۹

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

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

حداقل نسخه‌ها

• به connectedhomeip 498467887d40accff609c4f31a5bc7bb101d57b6 SHA Matter SDK متصل می‌شود
• آی‌او‌اس: آی‌او‌اس ۱۶.۴+، ایکس‌کد ۱۵.۳+
• حداقل نسخه‌های فریمور گوگل هاب:
  • نسخه بازیگران: 3.75.456944
  • نسخه حداقل فوشیا: 24.20241009.103.1900601
• کیت توسعه نرم‌افزاری iOS: home_platform_ios_1.0_1.zip
• نسخه حداقلی برنامه گوگل هوم: با هر نسخه‌ای کار می‌کند
• نسخه ماده: ۱.۴.۰.۰
  • توجه: انواع دستگاه‌ها و خوشه‌های Provisional Matter پشتیبانی نمی‌شوند.

مشکلات شناخته شده

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

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

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