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

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

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

إعداد معلومات إعدادات الفحص

لتحديد معلومات العرض، اتّبِع الخطوات التالية:

  1. افتح مشروع المنزل الذكي في وحدة تحكّم "المهام".
  2. في شريط التنقّل الأيمن، انقر على الإجراءات.
  3. ضمن ضبط حِزم تطوير البرامج (SDK) المحلية للأجهزة المنزلية (اختياري) > إضافة إعدادات فحص الجهاز، انقر على إعدادات فحص جديدة.
  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": "..."
      }
    }]
  }
}
السابق
نظرة عامة
التالي
تنفيذ تطبيق توصيل الطلبات المحلي