Pepper QiSDK开发如何在代码中调整Pepper音量 \vol=value\标签无效如何处理

QiSDK 支持代码控制 Pepper 音量，你使用的\vol=value\是旧版 NAOqi 框架的语音内嵌标签，在 QiSDK 中已不再兼容，无法生效，正确实现方式分为两类：

1. 调整全局系统音量 #

该方式会修改 Pepper 整机扬声器的默认音量，所有后续播报、媒体播放都会沿用该音量：

// Kotlin 示例，取值范围为 0.0（静音）~1.0（最大音量）
val adjustVolumeAction = AdjustVolumeBuilder.with(qiContext)
    .withVolume(0.7f)
    .build()
adjustVolumeAction.async().run()

2. 调整单次语音播报的音量 #

如果不需要修改全局音量，仅需单条语音播报使用指定音量，直接在 Say 动作中配置音量参数即可：

val sayAction = SayBuilder.with(qiContext)
    .withText("本次播报仅使用 50% 音量")
    .withVolume(0.5f)
    .build()
sayAction.async().run()

注意事项 #

• 音量参数必须传入 0.0~1.0 区间的浮点值，超出范围会触发参数校验异常
• 若需要音量设置重启后仍生效，调整全局音量后需调用安卓系统AudioManager的相关接口持久化配置
• 旧版\vol=value\内嵌标签仅适配 NAOqi 2.8及更早版本的ALTextToSpeech接口，QiSDK 已完全废弃该用法，请勿继续使用

内容的提问来源于stack exchange，提问作者Ele