C# SDK
SDK 实现(Implementation)
开发自己的程序时,需要引用以下 DLL 文件。
1. AmfiProt_Amfitrack.dll
作用:
AMFITRACK 专用的数据包处理库(Package Handler)。
主要负责:
AMFITRACK 数据协议解析
Sensor 数据处理
Source 数据处理
这是开发 AMFITRACK 应用的核心 DLL。
2. lib_AmfiProt_SW.dll
作用:
AmfiProt 协议处理库。
主要负责:
设备配置(Configuration)
设备名称(Device Name)
参数管理
即:
所有配置相关的数据都由该 DLL 负责。
3. lib_Connections.dll
作用:
负责:
设备连接(Connect)
设备断开(Disconnect)
数据传输(Transmit)
不过:
这些功能已经由 SDK 自动管理。
开发者无需直接调用其中的函数。
4. lib_Connections_Win.dll
作用:
Windows 平台 USB 通信库。
负责:
Windows USB 连接
USB 数据传输
同样:
SDK 已自动调用。
开发者无需自行处理。
5. hidapi32.dll
USB HID 通信库(32 位)。
由 SDK 自动调用。
无需开发者操作。
6. hidapi64.dll
USB HID 通信库(64 位)。
SDK 自动使用。
无需开发者处理。
7. HidApiAdapter.dll
USB HID 接口适配库。
负责:
USB HID 接口封装
与 hidapi 配合工作
同样由 SDK 自动调用。
开发者无需直接使用。
SDK 架构示意
自己开发的程序 (WinForms / WPF / Unity) │ │ 调用 ▼ AmfiProt_Amfitrack.dll │ ▼ lib_AmfiProt_SW.dll │ ▼ lib_Connections.dll │ ▼ lib_Connections_Win.dll │ ▼ hidapi64.dll / hidapi32.dll │ ▼ USB HID 通信 │ ▼ EMF Source / EMF Sensor
开发流程
通常开发一个基于 C# 的 AMFITRACK 应用可按以下步骤进行:
下载并解压 C# SDK。
在 Visual Studio(或其他 .NET 开发环境)中创建项目,并引用 SDK 提供的 DLL。
初始化 SDK,在
Main()函数中注册 Sensor 和 Source 的回调函数。连接 AMFITRACK 设备,SDK 会自动完成 USB 通信和设备管理。
在回调函数中接收并解析实时数据,例如:
传感器位置(Position)
姿态(Orientation)
IMU 数据
Source 状态信息(电流、频率等)
根据应用需求,将数据用于界面显示、Unity 场景控制、机器人控制或其他业务逻辑。