Звук

Введение

Робот-программист 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	Один из пользовательских звуковых файлов, загруженных пользователем, от 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). Допустимые ноты: A , G (с необязательной # для диезов) в диапазоне от 5 до 8 октав.
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)