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

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