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

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

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

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

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

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