إنّ أغراض المنزل المزوّد بأجهزة ذكية هي عناصر مراسلة بسيطة تصف الإجراء الذي يجب تنفيذه في "smart home"، مثل تشغيل إضاءة أو بث صوت إلى مكبّر صوت.
تتوفّر جميع أهداف smart home في مساحة الاسم
action.devices
وعليك استيفاء المتطلبات اللازمة. عندما يرسل "Google Assistant" طلبًا إلى تنفيذ عملية الشراء، يتم تمرير رمز الدخول المميز عبر OAuth 2 التابع لجهة خارجية
للمستخدم في عنوان "التفويض".
في ما يلي أغراض smart home المتوافقة:
مزامنة
يتم استخدام intent action.devices.SYNC
لطلب قائمة بالأجهزة التي اتصل بها المستخدم والمتاحة للاستخدام.
smart home
عندما يقوم مستخدم بإعداد أجهزته باستخدام Google Home app (GHA)، تتم أيضًا مصادقته على البنية الأساسية للسحابة الإلكترونية. بعد ذلك،
يتلقّى Assistant رمز OAuth2 المميز. في هذه المرحلة،
يرسل Assistant هدف action.devices.SYNC
إلى التنفيذ من أجل استرداد القائمة الأولية لأجهزة المستخدمين وإمكاناتهم من البنية الأساسية للسحابة الإلكترونية.
لتجنُّب إلغاء ربط حساب مستخدم وإعادة ربطه، يمكنك إرسال طلب مزامنة
إلى "Assistant". يؤدي هذا الإجراء إلى إرسال هدف action.devices.SYNC
إلى عملية التنفيذ لمزامنة قائمة الأجهزة والإمكانات. يمكنك الاطّلاع على تنفيذ طلب مزامنة للحصول على مزيد من المعلومات.
أثناء عملية إعداد تنفيذ الطلبات على المستوى المحلي،
تتحقّق منصة الصفحة الرئيسية المحلية من استجابة SYNC
من عملية التنفيذ على السحابة الإلكترونية في
smart home Action. لمزيد من المعلومات حول كيفية تعديل استجابة 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
، يجب عدم الإبلاغ عن حالة أجهزة هذا المستخدم.