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

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

لتفعيل Google على اكتشاف جهازك على الشبكة المحلية وتحديد مسار التسليم المحلي، عليك إضافة معلومات الاكتشاف في وحدة تحكّم "المهام". عليك أيضًا تعديل استجابة 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 في عملية التسليم في السحابة الإلكترونية

يُبلغ 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": "..."
      }
    }]
  }
}