Klang

Einführung

Der VEX AIM Coding Robot bietet integrierte Soundfunktionen, mit denen Benutzer Sounds, eigene Audiodateien und Noten abspielen können. Außerdem verfügt er über Steuerelemente zum Stoppen der Sounds und zur Erkennung, ob gerade Audio wiedergegeben wird.

Nachfolgend finden Sie eine Liste aller Methoden:

Aktionen – Töne abspielen oder stoppen.

• play — Spielt einen eingebauten Soundeffekt ab.

• play_file — Spielt einen vom Benutzer hochgeladenen benutzerdefinierten Sound ab.

• play_note — Spielt eine musikalische Note für eine festgelegte Dauer.

• stop — Stoppt den aktuell wiedergegebenen Ton.

Getter – Soundstatus prüfen.

• is_active — Gibt zurück, ob gerade ein Ton abgespielt wird.

Aktionen

play

Der Befehl play spielt einen der integrierten Sounds des Roboters mit einer festgelegten Lautstärke ab. Da es sich um eine Methode ohne Wartezeit handelt, spielt der Roboter den Sound ab und fährt mit dem nächsten Befehl fort, ohne auf dessen Beendigung zu warten.

Verwendung:

robot.sound.play(sound, volume)

Parameter	Beschreibung
sound	Eine der unten aufgeführten integrierten Soundoptionen.
volume	Optional. Die Lautstärke des Tons, als ganze Zahl von 0 % bis 100 %. Der Standardwert ist 50 %.

Eingebaute Sounds	Ton abspielen
ACT_ANGRY	Spiele
ACT_EXCITED	Spiele
ACT_HAPPY	Spiele
ACT_SAD	Spiele
ACT_SILLY	Spiele
BLINKER	Spiele
BRAKES	Spiele
CHEER	Spiele
CHIRP	Spiele
COMPLETE	Spiele
CRASH	Spiele
DETECTED	Spiele
DOORBELL	Spiele
FAIL	Spiele
FLOURISH	Spiele
HUAH	Spiele
LOOPING	Spiele
MOVE_FORWARD	Spiele
MOVE_REVERSE	Spiele
OBSTACLE	Spiele
PAUSE	Spiele
PICKUP	Spiele
RECEIVE	Spiele
RESUME	Spiele
SENSING	Spiele
SEND	Spiele
SPARKLE	Spiele
TADA	Spiele
TURN_LEFT	Spiele
TURN_RIGHT	Spiele

# 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 spielt einen vom Benutzer hochgeladenen benutzerdefinierten Sound ab. Da es sich um eine Methode ohne Wartezeit handelt, spielt der Roboter den benutzerdefinierten Sound ab und fährt mit dem nächsten Befehl fort, ohne auf dessen Beendigung zu warten.

Verwendung:

robot.sound.play_file(file, volume)

Parameter	Beschreibung
file	Eine der vom Benutzer hochgeladenen benutzerdefinierten Sounddateien, von SOUND1 bis SOUND10Die Soundnummer stimmt mit der im AIM-Bedienfeld angezeigten Nummer überein.
volume	Optional. Die Lautstärke des Tons, als ganze Zahl von 0 % bis 100 %. Der Standardwert ist 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 spielt eine bestimmte Note für eine bestimmte Dauer in Millisekunden. Da es sich um eine Methode ohne Wartezeit handelt, spielt der Roboter die Note und fährt mit dem nächsten Befehl fort, ohne auf deren Beendigung zu warten.

Verwendung:

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

Parameter	Beschreibung
note	Die zu spielende Tonhöhe wird als Tonfolge notiert (z. B. C5, A#6). Gültige Noten sind A bis G (mit optionalem # für Kreuze) über die Oktaven 5 bis 8.
length	Die Dauer des Tons, angegeben als ganze Zahl in Millisekunden.
volume	Optional. Die Lautstärke des Tons, als ganze Zahl von 0 % bis 100 %. Der Standardwert ist 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 stoppt einen aktuell abgespielten Ton.

Verwendung:

robot.sound.stop()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

Getter

is_active

is_active gibt einen booleschen Wert zurück, der angibt, ob gerade ein Ton abgespielt wird.

• True — Es wird gerade ein Ton abgespielt

• False — Es wird kein Ton abgespielt

Verwendung:

robot.sound.is_active()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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