پشتیبانی از کشف دستگاه

زمانی که Google یک دستگاه قابل کنترل محلی را با دستگاهی که در پاسخ SYNC از تکمیل ابری شما برگردانده شده است، تطبیق دهد، یک مسیر انجام محلی ایجاد می‌شود.

برای فعال کردن Google برای کشف دستگاه شما در شبکه محلی و ایجاد مسیر انجام محلی، باید اطلاعات اکتشاف را در کنسول Actions اضافه کنید. همچنین باید پاسخ SYNC را از انجام ابر خود به‌روزرسانی کنید تا Google را از دستگاه قابل کنترل محلی مطلع کنید.

اطلاعات پیکربندی اسکن را تنظیم کنید

برای مشخص کردن اطلاعات کشف، مراحل زیر را دنبال کنید:

  1. به ادغام Cloud-to-cloud خود در Google Home Developer Console بروید:

    به Developer Console بروید .

  2. به Project > Cloud-to-Cloud در سمت چپ صفحه بروید، سپس Edit را برای ادغام انتخاب کنید. در صفحه Setup and configuration ، به Local realization بروید و تنظیمات را روشن کنید. URL زیر را در هر فیلد URL آزمایشی وارد کنید، ID پروژه خود را وارد کنید و روی Save کلیک کنید:

    https://<project-id>.web.app/local-home/index.html

  3. برای افزودن پیکربندی اسکن جدید، روی + افزودن پیکربندی اسکن در قسمت کشف دستگاه کلیک کنید.

  4. یک نوع پروتکل منطبق با اسکن را از منوی کشویی انتخاب کنید و مقادیری را برای اسکن Google وارد کنید.

جداول زیر ویژگی هایی را که می توانید اضافه کنید، بر اساس پروتکل هایی که می خواهید Google برای اسکن دستگاه شما استفاده کند، نشان می دهد:

mDNS
صفت توضیحات مقدار نمونه
نام سرویس مورد نیاز. نام سرویس منتشر شده توسط دستگاه در service . domain . _http._tcp.local
نام

مورد نیاز. برای یک نمونه سرویس منحصر به فرد در instance . service . domain .

پلتفرم با این مقدار به عنوان یک عبارت منظم برخورد می کند و دستگاه های منطبق را برمی گرداند.
my-device-[0-9]{4}\._http\._tcp\.local
UPnP
صفت توضیحات مقدار نمونه
نوع خدمات مورد نیاز. شناسه کاملاً واجد شرایط سرویس UPnP در domain :service: type : version . schemas-upnp-org:service:SwitchPower:1
OUI

اختیاری. شناسه منحصر به فرد سازمانی

مقدار 24 بیتی که سازنده دستگاه را شناسایی می کند. به طور معمول، سه اکتت اول آدرس MAC دستگاه.
1A:2B:3C
UDP
صفت توضیحات مقدار نمونه
آدرس کشف مورد نیاز. آدرس IP مقصد برای پخش UDP. 255.255.255.255
بندر پخش مورد نیاز. پورت مقصد برای پخش UDP. 5555
بندر گوش دادن مورد نیاز. پورت گوش دادن برای پاسخ کشف UDP. 5556
بسته کشف

مورد نیاز. محموله برای ارسال در پخش UDP.

به عنوان یک رشته کدگذاری شده هگزادسیمال از بایت ها قالب بندی شده است.
48454C4C4F

پاسخ SYNC را در تکمیل ابر به‌روزرسانی کنید

هدف SYNC به دستیار گزارش می‌دهد که کاربر چه دستگاه‌هایی را کنترل می‌کند و قابلیت‌های آن‌ها را کنترل می‌کند.

برای پشتیبانی از انجام محلی، پلتفرم Local Home پاسخ SYNC را از انجام عملیات ابری خانه هوشمند شما بررسی می‌کند و سعی می‌کند شناسه‌های دستگاه در قسمت otherDeviceIds را با شناسه تأیید بازگردانده شده توسط کنترل‌کننده IDENTIFY مطابقت دهد. ورودی‌های دستگاه بدون فیلد otherDeviceIds از انجام محلی مستثنی هستند.

در فیلد otherDeviceIds پاسخ SYNC ، باید شناسه‌های دستگاه دستگاه‌های خانه هوشمند را تنظیم کنید که می‌توانند به صورت محلی کنترل شوند. فیلد در سطح device در پاسخ ظاهر می شود. Google می‌تواند یک مسیر انجام محلی را در هر دستگاهی با شناسه داده شده ایجاد کند.

از فیلد customData برای تعیین هرگونه داده اضافی مورد نیاز Google برای اتصال به دستگاه مستقل یا هدف قرار دادن دستگاه‌های پایانی با استفاده از یک هاب (مثلاً شماره پورت و سایر اطلاعات خاص پروتکل) استفاده کنید.

مثال

قطعه زیر نشان می دهد که چگونه می توانید کنترلر SYNC خود را ایجاد کنید.

مستقل / هاب
{
  "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf",
  "payload": {
    "agentUserId": "1836.15267389",
    "devices": [{
      "id": "123",
      "type": "action.devices.types.OUTLET",
      "traits": [
        "action.devices.traits.OnOff"
      ],
      "name": {
        "name": "Night light"
      },
      "willReportState": false,
      "otherDeviceIds": [{
        "deviceId": "local-device-id"
      }],
      "customData": {
        "port": 5555,
        "authToken": "..."
      }
    }]
  }
}