خدمات التوصيل المحلية

تحسّن حزمة تطوير البرامج (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"، ثم تتم معالجة نية المستخدم من خلال Google Cloud، ثم يتم تنفيذها محليًا على جهاز Google Home ويتم إصدار الأمر مباشرةً إلى مركز الأجهزة أو إلى الجهاز مباشرةً. يمكن استخدام السحابة الإلكترونية لمطوّر البرامج كخطة بديلة للسحابة الإلكترونية.
الشكل 1: إضافة مسار تنفيذ محلي إلى منزلك المزوّد بأجهزة ذكية.

لم تحدِّد منصة "الصفحة الرئيسية" المحلية إمكانية اختيار جهاز 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.

قبل البدء

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