يتم إنشاء مسار توصيل الطلبات محليًا عندما تُطابِق Google جهازًا يمكن التحكّم فيه محليًا
مع جهاز يتم عرضه في استجابة SYNC
من تنفيذ طلبات السحابة الإلكترونية.
لتمكين Google من اكتشاف جهازك على الشبكة المحلية وإنشاء مسار توصيل الطلبات المحلي، يجب إضافة معلومات الاكتشاف في وحدة تحكم الإجراءات.
يجب أيضًا تعديل استجابة SYNC
من خلال تنفيذ طلبك على السحابة الإلكترونية لإعلام Google
بالجهاز الذي يمكن التحكّم فيه محليًا.
إعداد معلومات تهيئة الفحص
لتحديد معلومات الاكتشاف، اتبع الخطوات التالية:
- افتح مشروعك المنزلي الذكي في "وحدة تحكّم المهام".
- في شريط التنقل الأيمن، انقر على الإجراءات.
- ضمن ضبط حزمة تطوير البرامج (SDK) المحلية للمنزل (اختياري) > إضافة ضبط فحص الجهاز، انقر على ضبط فحص جديد للجهاز.
- حدد نوع بروتوكول مطابق للمسح من القائمة المنسدلة وأدخل قيمًا لـ Google ليتم فحصها.
تعرض الجداول التالية السمات التي يمكنك إضافتها، بناءً على البروتوكولات التي تريد من Google استخدامها للبحث عن جهازك:
السمة | الوصف | مثال للقيمة |
---|---|---|
اسم الخدمة |
مطلوبة. اسم الخدمة الذي نشره الجهاز بالتنسيق
service.domain .
|
_http._tcp.local |
الاسم |
مطلوبة. يمكنك الفلترة بحثًا عن مثيل خدمة فريد بالتنسيق |
my-device-[0-9]{4}\._http\._tcp\.local |
السمة | الوصف | مثال للقيمة |
---|---|---|
نوع الخدمة |
مطلوبة. معرّف مؤهَّل بالكامل لخدمة UPnP بالتنسيق
domain:service:type:version .
|
schemas-upnp-org:service:SwitchPower:1 |
معرّف الوحدة التنظيمية |
اختياريّ. المعرّف الفريد التنظيمي. قيمة 24 بت التي تحدد الشركة المصنّعة للجهاز. وعادةً ما تكون أول ثُماني وحدات بت لعنوان MAC للجهاز. |
1A:2B:3C |
السمة | الوصف | مثال للقيمة |
---|---|---|
عنوان البث | مطلوبة. عنوان 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": "..." } }] } }