إصدار معاينة مطوّر البرامج
يسمح برنامج مطوّري البرامج في Google Home للشركات المصنّعة للأجهزة بربط أجهزتهم المنزلية الذكية بالمنظومة المتكاملة من Google Home. نعمل على توسيع مسار تنفيذ الإجراءات المنزلية الذكية مع إمكانية إضافة أجهزة تم تفعيل Matter إليها للإعداد باستخدام Google Home app (GHA) والتحكّم فيها باستخدام Google Assistant أو GHA أو الشاشات الذكية، مثل Google Nest Hub (2nd gen).
يوضّح هذا المستند طريقة البدء في إنشاء منصّة متوافقة مع Matter ودمجها في منظومة Google Home المتكاملة.
بنود إخلاء المسؤولية
في ما يتعلق بالإجراءات الموضّحة في معاينة مطوّري البرامج هذه لتطبيق Matter، يُرجى الانتباه إلى ما يلي:
- يجب أن يتضمّن الحساب المستخدَم للتطوير مركزًا واحدًا تم تفعيل Matter فيه للاختبار. يمكن أن يؤدي ربط عدة مراكز (Matter) تم تفعيلها في الوقت نفسه أو ربطها بالبنية نفسها أثناء الاختبار إلى سلوك غير متوقّع.
- تفترض كل الإجراءات استخدام جهاز يعمل بنظام التشغيل Linux يشغّل Ubuntu 20.04 لإنشاء نماذج Matter ووميضها، والتي اختبرتها Google. على الرغم من توافق أجهزة MacOS، ننصح باستخدام نظام التشغيل Linux. ويتم ذكر التعليمات الخاصة بنظام التشغيل Mac في الإجراءات عند الحاجة.
التعريفات
يتم استخدام المصطلحات التالية في جميع هذه المستندات:
- جهاز توجيه الحدود
- مركز يُنفِّذ جهاز توجيه الحدود Threadلأغراض عامة على الأجهزة التي تم تفعيل Thread عليها
- المحتوى الرئيسي
- جهاز Google Nest متوافق، مثل Google Nest Hub (2nd gen). يجب توفّر وحدة تحكّم للتحكّم في الأجهزة التي يتم تفعيل Matter عليها من خلال مساحات العرض الأخرى، مثل Assistant وGHA والشاشات الذكية.
- جهاز متوافق مع Matter
- جهاز أو لوح تطوير يحتوي على إصدار Matter متوافق مع نموذج أو تطبيق متوافق.
- الأجهزة الجوّالة
- الهاتف التجريبي المستخدَم للمساعدة في الإقران هذا الهاتف هو Android حاليًا.
المتطلبات الأساسية
لدمج جهاز متوافق مع Matter بالكامل مع منظومة Google Home المتكاملة، يجب أن يستوفي مطوّر البرامج ما يلي:
- مركز تحكُّم Google متوافق مع سلاسل المحادثات ليعمل كجهاز توجيه الحدود مع الأجهزة المزوّدة بسلسلة محادثات كمسار محلي لتنفيذ توجيهات المنزل الذكي.
- جهاز جوّال (هاتف اختباري) يستوفي الحدّ الأدنى من المتطلبات:
- Android O (الإصدار 8.1، مستوى واجهة برمجة التطبيقات 27 أو إصدار أحدث)
- iOS (الإصدار 16.5 أو إصدار أحدث)
- إمكانات BLE
- معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز Matter الذي تم تفعيله.
- جهاز متوافق مع نظام التشغيل Matter ويجب أن يكون هذا الجهاز أحد
أنواع أجهزة Matter المتوافقة حاليًا مع
منظومة Google Home المتكاملة، ويمكن أن يكون:
- منتجك مع برامج ثابتة مُفعّلة Matter
- لوحة التطوير لمنصة مورّدين معتمَدة يمكن استخدامها كجهاز Matter معتمَد بشكل شامل. تتوفّر المنصّات التالية:
المورّد | النظام الأساسي | الأدلة | دعم بقيمة Thread |
---|---|---|---|
مختبر بوفالو | BL602 | لمحة سريعة للبدء | |
BL702 | لمحة سريعة للبدء | ||
إسبريف | منصة ESP32 | لمحة سريعة للبدء
اختبار العبر الهواء |
|
شبه عواصف نوردية | nRF52840 الدانمرك | لمحة سريعة للبدء
اختبار العبر الهواء |
|
NCP | مجموعة تطوير IOTZTB-DK006 | لمحة سريعة للبدء | |
Realtek | سلسلة أميبا دي | لمحة سريعة للبدء | |
ميزات السيليكون الاختبارية | مجموعة أدوات EF32MG24 Dev | لمحة سريعة للبدء | |
مجموعة EFR32MG Zigbee وThread Starter | لمحة سريعة للبدء | ||
تيك لينك | TLSR9518 | لمحة سريعة للبدء | |
آلات تكساس | مجموعة تطوير CC2652R7 LaunchPad | لمحة سريعة للبدء |
معرّف المورّد
يمكنك استخدام أحد معرّفات VID التي خصّصتها CSA لأغراض الاختبار بشكل تلقائي. اختَر إحدى الطرق التالية:
0xFFF1
أو 0xFFF2
أو 0xFFF3
أو 0xFFF4
.
لاستخدام معرّف المورّد (VID) للإنتاج بحيث يكون معتمدًا ودمجًا، يجب أولاً أن تتحقّق Google منه من أجل ضمان حصول محرّك البحث Google على هذا الرقم.
يجب تنفيذ معرِّف VID هذا في البرامج الثابتة على جهازك.
يمكن إقران جهاز Matter فقط بالمنظومة المتكاملة لخدمة Google Home في حالات معيّنة من معرّف المورّد ونوع الجهاز.
- لا يمكن استخدام معرِّف المورِّد (VID) التجريبي على جهاز مستهلك.
- يجب أن يكون CID للإنتاج صادرًا عن وكالة CSA. ستتأكّد Google من أنّك مالك معرّف المورّد هذا (VID) قبل أن تتمكّن من استخدامه في Google Home Developer Console. وبعد حدوث ذلك، ستتمكّن من إنشاء عمليات دمج لمعرّف الفيديو هذا (VID).
- لأغراض التطوير والتجربة الميدانية، يجب إنشاء مشروع في "Developer Console" مع دمج معرِّف المورِّد (VID) ومعرِّف المنتج (PID) المقابلين له. يجب أن يكون المستخدم الذي ي عبارة عن تشغيل الجهاز عضوًا في المشروع أو مدرجًا في قائمة مستخدمي التجربة الميدانية.
- لا يمكن للمستخدمين المستهلكين استخدام منتجك إلا بعد اعتماده من جانب CSA.
ما هي أنواع المستخدمين الذين يمكنهم استخدام الجهاز في منظومة Google Home المتكاملة؟ | |||
---|---|---|---|
نوع معرِّف المورّد (VID) | شهادة VID وحالة دمج وحدة التحكّم | الإنتاج
(المستخدمون المستهلكون) |
التطوير
(مطوّرو البرامج والمستخدمون في المرحلة التجريبية) |
Test | ما مِن دمج في Developer Console (لا يمكن الاعتماد) | ||
Test | الدمج مضبوط على Developer Console (لا يمكن اعتماده) | ||
الإنتاج | غير معتمد، الدمج غير موجود في Developer Console | ||
الإنتاج | غير معتمد، الدمج موجود في Developer Console | ||
الإنتاج | معتمد في CSA DCL، وليس هناك دمج في Developer Console | ||
الإنتاج | تم اعتماد الشهادة في CSA DCL ودمجها في Developer Console |
معرّف المنتج
تتم قراءة المعلومات الخاصة بالجهاز من "مجموعة المعلومات الأساسية" Matter. يجب أن يتطابق معرّف المنتج المشفّر في البرامج الثابتة على جهازك مع معرّف المنتج لدمج Matter في Play Console.
الميزات غير المتوافقة
لم تظهر بعض مجموعات Matter للمستخدمين بعد، ولكن قد يستخدمها النظام. ويعني ذلك في معظم الحالات أنّ السمات التي يتم عرضها عبر هذه المجموعات لن تكون مرئية للمستخدمين:
نوع المجموعة | المجموعات |
---|---|
Core |
|
طلب الانضمام |
|
1 يُرجى الاطّلاع على مفاتيح التحكّم بالإضاءة/الإيقاف لمعرفة كيفية تأثير هذه الميزة على مفاتيح التشغيل والإيقاف.