Google Home Sample App for Matter از Google Home Mobile SDK برای ایجاد یک برنامه Android مشابه Google Home app (GHA) استفاده می کند. این برنامه نمونه ویژگی های زیر را ارائه می دهد:
- دستگاه های فیزیکی و مجازی Matter را به فابریک Local Android معرفی کنید
- دستگاه های فیزیکی و مجازی را به یک بافت توسعه سفارش دهید
- دستگاه های روی پارچه توسعه خود را کنترل کنید، به عنوان مثال روشن کردن یک چراغ
- ویژگی‌های چند مدیر به شما امکان می‌دهد دستگاه‌های روی پارچه توسعه‌دهنده را با برنامه‌های دیگر به اشتراک بگذارید، و برعکس بتوانید دستگاه‌های فابریک توسعه‌دهنده را که از برنامه‌های دیگر به اشتراک گذاشته شده‌اند، در برنامه‌نویسی قرار دهید.
- ابزارهای توسعه دهنده
این راهنما نحوه نصب Sample App for Matter APK و استفاده از آن برای راه اندازی، کنترل و اشتراک گذاری دستگاه های Matter را شرح می دهد.
برای دانلود کد منبع، یادگیری نحوه ادغام Mobile SDK و سفارشی کردن صفحه نمایش در Android Studio، Sample App for Matter Codelab ما را امتحان کنید.
به Sample App for Matter Codelab بروید
پیش نیازها
- یک Android O (8.1، API سطح 27) یا دستگاه جدیدتر برای آزمایش در دسترس است. برای اطمینان از اینکه دستگاه شما آخرین پشتیبانی Matter را دارد، راهنمای Verify Matter Modules & Services را مرور کنید.
- یک دستگاه Matter با قابلیت روشن/خاموش بسازید. این نمونه برنامه با یک دستگاه مجازی و یک ESP32 کار می کند.
- Matter Virtual Device (MVD) . برای به حداقل رساندن مشکلات محیطی، ما قویاً پیشنهاد می کنیم که برای شروع از MVD استفاده کنید. اگر زمانی با مشکل مواجه شدید، بررسی اینکه آیا برنامه نمونه در برابر MVD استفاده شده است، بسیار آسان تر خواهد بود.
- با برنامه
rootnode_dimmablelight_bCwGYSDpoeیک دستگاه مجازی Matter بسازید . وقتی یک Matter در Google Home Developer Console ایجاد می‌کنید، از0xFFF1به عنوان شناسه فروشنده و0x8000به عنوان شناسه محصول خود استفاده کنید. - یک دستگاه Espressif با
all-clusters-appبسازید. وقتی یک Matter در Developer Console ایجاد می کنید، از0xFFF1به عنوان شناسه فروشنده و0x8001به عنوان شناسه محصول خود استفاده کنید.
برای راه‌اندازی و کنترل دستگاه‌ها با Sample App for Matter به هاب، برای مثال Google Nest Hub (2nd gen) نیازی ندارید.
نصب کنید
به بخش Releases در مخزن Sample App for Matter GitHub بروید. برای آخرین نسخه، APK با نام
GHSAFM- version -default-debug.apkرا در بخش Assets پیدا کنید.targetcommissionerرا انتخاب نکنید.نصب Android Debug Bridge (adb):
دستگاه Android خود را با USB وصل کنید و File Transfer را فعال کنید، سپس APK را نصب کنید:
$ adb unroot && adb install GHSAFM-version-default-debug.apk
دستگاه های کمیسیون
وقتی برای اولین بار برنامه نمونه را راه اندازی می کنید، یک گفتگو با پیوندی به Sample App for Matter Codelab دریافت خواهید کرد. اگر دوباره این پیام را نشان ندهد را انتخاب کنید، می‌توانید در هر زمان که بخواهید با به‌روزرسانی تنظیمات برگزیده خود در بخش مدیریت برنامه، گفتگو را بازگردانید.
در مراحل بعدی، یک دستگاه Matter را به فابریک Local Android به همراه یک پارچه توسعه که فقط محلی برای برنامه نمونه است، اضافه می‌کنید.
پارچه های ماده چیست؟
Matter fabric دامنه مشترک اعتماد بین دستگاه‌ها در یک شبکه خانگی است که آنها را قادر می‌سازد تا با یکدیگر ارتباط برقرار کنند.
دستگاه‌ها ممکن است یک یا چند پارچه داشته باشند که مربوط به یک پلتفرم، برنامه یا گروهی از دستگاه‌هایی است که با هم تعامل دارند. پارچه‌ها یک شناسه منحصربه‌فرد دارند و دستگاه‌ها دارای مجموعه‌ای از اعتبارنامه‌ها و مرجع گواهی ( CA ) هستند. این اعتبارنامه ها در طول راه اندازی Matter اختصاص می یابد.
برای راه اندازی یک دستگاه Matter ، مراحل زیر را انجام دهید:
برای شروع فرآیند راه اندازی، روی دکمه افزودن دستگاه ضربه بزنید.
سپس، کنترل به Google Play services منتقل می‌شود که از طریق تماس به Mobile SDK راه‌اندازی می‌شود. برای اثبات مالکیت، کد QR را اسکن کنید یا روی استفاده از کد جفت‌سازی ضربه بزنید.
وقتی راه اندازی کامل شد، نام دستگاه را وارد کنید، سپس روی انجام شد ضربه بزنید.
دستگاه شما اکنون به هر دو فابریک Android Local و پارچه توسعه متصل است.
همه کارهای راه اندازی و صفحه های مربوطه توسط Play services هنگام راه اندازی دستگاه ها انجام می شود. این یک تجربه کاربری ثابت را فراهم می کند و نیاز به رسیدگی به مجوزهای حساس، به عنوان مثال، اعتبارنامه Wi-Fi و Thread را از بین می برد.
دستگاه های کنترل
فابریک توسعه، اعتبارنامه‌هایی را برای کنترل دستگاه‌های Matter درست از برنامه نمونه ایجاد می‌کند.
از صفحه اصلی، می‌توانید دستگاه خود را روشن یا خاموش کنید. برای دسترسی به جزئیات دستگاه، روی دستگاه ضربه بزنید.
دستگاه ها را به اشتراک بگذارید
به اشتراک گذاری یک دستگاه در مشخصات Matter به عنوان جریان چند مدیره گفته می شود. هنگامی که یک دستگاه به برنامه نمونه راه اندازی شد، می توانید به راحتی آن را با سایر اکوسیستم ها به اشتراک بگذارید.
برای به اشتراک گذاشتن دستگاه Matter خود با سایر اکوسیستم ها، باید پلتفرم دیگری را روی دستگاه اندروید خود نصب کنید. این پلتفرم خارجی به کمیسر هدف تبدیل می شود. ما نمونه دیگری از برنامه نمونه ایجاد کرده‌ایم که می‌توانید از آن به‌عنوان مأمور هدف استفاده کنید.
به بخش Releases در مخزن Sample App for Matter GitHub بروید. برای آخرین نسخه، APK با نام
GHSAFM- version -targetcommissioner-debug.apkرا در بخش Assets پیدا کنید.defaultرا انتخاب نکنیدکمیسیونر هدف را نصب کنید.
$ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apkاز صفحه اصلی، روی دستگاه ضربه بزنید تا اطلاعات دستگاه نمایش داده شود. روی اشتراک گذاری ضربه بزنید.
برنامه نمونه Mobile SDK Share API را فراخوانی می‌کند و بار دیگر، کنترل به Play services منتقل می‌شود.
برگه اشتراک‌گذاری نمایش داده می‌شود که به شما امکان می‌دهد برنامه یا پلتفرمی را که می‌خواهید دستگاه را با آن جفت کنید انتخاب کنید. این صفحه دو راه برای اشتراک گذاری دستگاه در اختیار شما قرار می دهد:
- به صورت دستی از طریق یک کد راه‌اندازی که با برنامه کمیسیونر هدف به اشتراک گذاشته می‌شود
- با یک برنامه اندروید محلی که به عنوان کمیسیونر Matter ثبت شده است
برنامه کمیسیونر هدف دارای برچسب GHSAFM-TC است. روی این نمونه از برنامه نمونه ضربه بزنید تا دستگاه خود را به اشتراک بگذارید.
در مرحله بعد، برنامه خارجی (مصوب کننده هدف) راه اندازی دستگاه را در بافت خودش کامل می کند.
تنظیمات
از صفحه اصلی، روی نماد کلیک کنید. در اینجا گزینه هایی برای به روز رسانی تنظیمات برگزیده کاربر، دریافت راهنمایی و کسب اطلاعات بیشتر در مورد برنامه دارید.
اطلاعیه نیم ورق
از صفحه تنظیمات، می‌توانید انتخاب کنید که اعلان‌های اکتشافی فعال برای دستگاه‌های Matter غیرفعال شود.
اگر برنامه شما جریان کشف Matter یا راه اندازی خود را ارائه می دهد، ممکن است بخواهید برای جلوگیری از وقفه، این اعلان ها را سرکوب کنید. برای اطلاعات بیشتر به سرکوب اعلان‌های کشف سفارشی مراجعه کنید.
ابزارهای توسعه دهنده
از صفحه تنظیمات، می‌توانید به ابزارهای توسعه‌دهنده نیز دسترسی داشته باشید.
برای بررسی محتویات مخازن دیتا استور Device and User Preferences در Logcat ، مراحل زیر را انجام دهید:
روی Log Repositories content کلیک کنید.
روی OK برای گفتگو کلیک کنید، سپس Logcat را علامت بزنید.
بازخورد و کمک
برای ارسال نظرات یا بازخورد خود در مورد اینکه چگونه می‌توانیم تجربه توسعه را با Sample App for Matter بهبود دهیم، فرم بازخورد ما را تکمیل کنید.
نظرات خود را برای ما ارسال کنید
اگر با Sample App for Matter مشکل دارید، مراحل را برای تأیید محیط خود تکمیل کنید:
اگر در مورد استفاده از برنامه نمونه یا کشف یک اشکال کد سؤالی دارید، می‌توانید مشکلات را به ردیاب مشکل در مخزن GitHub ارسال کنید:
برای دریافت راهنمایی رسمی از Google در مورد سؤالات فنی، از تالار گفتمان توسعه دهندگان خانه هوشمند استفاده کنید:
برای دریافت پشتیبانی فنی از انجمن، از برچسب google-smart-home در Stack Overflow استفاده کنید: