این راهنما، راهنماییهای UX را برای طراحی یکپارچهی APIهای Google Home، مجوزهای دستگاه و اشتراکگذاری برای تجربهی کاربری در برنامهی شما ارائه میدهد.
مباحث اصلی که در اینجا توضیح داده شده است عبارتند از:
- چرا باید دستگاهها را با گوگل هوم به اشتراک گذاشت؟
- مراحل کلیدی جریان اشتراکگذاری
- پیادهسازی فنی
- بهترین شیوههای تجربه کاربری
چرا باید دستگاهها را با گوگل هوم به اشتراک گذاشت؟
برای بهرهمندی از قابلیتهایی که رابطهای برنامهنویسی کاربردی (API) هوم ارائه میدهند، کاربران باید دستگاههای خود را با گوگل هوم به اشتراک بگذارند، زیرا:
- استفاده از این دستگاهها در اتوماسیونها برای گوگل یک الزام فنی است.
- این به حفظ یک تجربه سازگار و انعطافپذیر در گوگل هوم کمک میکند.
- اطمینان از اینکه دستگاهها به طور مداوم در برنامههای دارای رابط برنامهنویسی کاربردی خانگی (Home API) ارائه میشوند، برای جلوگیری از ایجاد یک تجربه کاربری پراکنده و گیجکننده که در آن کاربران باید برای انجام وظایف اساسی بین برنامهها جابجا شوند، بسیار مهم است.
اجزای کلیدی جریان اشتراکگذاری
| کامپوننت | برنامه | توضیحات |
|---|---|---|
| API مجوزها در اندروید | API های خانگی برای مجوزها در اندروید | از کاربران میخواهد که به برنامه شما مجوز بدهند. قبل از استفاده از هر یک از APIهای Home، برنامه شما باید مجوز دسترسی به دستگاههای موجود در خانه کاربر را داشته باشد (که در API به آن ساختار گفته میشود). با این حال، ترتیب انجام این مرحله به سناریوی توسعهدهنده بستگی دارد و در پیادهسازی فنی گنجانده شده است. |
| اتصال ابر به ابر | ابر به ابر برای اتصال حساب | به شما امکان میدهد فرآیند اتصال حساب کاربری را برای اشتراکگذاری دستگاههای متصل به فضای ابری با Google Home از داخل برنامه خود آغاز کنید. برای کاهش مشکل کاربر، توصیه میکنیم از قابلیت لینک عمیق (موجود در اندروید و iOS) استفاده کنید که کاربران را مستقیماً به صفحه اتصال حساب کاربری خاص شما در GHA هدایت میکند. |
| راهاندازی API در اندروید | راه اندازی ماده | اگرچه عموماً به عنوان یک API برای راهاندازی دستگاههای جدید Matter در نظر گرفته میشود، میتوانید از این API برای افزودن Google fabric به دستگاههای Matter که قبلاً به fabric دیگری سفارش داده شدهاند نیز استفاده کنید. بنابراین، این یک ابزار مفید برای فرآیند onboarding است. |
پیادهسازی فنی
نحوهی ایجاد جریانهای اشتراکگذاری بستگی به این دارد که قصد دارید کدام دستگاهها را با گوگل به اشتراک بگذارید.
برای سناریوهای زیر، توصیه میکنیم مراحل را به ترتیب ارائه شده دنبال کنید. این به کاربران کمک میکند تا تجربه کلی بهتری داشته باشند.
شما فقط دستگاههای Matter تولید میکنید
شما دستگاههایی با قابلیت پشتیبانی از Matter تولید میکنید که میخواهید به گوگل هوم سفارش دهید.
فراخوانی API مربوط به مجوزها در اندروید .
API راهاندازی را در اندروید روی هر دستگاه Matter که قبلاً به پارچه دیگری سفارش داده شده است، فراخوانی کنید.
- از آنجا که اشتراکگذاری Matter باید برای هر دستگاه به صورت جداگانه انجام شود و صفحات زیادی وجود دارد که نیاز به ورودی کاربر دارند، توصیه میکنیم کاربر را در این فرآیند با موارد زیر راهنمایی کنید:
- ارائه فهرستی از دستگاههای Matter که با گوگل به اشتراک گذاشته نمیشوند به کاربران.
- به کاربران اجازه میدهد تا با کلیک روی دستگاههای موجود در آن لیست، فرآیند اشتراکگذاری دستگاه (با استفاده از API راهاندازی) را آغاز کنند.
- بازگشت به لیست دستگاههای Matter، نمایش پیشرفت کار و اشتراکگذاری وضعیت با کاربر.
- از آنجا که اشتراکگذاری Matter باید برای هر دستگاه به صورت جداگانه انجام شود و صفحات زیادی وجود دارد که نیاز به ورودی کاربر دارند، توصیه میکنیم کاربر را در این فرآیند با موارد زیر راهنمایی کنید:
شما فقط دستگاههایی را تولید میکنید که با استفاده از APIهای Cloud-to-cloud با گوگل به اشتراک گذاشته شدهاند.
پیوند عمیق Cloud-to-cloud را انجام دهید. این دستگاهها را به نمودار گوگل هوم اضافه میکند.
- توصیه میکنیم ابتدا اتصال Cloud-to-cloud را انجام دهید تا از موقعیتهای گیجکنندهی احتمالی مانند نمایش فهرستی از دستگاههای اشتراکگذاریشده با گوگل و دستگاههای غیراشتراکگذاریشده به کاربر، جلوگیری شود.
فراخوانی API مربوط به مجوزها در اندروید .
شما هم دستگاههای Cloud-to-cloud و هم دستگاههای Matter را تولید میکنید
انجام لینکدهی عمیق Cloud-to-cloud .
- توصیه میکنیم ابتدا اتصال Cloud-to-cloud را انجام دهید تا از موقعیتهای گیجکنندهی احتمالی مانند نمایش فهرستی از دستگاههای اشتراکگذاریشده با گوگل و دستگاههای غیراشتراکگذاریشده به کاربر، جلوگیری شود.
فراخوانی API مربوط به مجوزها در اندروید .
API راهاندازی برای اندروید را روی هر دستگاه Matter که قبلاً به فابریک دیگری سفارش داده شده است، فراخوانی کنید.
- از آنجا که اشتراکگذاری Matter باید برای هر دستگاه به صورت جداگانه انجام شود و صفحات زیادی وجود دارد که نیاز به ورودی کاربر دارند، توصیه میکنیم کاربر را در این فرآیند با موارد زیر راهنمایی کنید:
- ارائه فهرستی از دستگاههای Matter که با گوگل به اشتراک گذاشته نمیشوند به کاربران.
- به کاربران اجازه میدهد تا با کلیک روی دستگاههای موجود در آن لیست، فرآیند اشتراکگذاری دستگاه (با استفاده از API راهاندازی) را آغاز کنند.
- بازگشت به لیست دستگاههای Matter، نمایش پیشرفت کار و اشتراکگذاری وضعیت با کاربر.
- از آنجا که اشتراکگذاری Matter باید برای هر دستگاه به صورت جداگانه انجام شود و صفحات زیادی وجود دارد که نیاز به ورودی کاربر دارند، توصیه میکنیم کاربر را در این فرآیند با موارد زیر راهنمایی کنید:
شما هیچ دستگاهی برای اشتراک گذاری با گوگل ندارید
API مربوط به مجوزها را فراخوانی کنید.
بهترین شیوههای تجربه کاربری
این بخش شامل برخی از مراحل حیاتی سفر کاربر است که باید هنگام توسعه برنامهای با استفاده از رابطهای برنامهنویسی کاربردی (API) در نظر گرفته شوند.
اشتراکگذاری دستگاه را از کجا در برنامه فعال کنیم؟
این یک لیست جامع نیست و ممکن است فرصتهای دیگری برای ارائه به موقع Google Home و تجربه اشتراکگذاری برای کاربران خود پیدا کنید.
اینها همچنین متقابلاً منحصر به فرد نیستند و چندین نقطه ورود وجود دارد:
از منوی تنظیمات

از آنجا که کاربران احتمالاً عادت دارند از طریق منوی تنظیمات، ارتباط با اکوسیستمهای گوگل هوم خود را برقرار کنند، این روش به آنها اجازه میدهد تا با این الگو ادامه دهند.
ممکن است بخواهید اشتراکگذاری دستگاه (ارتباط Cloud-to-cloud و API راهاندازی Matter ) را از مجوزدهی برنامه (API مجوزها) جدا کنید. این به کاربران این امکان را میدهد که مراحلی را که انجام میدهند کنترل کنند و فرصتی را برای شما فراهم میکند تا وضعیت اتصال را به کاربر نمایش دهید.
هنگام استفاده از دستگاهها در اتوماسیونهای اجرا شده توسط گوگل
از تب اتوماسیون، کاربران میتوانستند روی یک نقطه ورود به جریان اشتراکگذاری ضربه بزنند، صفحه گزاره ارزش را که به وضوح مزایای پیشرفت را توضیح میدهد، بخوانند و سپس به سرعت از طریق جریان مجوزها حرکت کنند.


فقط از زمان راهاندازی
این سناریو در درجه اول برای شرکایی خواهد بود که فقط دستگاههای Matter تولید میکنند (نه دستگاههای Cloud-to-cloud ) و Matter fabric مخصوص به خود را ندارند. نقطه ورود برای کاربر میتواند درست پس از یک صفحه نمایش آماده باشد که در آن اشتراکگذاری دستگاههای Matter (از طریق API راهاندازی) و مجوزدهی برنامه (از طریق API مجوزها) بخشی از یک جریان تجربه کاربری هستند.


منطق اشتراکگذاری
برخی از پیشنهادات در مورد درخواستهای کاربر عبارتند از:
شما معمولاً باید از کاربران بخواهید که فقط مراحل از قلم افتاده مورد نیاز برای نصب پلتفرم را تکمیل کنند. به عنوان مثال، مشتریان قدیمی ممکن است از قبل دستگاههای یک تولیدکننده اصلی (OEM) را با گوگل به اشتراک گذاشته باشند، که در این صورت آنها فقط باید فرآیند اعطای مجوز APIهای خانه را طی کنند تا به برنامه اجازه دسترسی به گوگل هوم خود را بدهند.
ممکن است چندین مدیر Google Home یک ساختار Google Home را به اشتراک بگذارند و در برخی موارد ممکن است فقط از یک حساب برای اشتراکگذاری دستگاهها با Google استفاده شود. در نتیجه، تکمیل اتصال Cloud-to-cloud نباید پیشنیاز درخواست مجوزهای Home API باشد.
پیشنهادهای طراحی بصری

یکی از مزایای آشکار استفاده از گوگل هوم (برای مثال، «ایجاد اتوماسیونهای پیشرفته با پشتیبانی گوگل هوم» یا «کنترل دستگاهها با استفاده از برنامههای دلخواه»).
یک فراخوان برای اقدام (مثلاً «شروع کنید») و راهی برای لغو در صورتی که کاربر نخواهد ادامه دهد.
اگر فضا اجازه دهد، توضیحی از آنچه که با پیشرفت کاربر در صفحات رخ خواهد داد.
به طور خاص برای Matter ، وقتی کاربر قبلاً از طریق APIهای Home به شما اجازه دسترسی به خانهاش را داده باشد، میتوانید هنگام راهاندازی دستگاههای جدید، اشتراکگذاری دستگاههای خانهاش را با Google Home امکانپذیر کنید. به عنوان مثال، میتوانید یک دستگاه Matter را به fabric خود اضافه کنید و سپس از کاربر بخواهید که این دستگاه را به Google fabric اضافه کند.
پیشنهادات محتوایی
کاربران راحتتر میتوانند به چیزی که آن را درک میکنند و ارزش افزوده دارد اعتماد کنند. با ارائه اطلاعات به کاربران، آنها را برای تصمیمگیری آگاهانه، از جمله در مورد بدهبستانها، توانمند کنید.
نکتهی انتقادی
اگر ارزش پیشنهادی قوی برای کاربران وجود نداشته باشد، آنها به مسیر اشتراکگذاری دستگاهها ادامه نخواهند داد.
- به نحوهی ارائهی پیشنهاد خود توجه ویژهای داشته باشید.
- جذابش کن اما بیش از حد قول نده.
- اگر کاربر به دستگاهی نیاز دارد که در پیشنهاد شما به آن اشاره شده است، مطمئن شوید که آن را به وضوح بیان کنید تا با مانع غیرمنتظرهای مواجه نشود.
- شما ممکن است فقط یک فرصت برای جذب این کاربران داشته باشید، بنابراین از آن نهایت استفاده را ببرید.
بهترین شیوهها
- با دیدگاه کاربر شروع کنید - رویکرد «چه چیزی در آن برای من وجود دارد؟»
- بیش از چهار خط محتوا در یک بخش ننویسید. کلمات بیشتر ممکن است توجه کاربر را از دست بدهند. با این حال، وضوح و درک مطلب میتواند مهمتر از مختصر بودن باشد.
- اتوماسیونها سرگرمکننده هستند! اگر فضا اجازه میدهد، یک مثال هیجانانگیز اما مفید انتخاب کنید.
- اگر با استراتژی کلی شما همسو است، لحن و صدای شوخ و بازیگوشانهای را امتحان کنید.
- از عبارات کاربردی مانند «شروع کنید» استفاده کنید.