چند مدیر برای راه اندازی API

Commissioning API از چند مدیریت (یا چند سرپرست ) برای Matter پشتیبانی می کند، به این معنی که Commissioning API می تواند به عنوان کمیسیون اصلی یا ثانویه Matter عمل کند و شما می توانید کمیسیونر خود را اضافه کنید:

  • به عنوان کمیسر اصلی Matter :

    • در این حالت ابتدا فابریک گوگل با استفاده از Google UX اضافه می شود.
    • می توانید یک کمیسیونر سفارشی اضافه کنید.
      • پس از افزودن فابریک Google به دستگاه، کمیسیونر شما تماس گرفته می شود، سپس پنجره راه اندازی Matter دوباره باز می شود.
      • اگر Google به هر دلیلی نتواند راه اندازی پارچه خود را در ابتدا تکمیل کند، سرویس سفارشی سفارشی شما اجرا نخواهد شد.
  • به عنوان Matter ثانویه:

    • در این حالت، می‌توانید UX راه‌اندازی خود را روی پارچه خود (یا روی پارچه‌های دیگر) پیاده‌سازی کنید.
    • Google Commissioning API را می‌توان بعداً با یک پنجره راه‌اندازی باز برای افزودن پارچه Google فراخوانی کرد. در این حالت، Google اکیداً توصیه می‌کند که وقتی کاربر نهایی به شما اجازه استفاده از APIهای Home را می‌دهد، برنامه به طور فعال از کاربران می‌خواهد که پس از تکمیل جریان راه‌اندازی، پارچه Google را (با استفاده از Commissioning API) اضافه کنند.

نحوه استفاده از Commissioning API به عنوان کمیسیون اصلی Matter

این مراحل، جریان راه‌اندازی کامل Matter مورد علاقه Google را نشان می‌دهد:

  1. کاربر جریان راه اندازی را در برنامه آغاز می کند. برای مثال، کاربر روی دکمه‌ای با عنوان افزودن دستگاه ضربه می‌زند.

  2. Google UX کنترل را در دست می گیرد و صفحه Scan Matter QR Code را نمایش می دهد و به کاربر این امکان را می دهد تا کد QR را اسکن کند تا فرآیند راه اندازی را شروع کند.

  3. در صفحه اتصال این دستگاه به حساب Google خود ، کاربر روی من برای افزودن دستگاهی به اکوسیستم Google ضربه می‌زند. اگر کاربر به جای آن روی لغو روی این صفحه ضربه بزند، تمام راه اندازی دستگاه بلافاصله پایان می یابد.

  4. در صفحه انتخاب صفحه اصلی ، کاربر خانه ای را انتخاب می کند که از آنجا می تواند دستگاه را کنترل کند. اگر خانه ای در دسترس نباشد، خانه جدیدی ایجاد می شود. اگر هیچ هاب مناسبی در خانه یافت نشد، یا اگر کاربر فاقد مجوز باشد، فرآیند راه اندازی به پایان می رسد.

  5. صفحه Device Connected باید در مرحله بعد ظاهر شود و فرآیند تنظیم Matter آغاز می شود. کاربر می تواند یک اتاق و نام دستگاه را در این صفحه انتخاب کند.

  6. هنگامی که دستگاه روی پارچه Matter سوار می شود، صفحه Getting your device ready ظاهر می شود.

  7. برنامه شما کنترل را از سر می گیرد، و کمیسیون سفارشی، در صورت ثبت نام، اکنون اجرا می شود.

نحوه استفاده از Commissioning API به عنوان کمیسیون ثانویه Matter

این مراحل جریان راه اندازی Matter را نشان می دهد که در آن فرآیند راه اندازی شما قبل از فرآیند راه اندازی Google اتفاق می افتد:

  1. کاربر جریان راه اندازی را در برنامه شما آغاز می کند. برای مثال، کاربر روی Add Device ضربه می‌زند.

  2. فرآیند UX راه اندازی شما برای افزودن دستگاهی به پارچه شما اجرا می شود.

  3. پس از تکمیل، می‌توانید رفتار بعدی را با استناد به دانش خود از کاربر دیکته کنید. برای مثال، اگر کاربر APIهای Google Home را انتخاب کرده باشد، که احتمالاً نشانه‌ای از این است که کاربر می‌خواهد به Google سفارش دهد، می‌توانید فرآیند راه‌اندازی را آغاز کنید.

  4. فرآیند شما با Commissioning API تماس می گیرد و محموله ای را ارائه می دهد که حاوی رمز عبور، تشخیص دهنده و سایر اطلاعات موجود است.

  5. فرآیند راه اندازی گوگل، دستگاه را به فابریک گوگل اضافه می کند.