Ήχος

Εισαγωγή

Οι ήχοι του ρομπότ κωδικοποίησης 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 επιστρέφει μια Boolean τιμή που υποδεικνύει εάν αναπαράγεται ένας ήχος τη δεδομένη στιγμή.

• 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)