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

إنّ أهداف المنزل المزوّد بأجهزة ذكية هي عناصر مراسلة بسيطة تصف الإجراء smart home الذي يجب تنفيذه، مثل إضاءة مصباح أو بث الصوت على مكبّر صوت.

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

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

مزامنة

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

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

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

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

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

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

QUERY

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

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

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

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

الإبلاغ عن حالة الجهاز باستخدام "حالة التقرير"
الشكل 4: الإبلاغ عن حالة الجهاز

التنفيذ

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

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

مخطط انسيابي للهجوم EXECUTE
الشكل 5: تنفيذ النية

قطع الاتصال

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