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

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

تتضمّن مساحة الاسم action.devices جميع نوايا smart home، ويجب توفير معلومات عنها. عندما يُرسِل Google Assistant طلبًا إلى جهة الامتثال، يتم تمرير رمز دخول OAuth 2 التابع لجهة خارجية في عنصر Authorization header (عنوان التفويض).

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

مزامنة

يُستخدَم الغرض action.devices.SYNC لطلب قائمة devices smart home التي ربطها المستخدم والتي تتوفّر للاستخدام.

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

يوضّح هذا الشكل التفاعل بين البنية الأساسية لشركة Google والبنية الأساسية للشريك. تتوفّر في بنية Google الأساسية قائمة بالشركاء المتاحين لتطبيق "مساعد Google"، والتي يتم نقلها بعد ذلك إلى بنية الشريك الأساسية لإكمال مصادقة OAuth. مصادقة OAuth من جانب الشريك هي webview لإعداد الشريك وwebview لبروتوكول 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 طلبًا من النوع action.devices.QUERY إلى قسم المعالجة.

مخطّط تدفق لطلب بحث
الشكل 3: نية طلب البحث

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

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

التنفيذ

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

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

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

قطع الاتصال

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

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