دعم اكتشاف الأجهزة

يتم إنشاء مسار تنفيذ محلي عندما تطابق Google جهازًا يمكن التحكّم فيه محليًا مع جهاز تم عرضه في الردّ SYNC من عملية التنفيذ في السحابة الإلكترونية.

لكي تتمكّن Google من رصد جهازك على الشبكة المحلية وإنشاء مسار التنفيذ المحلي، عليك إضافة معلومات الرصد في Actions Console. عليك أيضًا تعديل الردّ SYNC من خدمة التنفيذ على السحابة الإلكترونية لإعلام Google بالجهاز الذي يمكن التحكّم به محليًا.

إعداد معلومات ضبط عملية الفحص

لتحديد معلومات الاكتشاف، اتّبِع الخطوات التالية:

  1. انتقِل إلى عملية دمج Cloud-to-cloud في Google Home Developer Console:

    الانتقال إلى Play Console

  2. انتقِل إلى المشروع > النقل من السحابة الإلكترونية إلى السحابة الإلكترونية على يمين الشاشة، ثم انقر على تعديل لعملية الدمج. في صفحة الإعداد والضبط، انتقِل إلى التنفيذ المحلي وفعِّل الإعداد. أدخِل عنوان URL التالي في كل حقل من حقول عناوين URL التجريبية، وأدرِج رقم تعريف مشروعك، ثم انقر على حفظ:

    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 "مساعد Google" بالأجهزة التي يتحكّم بها المستخدم وإمكاناتها.

لإتاحة التنفيذ المحلي، تتحقّق منصة 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": "..."
      }
    }]
  }
}