组件结构

组件的核心是一个 JSON 对象，包含插件通常具有的普通函数导出，如名称、尺寸、LED 数量等。

存储在 AppData 中的文件在每次更新时都会被覆盖，而存储在用户文档目录中的文件将在版本之间持久保存。存储在那里的文件还会覆盖 AppData 目录中具有匹配产品名称的任何内容。这些自定义用户组件的显示效果与内置组件一样，并带有自动生成的品牌和类型过滤器。

JSON 结构

以下是将”Vertagear”椅子升级套件表示为具有所有必要属性的组件的示例。

注意：加载这些文件时的常见错误和警告将打印到调试日志中。

{
    "ProductName": "VertaGear PL4500 RGB Top Kit (Chair Back)",
    "DisplayName": "VertaGear PL4500 RGB Top Kit (Chair Back) - 5 Zone",
    "Brand" : "Vertagear",
    "Type" : "Chair",
    "LedCount" : 5,
    "Width": 5,
    "Height": 5,
    "LedMapping" : [
        0,1,2,3,4
        ],
    "LedCoordinates" : [
        [0,0], [0,1], [1,0], [2,0], [2,1]
    ],
    "LedNames" : [
        "Back Side - Top","Back Side - Bottom","Center Acrylic","Front Side - Top", "Front Side - Bottom"
    ],
    "ImageUrl": ""
}

参数	描述	类型	示例
ProductName	用于持久化存储为组件名称的 ProductName	String	Corsair LL Fan
Brand	表示组件品牌（用于过滤）的字符串	String	Corsair
Type	表示组件类型（用于过滤）的字符串	String	Fan
LedCount	表示组件 LED 总数的整数	Int	16
Width	表示组件像素缓冲区宽度的整数	Int	5
Height	表示组件像素缓冲区高度的整数	Int	5
LedMapping	包含 LED 颜色信息应按什么顺序返回的数组	1D Array	[0,1,2]
LedCoordinates	包含所有 LED 的 [X,Y] 位置的数组	2D Array	[[0,0],[0,1]]
LedNames	包含每个 LED 名称的数组	1D Array	[“Led 1”,“Led 2”]
ImageUrl	用作组件缩略图的 URL 图像字符串	String