تحسّن حزمة تطوير البرامج (SDK) المحلية للمنازل دمج المنزل المزوّد بأجهزة ذكية مع "مساعد Google" من خلال إضافة مسار تنفيذ غير مستند إلى السحابة لتوجيه الطلبات المتعلقة بأغراض المنزل الذكية.
تتيح لك حزمة تطوير البرامج (SDK) كتابة تطبيق توصيل محلي، باستخدام TypeScript أو JavaScript، الذي يحتوي على منطق نشاطك التجاري الذكي. يمكن لأجهزة Google Home أو Google Nest تحميل تطبيقك وتشغيله على الجهاز. يتواصل تطبيقك مباشرةً مع أجهزتك الذكية الحالية عبر شبكة Wi-Fi على شبكة منطقة محلية (LAN) لتلبية أوامر المستخدمين وبروتوكولات حالية.
يوفر دمج حزمة تطوير البرامج (SDK) تحسينات على الأداء لمنزلك الذكي، بما في ذلك وقت استجابة أقل وموثوقية أعلى. يمكن استخدام هذه الطريقة مع جميع أنواع الأجهزة وسماتها، باستثناء الأجهزة التي تستخدم طريقة التحقّق الثانوية.
فهم آلية العمل
بعد تلقّي استجابة SYNC
من خلال تنفيذ خدمات السحابة الإلكترونية، تفحص منصة "الصفحة الرئيسية" المحلية الشبكة المحلية للمستخدم من خلال استخدام mDNS أو UDP أو UPnP لاكتشاف الأجهزة الذكية المتصلة بخدمة "مساعد Google".
يرسل النظام الأساسي نيّة IDENTIFY
لتحديد ما إذا كان يمكن التحكّم في الجهاز محليًا، من خلال مقارنة رقم تعريف الجهاز في استجابة IDENTIFY
بتلك التي يعرضها الردّ SYNC
السابق. وإذا كان الجهاز الذي تم اكتشافه هو مركز أو مجموعة إعدادات نقل المحتوى، تُرسِل النظام الأساسي intent REACHABLE_DEVICES
وتتعامل مع المركز كجهاز وكيل للاتصال محليًا.
عندما تتلقّى ردًا يؤكّد جهازًا محليًا، تنشئ المنصة مسارًا محليًا لتوصيل الطلبات إلى جهاز Google Home أو جهاز Google Nest، ثم توجّه أوامر المستخدم إلى توصيل الطلبات المحلية.
عندما يشغّل المستخدم إجراءً منزليًا ذكيًا يتضمّن مسارًا محليًا لتوصيل الطلبات،
يرسل "مساعد Google" النية على استخدام EXECUTE
أو QUERY
إلى
جهاز Google Home أو Google Nest بدلاً من طريقة تنفيذ السحابة الإلكترونية. يشغِّل الجهاز بعد ذلك
تطبيق توصيل الطلب المحلي لمعالجة intent.

لم تحدِّد منصة "الصفحة الرئيسية" المحلية إمكانية اختيار جهاز Google Home أو Google Nest لتشغيل الأمر. قد يكون الغرض من جهازَي EXECUTE
وQUERY
هو أي جهاز
Google Home أو Google Nest محدّد في بنية
الرسم البياني للمنزل نفسها التي يستخدمها الجهاز المستهدف.
تطبيق توصيل الطلب المحلي
يحتوي تطبيق التنفيذ المحلي على منطق الأنشطة التجارية لمعالجة الأهداف التي أرسلتها منصة Home Home والوصول إلى جهازك الذكي من خلال شبكة المنطقة المحلية. ومن غير المتوقع أن يؤدي أي تعديل على جهازك إلى دمج هذه الميزة على الجهاز. يلبّي التطبيق طلبات الإجراءات المنزلية الذكية عن طريق إرسال أوامر التحكّم إلى الجهاز الذكي من خلال بروتوكولات طبقة التطبيق، بما في ذلك HTTP أو TCP أو UDP. في حال تعذّر تنفيذ الطلب المحلي، يتم استخدام تنفيذ السحابة الإلكترونية كمسار تنفيذ احتياطي.
لدعم إنشاء التطبيق، توفّر حزمة تطوير البرامج (SDK) المحلية للمنزل فئتين أساسيتين:
DeviceManager
: توفّر طرقًا للتواصل مع الأجهزة الذكية باستخدام طلبات بروتوكول TCP أو اتصالات UDP أو HTTP.App
: يوفّر طرقًا لإرفاق معالِجات intent التي ترسلها Google بعد اكتشاف الأجهزة التي يمكن التحكم فيها محليًا (IDENTIFY
،REACHABLE_DEVICES
). وينفّذ هذا الصف أيضًا أوامر المستخدم (EXECUTE
)، ويجيب عن طلبات البحث المتعلّقة بحالة الجهاز الحالية (QUERY
).
أثناء تطويره، يمكنك إنشاء التطبيق واختباره من خلال تحميله على خادم الاستضافة أو جهاز التطوير المحلي الخاص بك. في مرحلة الإنتاج، تستضيف Google تطبيقك في بيئة وضع حماية JavaScript آمنة على جهاز Google Home أو جهاز Google Nest للمستخدم.
إنّ واجهة برمجة التطبيقات Report State غير متاحة حاليًا لتوصيل الطلبات في المتجر. وتعتمد Google على طريقة تسليم الطلبات في السحابة الإلكترونية لمعالجة هذه الطلبات.
مراحل نشاط التطبيق
يتم تحميل تطبيق تنفيذ الطلبات المحلي عند الطلب عندما تكتشف منصّة المنزل المحلية أجهزة محلية جديدة تتطابق مع إعدادات فحص المشروع أو عندما يكون لديها نية بالشراء لإرسالها إلى جهاز تم تحديده سابقًا.
إنّ أجهزة Google Home أو Google Nest متوافقة مع الذاكرة وقد يتم إنهاء تطبيق توصيل الطلبات المحلي في أي وقت بسبب الضغط في الذاكرة على النظام. ويمكن أن يحدث ذلك إذا بدأ تطبيقك باستهلاك مساحة كبيرة جدًا من الذاكرة، أو إذا كان النظام يحتاج إلى إخلاء مساحة لتطبيق آخر. وتؤدي منصّة Home المحلية إلى إعادة تشغيل تطبيقك فقط عندما تكون هناك أغراض جديدة لتوفير موارد ذاكرة كافية لتشغيل التطبيق.
تعمل منصّة Home Home على إلغاء تحميل تطبيقك بعد انتهاء مهلة وضع عدم النشاط عندما يلغي المستخدم ربط حسابه أو لا تتوفّر أجهزة توفّر خدمة توصيل الطلب المحلية المرتبطة بجهاز agentUserId
.
الأجهزة المتوافقة
في إعدادات Home Home، ينفّذ تطبيق توصيل الطلبات المحلي على أجهزة Google Home أو Google Nest المتوافقة. يوضّح الجدول التالي الأجهزة المتوافقة ووقت التشغيل المستخدَم في كل جهاز. لمزيد من المعلومات حول متطلبات وقت التشغيل، يُرجى الاطّلاع على بيئة التنفيذ.
الجهاز | Type | البيئة |
---|---|---|
Google Home | المتحدث | Chrome |
Google Home Mini | المتحدث | Chrome |
Google Home Max | المتحدث | Chrome |
جهاز Nest Mini | المتحدث | Chrome |
Nest Hub | الشبكة الإعلانية | Chrome |
Nest Hub Max | الشبكة الإعلانية | Chrome |
Nest Wifi | جهاز التوجيه | Node.js |
نقطة | Chrome |
بيئة التنفيذ
تعتمد بيئة التنفيذ لتطبيق التنفيذ المحلي على جهازك. تتوافق منصّة Home Home مع البيئات التالية:
- Chrome: يتم تنفيذ تطبيق التنفيذ المحلي ضمن سياق متصفّح Chrome
window
الذي يشغِّل Chrome M80 أو الإصدارات الأحدث المتوافقة مع الإصدار ESMA0281 من ECMAscript. - Node.js: يتم تنفيذ تطبيق التنفيذ المحلي كنص برمجي ضمن عملية Node.js تعمل مع Node v10.x LTS أو إصدار أحدث متوافق مع ECMAscript version ES2018.
بنية رمز المصدر
نقترح تجميع تبعيّاتك في ملف JavaScript واحد باستخدام إعدادات الحزمة التي توفّرها حزمة تطوير البرامج (SDK) المحلية للمنزل ودمج رمز المصدر الخاص بك في شكل تعبير الدالة الذي يتم استدعاءه على الفور (IIFE).
مسار التنفيذ
للاستفادة من حزمة تطوير البرامج (SDK) المحلية للمنزل في منزلك المزوّد بأجهزة ذكية، عليك تنفيذ المهام التالية:
1 | ضبط إعدادات الفحص | اضبط وحدة تحكّم المهام باستخدام المَعلمات اللازمة لمساعدة "مساعد Google" من أجل اكتشاف الأجهزة التي يمكن التحكّم فيها محليًا. |
2 | تعديل ردود المزامنة في عملية تنفيذ السحابة الإلكترونية | في إعداد تنفيذ السحابة الإلكترونية، عدِّل معالج
الطلب SYNC
لإتاحة الحقل
otherDeviceIds الذي تستخدمه المنصة لإنشاء مسار تنفيذ محلي. في هذا الحقل، حدّد أرقام تعريف الأجهزة التي يمكن التحكم فيها محليًا.
|
3 | استخدام تطبيق توصيل الطلب المحلي | استخدِم حزمة تطوير البرامج (SDK) المحلية للمنزل لإنشاء تطبيق JavaScript للتعامل مع أهداف IDENTIFY و
EXECUTE و
QUERY . بالنسبة إلى الأجهزة الوكيلة في مركز التحكّم أو مجموعة إعدادات نقل المحتوى، عليك أيضًا
معالجة هدف REACHABLE_DEVICES .
|
4 | اختبار تطبيقك وتصحيح الأخطاء | اختبِر عملية الدمج (أو الشهادة الذاتية) باستخدام حزمة Google Home Test. |
قبل البدء
- اطّلِع على أساسيات إنشاء إجراء منزلي ذكي.
- في وحدة تحكُّم الإجراءات، تأكَّد من أنّ لديك مشروعًا حاليًا منزلاً ذكيًا وأنّه تم ضبط ربط الحساب.
- تأكَّد من تسجيل الدخول باستخدام حساب Google نفسه في "وحدة تحكّم المهام" وفي "مساعد Google" على جهاز الاختبار.
- ستحتاج إلى بيئة Node.js لكتابة تطبيقك. لتثبيت Node.js وnpm، يُنصح باستخدام Node Version (مدير العُقد).
- لاستخدام أحدث إصدار من حزمة تطوير البرامج (SDK) المحلية للمنزل، عليك تسجيل أجهزة الاختبار في برنامج "معاينة البث".