ما هي المكوّنات؟
تُشغّل وحدات التحكم في RGB — مثل موزّعات المراوح ومنافذ ARGB ووحدات التحكم في شرائط LED — مخارجها كسلسلة بسيطة من مصابيح LED بالترتيب. لا تعرف وحدة التحكم ما هو المتصل بها فعليًا ولا تهتم بذلك؛ فهي ترسل الألوان عبر السلك مصباحًا تلو الآخر.
المشكلة أن المنتجات المختلفة ترتّب هذه المصابيح بطرق مختلفة جدًا. فالمروحة ذات 16 مصباح LED تضعها في دائرة، والشريط ذو 30 مصباح LED يضعها في خط مستقيم، وقد تحتوي المروحة ثنائية الحلقة على حلقة داخلية من 8 مصابيح وحلقة خارجية من 16. إذا كنت تريد أن تكون هذه المصابيح في المكان الصحيح على لوحة SignalRGB — بحيث تتوافق تأثيرات الإضاءة بشكل صحيح عبر نظامك بالكامل — فأنت بحاجة إلى معرفة الشكل، وليس العدد فقط.
المكوّنات تحل هذه المشكلة. المكوّن هو وصف بصيغة JSON لمنتج RGB محدد: عدد مصابيح LED فيه، وموضع كل منها في الفضاء ثنائي الأبعاد، واسم كل منها. يستخدم SignalRGB هذا الوصف لربط ألوان اللوحة بشكل صحيح بالموضع المناسب في سلسلة LED، بغض النظر عن وحدة التحكم التي تشغّلها.
مكتبة المكوّنات
Section titled “مكتبة المكوّنات”يأتي SignalRGB مع مكتبة مدمجة كبيرة من المكوّنات تغطي المراوح والشرائط ورؤوس المضخات وملحقات RGB الأخرى من مجموعة واسعة من الشركات المصنّعة. كما أن المكتبة مفتوحة لمساهمات المجتمع — فإذا لم يكن منتج ما مدعومًا بعد، يمكنك إنشاء ملف JSON لمكوّنه وإرساله.
راجع بنية المكوّن للاطلاع على صيغة JSON.
كيفية استخدام المكوّنات
Section titled “كيفية استخدام المكوّنات”يعيّن المستخدم المكوّنات للقنوات على جهاز وحدة التحكم الخاص به من خلال واجهة اختيار في SignalRGB. على سبيل المثال، قد يُهيّئ مستخدم لديه ثلاث مراوح Corsair LL120 متصلة بـ Corsair Lighting Node Pro ما يلي:
- القناة 1 ← Corsair LL120 · Corsair LL120 · Corsair LL120
يرصّ SignalRGB المكوّنات بالترتيب على طول سلسلة LED الخاصة بالقناة، ويضع كل منها على اللوحة وفقًا لإحداثيات مصابيح LED الخاصة به. يمكن للمستخدم ترتيبها كما يشاء — ثلاث مراوح في صف، أو على شكل حرف L، أو أينما كانت موجودة فعليًا في صندوق الحاسوب.
لا تحتاج الإضافة إلى معرفة المنتجات المتصلة. فهي ببساطة تستدعي device.channel("Channel 1").getColors() وتحصل على بيانات الألوان المربوطة بشكل صحيح وفقًا لما هيّأه المستخدم. ويظل هذا التجريد صالحًا سواء كانت على تلك القناة مروحة ذات 16 مصباح LED أو شريط ذو 30 مصباحًا.
لماذا يهم هذا مطوّري الإضافات
Section titled “لماذا يهم هذا مطوّري الإضافات”إذا كنت تكتب إضافة لوحدة تحكم في الإضاءة (جهاز يحتوي على قناة إخراج واحدة أو أكثر تشغّل سلاسل LED عامة)، فلن تحتاج إلى بناء خرائط LED خاصة بكل منتج داخل إضافتك. أنت تحدد القنوات، ويتولى نظام المكوّنات الباقي.
وهذا يعني:
- تعمل إضافتك مع أي منتج في مكتبة المكوّنات تلقائيًا
- يمكن للمستخدمين المزج بين منتجات مختلفة على وحدة التحكم نفسها
- يمكن دعم منتجات جديدة بمجرد إضافة ملف JSON للمكوّن — دون الحاجة إلى أي تغييرات في الإضافة
راجع استخدام المكوّنات للاطلاع على واجهة البرمجة الخاصة بالإضافة، وبنية المكوّن لمعرفة كيفية إنشاء ملف مكوّن.