Cấu trúc component

Về cơ bản, một component là một đối tượng JSON chứa các hàm export thông thường mà một plugin sẽ có, như tên, kích thước, số lượng LED, v.v.

Thư mục

Các tệp này được tải từ một trong hai thư mục. Các tệp tích hợp sẵn nằm ở:

C:\Users\[TÊN NGƯỜI DÙNG]\AppData\Local\VortxEngine\app-[PHIÊN BẢN HIỆN TẠI]\Signal-x64\Components

Và các tệp tùy chỉnh nên được lưu trong thư mục người dùng. Theo mặc định nằm trong Documents:

C:\Users\[TÊN NGƯỜI DÙNG]\Documents\WhirlwindFX\Components

Các tệp được lưu trong AppData bị ghi đè ở mỗi lần cập nhật, trong khi các tệp trong thư mục Documents của người dùng tồn tại giữa các phiên bản. Các tệp được lưu ở đó cũng ghi đè bất kỳ tệp nào trong thư mục AppData với tên sản phẩm tương ứng. Các component tùy chỉnh này xuất hiện giống hệt như component tích hợp sẵn, với các bộ lọc thương hiệu và loại được tạo tự động.

Cấu trúc JSON

Dưới đây là ví dụ về bộ nâng cấp ghế “Vertagear”, được biểu diễn dưới dạng component với tất cả các thuộc tính bắt buộc.

Lưu ý: Các lỗi và cảnh báo phổ biến khi tải các tệp này được in trong debug logs.

{
    "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": ""
}

Tham số	Mô tả	Kiểu	Ví dụ
ProductName	Tên sản phẩm được sử dụng để lưu trữ bền vững làm tên component	String	Corsair LL Fan
Brand	Chuỗi đại diện cho thương hiệu component để lọc	String	Corsair
Type	Chuỗi đại diện cho loại component để lọc	String	Fan
LedCount	Số nguyên đại diện cho tổng số LED của component	Int	16
Width	Số nguyên đại diện cho chiều rộng của bộ đệm pixel component	Int	5
Height	Số nguyên đại diện cho chiều cao của bộ đệm pixel component	Int	5
LedMapping	Mảng chứa thứ tự mà thông tin màu LED được trả về	1D Array	[0,1,2]
LedCoordinates	Mảng chứa vị trí [X,Y] của tất cả các LED	2D Array	[[0,0],[0,1]]
LedNames	Mảng chứa tên của mỗi LED	1D Array	[“Led 1”,“Led 2”]
ImageUrl	Chuỗi URL hình ảnh được sử dụng làm xem trước component	String