帮助中心
soundplayer

soundplayer

  • basic

navigation

释义: 导航时音频的文件名

说明: 需要是wav文件,不需要加文件后缀

naviAheadTime

释义: 导航前的音频时长

说明:

navigationLoop

释义: 导航时音频是否循环播放

说明:

astern

释义: 倒走时音频的文件名

说明:

turnleft

释义: 左转时音频的文件名

说明:

turnright

释义: 右转时音频的文件名"

说明:

block

释义: 阻挡时音频的文件名"

说明:

lowBattery

释义: 低电量时音频的文件名"

说明: 优先级最高

error

释义: 报错时音频的文件名"

说明:

useErrorCode

释义: 是否依据错误码播放错误音频"

说明: 如果报错,并且有报错码的音频文件则播放改音频,否则播放默认的报错音频

collision

释义: 发生碰撞时音频的文件名"

说明:

openSound

释义: 是否播放音乐"

说明:

音频使用说明

AGV在正常运行时,会依据模型文件sound机构的配置,或者传入任务的参数,来控制播放音频。

模型文件soundplayer配置

模型文件soundplayer控制agv在不同状态播放相应音频。

相应的状态有: 开始执行任务、倒车、遇到障碍物、原地旋转、低电池电量、阻挡、错误来控制

  • navigation: 表示执行任务时的音频文件,只需要将文件写入即可,无需加入后缀
  • navigationAheadTime: 表示执行任务前多长时间开始播放音频
  • navigationLoop:表示执行任务过程中是否要循环播放音频
  • astern: 表示倒车运行时的音频
  • turnleft:表示原地左转时的音频
  • turnright:表示原地右转时的音频
  • block:表示阻挡时的音频
  • lowBattery:表示低电量时的音频
  • error:表示报错时的音频
  • collision:表示碰撞条被触发时播放的音频
  • openSound:控制是否播放音频
  • useErrorCode:表示报错时,是否报对应错误码特殊的音频

任务指令中音频的配置

  • "audio_name": 表示agv到点后是否播放音频
  • "audio_loop": 表示到点后的音频是否要循环播放
json
{
    "id": "LM1",
    "audio_name": "reached",
    "audio_loop": true
}
1
2
3
4
5

上面的3051指令表示,AGV导航到达LM1后,播放reached.wav音频,并且循环播放。

需要注意,如果立刻下发新的指令,这个音频将被导航或者起步音频切换。可以通过在任务结束后增加等待或者堵塞时间来保证到点后音频有一段播放时间。

高级区域中音频的配置

在高级区域的属性中,"openSound"用来控制区域内开启或者关闭音频功能。

高级区域中"openSound"优先级高于模型文件的"openSound"。

通过高级区域的"openSound",我们就可以实现在特殊区域打开或者关闭音频。

音频的优先级

区域内的openSound > 模型文件中的openSound > 导航过程中阻挡 > 低电量 > 报错 > 导航 > 脚本音频

RoboShop用户控制音频

  • 报错低电量优先级高于用户播放音频
  • 在导航过程中不播放用户音频。只有没有任务或者暂停任务时播放用户音频。
  • 区域或者全局禁止播放音频时,用户也无法播放音频。
最近更新 2022/11/28
文章内容

soundplayer

音频使用说明

模型文件soundplayer配置

任务指令中音频的配置

高级区域中音频的配置

音频的优先级

RoboShop用户控制音频