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

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

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

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

مخطط انسيابي لهدف SYNC
الشكل 2: نية المزامنة

أثناء عملية إعداد تنفيذ الطلبات على المستوى المحلي، تتحقّق منصة الصفحة الرئيسية المحلية من استجابة SYNC من عملية التنفيذ على السحابة الإلكترونية في smart home Action. لمزيد من المعلومات حول كيفية تعديل استجابة 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، أريد تشغيل المصابيح في غرفة المعيشة.

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

قطع الاتصال

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

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