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

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

اختياريّ. المعرّف الفريد للمؤسسة

قيمة 24 بت التي تحدِّد الشركة المصنِّعة للجهاز عادةً، أول ثماني وحدات ثمانيّة عنوان MAC للجهاز.
1A:2B:3C
بروتوكول حزم بيانات المستخدم (UDP)
السمة الوصف مثال للقيمة
عنوان البث مطلوبة. عنوان IP الوجهة لعملية بث UDP. 255.255.255.255
منفذ البث مطلوبة. منفذ الوجهة للبث على UDP 5555
منفذ الاستماع مطلوبة. منفذ استماع لاستجابة UDP UDP 5556
حزمة Discovery

مطلوبة. حمولة لإرسالها في بث UDP

تم تنسيقه كسلسلة سداسية عشرية مشفّرة.
48454C4C4F

تعديل استجابة المزامنة في طريقة تنفيذ السحابة الإلكترونية

يقدِّم هدف intent SYNC تقارير إلى "مساعد Google" حول الأجهزة التي يتحكم فيها المستخدم وإمكاناته.

لتوفير الدعم المحلي، يتحقّق النظام الأساسي المحلي إلى الاستجابة 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": "..."
      }
    }]
  }
}