Headset Controls

为 PC 提供 3.5mm 耳机线控支持。

Python >= 3.6

项目目前严重缺乏测试，不同设备、不同耳机很可能有不同表现。

目录

• 介绍
• 安装
• 使用
  • 可选参数
  • 按键
• 注意哦
  • 抓取日志
• 捐赠
• 许可

介绍

TRRS 接口的有线耳机的麦克风与按钮并联，按钮按下时麦克风被短接，安卓设备通过检测电压差可以知道按下的按钮。

多数 PC 设备无法获知电压差，但短接对麦克风两个声道产生的影响有些不同。这里使用 Soundcard Oscilloscope 的 x-y graph 功能对比最近 1s 内两个声道的信号幅度进行演示。为了更明显，我们只检视 0.1 范围内的 x 轴和 y 轴：

这是普通声音在极端情况下的声道对比图：

这是 A 按钮（暂停开始键）的声道对比图：

其他情况的声道对比有兴趣的同志可以自己尝试。本项目正是在不同情况的不同声道对比中找不同，来尝试辨别不同按钮的点击、长按事件。

因此，运行时需要使用麦克风。

安装

以下两种方式都需要联网，会自动安装依赖包 keyboard，numpy 和 sounddevice 。

PyPI

通过 PyPI 安装：

pip install trrsheadset

Clone

或者， 从 这里 下载本仓库的压缩包，解压到一个记得住位置的地方，作为安装文件夹。

在安装文件夹中运行：

pip install .

使用

插入耳机后，在命令行中使用 Python 启动 trrsheadset 即可:

python -m trrsheadset [参数]

• 关闭可以使用两种方式，一种是直接关闭命令行，一种是按下 ctrl+break 快捷键强制退出。
• 选用 pythonw 启动可在命令行关闭后保持运行，可在任务管理器种找到 Python 3.x (Windowed) 关闭。

重插耳机需要重新启动。

可选参数

-l or --log 将运行日志保存至文件

--use-hotkey 开启键盘快捷键

-h or --help 输出此列表后退出

按键

耳机按键映射 & 键盘快捷键响应。基于 Python 库 keyboard 。

耳机

按键	短按	长按	双击
A	继续 / 暂停	继续 / 暂停	静音
B	音量+	下一首	/
C	音量-	上一首	/
D	/	/	/

双击操作处于开发早期阶段

键盘

需在启动时使用 --use-hotkey 参数。

基础快捷键 ctrl+shift+h ，在基础快捷键触发后 1s 内按下以下按键可以触发相应操作：

p 暂停或继续

e 退出

！ 部分设备在开启上述快捷键后，检测不到右 shift、右 ctrl 的释放动作，此时可以按击键盘左边对应按键恢复。

注意哦

• 不要按得太快，招架不住。
• 技术问题欢迎提 issue，其他问题请进入 讨论区（Discussions） 进行交流。
• 如果放久后按钮辨别老错，可能是太久不放音乐了电压不高（？存疑，欢迎讨论）
• 灵感源于：roligheten/AndroidMediaControlsWindows 👍

抓取日志

添加参数 -l 或 --log 启动可将运行时日志保存到运行时文件夹的 debug.log.1 和 debug.log 日志文件中。日志文件对定位 BUG 非常有帮助。

python run.py -l

捐赠

如果你足够开心 🌹

许可

GPL-3.0 License