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

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

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

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

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

  1. پروژه خانه هوشمند خود را در کنسول Actions باز کنید.
  2. در پیمایش سمت چپ، روی Actions کلیک کنید.
  3. در قسمت Configure local home SDK (اختیاری) > Add device scan configuration ، روی New scan config کلیک کنید.
  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": "..."
      }
    }]
  }
}