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

إنّ أغراض المنزل الذكي هي عناصر مراسلة بسيطة تصف عملية الدمج التي يجب تنفيذها، مثل تشغيل ضوء أو بث الصوت إلى مكبّر صوت.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 التنفيذ السحابي للإجراء. لمزيد من المعلومات حول كيفية تعديل ردّك 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: نية EXECUTE

قطع الاتصال

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

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