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

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

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

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

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

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

    انتقِل إلى Play 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": "..."
      }
    }]
  }
}