API کمیسیون در اندروید از چند-مدیریتی (یا چند-مدیری ) برای Matter پشتیبانی می‌کند، به این معنی که API کمیسیون می‌تواند به عنوان کمیسر اصلی یا فرعی Matter عمل کند و شما می‌توانید کمیسر خودتان را اضافه کنید:
به عنوان کمیسر اصلی Matter :
- در این حالت، ابتدا Google fabric با استفاده از Google UX اضافه می‌شود.
- می‌توانید یک کمیسر سفارشی اضافه کنید.
- پس از اضافه شدن Google fabric به دستگاه، با مسئول مربوطه تماس گرفته می‌شود و سپس پنجره راه‌اندازی Matter دوباره باز می‌شود.
- اگر گوگل به هر دلیلی نتواند ابتدا راه‌اندازی را روی پارچه خودش تکمیل کند، سرویس راه‌اندازی سفارشی شما اجرا نخواهد شد.
به عنوان کمیسر Matter ثانویه:
- در این حالت، می‌توانید UX راه‌اندازی خود را پیاده‌سازی کرده و آن‌بورد را روی فابریک خودشان (یا فابریک‌های دیگر) نصب کنید.
- می‌توان بعداً با یک پنجره راه‌اندازی باز، Google Commissioning API را برای افزودن Google fabric فراخوانی کرد. در این حالت، گوگل اکیداً توصیه می‌کند که وقتی کاربر نهایی به شما اجازه استفاده از Home APIها را داد، برنامه پس از اتمام فرآیند راه‌اندازی، به طور فعال از کاربران بخواهد که Google fabric (با استفاده از Commissioning API) را اضافه کنند.
نحوه استفاده از API کمیسیون به عنوان کمیسر اصلی امور
این مراحل، جریان راه‌اندازی کامل Matter مورد نظر گوگل را نشان می‌دهد:
کاربر جریان راه‌اندازی را در برنامه آغاز می‌کند. برای مثال، کاربر روی دکمه‌ای با عنوان «افزودن دستگاه» ضربه می‌زند.
رابط کاربری گوگل (Google UX) کنترل را به دست می‌گیرد و صفحه نمایش کد QR اسکن متر (Scan Matter QR Code) را نمایش می‌دهد و به کاربر اجازه می‌دهد کد QR را اسکن کند تا فرآیند راه‌اندازی آغاز شود.
در صفحه «این دستگاه را به حساب گوگل خود وصل کنید» ، کاربر روی «من موافقم که دستگاهی را به اکوسیستم گوگل اضافه کنم» ضربه می‌زند. اگر کاربر در این صفحه روی «لغو» ضربه بزند، تمام راه‌اندازی دستگاه بلافاصله پایان می‌یابد.
در صفحه انتخاب خانه ، کاربر خانه‌ای را که می‌تواند دستگاه را از آنجا کنترل کند، انتخاب می‌کند. اگر خانه‌ای در دسترس نباشد، یک خانه جدید ایجاد می‌شود. اگر هیچ هاب مناسبی در خانه پیدا نشود، یا اگر کاربر مجوز نداشته باشد، فرآیند راه‌اندازی پایان می‌یابد.
صفحه «دستگاه متصل است» باید در مرحله بعد ظاهر شود و فرآیند راه‌اندازی Matter آغاز می‌شود. کاربر می‌تواند در این صفحه، نام اتاق و دستگاه را انتخاب کند.
صفحه «آماده‌سازی دستگاه» همزمان با اتصال دستگاه به Matter fabric ظاهر می‌شود.
برنامه شما کنترل را از سر می‌گیرد و اگر کمیسیونر سفارشی ثبت شده باشد، اکنون اجرا می‌شود.
نحوه استفاده از API کمیسیون به عنوان کمیسر ثانویه امور
این مراحل، جریان راه‌اندازی Matter را نشان می‌دهد که در آن فرآیند راه‌اندازی شما قبل از فرآیند راه‌اندازی Google رخ می‌دهد:
کاربر جریان راه‌اندازی را در برنامه شما آغاز می‌کند. برای مثال، کاربر روی «افزودن دستگاه» ضربه می‌زند.
فرآیند راه‌اندازی تجربه کاربری شما برای اضافه کردن یک دستگاه به فابریک شما اجرا می‌شود.
پس از تکمیل، می‌توانید با تکیه بر دانش خود از کاربر، رفتار بعدی را دیکته کنید. به عنوان مثال، اگر کاربر در APIهای Google Home ثبت نام کرده باشد، که احتمالاً نشانه‌ای از تمایل کاربر به سفارش به گوگل است، می‌توانید فرآیند سفارش را آغاز کنید.
فرآیند شما، رابط برنامه‌نویسی کاربردی راه‌اندازی (Commissioning API) را فراخوانی می‌کند و payload را ارائه می‌دهد که شامل کد عبور، متمایزکننده و سایر اطلاعات موجود است.
فرآیند راه‌اندازی گوگل، دستگاه را به Google fabric اضافه می‌کند.