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