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

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

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

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

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

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

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