Fuaim#

Réamhrá#

Leis na fuaimeanna atá ag an VEX AIM Coding Robot, is féidir le húsáideoirí fuaimeanna ionsuite, comhaid fuaime saincheaptha, agus nótaí ceoil a sheinm. Tá rialuithe ann freisin chun fuaimeanna a stopadh agus a bhrath an bhfuil fuaim ag seinm faoi láthair.

Seo thíos liosta de na modhanna uile:

Gníomhartha — Seinn nó stop fuaimeanna.

  • play — Seinneann sé éifeacht fuaime ionsuite.

  • play_file — Seinneann sé fuaim saincheaptha arna huaslódáil ag an úsáideoir.

  • play_note — Seinneann sé nóta ceoil ar feadh tréimhse socraithe.

  • stop — Stopann sé aon fhuaim atá á seinm faoi láthair.

Getter — Seiceáil stádas an fhuaime.

  • is_active — Tugann sé seo le fios an bhfuil fuaim ag seinm faoi láthair.

Gníomhartha#

play#

play seinntear ceann de na fuaimeanna ionsuite sa róbat ag céatadán toirte sonraithe. Ós rud é nach modh feithimh é seo, seinntear an róbat an fhuaim ionsuite agus bogann sé go dtí an chéad ordú eile gan fanacht go gcríochnóidh sé.

Úsáid:

robot.sound.play(sound, volume)

Paraiméadar

Cur síos

sound

Ceann de na roghanna fuaime ionsuite atá liostaithe thíos.

volume

Roghnach. An toirt don fhuaim, mar uimhir iomlán ó 0% go 100%. Is é 50% an réamhshocrú.

Fuaimeanna Tógtha Isteach

Seinn Fuaim

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 Seinneann fuaim saincheaptha arna huaslódáil ag an úsáideoir. Ós rud é nach modh feithimh é seo, seinneann an róbat an fhuaim saincheaptha agus bogann sé go dtí an chéad ordú eile gan fanacht go gcríochnóidh sé.

Úsáid:

robot.sound.play_file(file, volume)

Paraiméadar

Cur síos

file

Ceann de na comhaid fuaime saincheaptha a d’uaslódáil an t-úsáideoir, ó SOUND1 go SOUND10Tá an uimhir fhuaime mar an gcéanna leis an uimhir a thaispeántar i bpainéal rialaithe AIM.

volume

Roghnach. An toirt don fhuaim, mar uimhir iomlán ó 0% go 100%. Is é 50% an réamhshocrú.

# 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 Seinneann nóta ar leith ar feadh tréimhse ar leith i milleasoicindí. Ós rud é nach modh feithimh é seo, seinneann an róbat an nóta ar leith agus bogann sé go dtí an chéad ordú eile gan fanacht go gcríochnóidh sé.

Úsáid:

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

Paraiméadar

Cur síos

note

An airde cheoil le seinm, scríofa mar shreang (m.sh., C5, A#6). Is iad na nótaí bailí ná A go G (le # roghnach do ghéara) trasna ochtaibhí 5 go 8.

length

Fad an nóta, tugtha mar uimhir iomlán i milleasoicindí.

volume

Roghnach. An toirt don fhuaim, mar uimhir iomlán ó 0% go 100%. Is é 50% an réamhshocrú.

# 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 stadann fuaim atá á sheinm faoi láthair.

Úsáid:

robot.sound.stop()

Paraiméadair

Cur síos

Níl aon pharaiméadair ag an modh seo.

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

Faighteoirí#

is_active#

Tugann is_active luach Booleanach ar ais a léiríonn an bhfuil fuaim ag seinm faoi láthair.

  • True — Tá fuaim ag seinm faoi láthair

  • False — Níl aon fhuaim ag seinm

Úsáid:

robot.sound.is_active()

Paraiméadair

Cur síos

Níl aon pharaiméadair ag an modh seo.

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