游戏配音·UI语音

概述

按已经写好的界面短句，做成每条带标签口播一条语音。交付 8 到 20 条。先覆盖按钮、胜利和失败。

适用范围与相邻路线

工作室需要按已经写好的界面短句做带标签口播时，使用本 Skill。

按角色的剧情对白转到 game-script-voice-pack。通用讲述转到voiceover-narration-studio。

只读已经提供的界面短句。不要补清单上没有的句子、口号或读音。

收集界面短句

硬输入是：

• 工作室已经写好的按钮、胜利、失败和其他界面短句；
• 出现人名或造词时的读音表；
• 这包要几条，或允许使用默认 10 条；
• 克隆声音会出现时的形象和声音权利。

复用已知语言，以及冻结的 voice_id。只补问缺失的硬输入。8 到 20 以外的数量也能做：确认该规模和实时费用。

不要编造点击句、胜利句或读音。拿到文件不等于同意。

名字存在而读音表为空时，停下来收集读法。

先做免费槽表

任何付费克隆或旁白前，先写带标签的界面口播清单。卖家没有另报 8 到 20 之间的数量时，默认十个槽位：点击、确认、取消、开始、暂停、胜利、失败、连击、警告和升级。每个槽位记下由已写界面短句写出的口播句，以及用目录音色还是克隆。

这份清单就是免费可见结果。规划不是批准。

安全默认：

• 每个槽位一次 beatra.speech.synthesize；
• 仅当每张实时旁白卡都支持该语言时，才用 model: "auto"；
• format: "mp3"；speed: 1.0；
• 整包一把品牌声音。

每次提交的 input 不超过 50,000 字。按句拆。按清单写成短口语句。

卖家要克隆时，先查看其可授权样本。本地文件检查后，只通过随包客户端上传（scripts/mcp_client.py / beatra.assets.upload）。保留返回的产物编号。绝不要把本地路径传给beatra.voices.clone 或beatra.speech.synthesize。

确认克隆，再确认旁白

克隆和旁白是分开的付费阶段。每个阶段各自一张六字段卡，各自一个不透明 client_request_id。

卖家要克隆音色时，先查看其可授权样本，读取当前的 voice_clone 卡片，并在 beatra.voices.clone 之前等在克隆卡上。找到的文件不是克隆同意。出示克隆卡并等待：

1. 做什么 — 一份可授权声音样本（beatra.voices.clone）。
2. 积分 — 刚读到的 voice_clone 价格。不要复用记忆中的数字。
3. 几笔 — 这份样本一次付费克隆。
4. 身份 — 一个新的不透明 client_request_id。
5. 若停在这里 — 带标签的槽表仍然可用。
6. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。卖家说已充值之前不要重试。

旁白前，调用 beatra.models.list，能力为 text_to_speech：

{"capability": "text_to_speech"}

目录音色还没定时再用 beatra.voices.list。绝不要把显示名放进 voice。出示旁白卡并等待：

1. 做什么 — 每个点名槽位一条界面口播

（beatra.speech.synthesize）。

1. 积分 — 刚读到的 text_to_speech 价格乘以槽位数。不要复用记忆中的数字。
2. 几笔 — 每个槽位一次付费旁白。
3. 身份 — 每个槽位一个新的不透明 client_request_id。
4. 若停在这里 — 带标签的槽表仍然可用。
5. 若余额不足 — 原样转达官方说明和充值链接。翻译正文，保留链接。卖家说已充值之前不要重试。

每个旁白槽位只通过随包 scripts/mcp_client.py 提交一次。用beatra.tasks.get 轮询。读取实际音频 MIME、时长和大小，以及billing.net_charged_credits。不要承诺预付估价就是最终扣费。文稿预览不是音频审听。

审听、交付与恢复

核对每条口播用同一把声音，且名字与读音表和已写界面清单一致。只报告宿主实际听得到的内容。

拿到 task_id 后轮询该任务。创建响应丢失时，先用 beatra.tasks.list 搜索，再用beatra.tasks.get 核对，然后再重放。只有参数逐字节相同才能复用原标识。口播句、音色或语速变了就是新卡和新标识。只有卖家要求时才取消。

执行

每个远程 Beatra 操作都只通过本包随附的scripts/mcp_client.py 调用。把 MCP 工具名放在 call 后面，并向标准输入发送一个 JSON 对象。

python3 scripts/mcp_client.py call beatra.models.list

{"capability": "text_to_speech"}

printf '%s' '{"input":"<the written line for this slot>","voice":"voice_...","format":"mp3","client_request_id":"opaque-ui-speech-01"}' | python3 scripts/mcp_client.py call beatra.speech.synthesize

不要配置或调用宿主 Beatra Connector，也不要使用 REST/OpenAPI 作为降级。

账户余额

用户问还剩多少积分，或某次实时估价够不够时，调用 beatra.wallet.get。问已经扣了多少时，调用 beatra.wallet.ledger。两者都是只读的。不要臆造查余额或充值的工具。也不要把wallet.get 变成每次付费提交前的必需步骤。

模型卡返回里带 top_up 块时，按卡片给出的档位和顺序原样转述。不要给档位排高低，不要贬低其中任何一档，也不要替用户挑。选哪一档是用户自己的事，钱包页会把整份清单摆在他面前。任何时候都不要凭记忆报档位。

按任务查阅的参考

• 槽表、载荷和恢复，读

界面口播工作流（references/workflow.md）。

• 授权和非计费注册步骤，读

安装与认证（references/installation-and-auth.md）和 安装注册（references/installation-registration.md）。

• 共用的任务、计费和连接细节，读 任务与结果（references/tasks-and-results.md）、计费、错误与恢复（references/billing-errors-and-recovery.md） 和 随包 MCP Client 连接诊断（references/mcp-connection.md）。
• 更新与安全：更新与安全（references/updates-and-security.md）
• 移除时读 卸载与断开（references/uninstall-and-disconnect.md）。

更新与安全

本 Skill 会自动更新。内置客户端每天最多一次从 Beatra 官网读取本渠道的版本信息（中国大陆网络走 www.beatra.cn 与 cdn.beatra.cn）。有新版本时，它下载官方发布包，逐个文件校验 SHA-256，再替换本 Skill 自己的文件；你放进这个目录的其他文件不会被改动。替换过程中断时，下次运行会自动恢复到替换前的状态。除此之外，它不下载或执行任何其他代码，只通过 HTTPS 与 Beatra 官方服务通信；你选择上传的文件只会传到Beatra 为这次上传签发的一次性地址。

关闭自动更新：python3 scripts/mcp_client.py update --auto off。关闭后，客户端每天最多提示一次在你安装它的商店里更新的命令。详见更新与安全（references/updates-and-security.md）。