元件結構

元件的核心是一個 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 陣列	[0,1,2]
LedCoordinates	包含所有 LED [X,Y] 位置的陣列	2D 陣列	[[0,0],[0,1]]
LedNames	包含每個 LED 名稱的陣列	1D 陣列	[“Led 1”,“Led 2”]
ImageUrl	用作元件縮圖的 URL 圖片字串	String