芯步20W壁挂音箱支持通过HTTP接口远程调节音色、音调、语速等参数，无需上传录音，可直接对接现有业务系统。以下方案涵盖鉴权、接口调用及参数说明。

1. 产品与接口概述

芯步的 20W 壁挂户外防水语音音箱（型号如 UNI-YY-YX-BG-PRO-20W 或 UNI-YY-YX-BG-20W）支持通过标准的 HTTP 协议进行远程控制。

核心优势：

• 开放性：提供公开的 HTTP API，无需网关，设备直连 WiFi 2.4G 。

• 实时性：支持实时下发指令，无需上传录音文件，直接推送文本即可合成语音 。

• 可调参数：针对“音色”和“音调”，该设备支持设置音色（男/女）、语速 和 语调。

2. 接口鉴权与基础信息

在对接前，需在芯步控制台获取以下凭证：

• AppID：应用唯一标识。

• AppSecret：开发者密码（用于签名计算）。

2.1 签名算法

所有 API 请求需携带签名 sign 和时间戳 ts 以防止篡改。计算公式：

注：先将 AppSecret 进行 MD5 加密得到字符串 S1，再将 S1 与 ts 拼接后进行第二次 MD5 加密。

2.2 请求地址

2.3 请求体结构

3. “音色”与“音调”设置指令详解

针对 20W 壁挂音箱，实现音色音调设置的核心在于 order 字段的构建。该设备支持以下几种与声音质感相关的独立指令：

3.1 音色设置 (Voice)

切换发音人的性别。

• 命令Key: voice

• 可用值:

  • 0: 女声（通常默认，风格自然柔和）

  • 1: 男声（风格沉稳）

• 请求示例（设为男声） :

3.2 语速设置 (Speed)

控制说话的快慢节奏。

• 命令Key: speed

• 可用值: 0 至 9 （整数，数值越大语速越快，默认值 5）

• 请求示例（快速播报） :

3.3 语调设置 (Tone)

控制语音的声调起伏（音高），直接影响听感的“音调”高低。

• 命令Key: tone

• 可用值: 0 至 9 （整数，数值越大语调越高越尖锐，默认值 5）

• 请求示例（低沉舒缓语调） :

4. 组合设置与播报实战

在实际业务场景中，通常需要在设置音色后立即进行语音播报，或者一次性调整多个参数。

注意：HTTP 接口通常一次请求只处理一个 order 键值对。如果需要同时设置音色、语速并播报内容，采用连续调用策略（只要网络延迟足够低，设备响应极快）。

4.1 场景：商场促销播报（女声，慢语速，温柔语调）

步骤 1：设置音色、语速、语调分别发送三条指令确保参数生效，或者根据 SDK 特性尝试合并（具体取决于固件，分开最稳）。

1. 设置音色：{"voice":"0"}

2. 设置语速：{"speed":"3"}

3. 设置语调：{"tone":"4"}

步骤 2：播报文本使用 play:gbk:16 指令推送文字。

• 命令Key: play:gbk:16

• 命令值: 需要播报的文本内容（支持多音字、数字智能识别）。

4.2 代码实现逻辑 (伪代码示例)

5. 最佳实践

1. 参数持久化设备断电重启后，通常会保持上一次设置的音量、音色和语调。在系统启动时或设备上线时，主动下发一次配置指令，确保音色符合当前场景预期。

2. 户外防水场景的特殊处理该音箱为 20W 功率 且 户外防水 设计。在户外嘈杂环境下，将 音量 设置在 7-9 之间（默认最大值 9），并适当提高 语调 (Tone) 至 6-7，高频提升有助于穿透环境噪音，增强语音清晰度 。

3. 文本优化虽然接口支持直接发送中文，但对于户外场景，文本简洁。若有数字（如金额、手机号），系统会自动智能处理读法，无需人工转换 。

6. 常见问题排查

通过上述接口对接，您可以轻松地将芯步 20W 户外防水音箱集成到您的 SaaS 或本地系统中，实现远程、灵活的语音播报与音色定制。