توفّر واجهات Google Home APIs لنظام التشغيل Android مساحة موحّدة لواجهات برمجة التطبيقات تتيح للمطوّرين التفاعل مع حالة العناصر في منزل المستخدم. يمكن أن تصف هذه الكيانات الأجهزة والمعلومات غير المتعلّقة بالأجهزة والمرتبطة ببنية المستخدم وغرفه.
تحدّد واجهات برمجة التطبيقات الخاصة بمنصة Home الكيانات التالية التي يمكن للمستخدم التفاعل معها:
- تمثّل البُنى منزلاً يحتوي على غرف وأجهزة.
- الغرف هي جزء من بنية وتحتوي على أجهزة.
- تنفّذ الأجهزة سمات تحتوي على خصائص، وتتوافق مع أنواع، وتصدر أحداثًا، وتستجيب للأوامر.
- عمليات التشغيل الآلي هي جزء من بنية وتستخدم البيانات الوصفية الخاصة بالمنزل والأجهزة لتنفيذ المهام بشكل آلي في المنزل.
يوضّح الشكل 1 هذه البنية:
قد تكون أنواع الأجهزة المتوافقة مع Home API متوافقة مع Matter، وهو معيار مفتوح للمنزل الذكي، أو قد تكون جهاز Cloud-to-cloud في منظومة Google Home المتكاملة. قد تتضمّن بعض أنواع الأجهزة وظائف من كليهما. لمزيد من المعلومات، يُرجى الاطّلاع على أنواع الأجهزة المتوافقة على Android.
في Matter، يتم تجميع وظائف الجهاز حسب المجموعات، التي يتم تمثيلها في واجهات برمجة تطبيقات Home كسمات Matter عادية. تتيح واجهات برمجة التطبيقات Home استخدام المجموعة العادية من Matter المجموعات المحدّدة في مواصفات Matter الحالية.
في نظام Google Home المتكامل، يتم تجميع وظائف الأجهزة حسب سمات المنزل الذكي، والتي يتم تمثيلها في واجهات برمجة التطبيقات الخاصة بمنصة Home على أنّها سمات Google للمنزل الذكي. تتيح واجهات برمجة التطبيقات الخاصة بالمنزل مجموعة من سمات المنزل الذكي كما هو محدّد في برنامج Cloud-to-cloud.
تتوفّر أيضًا سمات أخرى، مثل المجموعات الخاصة بالمصنّع وسمات المنصة. لمزيد من المعلومات، يُرجى الاطّلاع على نموذج البيانات على Android.
المنظومة المتكاملة
توفّر منظومة Google Home المتكاملة أساسًا مبسطًا لإنشاء تجارب منزلية ذكية وإدارتها وتأمينها ودمجها. يوضّح الشكل 2 طريقة عمل المكوّنات معًا.
يتضمّن النظام المتكامل محرك التشغيل الآلي من Google الذي يخزّن عمليات التشغيل الآلي ويشغّلها، ما يوفّر طريقة لتنفيذ المهام وضبط إعدادات الأجهزة في المنزل بشكل آلي.
تستخدم واجهات برمجة التطبيقات Home بروتوكول OAuth 2.0 لمنح إذن الوصول إلى الأجهزة في البنية. يسمح بروتوكول OAuth للمستخدم بمنح الإذن لتطبيق أو خدمة بدون الحاجة إلى الكشف عن بيانات اعتماد تسجيل الدخول.
يتم استخدام Google Home Developer Console لإدارة جميع مراحل مشروع واجهات برمجة التطبيقات الخاصة بمنصة Home، بدءًا من إثبات ملكية العلامة التجارية، ووصولاً إلى التطوير والاختبار والاعتماد والإطلاق النهائي. فهي تبسّط عملية التطوير وتوفّر أدوات قوية وتتيح التوزيع من خلال منظومة Google Home المتكاملة.
اللغة
تمت كتابة واجهات برمجة التطبيقات Home APIs لنظام Android بلغة Kotlin وتوفّر واجهة Kotlin اصطلاحية تستخدم Flow لإدارة الحالة والاشتراك. ويوفّر ذلك عددًا من المزايا مقارنةً بواجهة برمجة تطبيقات الاشتراك العادية.
ننصحك بالاطّلاع على مستندات Kotlin حول الروتينات المشتركة، والتدفق، وJetpack Compose، إذا لم يسبق لك ذلك:
- تطوير تطبيقات Android باستخدام لغة Kotlin
- تعلم لغة Kotlin لأجهزة Android
- كوروتين في لغة Kotlin على Android قد تكون هذه الدروس العملية مفيدة:
- تدفّقات Kotlin على Android، وتحديدًا StateFlow
- State وJetpack Compose، وتحديدًا الدالة
collectAsStateWithLifecycle()تتولّى هذه الدالة تلقائيًا إدارة الاشتراك في عمليات البث وإلغاء الاشتراك فيها استنادًا إلى ما إذا كانت واجهة المستخدم التي تعرض هذه الحالة معروضة في المقدّمة أم لا. - إذا كنت تعمل باستخدام Automation API، سيكون من المفيد الاطّلاع على أدوات إنشاء Kotlin الآمنة من حيث الأنواع لفهم طريقة عمل Automation DSL.
معرّفات الكيانات
لكل كيان في واجهات برمجة التطبيقات الخاصة بمنصة Home معرّف يمثّل المعرّف الأساسي له. هذا المعرّف هو معرّف فريد وثابت لن يتغير أبدًا طوال مدة توفّر العنصر. يمكن استخدام هذا المعرّف لتخزين العناصر مؤقتًا أو التحقّق من التساوي لأنّ البيانات الوصفية الخاصة بالكيان يمكن أن تتغيّر.
راجِع واجهة HasId لمعرفة العناصر التي تتضمّن معرّفًا.
ربط المصطلحات
يتم ربط الكيانات في واجهات برمجة التطبيقات الخاصة بمنزل ذكي بمفهومَي Matter وCloud-to-cloud على النحو التالي:
| Home APIs | Matter | Cloud-to-cloud |
|---|---|---|
| السمة | المجموعة | السمة |
| السمة | السمة | السمة، الحالة |
| Command | Command | Command |
| الحدث | الحدث | رد المتابعة، الإشعار |