Звук#

Вступ#

Звуки робота-кодувача VEX AIM дозволяють користувачам відтворювати вбудовані звуки, власні аудіофайли та музичні ноти. Він також містить елементи керування для зупинки звуків та визначення того, чи відтворюється аудіо на даний момент.

Нижче наведено список усіх методів:

Дії — Відтворити або зупинити звуки.

  • play — Відтворює вбудований звуковий ефект.

  • play_file — Відтворює завантажений користувачем власний звук.

  • play_note — Відтворює музичну ноту протягом встановленого часу.

  • stop — Зупиняє будь-який поточний звук.

Getter — Перевірка стану звуку.

  • 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)
On this page