DSBox SDK 下载与接入文档

面向 DSBox 硬件的 Python SDK,支持鼠标移动、左右中键、滚轮、X1/X2 侧键透传等操作。当前页面提供 Windows x64 / Python 3.12 版本下载和可直接运行的演示代码。

SDK 下载

下载 wheel 文件后,在 Python 3.12 环境中安装。

安装命令

推荐在虚拟环境中安装,避免污染系统 Python。

py -3.12 -m venv .venv
.\.venv\Scripts\activate
python -m pip install dsbox_sdk-0.1.1-cp312-cp312-win_amd64.whl

调用示例

连接硬件后完成移动、点击、滚轮和侧键透传。

from dsbox import DSBox
import time

box = DSBox.connect()

try:
    box.move(100, 0)       # 向右移动
    time.sleep(0.2)

    box.click("left")      # 左键
    box.click("right")     # 右键
    box.click("middle")    # 中键

    box.wheel(3)           # 滚轮向上
    box.wheel(-3)          # 滚轮向下

    box.click("x1")        # 侧键 X1 / back
    box.click("x2")        # 侧键 X2 / forward
finally:
    box.stop()
    box.close()

示例演示

运行演示脚本前,请把鼠标移动到安全空白区域。

连接设备
调用 DSBox.connect()
移动指针
执行小范围 move
鼠标点击
左键、右键、中键
滚轮动作
wheel 正负方向
侧键透传
x1 / x2 输出
python dsbox_quick_demo.py

用户协议

下载或使用 SDK 即表示用户理解并接受以下条款。

合法使用。用户应在合法、合规、获得授权的环境中使用 DSBox SDK 与硬件,不得用于破坏系统、规避平台规则、侵犯他人权益或违反当地法律法规的行为。

风险提示。SDK 可以控制鼠标移动、点击、滚轮和侧键输出。运行示例前应关闭重要窗口并将指针移动到安全区域,因误操作造成的损失由用户自行承担。

兼容性。当前下载包适用于 Windows x64 与 Python 3.12。不同系统、Python 版本或硬件固件可能需要对应版本的 SDK。

更新与维护。网站可能不定期更新 SDK、文档和示例。用户应优先使用最新稳定版本,并在升级前确认项目依赖。

免责声明。除明确书面承诺外,本 SDK 按现状提供。因用户环境、第三方软件、操作系统策略或错误使用导致的问题,发布方不承担超出法律规定范围的责任。

联系我们。如需商务授权、技术支持或问题反馈,请通过购买渠道或官方客服入口联系。