صوت

مقدمة

تتيح أصوات روبوت البرمجة VEX AIM للمستخدمين تشغيل الأصوات المدمجة، وملفات الصوت المخصصة، والنوتات الموسيقية. كما يتضمن أدوات تحكم لإيقاف الأصوات والكشف عما إذا كان الصوت قيد التشغيل حاليًا.

فيما يلي قائمة بجميع الطرق:

الإجراءات — تشغيل الأصوات أو إيقافها.

• play — تشغيل مؤثر صوتي مدمج.

• play_file — تشغيل صوت مخصص تم تحميله بواسطة المستخدم.

• play_note — يعزف نغمة موسيقية لمدة محددة.

• stop — إيقاف أي صوت قيد التشغيل حاليًا.

المُستقبِل — تحقق من حالة الصوت.

• 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 تُرجع قيمة منطقية تشير إلى ما إذا كان الصوت قيد التشغيل حاليًا.

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