Ses#

giriiş #

VEX AIM Kodlama Robotu’nun sesleri, kullanıcıların yerleşik sesleri, özel ses dosyalarını ve müzik notalarını çalmasına olanak tanır. Ayrıca sesleri durdurma ve sesin şu anda çalınıp çalınmadığını algılama kontrolleri de içerir.

Aşağıda tüm yöntemlerin listesi bulunmaktadır:

İşlemler — Sesleri çal veya durdur.

play — Dahili bir ses efektini çalar.
play_file — Kullanıcı tarafından yüklenen özel bir sesi oynatır.
play_note — Belirli bir süre boyunca bir müzik notası çalar.
stop — Şu anda çalmakta olan herhangi bir sesi durdurur.

Getter — Ses durumunu kontrol et.

is_active — Bir sesin şu anda çalınıp çalınmadığını döndürür.

Eylemler #

play #

play komutu, robotun dahili seslerinden birini belirtilen ses seviyesi yüzdesinde çalar. Bu bekleme gerektirmeyen bir yöntem olduğundan, robot dahili sesi çalar ve bitmesini beklemeden bir sonraki komuta geçer.

Kullanım:

robot.sound.play(sound, volume)

Parametre	Tanım
`sound`	Aşağıda listelenen dahili ses seçeneklerinden biri.
`volume`	İsteğe bağlı. Ses seviyesi, %0 ile %100 arasında tam sayı olarak belirtilebilir. Varsayılan değer %50’dir.

Dahili Sesler	Sesi Çal
`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 , kullanıcı tarafından yüklenen özel bir sesi çalar. Bu bekleme gerektirmeyen bir yöntem olduğundan, robot özel sesi çalar ve bitmesini beklemeden bir sonraki komuta geçer.

Kullanım:

robot.sound.play_file(file, volume)

Parametre	Tanım
`file`	Kullanıcı tarafından yüklenen özel ses dosyalarından biri, `SOUND1` ile `SOUND10`arasındadır. Ses numarası, AIM kontrol panelinde gösterilen numarayla eşleşir.
`volume`	İsteğe bağlı. Ses seviyesi, %0 ile %100 arasında tam sayı olarak belirtilebilir. Varsayılan değer %50’dir.

# 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 komutu, belirli bir notayı belirli bir süre (milisaniye cinsinden) boyunca çalar. Bu bekleme gerektirmeyen bir yöntem olduğundan, robot belirli notayı çalar ve bitmesini beklemeden bir sonraki komuta geçer.

Kullanım:

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

Parametre	Tanım
`note`	Çalınacak müzik notası, bir tel olarak yazılır (örneğin, `C5`, `A#6`). Geçerli notalar, 5 ila 8. oktavlar arasında `A` `G` kadardır (diyezler için isteğe bağlı `#` ile).
`length`	Notanın süresi, milisaniye cinsinden tam sayı olarak verilir.
`volume`	İsteğe bağlı. Ses seviyesi, %0 ile %100 arasında tam sayı olarak belirtilebilir. Varsayılan değer %50’dir.

# 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 durdur. Şu anda çalmakta olan sesi durdurur.

Kullanım:

robot.sound.stop()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

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

Getters #

is_active #

is_active bir sesin şu anda çalınıp çalınmadığını gösteren bir Boolean değeri döndürür.

True — Şu anda bir ses çalıyor
False — Ses çalınmıyor

Kullanım:

robot.sound.is_active()

Parametreler	Tanım
	Bu yöntemin parametresi yoktur.

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