مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

يعرض هذا الشكل التفاعل بين بنية Google الأساسية والبنية الأساسية للشريك. تتوفّر في البنية الأساسية لـ Google قائمة بالشركاء المتاحين لتطبيق عميل "مساعد Google" الذي يتدفق إلى البنية الأساسية للشريك لاستكمال مصادقة OAuth. تتم المصادقة على OAuth من جانب الشريك من خلال عرض الويب لإعداد الشريك وعرض الويب OAuth والإعدادات والبنود الاختيارية وخدمات السحابة الإلكترونية للشريك. تعرض البنية الأساسية للشريك بعد ذلك بيانات اعتماد OAuth على تطبيق عميل "مساعد Google". ترسل خدمات السحابة الإلكترونية للشريك الأجهزة والإمكانات المتوفّرة إلى خدمات "مساعد Google" التي تخزّن المعلومات في الرسم البياني الرئيسي.
الشكل 1: التفاعل بين البنية الأساسية لدى Google والشريك

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

رسم بياني انسيابي يوضّح هدف SYNC
الشكل 2: الرغبة في المزامنة

أثناء إعداد ميزة تنفيذ الطلبات محليًا، يتحقّق النظام الأساسي Home Home من استجابة SYNC الواردة من تنفيذ إجراءات smart home على السحابة الإلكترونية. للاطّلاع على مزيد من المعلومات عن كيفية تعديل ردّك على SYNC لدعم عمليات تسليم الطلبات المحلية، يُرجى مراجعة تعديل استجابة SYNC في طريقة توفّر طريقة الدفع.

QUERY

يتم استخدام intent من action.devices.QUERY للاستعلام عن الحالة الحالية لجهازين (smart home).

عندما يُجري المستخدمون طلبات بحث عن حالة الجهاز، للإجابة عن سؤال مثل Ok Google، ما الأضواء التي يتم تشغيلها في المطبخ؟، يرسل Assistant نية action.devices.QUERY للحصول على الطلب.

رسم بياني انسيابي على شكل إحالة من QUERY
الشكل 3: الهدف من طلب البحث

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

الإبلاغ عن حالة الجهاز باستخدام حالة التقرير
الشكل 4: الإبلاغ عن حالة الجهاز

غير مفعّل

يتم استخدام intent من action.devices.EXECUTE لتوفير أوامر لتنفيذها على smart home جهاز.

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

رسم بياني انسيابي على شكل intent في EXECUTE
الشكل 5: الرغبة في الشراء

قطع الاتصال

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