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

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

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

إعداد معلومات ضبط الفحص

لتحديد معلومات الاكتشاف، اتّبِع الخطوات التالية:

  1. انتقِل إلى عملية دمج "Cloud-to-cloud" في Google Home Developer Console:

    انتقِل إلى Developer 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 "مساعد 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": "..."
      }
    }]
  }
}