音#

導入#

VEX EXP Brainは、内蔵スピーカーを通して音声を出力できます。これは、「サウンド」カテゴリのメソッドを使用して、プリロードされた効果音や音符を再生するものです。

以下の例では、構築された Brain には Sound メソッドへのアクセスが含まれており、この API ドキュメント全体を通して、これらのメソッドを参照する際には、以降のすべての例で使用されます。

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

アクション — Brainから音を再生する。

  • play_sound — Brain からプリセットのサウンドを再生します。

  • play_note — Brain から音符を再生します。

行動#

play_sound#

play_sound は、脳に組み込まれた音の1つを再生します。

Usage:
brain.play_sound(sound, volume)

パラメータ

説明

sound

脳から再生する指定された音。

volume

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

サウンド名

サウンドを再生

SoundType.ALARM

SoundType.ALARM2

SoundType.DOOR_CLOSE

SoundType.FILLUP

SoundType.HEADLIGHTS_OFF

SoundType.HEADLIGHTS_ON

SoundType.POWER_DOWN

SoundType.RATCHET

SoundType.RATCHET2

SoundType.SIREN

SoundType.SIREN2

SoundType.TADA

SoundType.TOLLBOOTH

SoundType.WRENCH

SoundType.WRONG_WAY

SoundType.WRONG_WAY_SLOW

# Play the TADA sound from the brain
brain.play_sound(SoundType.TADA)

play_note#

play_note は、特定の音符を特定の時間(ミリ秒単位)再生します。

Usage:
brain.play_note(octave, note, duration, volume)

パラメータ

説明

octave

低音域または高音域のいずれか:

  • 3 — 低音域
  • 4 — 高音域

note

演奏する音符:

  • 0 — C
  • 1 — D
  • 2 — E
  • 3 — F
  • 4 — G
  • 5 — A
  • 6 — B

duration

オプション。音符を演奏する時間(ミリ秒単位)を指定します。最大500ミリ秒までです。時間を指定しない場合、デフォルトの演奏時間は500ミリ秒になります。

volume

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

# Play a quarter note C and half note F
brain.play_note(4, 0, 250)
brain.play_note(4, 3, 500)