این راهنما دستورالعمل‌های تجربه کاربری را برای طراحی یکپارچه اجازه‌های دستگاه و هم‌رسانی Google Home APIs برای تجربه آماده‌سازی در برنامه‌تان ارائه می‌دهد.
موضوعات اصلی شرح‌داده‌شده در اینجا عبارتند از:
- چرا دستگاه‌ها را با Google Home هم‌رسانی کنیم؟
- مراحل کلیدی جریان هم‌رسانی
- پیاده‌سازی فنی
- روال‌های مطلوب تجربه کاربری
چرا دستگاه‌ها را با Google Home هم‌رسانی کنیم؟
برای بهره‌مند شدن از قابلیت‌هایی که Home API ارائه می‌دهد، کاربران باید دستگاه‌هایشان را با Google Home هم‌رسانی کنند زیرا:
- این یک الزام فنی برای Google است تا از این دستگاه‌ها در خودکارسازی‌ها استفاده کند.
- این کار به حفظ تجربه هماهنگ و انعطاف‌پذیر Google Home کمک می‌کند.
- اطمینان از اینکه دستگاه‌ها به‌طور یکسان در برنامه‌های فعال‌شده با Home API ارائه می‌شوند، برای جلوگیری از ایجاد تجربه کاربری پراکنده و گیج‌کننده که در آن کاربران باید برای انجام کارهای اصلی بین برنامه‌ها جابه‌جا شوند، بسیار مهم است.
عناصر اصلی جریان هم‌رسانی
| مؤلفه | برنامه | شرح |
|---|---|---|
| Permissions API در Android | ای‌پی‌آی‌های Home برای اجازه‌ها در Android | از کاربران درخواست می‌کند به برنامه شما اجازه دسترسی بدهند. قبل‌از استفاده از هرکدام از میاناهای برنامه‌سازی کاربردی Home، برنامه شما باید اجازه دسترسی به دستگاه‌های موجود در خانه کاربر را داشته باشد (در میانای برنامه‌سازی کاربردی به آن ساختار گفته می‌شود). بااین‌حال، ترتیبی که این مرحله انجام می‌شود به سناریو توسعه‌دهنده بستگی دارد و در پیاده‌سازی فنی گنجانده شده است. |
| پیوند دادن Cloud-to-cloud | Cloud-to-cloud برای پیوند دادن حساب | به شما امکان می‌دهد فرایند پیوند دادن حساب را برای هم‌رسانی دستگاه‌های متصل به ابر با Google Home از داخل برنامه‌تان شروع کنید. برای کاهش اصطکاک کاربر، توصیه می‌کنیم از قابلیت پیوند عمیق (در Android و iOS دردسترس است) استفاده کنید که کاربران را مستقیماً به صفحه پیوند دادن حساب خاص شما در GHA می‌برد. |
| Commissioning API در Android | راه‌اندازی Matter | درحالی‌که به‌طور کلی به‌عنوان یک میانای برنامه‌سازی کاربردی برای راه‌اندازی دستگاه‌های جدید Matter درنظر گرفته می‌شود، می‌توانید از این میانای برنامه‌سازی کاربردی برای افزودن ساختار Google به دستگاه‌های Matter که قبلاً در ساختار دیگری راه‌اندازی شده‌اند نیز استفاده کنید. بنابراین، این ابزار مفیدی برای فرایند آماده‌سازی است. |
پیاده‌سازی فنی
نحوه ساختن جریان‌های هم‌رسانی به این بستگی دارد که قصد دارید کدام دستگاه‌ها را با Google هم‌رسانی کنید.
برای سناریوهای زیر، توصیه می‌کنیم مراحل را به‌ترتیب ارائه‌شده دنبال کنید. این کار به ارائه تجربه کلی بهتر به کاربران کمک می‌کند.
فقط دستگاه‌های Matter تولید می‌کنید
دستگاه‌های سازگار با Matter تولید می‌کنید که می‌خواهید آن‌ها را به Google Home راه‌اندازی کنید.
Permissions API را در Android فراخوانی کنید.
Commissioning API on Android را در هر دستگاه Matter که قبلاً در ساختار دیگری راه‌اندازی شده است فراخوانی کنید.
- چون هم‌رسانی Matter باید برای هر دستگاه به‌طور جداگانه انجام شود و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارد، توصیه می‌کنیم کاربر را ازطریق موارد زیر در این فرایند راهنمایی کنید:
- ارائه فهرستی از دستگاه‌های Matter به کاربران که با Google هم‌رسانی نمی‌شوند.
- به کاربران اجازه می‌دهد با کلیک کردن روی دستگاه‌ها در آن فهرست، فرایند هم‌رسانی دستگاه را (بااستفاده از Commissioning API) شروع کنند.
- بازگشت به فهرست دستگاه‌های Matter، نمایش پیشرفت تکلیف و وضعیت هم‌رسانی به کاربر.
- چون هم‌رسانی Matter باید برای هر دستگاه به‌طور جداگانه انجام شود و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارد، توصیه می‌کنیم کاربر را ازطریق موارد زیر در این فرایند راهنمایی کنید:
فقط دستگاه‌هایی را تولید می‌کنید که بااستفاده از میاناهای برنامه‌سازی کاربردی «ابر به ابر» با Google هم‌رسانی شده‌اند
Cloud-to-cloud پیونددهی عمیق را انجام دهید. این کار دستگاه‌ها را به Google Home Graph اضافه می‌کند.
- توصیه می‌کنیم ابتدا پیونددهی Cloud-to-cloud را انجام دهید تا از موقعیت‌های بالقوه گیج‌کننده مانند ارائه فهرستی به کاربر که حاوی دستگاه‌های هم‌رسانی‌شده با Google و دستگاه‌های هم‌رسانی‌نشده با Google است جلوگیری شود.
Permissions API را در Android فراخوانی کنید.
هم دستگاه‌های Cloud-to-cloud و هم دستگاه‌های Matter تولید می‌کنید
Cloud-to-cloud پیونددهی عمیق را انجام دهید.
- توصیه می‌کنیم ابتدا پیونددهی Cloud-to-cloud را انجام دهید تا از موقعیت‌های بالقوه گیج‌کننده مانند ارائه فهرستی به کاربر که حاوی دستگاه‌های هم‌رسانی‌شده با Google و دستگاه‌های هم‌رسانی‌نشده با Google است جلوگیری شود.
Permissions API را در Android فراخوانی کنید.
Commissioning API for Android را در هر دستگاه Matter که قبلاً در ساختار دیگری راه‌اندازی شده است فراخوانی کنید.
- چون هم‌رسانی Matter باید برای هر دستگاه به‌طور جداگانه انجام شود و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارد، توصیه می‌کنیم کاربر را ازطریق موارد زیر در این فرایند راهنمایی کنید:
- ارائه فهرستی از دستگاه‌های Matter به کاربران که با Google هم‌رسانی نمی‌شوند.
- به کاربران اجازه می‌دهد با کلیک کردن روی دستگاه‌ها در آن فهرست، فرایند هم‌رسانی دستگاه را (بااستفاده از Commissioning API) شروع کنند.
- بازگشت به فهرست دستگاه‌های Matter، نمایش پیشرفت تکلیف و وضعیت هم‌رسانی به کاربر.
- چون هم‌رسانی Matter باید برای هر دستگاه به‌طور جداگانه انجام شود و صفحه‌های زیادی وجود دارد که به ورودی کاربر نیاز دارد، توصیه می‌کنیم کاربر را ازطریق موارد زیر در این فرایند راهنمایی کنید:
دستگاهی برای هم‌رسانی با Google ندارید
Permissions API را فراخوانی کنید.
روال‌های مطلوب تجربه کاربری
این بخش حاوی برخی‌از مسیرهای قطعی کاربر است که باید هنگام توسعه برنامه‌ای که از Home API استفاده می‌کند درنظر گرفته شود.
کجا هم‌رسانی دستگاه را در برنامه معرفی کنید
این فهرست کامل نیست و ممکن است فرصت‌های دیگری برای ارائه پیشنهاد به‌موقع Google Home و تجربه هم‌رسانی برای کاربران خود پیدا کنید.
این موارد نیز ناسازگار نیستند و چندین نقطه ورودی وجود دارد:
از منو «تنظیمات»
چون کاربران احتمالاً به راه‌اندازی اتصال با بوم‌سازگان Google Home خود ازطریق منو تنظیمات عادت کرده‌اند، این روش به آن‌ها اجازه می‌دهد این الگو را ادامه دهند.
شاید بخواهید هم‌رسانی دستگاه (پیوند دادن Cloud-to-cloud و «میانای برنامه‌سازی کاربردی راه‌اندازی» Matter) را از اجازه دادن به برنامه («میانای برنامه‌سازی کاربردی اجازه‌ها») جدا کنید. این کار به کاربران امکان می‌دهد مراحلی را که تکمیل می‌کنند کنترل کنند و فرصتی برای شما فراهم می‌کند تا وضعیت اتصال را به کاربر نشان دهید.
هنگام استفاده از دستگاه‌ها در خودکارسازی‌هایی که Google اجرا می‌کند
از برگه «خودکارسازی‌ها»، کاربران می‌توانند روی نقطه ورودی به جریان هم‌رسانی تک‌ضرب بزنند، صفحه گزاره ارزش را که مزایای ادامه دادن را به‌وضوح توضیح می‌دهد بخوانند، و سپس به‌سرعت در جریان اجازه‌ها حرکت کنند.
فقط از راه‌اندازی
این سناریو در درجه اول برای شرکایی است که فقط دستگاه‌های Matter تولید می‌کنند (بدون دستگاه‌های Cloud-to-cloud) و ساختار Matter خودشان را ندارند. نقطه ورود برای کاربر می‌تواند درست بعداز صفحه نوع آماده استفاده باشد که در آن هم‌رسانی دستگاه‌های Matter (ازطریق Commissioning API) و اجازه دادن به برنامه (ازطریق Permissions API) بخشی از همان جریان تجربه کاربری است.
درحال هم‌رسانی منطق
برخی‌از پیشنهادها درباره پیام‌واره‌های کاربر عبارتند از:
به‌طور کلی باید از کاربران بخواهید فقط مراحل جاافتاده‌ای را که برای آماده‌سازی پلاتفرم لازم است تکمیل کنند. برای مثال، مشتریان قدیمی ممکن است ازقبل دستگاه‌های OEM را با Google هم‌رسانی کنند، در این صورت آن‌ها فقط باید فرایند اعطای اجازه‌های Home API را طی کنند تا به برنامه اجازه دهند به Google Home آن‌ها دسترسی داشته باشد.
ممکن است چند سرپرست Google Home ساختار Google Home را هم‌رسانی کنند، و در برخی موارد ممکن است فقط از یک حساب برای هم‌رسانی دستگاه‌ها با Google استفاده شود. درنتیجه، تکمیل پیونددهی Cloud-to-cloud نباید پیش‌نیازی برای درخواست اجازه‌های Home API باشد.
پیشنهادهای طراحی دیداری
مزیت واضحی از آماده‌سازی برای Google Home (برای مثال، «ایجاد خودکارسازی‌های پیشرفته با پشتیبانی Google Home» یا «کنترل دستگاه‌ها بااستفاده از برنامه‌های انتخابی شما»).
یک دعوت به اقدام (برای مثال، «شروع به کار») و راهی برای لغو کردن درصورتی‌که کاربر نخواهد ادامه دهد.
اگر فضا اجازه دهد، توضیحی درباره آنچه با پیشرفت کاربر در صفحه‌ها اتفاق خواهد افتاد.
به‌طور خاص برای Matter، وقتی کاربر قبلاً ازطریق Home API به شما اجازه دسترسی به خانه‌اش را داده باشد، می‌توانید امکان هم‌رسانی دستگاه‌های موجود در خانه‌اش را با Google Home هنگام راه‌اندازی دستگاه‌های جدید فراهم کنید. برای مثال، می‌توانید دستگاه Matter را به ساختار خود اضافه کنید و سپس از کاربر بخواهید این دستگاه را به ساختار Google اضافه کند.
پیشنهادهای محتوا
برای کاربران آسان‌تر است به چیزی اعتماد کنند که آن را درک می‌کنند و برایشان ارزش‌افزوده دارد. با ارائه اطلاعات برای تصمیم‌گیری آگاهانه، ازجمله مبادلات، کاربران را توانمند کنید.
زیروبمی بحرانی
اگر گزاره ارزش قوی‌ای برای هم‌رسانی دستگاه‌ها وجود نداشته باشد، کاربران به این کار ادامه نخواهند داد.
- به نحوه قرار دادن پیشنهاد توجه ویژه‌ای داشته باشید.
- آن را وسوسه‌انگیز کنید اما وعده بیش‌ازحد ندهید.
- اگر کاربر به دستگاهی نیاز دارد که در پیشنهاد شما ذکر شده است، مطمئن شوید که این موضوع به‌وضوح بیان شده باشد تا با مانع غیرمنتظره‌ای مواجه نشود.
- ممکن است فقط یک فرصت برای جذب این کاربران داشته باشید، بنابراین از آن نهایت استفاده را ببرید.
روال‌های مطلوب
- با دیدگاه کاربر شروع کن - رویکرد «چه چیزی برای من دارد؟».
- در بلوک بخش، بیشتر از چهار خط محتوا ننویسید. کلمات بیشتر ممکن است توجه کاربر را ازدست بدهد. بااین‌حال، شفافیت و قابل‌فهم بودن می‌تواند مهم‌تر از مختصر بودن باشد.
- خودکارسازی‌ها سرگرم‌کننده‌اند! اگر فضا اجازه می‌دهد، نمونه‌ای هیجان‌انگیز اما مفید انتخاب کنید.
- اگر با استراتژی کلی شما همسو است، از صدا و لحن بازیگوشانه استفاده کنید.
- از عبارت‌های کنش‌پذیر مانند «شروع به کار» استفاده کنید.