音#

導入#

VEX AIMコーディングロボットのサウンド機能を使えば、内蔵サウンド、カスタムオーディオファイル、音符などを再生できます。また、サウンドを停止したり、現在オーディオが再生されているかどうかを検出したりするコントロールも備えています。

以下にすべてのメソッドの一覧を示します。

操作 — 音を再生または停止します。

  • play — 内蔵の効果音を再生します。

  • play_file — ユーザーがアップロードしたカスタムサウンドを再生します。

  • play_note — 指定された時間、音符を演奏します。

  • stop — 現在再生中のサウンドを停止します。

ゲッター — サウンドの状態を確認します。

  • is_active — サウンドが現在再生されているかどうかを返します。

行動#

play#

play は、ロボットに内蔵されている音のいずれかを、指定された音量で再生します。これは待機しない方式なので、ロボットは内蔵音を再生すると、その音が終わるのを待たずに次のコマンドに進みます。

使用法：

robot.sound.play(sound, volume)

パラメータ

説明

sound

下記に記載されている内蔵サウンドオプションのいずれか。

volume

オプション。音量を0%から100%までの整数で指定します。デフォルト値は50%です。

内蔵サウンド

サウンドを再生

ACT_ANGRY

ACT_EXCITED

ACT_HAPPY

ACT_SAD

ACT_SILLY

BLINKER

BRAKES

CHEER

CHIRP

COMPLETE

CRASH

DETECTED

DOORBELL

FAIL

FLOURISH

HUAH

LOOPING

MOVE_FORWARD

MOVE_REVERSE

OBSTACLE

PAUSE

PICKUP

RECEIVE

RESUME

SENSING

SEND

SPARKLE

TADA

TURN_LEFT

TURN_RIGHT

 

# Play cheer
robot.sound.play(CHEER)


# Play cheer at full volume
robot.sound.play(CHEER, 100)


# Wait until sound is finished to move
robot.sound.play(ACT_HAPPY)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

play_file#

play_file は、ユーザーがアップロードしたカスタムサウンドを再生します。これは待機しないメソッドなので、ロボットはカスタムサウンドを再生した後、その完了を待たずに次のコマンドに進みます。

使用法：

robot.sound.play_file(file, volume)

パラメータ

説明

file

ユーザーがアップロードしたカスタムサウンドファイルのうちの1つで、 SOUND1 から SOUND10までの範囲です。サウンド番号は、AIM コントロールパネルに表示される番号と一致します。

volume

オプション。音量を0%から100%までの整数で指定します。デフォルト値は50%です。

 
# Play an uploaded sound
robot.sound.play_file(SOUND1)


# Play an uploaded sound at full volume
robot.sound.play_file(SOUND1, 100)


# Wait until sound is finished to move
robot.sound.play_file(SOUND1)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

play_note#

play_note は、特定の音符をミリ秒単位で指定した時間だけ演奏します。これは待機しない方式なので、ロボットは特定の音符を演奏した後、演奏が終わるのを待たずに次のコマンドに進みます。

使用法：

robot.sound.play_note(note, length, volume)

パラメータ

説明

note

演奏する音高を文字列で表記します（例： C5、 A#6）。有効な音は、5オクターブから8オクターブにわたる A から G （シャープの場合はオプションで # ）です。

length

音符の長さをミリ秒単位の整数で表したもの。

volume

オプション。音量を0%から100%までの整数で指定します。デフォルト値は50%です。

 
# Play C5 for 2 seconds
robot.sound.play_note("C5", 2000)


# Play C5 for 2 seconds at full volume
robot.sound.play_note("C5", 2000, 100)


# Wait until note is finished to move
robot.sound.play_note("C6", 1000)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

stop#

stop 現在再生中の音を停止します。

使用法：

robot.sound.stop()

パラメータ

説明

このメソッドにはパラメータがありません。

 
# Cut a sound off after 1 second
robot.sound.play(ACT_SILLY)
wait(1, SECONDS)
robot.sound.stop()

ゲッター#

is_active#

is_active は、現在サウンドが再生されているかどうかを示すブール値を返します。

  • True — 現在音声が再生されています

  • False — 音が出ません

使用法：

robot.sound.is_active()

パラメータ

説明

このメソッドにはパラメータがありません。

 
# Play tada after cheer finishes
robot.sound.play(CHEER)   
while robot.sound.is_active():
    wait(10, MSEC)
robot.sound.play(TADA)
On this page