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

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

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

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

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

مخطط انسيابي لنية المزامنة
الشكل 2: نية المزامنة

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

QUERY

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

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

مخطط انسيابي لهدف QUERY
الشكل 3: هدف طلب البحث

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

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

نفاد

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

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

مخطط انسيابي لهدف EXECUTE
الشكل 5: نية الحذف

قطع الاتصال

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