مكان ووقت الاستماع إلى الموسيقى

أهداف المنزل المزوّد بأجهزة ذكية هي كائنات مراسلة بسيطة تصف الإجراء الذي يجب تنفيذه smart home مثل تشغيل ضوء أو إرسال الصوت إلى مكبّر صوت

يتم تضمين جميع أغراض smart home في مساحة الاسم action.devices وعليك توفير مساحة الاسم. في كل مرة يرسل Google Assistant نية للتنفيذ، وهي يتم تمرير رمز الدخول إلى OAuth 2 التابع لجهة خارجية في عنوان التفويض.

في ما يلي أغراض smart home المتوافقة:

مزامنة

يُستخدَم الغرض action.devices.SYNC لطلب قائمة smart home جهاز متصل به المستخدم متاحة للاستخدام.

في حال إعداد المستخدم أجهزته باستخدام Google Home app (GHA)، يمكنه أيضًا الحصول على مصادقة للبنية الأساسية للسحابة الإلكترونية. بعد ذلك، يُرجى اتّباع الخطوات التالية: يتلقّى Assistant رمز OAuth2 المميز. في هذه المرحلة، يرسل "Assistant" الهدف "action.devices.SYNC" إلى التنفيذ لاسترداد القائمة الأولية لأجهزة المستخدم وإمكاناته من البنية الأساسية للسحابة الإلكترونية.

يوضح هذا الشكل التفاعل بين بنية Google الأساسية والبنية الأساسية للشريك. من بنية Google الأساسية هناك قائمة بالشركاء المتاحين لتطبيق عميل "مساعد Google" إلى البنية الأساسية للشريك لإكمال مصادقة OAuth. بروتوكول OAuth من جانب الشريك مثل webview لإعداد الشريك أو OAuth webview الإعدادات والبنود الاختيارية وخدمات السحابة الإلكترونية للشركاء. البنية الأساسية للشريك بعد ذلك بيانات اعتماد OAuth إلى تطبيق عميل "مساعد Google". الشريك ترسل خدمات السحابة الإلكترونية الأجهزة والإمكانات المتاحة إلى خدمات "مساعد Google" الذي يخزن بعد ذلك المعلومات في الرسم البياني المنزلي.
الشكل 1: التفاعل بين Google والشريك البنية الأساسية

لتجنُّب إلغاء ربط حساب مستخدم وإعادة ربطه، يمكنك إرسال طلب مزامنة. إلى Assistant. يؤدي هذا الإجراء إلى إرسال هدف "action.devices.SYNC" إلى وجهة الطلب لمزامنة قائمة الأجهزة والإمكانات. عرض تنفيذ طلب مزامنة لمزيد من المعلومات المعلومات.

مخطط انسيابي لهدف SYNC
الشكل 2: نية المزامنة

أثناء إعداد توصيل الطلبات محليًا، يتم عرض تتحقّق منصة الصفحة الرئيسية المحلية من ردّ SYNC من smart home التنفيذ على السحابة الإلكترونية في Action. لمزيد من المعلومات حول كيف لتعديل ردّك من "SYNC"، يُرجى الاطّلاع على المعلومات المتوفرة في المتجر. تعديل استجابة المزامنة في تنفيذ السحابة الإلكترونية:

QUERY

يتم استخدام الغرض action.devices.QUERY لطلب البحث عن الحالة الحالية. من smart home جهاز.

عندما يطلب المستخدمون البحث عن حالة الجهاز، للإجابة عن سؤال مثل Ok Google، أيّ مصابيح مضاءة في المطبخ؟، يرسل "Assistant" الهدف "action.devices.QUERY" إلى التنفيذ.

مخطط انسيابي لهدف QUERY
الشكل 3: هدف QUERY

لتقديم أفضل تجربة للمستخدم، يجب تنفيذ حالة الإبلاغ للإبلاغ بشكل استباقي عن الحالة الحالية لأجهزة المستخدم مباشرة Google Home Graph على سبيل المثال، يتيح ذلك يمكن لـ Assistant معرفة ما إذا شغّل المستخدم مصباحًا ذكيًا باستخدام مفتاح إضاءة فعلي.

الإبلاغ عن حالة الجهاز باستخدام "حالة التقرير"
الشكل 4: الإبلاغ عن حالة الجهاز

التنفيذ

يتم استخدام الغرض action.devices.EXECUTE لتقديم الطلبات. لتنفيذه على smart home جهاز.

عندما يرسل المستخدمون طلبات إلى الأجهزة باستخدام "Assistant"، سيتم تنفيذ ما يلي: عملية تنفيذ الطلب تحصل على action.devices.EXECUTE، وذلك في تلبية طلبك. يصف الإجراء والأجهزة التي يجب العمل عليها. يمكن للمستخدم تنفيذ إجراء على جهاز يوجِّه طلبًا، مثل Ok Google، أريد إضاءة المصابيح في غرفة المعيشة

مخطط انسيابي لهدف التنفيذ
الشكل 5: تنفيذ النية

قطع الاتصال

يتم تشغيل الغرض action.devices.DISCONNECT لإبلاغك. عندما يلغي أحد المستخدمين ربط حساب التطبيق من Assistant. بعد تلقّي هدف action.devices.DISCONNECT، يجب عدم الإبلاغ عنه. الخاصة بأجهزة هذا المستخدم.

السابق
أنواع الأجهزة والسمات
التالي
توصيل الطلبات