مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يتم إنشاء مسار توصيل الطلبات محليًا عندما تُطابِق 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
حزمة Discovery

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

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

تحديث استجابة SYNC في تنفيذ السحاب

تُبلِغ وحدة intent في 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": "..."
      }
    }]
  }
}