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

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

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

في ما يلي 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 الاستجابة في السحابة الإلكترونية لتطبيق "الإجراء". لمعرفة مزيد من المعلومات عن كيفية تعديل استجابة 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، يجب عدم الإبلاغ عن حالة أجهزة هذا المستخدم.

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