音效#

简介#

VEX AIM 智能编程机器人的声音功能允许用户播放内置音效、自定义音频文件以及音符。它还包括停止声音以及检测当前是否有音频正在播放的控制功能。以下是所有可用指令块的列表:

播放音效#

播放音效指令块用于播放机器人的一个内置音效。

播放声音门铃指令块#
播放声音 [表现开心 v] ▶

参数

描述

音效

下方显示的内置音效之一。

展开箭头

展开该指令块,显示“说完继续”选项,使其变为非等待型指令块。默认情况下,此指令块为等待型指令块。

音效名称

播放音效

表现开心

表现悲伤

表现傻

表现生气

表现兴奋

前进

后退

右转

左转

撞毁

刹车

捡起

传感

检测到

障碍

闪耀

闪烁

啁啾

循环

完成

发送

接受

暂停

继续

嗒哒

失败

门铃

精彩

欢呼

示例

启动时,播放声音,表现快乐。#
当开始
[Play the act happy sound.]
播放声音 [表现开心 v] ▶

播放音效文件#

播放音效文件指令块用于播放用户加载的自定义声音文件。

播放用户声音 1 指令块。#
播放声音文件 [1 v] ▶

参数

描述

音效槽位编号

要使用的自定义声音,编号为 1 到 10。该编号与 AIM 控制面板中显示的数字相对应。

展开箭头

展开该指令块,显示“说完继续”选项,使其变为非等待型指令块。默认情况下,此指令块为等待型指令块。

示例

启动时,播放用户音效1。#
当开始
[Upload a sound file in VEXcode.]
[Play the custom sound.]
播放声音文件 [1 v] ▶

播放音符#

播放音符指令块以指定的时长播放一个特定的音符。

播放音符动作指令块。#
播放音符 [低 v] [C v] [note_eight v] ▶

参数

描述

八度

音符的八度:

音符

定义音高:

  • C
  • C#
  • D
  • D#
  • E
  • F
  • F#
  • G
  • G#
  • A
  • A#
  • B
  • rest

音符长度

设置音符的长度:

  • 全音符 - 全音符
  • 二分音符 - 二分音符
  • 四分音符 - 四分音符
  • 八分音符 - 八分音符
  • 十六分音符 - 十六分音符

展开箭头

展开该指令块,显示“说完继续”选项,使其变为非等待型指令块。默认情况下,此指令块为等待型指令块。

示例

播放声音文件 1,不要等待。等待 2 秒。如果声音仍然有效,则停止声音。#
当开始
[Play a short tune.]
播放音符 [低 v] [C v] [note_half v] ▶
播放音符 [低 v] [D v] [note_quarter v] ▶
播放音符 [低 v] [E v] [note_sixteenth v] ▶

停止音效#

停止音效指令块停止当前正在播放的音效。

停止声音动作指令块。#
停止声音

参数

描述

该指令块没有参数。

示例

播放声音文件 1,不要等待。等待 2 秒。如果声音仍然有效,则停止声音。#
当开始
[Stop sound if it is still playing after 2 seconds]
播放声音文件 [1 v] ◀ 并且不等待
等待 (2) 秒
如果 <声音活跃吗?> 那么
停止声音
结束

音效播放中?#

音效播放中 指令块返回一个布尔值,指示当前是否有任何音效正在播放。

  • 正确 – 正在播放音效。

  • 错误 – 没有播放音效。

音效正在播放布尔值指令块。#
<声音活跃吗?>

参数

描述

该指令块没有参数。

示例

播放声音文件 1,不要等待。等待 2 秒。如果声音仍然有效,则停止声音。#
当开始
[Stop sound if it is still playing after 2 seconds]
播放声音文件 [1 v] ◀ 并且不等待
等待 (2) 秒
如果 <声音活跃吗?> 那么
停止声音
结束