音效#

简介#

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) 秒
如果 <声音活跃吗?> 那么
停止声音
结束