本文随源码和版本维护。欢迎通过 Issue 提问、PR 补充;不需要另开 Wiki 仓库。
Steam Input 是 Steam 官方映射系统。Talaria 的 Xbox 模拟额外创建一个虚拟 Xbox 手柄,不会把物理 Steam Controller 改成 Xbox。同一个游戏应避免两套映射同时输出。关闭 Talaria 的 Xbox 输出后,键鼠和宏仍可用;游戏的手柄输入可以由 Steam Input 或游戏原生支持提供。
两者可以同时读取同一只手柄。Talaria 的「启用接管」表示按自己的配置输出,并不代表独占物理设备,也不会修改或关闭 Steam 的桌面布局。因此,同一次操作可能同时触发两套鼠标、键盘或触觉反馈,表现为重复点击、滚动过快或手感异常。这与是否开启 Talaria 的虚拟 Xbox 输出是两回事。
如果同一个手柄按键或触摸板按压在 Steam 桌面布局和 Talaria 中都绑定了鼠标左键,一次按下、松开可能由两边各发送一次点击,应用就可能识别成双击。右键、快捷键等绑定也应检查是否重复。
请同时检查两边的按键绑定和触摸板按压动作,让当前场景中的同一个操作只由一套映射输出;仅关闭触摸板移动鼠标的绑定,并不会清除按压点击绑定。可以先暂停 Talaria 对照测试,再按下面的方法备份并调整 Steam 桌面布局。不建议先靠修改系统双击速度掩盖重复输入。
- 在 Steam「设置 → 控制器 → 桌面布局」中先保存或导出原布局,方便恢复;不同 Steam 版本的入口名称可能略有不同。
- 将 Steam 桌面布局改为空布局,或逐项移除与 Talaria 重叠的按键、触摸板动作及触觉设置。若只清除鼠标动作而保留触觉,仍可能收到 Steam 的震动。
- 在 Talaria 中选择设备、应用自己的配置并启用接管。先在普通桌面窗口验证点击、滚动和触觉。
- Steam 游戏继续使用各自的 Steam Input 配置;希望由 Steam 负责的游戏,在 Talaria 中排除实际游戏 EXE。大屏模式仍交给 Steam,不需要全局关闭 Steam Input。
清空桌面布局是持久设置,不会随窗口切换自动恢复。 Talaria 暂停或遇到不接管的普通应用时,原来的 Steam 桌面操作也不会自动回来;需要时请手动恢复备份布局。游戏布局与桌面布局应分开设置。
非 Steam 游戏可以先退出 Steam,再启用 Talaria;需要手柄输入时为游戏配置开启 Xbox 模拟。这样没有 Steam 的另一套映射同时输出。
Steam 游戏 + 管理员权限修改器可以保留 Steam 桌面和游戏配置:
- Steam 以普通权限运行,修改器以管理员权限运行。
- Talaria 已安装并启用管理员窗口操作能力(UIAccess,例如安装器的本机自签选项)。标准模式本身不能跨越这个权限边界。
- Talaria 使用白名单,只加入修改器的实际 EXE,不加入游戏;修改器使用键鼠配置,无需 Xbox 模拟。
- 修改器在前台时由 Talaria 操作;切回游戏,Talaria 停止输出,由 Steam Input 负责游戏。
这个场景中,普通权限 Steam 的键鼠注入会受到 Windows UIPI 权限边界限制,不能操作管理员修改器,因此可以利用权限分隔避免修改器窗口收到两套点击,无需为此清空 Steam 桌面布局。如果 Steam 也以管理员权限运行,或修改器并未提权,就不再满足这个条件,应按普通窗口检查重复绑定。
权限边界限制的是窗口输入,不会阻止 Steam 向手柄发送触觉反馈。若触觉叠加,再调整重叠的 Steam 桌面触觉设置即可;白名单仍不代表独占设备。
白名单可以减少两者同时生效的范围,但不能保证名单内独占:
- 白名单外:Talaria 不输出,Steam 按自己的规则工作。
- 白名单内:Talaria 输出;如果 Steam 桌面布局也在生效,仍可能重复输入。
- 单独应用配置只决定 Talaria 使用哪套映射,不会替你关闭 Steam 的布局。
如果主要用 Steam 操作桌面,可以暂停 Talaria,需要时再启用;也可以使用白名单,但仍需避免名单内两套配置绑定同一操作。黑名单同样只控制 Talaria;仅排除 steam.exe 不会排除所有 Steam 游戏。
当前没有「白名单内独占」功能。 白名单只决定是否输出,不会把手柄从 Steam 手中抢过来。若未来采用关闭共享、重新获取设备的方式,Steam 已打开设备时可能需要重启设备连接;这可能带来 Windows 拔插提示音、短暂输入中断或游戏重新识别设备,不能承诺无声无缝切换。
「切换窗口时保持 Xbox 手柄连接」只控制 Talaria 创建的虚拟手柄,不会屏蔽 Steam 桌面映射,也不能解决物理手柄重新连接产生的声音。
先暂停 Talaria 的输入接管及其他触觉测试,再恢复准备录制的 Steam 桌面布局,让 Steam 提供所需反馈。录制完成后,若继续由 Talaria 操作桌面,请重新应用空桌面布局或移除重叠设置,再启用 Talaria。录制不会自动替你切换、备份或恢复 Steam 布局。
在同一窗口用相同动作比较:先暂停 Talaria,只测试 Steam;再备份并清空 Steam 桌面布局,启用 Talaria 测试。若各自正常、同时启用异常,就检查重叠映射。仅凭震动强弱不能判断来源,手柄固件也可能产生反馈;反馈问题时请附连接方式、Steam 是否运行、两边布局及复现步骤。
虚拟手柄断开、重建时 Windows 可能播放提示音。「接管状态」里的全局「切换窗口时保持 Xbox 手柄连接」可减少这些声音,默认开启。开启后不接管的窗口不会收到 Talaria 操作,但仍可能看到空闲手柄或占用玩家槽位。暂停接管或退出会断开。
不会,当前 Talaria 共用一个虚拟 Xbox 手柄。切换前台时松开按键、清零摇杆,并加载对应配置。两个应用都需要 Xbox 输出时直接复用;不需要输出时是否断开由全局保持连接开关决定,不取决于上一份应用配置。
排除名单控制 Talaria 是否输出,不会隐藏物理设备或禁用 Steam Input。保持连接开启时,空闲虚拟手柄也可能仍然可见。若要排查,暂停 Talaria 移除其虚拟设备。仅排除 steam.exe 不会排除游戏,需要加入实际游戏 EXE。
先暂停 Talaria 做对照测试,再检查 Steam 的设备检测、该游戏的 Steam Input 配置及游戏内输入设置。区分“未识别设备”和“已识别但映射不适用”;支持手柄不代表任意模板都适用。重新插拔后有些游戏可能需要重启才能重新枚举设备,先保存游戏进度。对照测试仍无效时,不应直接归因于 Talaria。
输出与录制是两条不同的链路:蓝牙、USB、Puck 均支持向手柄发送触觉反馈;当前录制器只能从 Windows 蓝牙日志提取 Steam 的反馈参数。可先用蓝牙录制,再在三种连接下使用保存的配置。验证步骤见触觉录制。
不需要。已有配置时显示「检查录制组件」,只检查不下载;检查失败后提供修复。首次安装会显示检测、下载、校验和安装阶段。详细步骤见触觉录制。
「关于 → 诊断与日志」可查看最近日志、设备诊断日志和日志文件夹;录制区域可打开组件安装日志。内置查看器支持刷新和复制。日志在 %LOCALAPPDATA%/Talaria/logs。反馈时附软件版本、连接方式、复现步骤和相关时间段,分享前检查路径及设备标识;不要上传整个原始蓝牙采集目录。详见隐私说明。