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

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

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

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

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

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