μSwitch

μSwitch 是一个跨平台应用程序，它允许音乐家使用开关来演奏声音。它旨在帮助残疾人练习演奏音乐并在音乐会上表演。

开关界面设备将游戏手柄、键盘或鼠标信号发送到个人电脑。例如，可以将开关界面配置为在按下开关时向电脑发送特定的游戏手柄按钮。μSwitch 将根据这些信号播放声音。

这类开关界面设备的例子之一是 Xbox Adaptive Controller。它通过 USB 或蓝牙连接到电脑。可以通过将开关插入其中一个 3.5 毫米插孔来将开关分配给游戏手柄按钮。

μSwitch 可以配置为在按下特定的游戏手柄按钮、键盘键或 GUI 上的按钮时播放特定的或随机的 flac、mp3、ogg 或 PCM wav 文件。

用例

此应用程序的一个重要用例是能够轻松将其发送给某人，并完全预配置。例如，在 My Breath My Music 基金会，我们为残疾人提供一项借用计划。在此借用计划中，我们试图确定某人需要什么样的硬件，然后将它邮寄给他们。μSwitch 应用程序也发送给他们，预配置到他们特定的硬件集。

μSwitch 使用 Rust 编写，这使得它很容易为不同的平台（例如 Windows、macOS、Linux）创建原生应用程序。用户无需首先安装运行时或共享库。必须在与二进制可执行文件相同的文件系统目录中放置一个配置文件。此配置文件指定在按下按钮或开关后播放哪个声音。

最终用户只需连接他的开关界面并打开程序。他们就可以立即开始演奏。

入门

在您的电脑上运行此应用程序有三种方法

1. 下载发布版

您可以从发布页面下载包含启动所需所有内容的zip文件。只需找到最新版本，然后下载适用于您平台的zip文件。这些zip文件还包含示例配置和声音。只需解压所有文件，然后启动二进制文件。

2. 使用cargo安装

此应用程序还发布在crates.io上。您可以使用cargo命令自动从crates.io构建和安装二进制文件。

首先，安装rust。然后，您可以在命令行终端运行cargo install microswitch来安装此应用程序。

μSwitch需要配置文件才能运行。在示例目录中您可以找到示例配置文件和CC0声音。

要开始使用此应用程序，请在终端中运行：microswitch path/to/config.yaml。

3. 自己构建

首先，安装rust。

其次，克隆此项目

git clone https://github.com/Joris-van-der-Wel/microswitch.git

第三步，通过运行以下命令构建可执行二进制文件：

cd microswitch
cargo build --bins --release

二进制文件将在target/release/microswitch或target\release\microswitch.exe中找到。

μSwitch需要配置文件才能运行。此文件的路径可以在命令行中指定。

例如（Linux/macOS）

./target/release/microswitch example/config.yaml

在Windows上这将是

.\target\release\microswitch.exe example\config.yaml

如果没有指定此路径，它将在可执行文件相同的目录中查找config/config.yaml。

声音样本的指定路径相对于配置文件所在的目录。