علامات التصدير الاختيارية
DeviceMessage()
Section titled “DeviceMessage()”تُستخدم علامة التصدير هذه لعرض رسالة في SignalRGB على صفحة الجهاز المرتبط. يمكنك استخدامها لعرض أي خصائص غريبة للجهاز أو أي وصف يحتاج إليه المستخدم.
القيمة المُرجعة هي مصفوفة أحادية البعد مكوّنة من سلسلتين نصيتين: النص المراد عرضه في النافذة المنبثقة، يليه تلميح التمرير.
export function DeviceMessage() { return ["This device has a weird quirk!", "The quirk is this!"]; }SupportsSubdevices()
Section titled “SupportsSubdevices()”تُستخدم علامة التصدير هذه لوحدات التحكم في الإضاءة التي تدعم الأجهزة الفرعية فقط ولا تحتوي على مصابيح LED مدمجة للتحكم فيها. عندما تُرجع true، يمنع هذا التصدير ظهور الجهاز الأصلي فوق اللوحة في التخطيطات، ويعطّل تعديل إعدادات موضعه.
export function SupportsSubdevices(){ return true; }on*Changed()
Section titled “on*Changed()”لا تستخدم الواجهة الخلفية دالة التصدير هذه، بل تُستخدم كاستدعاء داخل الإضافة للإشعار عند تغيير أحد الإعدادات. سترى أدناه مثالًا على استخدامها لضبط قيمة DPI للماوس في كل مرة يغيّر فيها المستخدم المنزلق، بدلًا من استطلاع القيم في حلقة العرض والتعامل مع التغيير هناك.
تُستدعى هذه الاستدعاءات بعد جلب بيانات RGB من اللوحة، ولكن قبل استدعاء دالة العرض لإطار العرض الحالي.
// Setting Exportexport function ControllableParameters(){ return [{ property: "dpi1", label: "DPI", step: "50", type: "number", min: "200", max: "18000", default: "800" }, ];}
// DPI Functionsexport function ondpi1Changed() { setDpi(dpi1);}
function setDpi(dpi) { if (!SettingControl) { return; } device.log(`Setting Dpi to ${dpi}`); Corsair_Set(CORSAIR_DPI_X, dpi); Corsair_Set(CORSAIR_DPI_Y, dpi);
device.log(`DPI x is now ${Corsair_Get(CORSAIR_DPI_X)}`); device.log(`DPI y is now ${Corsair_Get(CORSAIR_DPI_Y)}`);}