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

انتشار پیش‌نمایش توسعه‌دهنده

برنامه Google Home Developer به سازندگان دستگاه اجازه می دهد تا دستگاه های خانه هوشمند خود را به اکوسیستم Google Home متصل کنند. ما در حال گسترش مسیر تحقق محلی Smart Home Actions با قابلیت افزودن Matter -enabled devices for setup using the Google Home app (GHA) on Android and control them using Google Assistant , GHA , or smart displays like the Google Nest Hub (2nd gen) .

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

سلب مسئولیت

با توجه به رویه‌های شرح داده شده در این پیش‌نمایش Matter ، از موارد زیر آگاه باشید:

• حسابی که برای توسعه استفاده می‌شود باید فقط دارای یک هاب فعال با Matter باشد که برای آزمایش متصل است. هاب های Matter چندگانه که به طور همزمان و یا در طول آزمایش به یک ساختار متصل می شوند، می تواند منجر به رفتار غیرقابل پیش بینی شود.
• همه رویه‌ها استفاده از یک ماشین لینوکس با Ubuntu 20.04 را برای ساختن و فلش کردن نمونه‌های Matter که توسط Google آزمایش شده‌اند، فرض می‌کنند. در حالی که ماشین‌های MacOS پشتیبانی می‌شوند، لینوکس توصیه می‌شود. دستورالعمل‌های مخصوص Mac در صورت لزوم در رویه‌ها فراخوانی می‌شوند.
• فقط نسخه اندروید GHA پشتیبانی می شود.

تعاریف

عبارات زیر در سراسر این مستندات استفاده می شود:

روتر مرزی

هابی که یک Thread Border Router for Thread -enabled devices.

هاب

یک Google Nest device, such as the Google Nest Hub (2nd gen) . A hub is required to control Matter -enabled devices through other surfaces such as Assistant , the GHA , and smart displays.

دستگاه دارای Matter فعال

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

دستگاه موبایل

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

پیش نیازها

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

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

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

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

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

این VID باید در سیستم عامل دستگاه شما پیاده سازی شود.

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

• یک VID آزمایشی را نمی توان در دستگاه مصرف کننده استفاده کرد.
• برای اینکه یک دستگاه تولیدی (مصرف کننده) جفت شود، باید در CSA DCL تأیید شده باشد.
• برای اهداف توسعه و آزمایش میدانی، یک دستگاه باید در Google Home Developer Console ثبت شده باشد.

شناسه محصول

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

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

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

-placeholder164