يتم إنشاء مسار تنفيذ محلي عندما تطابق Google جهازًا يمكن التحكّم به محليًا مع جهاز تم عرضه في الردّ SYNC
من عملية التنفيذ في السحابة الإلكترونية.
للسماح لـ Google باكتشاف جهازك على الشبكة المحلية وإنشاء مسار التنفيذ المحلي، عليك إضافة معلومات الاكتشاف في Actions Console.
عليك أيضًا تعديل الردّ SYNC
من خدمة التنفيذ على السحابة الإلكترونية لإعلام Google بالجهاز الذي يمكن التحكّم به محليًا.
إعداد معلومات ضبط عملية الفحص
لتحديد معلومات الاكتشاف، اتّبِع الخطوات التالية:
انتقِل إلى عملية الدمج Cloud-to-cloud في Google Home Developer Console:
انتقِل إلى المشروع > النقل من السحابة الإلكترونية إلى السحابة الإلكترونية على يمين الشاشة، ثم انقر على تعديل لعملية الدمج. في صفحة الإعداد والضبط، انتقِل إلى التنفيذ المحلي وفعِّل الإعداد. أدخِل عنوان URL التالي في كل حقل من حقول عناوين URL التجريبية، وأدرِج رقم تعريف مشروعك، ثم انقر على حفظ:
https://<project-id>.web.app/local-home/index.html
انقر على + إضافة إعدادات المسح الضوئي ضمن اكتشاف الأجهزة لإضافة إعدادات مسح ضوئي جديدة.
اختَر نوع بروتوكول مطابقة عمليات البحث من القائمة المنسدلة وأدخِل القيم التي تريد أن يبحث عنها 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 |
OUI |
اختيارية: المعرّف الفريد للمؤسسة: قيمة 24 بت تحدّد الشركة المصنّعة للجهاز. عادةً ما تكون الثمانيات الثلاث الأولى من عنوان MAC للجهاز. |
1A:2B:3C |
السمة | الوصف | مثال للقيمة |
---|---|---|
عنوان الاستكشاف | الحقل مطلوب. عنوان 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": "..." } }] } }