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

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

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

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

SYNC

يُستخدَم الأمر 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: الأمر SYNC

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

QUERY

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

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

مخطط انسيابي لنية QUERY
الشكل 3: الأمر QUERY

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

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