تنبيه: سيتم طرح برامج معاينة المطوّرين الجديدة قريبًا. يمكنك تقديم طلب من هنا كُن من أوائل الأشخاص الذين يجرّبون الأدوات الجديدة ويقدّمون الملاحظات.

بدء استخدام Matter

  إصدار معاينة مطوّر البرامج  

يسمح برنامج مطوّري البرامج في 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 حاليًا.

المتطلبات الأساسية

إضافات IDE المقترحة لتطوير Matter

لدمج جهاز متوافق مع Matter بالكامل مع منظومة Google Home المتكاملة، يجب أن يستوفي مطوّر البرامج ما يلي:

  1. مركز تحكُّم Google متوافق مع سلاسل المحادثات ليعمل كجهاز توجيه الحدود مع الأجهزة المزوّدة بسلسلة محادثات كمسار محلي لتنفيذ توجيهات المنزل الذكي.
  2. جهاز جوّال (هاتف اختباري) يستوفي الحدّ الأدنى من المتطلبات:
    • Android O (الإصدار 8.1، مستوى واجهة برمجة التطبيقات 27 أو إصدار أحدث)
    • iOS (الإصدار 16.5 أو إصدار أحدث)
    • إمكانات BLE
  3. معرّف المورّد (VID) ومعرّف المنتج (PID) للجهاز Matter الذي تم تفعيله.
  4. جهاز متوافق مع نظام التشغيل Matter ويجب أن يكون هذا الجهاز أحد أنواع أجهزة Matter المتوافقة حاليًا مع منظومة Google Home المتكاملة، ويمكن أن يكون:
    • منتجك مع برامج ثابتة مُفعّلة Matter
    • لوحة التطوير لمنصة مورّدين معتمَدة يمكن استخدامها كجهاز 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.
الجدول: معرّف المورّد (VID) وسيناريوهات إقران نوع الجهاز
ما هي أنواع المستخدمين الذين يمكنهم استخدام الجهاز في منظومة 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 للمستخدمين بعد، ولكن قد يستخدمها النظام. ويعني ذلك في معظم الحالات أنّ السمات التي يتم عرضها عبر هذه المجموعات لن تكون مرئية للمستخدمين:

جدول: Matter المجموعات التي لا تظهر للمستخدمين في منظومة Google Home المتكاملة
نوع المجموعة المجموعات
Core
  • ربط 1
  • التصنيف
  • تصنيف ثابت
  • تصنيف المستخدم
  • الإجراءات
  • مفتاح المجموعة
  • إعدادات الأقلمة
  • أقلمة تنسيق الوقت
  • أقلمة الوحدة
  • إعداد مصدر الطاقة
  • مصدر الطاقة
  • مجموعات بيانات التشخيص (سجلات بيانات التشخيص، بيانات التشخيص العامة، بيانات تشخيص البرامج، بيانات تشخيص شبكة سلاسل المحادثات/بيانات تشخيص شبكة Wi-Fi وبيانات تشخيص شبكة إيثرنت)
  • مزامنة الوقت
  • اختيار الوضع
طلب الانضمام
  • المجموعات والمَشاهد غير متاحة مباشرةً. وتتوفّر وظائف مماثلة من خلال سلاسل الإجراءات.
  • جميع مجموعات الوسائط. تتوفّر ميزة مكافئة من خلال Google Cast.

1 يُرجى الاطّلاع على مفاتيح التحكّم بالإضاءة/الإيقاف لمعرفة كيفية تأثير هذه الميزة على مفاتيح التشغيل والإيقاف.