با ماده شروع کنید

برنامه توسعه‌دهندگان خانگی گوگل به تولیدکنندگان دستگاه‌ها اجازه می‌دهد تا دستگاه‌های خانه هوشمند خود را به اکوسیستم گوگل هوم متصل کنند. ما در حال گسترش مسیر انجام سفارشات محلی Smart Home Actions هستیم و این امکان را فراهم می‌کنیم که دستگاه‌های مجهز به Matter را برای راه‌اندازی با استفاده از Google Home app (GHA) اضافه کنیم و آنها را با استفاده از Google Assistant ، GHA یا نمایشگرهای هوشمند مانند Google Nest Hub (2nd gen) کنترل کنیم.

این مستندات نحوه شروع ساخت و ادغام یک پلتفرم پشتیبانی شده توسط Matter در اکوسیستم Google Home را شرح می‌دهد.

سلب مسئولیت‌ها

در خصوص رویه‌های شرح داده شده در مستندات Matter ، به موارد زیر توجه داشته باشید:

• توصیه می‌کنیم حسابی که برای توسعه استفاده می‌شود، فقط یک هاب فعال‌شده Matter را برای آزمایش متصل داشته باشد. اتصال همزمان چندین هاب فعال‌شده Matter یا اتصال به یک ساختار در طول آزمایش می‌تواند منجر به رفتار غیرقابل‌پیش‌بینی شود.
• تمام مراحل، استفاده از یک دستگاه لینوکس با سیستم عامل اوبونتو ۲۰.۰۴ را برای ساخت و فلش کردن نمونه‌های Matter که توسط گوگل آزمایش شده‌اند، فرض می‌کنند. در حالی که دستگاه‌های macOS پشتیبانی می‌شوند، لینوکس توصیه می‌شود. دستورالعمل‌های خاص مک در صورت نیاز در مراحل ذکر شده است.

نحوه ساخت

برای ساخت یک دستگاه مجهز به Matter که با اکوسیستم Google Home ادغام شود، باید از یک برد توسعه سازگار با Matter و کیت توسعه نرم‌افزاری (SDK) Matter استفاده کنید.

ساده‌ترین راه برای شروع، بررسی آزمایشگاه‌های کد ما است. توصیه می‌کنیم حداقل یکی از آزمایشگاه‌های کد زیر را انجام دهید:

پس از آن، لیست دستگاه‌های پشتیبانی‌شده ما را بررسی کنید تا مطمئن شوید آنچه قصد ادغام آن را دارید در اکوسیستم Google Home پشتیبانی می‌شود. سپس چک‌لیست توسعه‌دهندگان را مطالعه کنید تا کل جریان توسعه را از ایجاد پروژه تا راه‌اندازی درک کنید.

دستگاه‌های پشتیبانی‌شده

تعاریف

اصطلاحات زیر در سراسر این مستندات استفاده می‌شوند:

روتر مرزی

هابی که یک روتر همه منظوره Thread Border Router را برای دستگاه‌های دارای Thread پیاده‌سازی می‌کند.

هاب

یک دستگاه Google Nest پشتیبانی‌شده، مانند Google Nest Hub (2nd gen) . برای کنترل دستگاه‌های مجهز به Matter از طریق سطوح دیگر مانند Assistant ، GHA و نمایشگرهای هوشمند، به یک هاب نیاز است.

دستگاه فعال‌شده Matter

یک دستگاه یا برد توسعه که با یک برنامه ساخت یا نمونه با قابلیت Matter فلش شده است.

دستگاه همراه

گوشی آزمایشی که برای جفت‌سازی استفاده شد. در حال حاضر این یک گوشی Android است.

پیش‌نیازها

برای ادغام کامل یک دستگاه مجهز به Matter با اکوسیستم Google Home، یک توسعه‌دهنده باید موارد زیر را داشته باشد:

1. یک هاب گوگل با پشتیبانی از Thread که هم به عنوان یک روتر مرزی برای دستگاه‌های دارای Thread و هم به عنوان یک مسیر تحقق محلی برای مسیریابی اهداف خانه هوشمند عمل می‌کند.
2. یک دستگاه تلفن همراه (گوشی آزمایشی) که حداقل شرایط لازم را داشته باشد:
   • اندروید O (8.1، API سطح 27 یا جدیدتر)
   • iOS (نسخه ۱۶.۵ یا جدیدتر)
   • قابلیت بلوتوث کم مصرف (BLE)
3. شناسه فروشنده (VID) و شناسه محصول (PID) برای دستگاهی که Matter روی آن فعال است.
4. یک دستگاه مجهز به Matter . این دستگاه باید یکی از انواع دستگاه‌های Matter باشد که در اکوسیستم Google Home پشتیبانی می‌شوند و می‌تواند یکی از موارد زیر باشد:
   • محصول خودتان با میان‌افزار فعال‌شده با Matter .
   • یکی از دستگاه‌های Matter زیر برای تأیید سرتاسری:

شناسه فروشنده

به طور پیش‌فرض، می‌توانید از یکی از VID های اختصاص داده شده توسط CSA برای اهداف آزمایشی استفاده کنید. یکی از موارد زیر را انتخاب کنید: 0xFFF1 ، 0xFFF2 ، 0xFFF3 ، 0xFFF4 .

برای استفاده از VID تولید به منظور تأیید و راه‌اندازی یکپارچه‌سازی شما، ابتدا باید آن را توسط گوگل تأیید کنید تا مطمئن شوید که توسط CSA برای شما صادر شده است.

این VID باید در میان‌افزار دستگاه شما پیاده‌سازی شده باشد.

یک دستگاه Matter فقط در برخی سناریوهای خاص با شناسه فروشنده و نوع دستگاه می‌تواند در اکوسیستم Google Home جفت شود.

• VID آزمایشی را نمی‌توان در دستگاه مصرف‌کننده استفاده کرد.
• VID تولیدی شما باید توسط Connectivity Standards Alliance (Alliance) صادر شود. گوگل قبل از اینکه بتوانید از آن در Google Home Developer Console ) استفاده کنید، تأیید می‌کند که شما مالک آن VID هستید. پس از این، می‌توانید برای آن VID ادغام ایجاد کنید.
• برای اهداف توسعه و Field Trial ، یک پروژه و ادغام با ترکیب VID و PID مربوطه باید در Developer Console ایجاد شود. کاربری که دستگاه را راه‌اندازی می‌کند باید یا عضوی از پروژه باشد یا در فهرست کاربران Field Trial قرار داشته باشد.
• کاربران عادی فقط زمانی می‌توانند از محصول شما استفاده کنند که توسط Alliance تأیید شده باشد.

VID و PID فقط یک بار برای یک ادغام قابل استفاده هستند. اگر می‌خواهید از VID یا PID یکسان در ادغام خود استفاده کنید، باید یکی از موارد زیر را انجام دهید:

• ادغام را با استفاده از VID یا PID به یک VID یا PID متفاوت ویرایش کنید.
• ادغام را با استفاده از VID یا PID حذف کنید.

شناسه محصول

اطلاعات مربوط به دستگاه از خوشه اطلاعات پایه Matter خوانده می‌شود. شناسه محصول کدگذاری شده در میان‌افزار دستگاه شما باید با شناسه محصول ادغام Matter در کنسول توسعه‌دهندگان مطابقت داشته باشد.

ویژگی‌های پشتیبانی نشده

برخی از خوشه‌های Matter هنوز در معرض دید کاربران قرار نگرفته‌اند، اگرچه ممکن است توسط سیستم مورد استفاده قرار گیرند. در بیشتر موارد، این بدان معناست که ویژگی‌هایی که از طریق این خوشه‌ها در معرض دید قرار می‌گیرند، برای کاربران نهایی قابل مشاهده نیستند:

برای اطلاع از چگونگی تأثیر این موضوع بر کلیدهای روشن /خاموش، به بخش کلیدهای روشن/خاموش مراجعه کنید.