音效#

简介#

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) 秒
如果 <音效播放中?> 那么
停止音效
结束