Fuaim#

Réamhrá#

Ligeann Rialaitheoir Dróin VEX AIR d’úsáideoirí fuaimeanna ionsuite, comhaid fuaime saincheaptha, agus nótaí ceoil a sheinm. Cuimsíonn sé rialuithe freisin chun fuaimeanna a stopadh agus a bhrath an bhfuil fuaim ag seinm faoi láthair.

Seo thíos liosta de na modhanna uile atá ar fáil:

Gníomhartha - Seinn agus Stop Fuaimeanna

  • play — Seinneann sé fuaim ionsuite ó liosta réamhshainithe.

  • play_file — Seinneann sé fuaim a d’uaslódáil an t-úsáideoir.

  • play_note — Seinneann sé nóta ceoil le páirc, ochtach agus fad sonraithe.

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

Getters - Faigh Stádas na bhFuaimeanna

  • is_active — Seiceálann sé an bhfuil fuaim ag seinm faoi láthair.

Gníomhartha#

play#

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

Úsáid:

controller.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 shlánuimhir ó 0% go 100%. Is é 50% an réamhshocrú.

Fuaimeanna Tógtha Isteach

Seinn Fuaim

SUCCESS

FAULT

SENSING

DETECTED

OBSTACLE

LOOPING

COMPLETE

PAUSE

RESUME

SEND

RECEIVE

# Play the looping sound.
controller.sound.play(LOOPING)

# Play the looping sound at full volume.
controller.sound.play(LOOPING, 100)

# Play the looping sound. 
# Wait until the sound is finished before taking off.
controller.sound.play(LOOPING)
while controller.sound.is_active():
    wait(50, MSEC)
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()

play_file#

play_file Seinneann fuaim saincheaptha a luchtaíonn an t-úsáideoir ag céatadán toirte sonraithe. Ós rud é nach modh feithimh é seo, seinneann an drón an fhuaim saincheaptha agus bogann sé go dtí an chéad ordú eile gan fanacht go gcríochnóidh sé.

Úsáid:

controller.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á uimhir an fhuaime ailínithe leis an uimhir a thaispeántar i bPainéal Rialaithe AIR.

volume

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

# Upload a sound file in VEXcode.
# Play the custom sound.
controller.sound.play_file(SOUND1)

# Upload a sound file in VEXcode.
# Play the custom sound at full volume.
controller.sound.play_file(SOUND1, 100)

# Play the custom sound sound. 
# Wait until the sound is finished before taking off.
controller.sound.play_file(SOUND1)
while controller.sound.is_active():
    wait(50, MSEC)
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()

play_note#

play_note seinneann nóta ar leith ar feadh tréimhse ar leith. Ós rud é nach modh feithimh é seo, seinneann an drón an nóta ar leith agus bogann sé go dtí an chéad ordú eile gan fanacht go mbeidh sé críochnaithe.

Úsáid:

controller.sound.play_note(note, duration, 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.

duration

Fad an nóta, tugtha mar shlánuimhir i milleasoicindí.

volume

Roghnach. Toirt an nóta, mar shlánuimhir ó 0% go 100%. Is é 50% an réamhshocrú.

# Play C5 for 2 seconds
controller.sound.play_note("C5", 2000)

# Play C5 for 2 seconds at full volume
controller.sound.play_note("C5", 2000, 100)

# Play a short tune.
controller.sound.play_note("C5", 1000)
while controller.sound.is_active():
    wait(50, MSEC)
controller.sound.play_note("D5", 1000)
while controller.sound.is_active():
    wait(50, MSEC)
controller.sound.play_note("E5", 250)
while controller.sound.is_active():
    wait(50, MSEC)

stop#

stop stadann fuaim atá á sheinm faoi láthair.

Úsáid:

controller.sound.stop()

Paraiméadair

Cur síos

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

# Upload a sound 10 seconds or greater in VEXcode.
# Stop the sound while it is playing.
controller.sound.play_file(SOUND1)
wait(6, SECONDS)
controller.sound.stop()

Faighteoirí#

is_active#

Tugann is_active luach Booleach ar ais a léiríonn an bhfuil fuaim á sheinm ag an drón faoi láthair.

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

  • False — Níl aon fhuaim ag seinm

Usage:
controller.sound.is_active()

Paraiméadair

Cur síos

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

# Display text once a sound starts playing
controller.sound.play(LOOPING)
while not controller.sound.is_active():
    wait(50, MSEC)
print("I hear the sound!")