Stick

跨平台异步游戏手柄、摇杆和飞行杆库

Stick支持从各种游戏手柄、摇杆、飞行杆和其他控制器获取控制器输入。Stick还支持左右震动触觉效果。

为什么Stick存在？

主要原因是我从2017年开始 Stick 的时候还没有听说过 gilrs，当时 gilrs 只有1年历史，总下载量不到500。现在，我认为即使有 gilrs，stick 也存在许多其他原因。

• 针对游戏手柄、摇杆等执行器无关的 async/.await (我建议使用 pasts crate 来实现简单的单线程执行器)。
• 低级别热插拔支持（您分配游戏手柄ID）
• 有意义的命名事件（使用 ActionA 和 ActionB 而不是 South 和 East）
• 最小依赖
• 双许可使用Boost许可证（在二进制UI中无需归功于许可） - 使得它非常适合游戏开发。
• 非游戏特定，不依赖于“标准游戏手柄”模型（由于存在各种控制器，这不起作用） - 因此也可以用于机器人、控制中心、高级飞行模拟等。
• 支持比 gilrs 更多的游戏手柄/摇杆类型，并且（WIP）跨平台统一支持。

平台支持

• Linux
• Windows

计划支持的平台

• MacOS
• BSD
• Redox
• Fuchsia
• Android
• iOS
• Web Assembly
• Nintendo Switch（和其他游戏机）
• 其他

目录

• 入门指南
  • 示例
  • API
  • 功能
• 升级
• 许可证
  • 贡献

API

API 文档可在 docs.rs 上找到。

功能

您可以启用以下功能

• sdb：默认启用，Stick 数据库控制器重映射
• gcdb：SDL 游戏控制器数据库重映射

升级

您可以使用 变更日志 来帮助升级此 crate 作为依赖项。

许可证

许可方式为以下之一

• Apache License, Version 2.0, (LICENSE_APACHE_2_0.txt 或 https://www.apache.org/licenses/LICENSE_2.0)
• MIT License, (LICENSE_MIT.txt 或 https://mit-license.org/)
• Boost Software License, Version 1.0, (LICENSE_BOOST_1_0.txt 或 https://boost.ac.cn/LICENSE_1_0.txt)

任选其一。

贡献

除非您明确声明，否则您提交给作品并有意包含在内的任何贡献，如 Apache-2.0 许可证所定义，应按上述方式许可，不附加任何额外条款或条件。

帮助

如果您想使用或贡献这个库，欢迎发送电子邮件至 [email protected]。