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

تتضمّن طلبات المنزل الذكي عناصر مراسلة بسيطة تصف عملية الدمج التي يجب تنفيذها، مثل تشغيل ضوء أو بث صوت إلى مكبّر صوت.Cloud-to-cloud

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

في ما يلي smart home النوايا المتوافقة:

مزامنة

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

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

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

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

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

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

QUERY

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

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

مخطط انسيابي لنية طلب البحث QUERY
الشكل 3: النية من طلب البحث

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

الإبلاغ عن حالة الجهاز باستخدام Report State
الشكل 4: الإبلاغ عن حالة الجهاز

EXECUTE

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

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

مخطط انسيابي لغرض EXECUTE
الشكل 5: نية التنفيذ

قطع الاتصال

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

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