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

يتم إنشاء مسار توفير الطلبات على الجهاز عندما تتطابق 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" تحدّد الأجهزة التي يتحكّم فيها المستخدم وقدراته.

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