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 应用可按以下步骤进行:

  1. 下载并解压 C# SDK。

  2. 在 Visual Studio(或其他 .NET 开发环境)中创建项目,并引用 SDK 提供的 DLL。

  3. 初始化 SDK,在 Main() 函数中注册 Sensor 和 Source 的回调函数。

  4. 连接 AMFITRACK 设备,SDK 会自动完成 USB 通信和设备管理。

  5. 在回调函数中接收并解析实时数据,例如:

    • 传感器位置(Position)

    • 姿态(Orientation)

    • IMU 数据

    • Source 状态信息(电流、频率等)

  6. 根据应用需求,将数据用于界面显示、Unity 场景控制、机器人控制或其他业务逻辑。