音效#

简介#

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