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

أهداف المنزل المزوّد بأجهزة ذكية هي عناصر مراسلة بسيطة تصف عملية دمج Cloud-to-cloud التي يجب تنفيذها، مثل تشغيل ضوء أو بث الصوت إلى مكبّر صوت.

يتم تضمين جميع الأهداف 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 لإعداد الشريك وWebView لبروتوكول OAuth والإعدادات والبنود الاختيارية وخدمات السحابة الإلكترونية الخاصة بالشريك. بعد ذلك، تُعيد البنية الأساسية للشريك بيانات اعتماد OAuth إلى تطبيق عميل "مساعد Google". تُرسل خدمات السحابة الإلكترونية للشريك الأجهزة والإمكانات المتاحة إلى خدمات "مساعد Google"، والتي تخزّن المعلومات بعد ذلك في Home Graph.
الشكل 1: التفاعل بين البنية الأساسية لـ Google والبنية الأساسية للشريك

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

مخطّط بياني لتدفّق طلب SYNC
الشكل 2: نية SYNC

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

QUERY

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

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

مخطّط بياني لتدفّق نية QUERY
الشكل 3: نية QUERY

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

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

EXECUTE

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

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

مخطّط بياني لتدفّق نية EXECUTE
الشكل 5: نية EXECUTE

قطع الاتصال

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

السابق
أنواع الأجهزة والسمات
التالي
توصيل الطلبات