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

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