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

يتم إنشاء مسار تسليم محلي عندما تطابق 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": "..."
      }
    }]
  }
}
السابق
نظرة عامة
التالي
تنفيذ تطبيق توصيل الطلبات المحلي