Apple 辅助功能控制

通过 Apple 快捷指令、辅助触控和 Streamable TTS 监控页面,设置安全的 TTS 控制。

选择合适的操作

点击跳过后,播放器收到指令便会停止当前消息。启用和禁用只会更改现有的“允许 TTS 消息”设置。

禁用不会停止正在播放或排队中的语音。要停止当前消息,请使用跳过。操作需要互联网连接。

第 1 步:创建认证令牌

以账户所有者身份登录。打开“打赏”→“设置”→“Apple 辅助功能控制”,选择“创建 TTS 控制认证令牌”。

输入一个名称,例如“我的 iPhone”。创建并复制令牌。完整令牌只会显示一次。

请妥善保管令牌。任何持有令牌的人都能控制你的 TTS,直到令牌过期或被撤销。不要将令牌放入共享的快捷指令或截图中。

第 2 步:创建“停止 TTS”快捷指令

在“快捷指令”中创建一个名为“停止 TTS”的快捷指令。添加“URL”操作,填入 https://platform.streamable.run/api/tts/skip。

添加“获取 URL 内容”,选择“URL”操作的输出。展开设置,将方法设为 POST。请求正文留空。

添加名为 Authorization 的标头,值填入 Bearer YOUR_AUTH_TOKEN。将 YOUR_AUTH_TOKEN 替换为你的令牌,Bearer 后保留一个半角空格。

第 3 步:显示操作结果

在“获取 URL 内容”后添加“获取词典值”,读取响应中的 message 键,再将该值传给“显示通知”。

Stop requested 表示服务器已接受停止指令。相关播放器确认停止后,监控页面会显示 Playback stopped 对应的播放已停止状态。

请使用响应返回的消息,不要使用固定的成功通知。请求失败时,快捷指令不应提示成功。

第 4 步:创建启用和禁用快捷指令

复制“停止 TTS”,将副本命名为“禁用 TTS”,只把 URL 改为 https://platform.streamable.run/api/tts/disable。

再次复制“停止 TTS”,将副本命名为“启用 TTS”,只把 URL 改为 https://platform.streamable.run/api/tts/enable。

三个快捷指令都使用 POST 和同一个身份验证令牌,只需更改 URL。

第 5 步:设置辅助触控手势

在 iPhone 上打开“设置”→“辅助功能”→“触控”→“辅助触控”,开启辅助触控。在“自定操作”中按以下方式分配快捷指令:

  • 单点 → 停止 TTS
  • 轻点两下 → 禁用 TTS
  • 长按 → 启用 TTS

第 6 步:直播前先测试

手动运行每个快捷指令一次,允许预期的 platform.streamable.run 访问请求。打开 TTS 监控页面,确认播放器已连接。

播放一条内容合适的 TTS 测试消息,然后打开 Kick。轻点一次辅助触控,确认语音在消息读完前停止。

轻点两下以禁用 TTS,长按以启用。确认监控页面显示了每次设置变更。

使用 TTS 监控页面

在“打赏”中选择“打开 TTS 监控”。页面会显示正在播放的消息、队列、TTS 设置和播放器连接状态。

管理员、场景切换员和工具管理员使用各自的 Streamable 账号登录。他们不需要你的身份验证令牌。打开监控页面不会自动播放音频。

通过蓝牙音箱播放语音

将音箱与播放 TTS 的设备配对。在 iPhone 上打开“设置”→“蓝牙”,选择音箱。

快捷指令只发送操作命令,不向音箱传输音频。远程 OBS 播放器的声音不会自动在 iPhone 上播放。

要用手机播放,账户所有者可在监控页面选择“在此设备播放音频”。请在连接音箱的手机上保持监控页面打开。

在同一部手机上使用 Kick 前,请测试后台播放、消息间隔、锁屏和重新连接。浏览器在后台时,音频可能会停止或暂停。

更换或撤销令牌

在“Apple 辅助功能控制”中按名称找到令牌,选择“撤销令牌”。所有使用此令牌的快捷指令都会立即失去访问权限。

创建新令牌,并更新三个快捷指令中的 Authorization 标头。下次直播前,分别运行每个快捷指令一次。

撤销令牌不会停止当前语音,也不会更改 TTS 设置。令牌列表会显示到期时间和上次使用时间。

操作无效时如何处理

  • 如果令牌无效或已过期,请创建新令牌。确认三个快捷指令都使用最新的 Authorization 标头。
  • 如果显示 Stop requested 但语音仍在继续,请在监控页面检查播放器连接。重新连接播放器后再试。
  • 如果禁用后语音仍在播放,请使用跳过。禁用只会更改设置。如果音箱没有声音,请检查与其配对的播放设备。