جرب أن تلعب أي لعبة تحبها والصوت مغلق، وسوف تلاحظ أنها أصبحت أبطأ وأثقل، مع أن الصورة هي نفسها والتحكم هو نفسه. فالقفز دون صوت لا تشعر بلحظة بدايته، والتقاط الشيء دون رنة صغيرة لا تعرف هل حدث فعلاً، والحجر الذي يسقط خلفك لا تنتبه له حتى يصيبك. والصوت في الألعاب ليس زينة تضاف في الأسبوع الأخير، وإنما جزء من التحكم نفسه: يخبر اللاعب بما حدث قبل أن تراه عينه، ويحدد إيقاع اللعبة ومزاجها. ومع ذلك فهو أكثر جزء يؤجله المطور المبتدئ، ثم يضيف الأصوات كلها في يوم واحد على مستوى 0 dB، فتخرج اللعبة بموسيقى تغطي كل شيء، وأصوات تتشوه عندما تجتمع، وحلقة موسيقية فيها نقرة مزعجة كل ثماني ثوان.
وفي هذا المقال سوف نضيف الصوت إلى لعبة «جني التمر» التي بنيناها في مقال الفيزياء والتحكم في هذه المرحلة: صوت للقفز، ورنة لالتقاط التمرة، وضربة لسقوط الحجر، وموسيقى للنهار وأخرى لليل. وكل صوت في المقال من صنعنا، ولدناه بسكربت Python من موجات جيبية وضوضاء، فلا توجد رخصة تقلق منها، ثم نشغل كل شيء في Godot 4.7.2 ونسجل ما يخرج منه فعلاً، ونقيسه بالأرقام: حجم الملفات، وتكلفة فك الضغط، ومستوى الصوت بوحدة LUFS، وأعلى قمة، والفرق بين السماعة اليمنى واليسرى.
وسوف نتناول في هذا المقال ما يلي:
- كيف يمر الصوت في Godot: العقد AudioStreamPlayer بأنواعها الثلاثة، والحافلات Audio Buses، والمؤثرات Audio Effects.
- صيغ الملفات WAV وOgg Vorbis وMP3، وما يحدث لها عند الاستيراد، وحجمها وتكلفة فك ضغطها مقيسة.
- الموسيقى التي تدور Looping، ونقرة حقيقية ظهرت في المختبر عند نقطة الدوران وكيف أصلحناها.
- التسجيل من داخل المحرك بوضع Movie Maker، ثم قياس المستوى بوحدة LUFS والقمة الحقيقية True Peak.
- المزج Mixing: لماذا تتشوه الأصوات عندما يكون كل شيء على 0 dB، وماذا يفعل المحدد Limiter.
- الانتقال بين مقطعين موسيقيين Crossfade، ولماذا يسقط الصوت في منتصفه إذا حركت
volume_dbفي خط مستقيم. - الصوت الذي له مكان: AudioStreamPlayer2D بين السماعتين، وAudioStreamPlayer3D مع المسافة.
- من أين تأتي بأصوات جاهزة: Freesound وOpenGameArt ورخص Creative Commons.
طريق الصوت في Godot: العقد والحافلات Audio Buses
في Godot لا تشغل ملف الصوت مباشرة، وإنما تضعه في عقدة تشغله، وهذه العقدة ترسل ما تشغله إلى حافلة Bus، والحافلة تضبط مستواه وتمرره على مؤثراتها، ثم ترسله إلى حافلة أخرى، حتى يصل إلى الحافلة الرئيسية Master التي تخرج إلى السماعة. ويصف توثيق الحافلات في Godot الحافلة بأنها مكان يمر به الصوت في طريقه إلى السماعات، يمكن أن يغيره ويعيد توجيهه، ولكل حافلة مقياس VU يضيء بمستوى ما يمر بها. وأقرب تشبيه لها طاولة المزج Mixing Console في الاستوديو: كل قناة لها مستوى ومؤثرات، والقنوات تجتمع في مخرج واحد. والشكل التالي يبين الطريق في لعبتنا:

والعقد التي تشغل الصوت ثلاثة أنواع، والفرق بينها هو هل للصوت مكان في العالم أم لا:
- العقدة AudioStreamPlayer: صوت بلا مكان، يسمع بالمستوى نفسه من السماعتين أينما كانت الكاميرا، وهي المناسبة للموسيقى وأصوات الواجهة، ولأصوات الشخصية التي يتحكم بها اللاعب في لعبة ثنائية الأبعاد صغيرة مثل لعبتنا.
- العقدة AudioStreamPlayer2D: صوت له موضع في العالم ثنائي الأبعاد، فيميل إلى السماعة اليمنى إذا كان مصدره على يمين الشاشة، ويضعف كلما ابتعد، كما سنقيس.
- العقدة AudioStreamPlayer3D: صوت له موضع في عالم ثلاثي الأبعاد، والمستمع هو الكاميرا Camera3D أو عقدة AudioListener3D، ويضعف مع المسافة بحسب نموذج تختاره.
وأما الحافلات فهي ملف واحد في المشروع اسمه default_bus_layout.tres، تعدله في المحرر من اللوحة Audio في أسفل الشاشة، وهذا الملف في لعبتنا كما هو:
[gd_resource type="AudioBusLayout" load_steps=3 format=3]
[sub_resource type="AudioEffectHardLimiter" id="limiter"]
resource_name = "HardLimiter"
ceiling_db = -1.0
[sub_resource type="AudioEffectReverb" id="reverb"]
resource_name = "Reverb"
room_size = 0.4
damping = 0.6
wet = 0.15
[resource]
bus/0/name = &"Master"
bus/0/solo = false
bus/0/mute = false
bus/0/bypass_fx = false
bus/0/volume_db = 0.0
bus/0/send = &""
bus/0/effect/0/effect = SubResource("limiter")
bus/0/effect/0/enabled = true
bus/1/name = &"Music"
bus/1/solo = false
bus/1/mute = false
bus/1/bypass_fx = false
bus/1/volume_db = -10.0
bus/1/send = &"Master"
bus/2/name = &"SFX"
bus/2/solo = false
bus/2/mute = false
bus/2/bypass_fx = false
bus/2/volume_db = -4.0
bus/2/send = &"Master"
bus/2/effect/0/effect = SubResource("reverb")
bus/2/effect/0/enabled = trueفي الملف أعلاه لاحظ التالي:
- ثلاث حافلات: Master رقم 0، وMusic رقم 1، وSFX رقم 2، والأخيرتان ترسلان إلى Master بالسطر
send. والسبب في فصل الموسيقى عن المؤثرات الصوتية Sound Effects أن اللاعب يريد غالباً أن يخفض الموسيقى وحدها من قائمة الإعدادات، وأنت تريد أن تضع على كل مجموعة ما يناسبها من مؤثرات. - المستويات بالديسيبل dB: الموسيقى -10 والمؤثرات -4. ويذكر التوثيق أن كل 6 dB تضاعف قيمة الموجة أو تنصفها، وأن 0 dB هو أعلى قيمة يمثلها الصوت الرقمي، فما يتجاوزه يتشوه تشوهاً اسمه Clipping، ولذلك يجب ألا يتجاوز مخرج Master الصفر، وأن الصوت لا يكاد يسمع بين -60 و-80 dB. وسوف نرى في المختبر من أين جاءت أرقامنا.
- الصدى Reverb على SFX: بنسبة 15 في المئة فقط من الصوت، يعطي إحساساً بمكان مفتوح، ولأنه على الحافلة يطبق مرة واحدة على مجموع المؤثرات، لا على كل صوت وحده.
- المحدد HardLimiter على Master: يمنع أي قمة من تجاوز -1 dB، ويقول توثيق AudioEffectHardLimiter إنه يتوقع القمم ويخفض المستوى بهدوء قبل أن تتجاوز السقف، ويوصي بوضعه على Master كإجراء أمان من التشوه Clipping عندما يتجاوز الصوت 0 dB. وفي المختبر سوف ترى ماذا يحدث دونه.
والحافلة التي تذهب إليها كل عقدة هي الخاصية bus فيها، وقيمتها الافتراضية Master. فإذا نسيت أن تغيرها ذهب الصوت مباشرة إلى Master متجاوزاً حافلته ومؤثراتها، ولن يعمل زر خفض الموسيقى في قائمة الإعدادات معه، وهذا من أكثر الأخطاء تكراراً عندما يضيف أكثر من شخص أصواتاً إلى المشروع.
الأصوات من صنعنا: موجات جيبية وضوضاء
قبل أن نختار صيغة نحتاج أصواتاً، والطريقة الأسهل في مقال تعليمي، والأسلم من ناحية الرخص، أن نولدها بأنفسنا. والسكربت tools/gen_sounds.py يكتب ملفات WAV بمكتبة Python القياسية فقط، دون أي مكتبة صوت، وهذه أهم أجزائه:
def env(t, attack, decay): # quick attack, exponential decay
return min(1.0, t / attack) * math.exp(-t / decay)
# --- sound effects (mono) -------------------------------------------------
n = int(0.18 * RATE) # jump: a sine that sweeps up from 300 to 900 Hz
jump, ph = [], 0.0
for i in range(n):
t = i / RATE
ph += 2 * math.pi * (300 + 600 * t / 0.18) / RATE
jump.append(0.7 * env(t, 0.005, 0.08) * math.sin(ph))
write(f"{out}/sfx/jump.wav", jump, 1)
# --- music loops (stereo, 8 s = 4 bars of 4 beats at 120 BPM) ---------------
# A drone at 110 Hz makes exactly 880 cycles in 8 s, so the loop point is seamless: any gap at the seam is the format's fault.
def song(notes, drone_hz, path):
frames = []
beat = 0.5
for i in range(8 * RATE):
t = i / RATE
b = int(t / beat)
u = t - b * beat
f = notes[b % len(notes)]
lead = 0.28 * env(u, 0.01, 0.18) * math.sin(2 * math.pi * f * u) if f else 0.0
drone = 0.22 * math.sin(2 * math.pi * drone_hz * t)
frames.append((drone + lead * 0.8, drone + lead)) # the lead leans a little to the right
write(path, frames, 2)في السكربت أعلاه لاحظ التالي:
- صوت القفز: موجة جيبية يرتفع ترددها من 300 إلى 900 هرتز في 0.18 ثانية، مع غلاف Envelope يبدأ بسرعة ويخفت بسرعة، وهذا الصعود في الطبقة هو ما تربطه الأذن بالصعود. وكذلك رنة التقاط التمرة نغمتان متتاليتان، وضربة الحجر ضوضاء منخفضة التردد مع نغمة 90 هرتز تهبط.
- الموسيقى: ثماني ثوان، أي أربع وحدات موسيقية Bars بإيقاع 120 ضربة في الدقيقة، فيها لحن بسيط وصوت ممتد Drone على 110 هرتز. واخترنا الصوت الممتد عن قصد: فهو يكمل 880 دورة كاملة في ثماني ثوان، أي أن آخر عينة في الملف تتصل بأول عينة بلا أي قفز في الموجة، فإذا سمعنا نقرة عند نقطة الدوران فالسبب ليس الملف، وإنما ما حدث له بعد ذلك.
- موسيقى الليل: بالطريقة نفسها بلحن آخر، لنستخدمها في الانتقال بين المقطعين، ونغمة 440 هرتز لمدة ثانية لقياسات المكان.
ثم يحول ffmpeg موسيقى النهار إلى Ogg Vorbis بالجودة 4، وهي ترميز بمعدل متغير Variable Bitrate، وإلى MP3 بمعدل ثابت 128 كيلوبت في الثانية، والمخرج كان كما يلي:
game/sfx/jump.wav: 0.180 s, 15920 bytes
game/sfx/pickup.wav: 0.300 s, 26504 bytes
game/sfx/thud.wav: 0.350 s, 30912 bytes
game/sfx/tone.wav: 1.000 s, 88244 bytes
game/music/day.wav: 8.000 s, 1411244 bytes
game/music/night.wav: 8.000 s, 1411244 bytes
129193 day.mp3
31829 day.ogg
1411244 day.wav
1411244 day_loop.wav
1411244 day_pcm.wav
27420 night.oggثماني ثوان ستيريو بدقة 16 بت و44,100 عينة في الثانية حجمها 1.41 ميجابايت في WAV، وهي ببساطة 8 في 44,100 في 2 قناة في 2 بايت. والملف نفسه بصيغة Ogg Vorbis 31.8 كيلوبايت فقط، وبصيغة MP3 129 كيلوبايت. وقد تستغرب أن Ogg أصغر من MP3 بأربع مرات، والسبب أن الترميز المتغير يعطي المقطع البسيط، مثل موسيقانا المكونة من موجات جيبية نقية، معدلاً منخفضاً جداً، بينما يبقى MP3 على 128 كيلوبت في كل ثانية مهما كان المقطع بسيطاً. ولهذا لا تحكم على الصيغ من جدول جاهز، وقس على أصواتك أنت. والملفان day_pcm.wav وday_loop.wav نسختان من day.wav سوف نغير إعدادات استيرادهما.
الصيغ والاستيراد: WAV وOgg Vorbis وMP3
يقبل Godot ثلاث صيغ للصوت بحسب توثيق استيراد الصوت، ونصيحته المختصرة: WAV للمؤثرات القصيرة التي تتكرر، وOgg Vorbis للموسيقى والكلام والمؤثرات الطويلة، وMP3 مفيد للجوال والويب عندما يكون المعالج محدوداً. والمهم أن تعرف أن الملف الذي تضعه في المشروع ليس هو ما يدخل في اللعبة، وإنما يحوله المحرك عند الاستيراد إلى ملف في مجلد .godot/imported، بحسب إعدادات تحفظ في ملف بجانبه امتداده .import. والمختبر يستورد المشروع من سطر الأوامر بالأمر godot --headless --import، ثم يطبع إعدادات الاستيراد الافتراضية وأحجام الملفات الناتجة:
--- music/day.wav.import [params]
[params]
force/8_bit=false
force/mono=false
force/max_rate=false
force/max_rate_hz=44100
edit/trim=false
edit/normalize=false
edit/loop_mode=0
edit/loop_begin=0
edit/loop_end=-1
compress/mode=2
--- music/day.ogg.import [params]
[params]
loop=false
loop_offset=0
bpm=0
beat_count=0
bar_beats=4
--- imported files
129531 day.mp3.mp3str
35663 day.ogg.oggvorbisstr
285391 day.wav.sample
285415 day_loop.wav.sample
1411583 day_pcm.wav.sample
3603 jump.wav.sample
30823 night.ogg.oggvorbisstr
5747 pickup.wav.sample
6651 thud.wav.sample
18259 tone.wav.sampleوالقراءة كما يلي:
- السطر
compress/mode=2: ملفات WAV لا تبقى كما هي، وإنما يضغطها Godot افتراضياً بصيغة Quite OK Audio واختصاراً QOA، وهي بحسب التوثيق الوضع الافتراضي، تصغر الملف أكثر من IMA ADPCM بفرق في الجودة أقل وضوحاً، مقابل استخدام أعلى قليلاً للمعالج. والنتيجة في القائمة:day.wavأصبح 285 كيلوبايت بدل 1.41 ميجابايت، أي خمس حجمه. وأماday_pcm.wavفقد غيرنا له الوضع إلى 0، أي بلا ضغط PCM، فبقي 1.41 ميجابايت. - المؤثرات الصغيرة: صوت القفز أصبح 3.6 كيلوبايت بدل 15.9، وهذا أحد أسباب نصيحة التوثيق بأن تبقى المؤثرات القصيرة WAV: الحجم بعد الضغط صغير، وفكها رخيص.
- Ogg Vorbis وMP3: لا يعيد Godot ترميزهما، وإنما يحفظ البيانات كما هي تقريباً، فالحجم بعد الاستيراد قريب من الأصل: 35.7 و129.5 كيلوبايت.
- الإعداد
loop=false: ملفات Ogg وMP3 لا تدور افتراضياً، وملفات WAV تتبع ما في الملف نفسه من معلومات الدوران معedit/loop_mode=0، وملفاتنا لا تحتوي شيئاً من ذلك. وهذا الإعداد هو موضوع القسم بعد التالي.
كم يكلف فك الصوت؟ AudioStreamPlayback.mix_audio
الصيغة المضغوطة أصغر على القرص، ولكن المحرك يفك ضغطها في أثناء اللعب، والسؤال كم يكلف ذلك. ويتيح Godot 4.7 قياس ذلك مباشرة: كل صوت AudioStream ينشئ مشغلاً AudioStreamPlayback بالدالة instantiate_playback، وهذا المشغل له الدالة mix_audio التي تفك عدداً من العينات وترجعها، كما يشرح توثيق AudioStreamPlayback. والتجربة تفك أول سبع ثوان من كل نسخة خمس مرات وتأخذ أسرعها:
var best := 1 << 30
for run in 5:
var pb := s.instantiate_playback()
pb.start(0.0)
var t0 := Time.get_ticks_usec()
var done := 0
while done < int(7 * rate):
done += pb.mix_audio(1.0, 512).size()
best = mini(best, Time.get_ticks_usec() - t0)ولاحظ أن الحلقة تتوقف عند سبع ثوان لا ثمان، وهذا درس من أول تشغيل: طلبنا ثماني ثوان كاملة من ملف طوله ثماني ثوان، فلما انتهى الملف أصبحت mix_audio ترجع مصفوفة فارغة، والحلقة تنتظر عينات لن تأتي، فعلقت التجربة إلى أن أوقفها الأمر timeout. والتوثيق ينبه إلى أن الدالة قد ترجع عينات أقل مما تطلب، فاعتمد دائماً على حجم ما رجع. وهذه أسطر التوقيت من المخرج، وفيه أيضاً معلومات كل نسخة كما يراها المحرك:
day_pcm.wav AudioStreamWAV length=8.000 s format=16 bit data=1411200 bytes
decode 7 s: 3448 us ( 493 us per second of audio, 2030 times faster than real time)
day.wav AudioStreamWAV length=8.000 s format=QOA data=285008 bytes
decode 7 s: 10160 us ( 1451 us per second of audio, 689 times faster than real time)
day_loop.wav AudioStreamWAV length=8.000 s format=QOA data=285008 bytes
decode 7 s: 8758 us ( 1251 us per second of audio, 799 times faster than real time)
day.ogg AudioStreamOggVorbis length=8.000 s packets=10
decode 7 s: 15621 us ( 2232 us per second of audio, 448 times faster than real time)
day.mp3 AudioStreamMP3 length=8.000 s data=129193 bytes
decode 7 s: 17808 us ( 2544 us per second of audio, 393 times faster than real time)وشغلنا التجربة مرتين أخريين، لأن الجهاز مشترك والتوقيت يتغير من تشغيل لآخر، وحفظنا الناتج في out-03b-decode-repeats.txt. والشكل التالي يجمع الحجم وأقل وأعلى زمن في التشغيلات الثلاثة:

والقراءة العملية لهذه الأرقام كما يلي:
- الترتيب ثابت في التشغيلات الثلاثة: WAV بلا ضغط هو الأرخص، حوالي نصف جزء من الألف من الثانية لكل ثانية صوت، ثم QOA بثلاثة أضعافه تقريباً، ثم Ogg Vorbis، ثم MP3.
- MP3 كان الأبطأ هنا: وهذا عكس ما يذكره توثيق الاستيراد من أن MP3 يحتاج معالجاً أقل من Ogg Vorbis. وقد تكرر ذلك في التشغيلات الثلاثة على هذا المعالج، مع ملفاتنا البسيطة، فلا تختر MP3 من أجل المعالج قبل أن تقيس على الجهاز الذي تستهدفه وأصواتك أنت.
- الأرقام كلها صغيرة: حتى أبطأ صيغة فكت الثانية الواحدة في أقل من 4 أجزاء من الألف من الثانية، أي أسرع من الزمن الحقيقي بأكثر من 250 مرة. فالموسيقى الواحدة لن تؤثر في أداء لعبتك، والتكلفة تظهر عندما تشغل عشرات الأصوات المضغوطة في الوقت نفسه على جوال ضعيف، وهذا ما يحذر منه التوثيق.
وبهذا يصبح الاختيار واضحاً: المؤثرات القصيرة WAV بضغط QOA الافتراضي، والموسيقى والأصوات الطويلة Ogg Vorbis، ولا تحتاج WAV بلا ضغط إلا لصوت قصير جداً يتكرر مئات المرات في الثانية.
الموسيقى التي تدور Looping: نقرة عند الثانية الثامنة
الموسيقى في الألعاب تدور بلا نهاية، والمكان الذي يكشف أي خطأ في ذلك هو نقطة الدوران Loop Point: آخر عينة من الملف ثم أول عينة منه مرة أخرى. فإذا لم تتصلا بشكل صحيح ظهرت نقرة Click أو فجوة Gap قصيرة يسمعها اللاعب كل دورة، وبعد عشر دقائق من اللعب تصبح مزعجة جداً. والتجربة تشغل كل نسخة 12 ثانية مع الدوران، ثم تطبع ثماني عينات حول الثانية الثامنة بالضبط، وأكبر قفز بين عينتين متتاليتين في المنطقة من 7.9 إلى 8.2 ثانية، وتقارنه بأكبر قفز في الثواني 2 إلى 5 حيث لا يوجد دوران.
وأغلب الدروس تفعل الدوران من الكود، وهكذا فعلنا أولاً لملفات WAV التي لم نغير إعداداتها:
if s is AudioStreamWAV and s.loop_mode == AudioStreamWAV.LOOP_DISABLED:
s.loop_mode = AudioStreamWAV.LOOP_FORWARD # looping set from code, the way many tutorials do it
s.loop_begin = 0
s.loop_end = int(s.get_length() * s.mix_rate) # 8 s × 44100 = 352800
elif s is AudioStreamWAV:
print(" loop from the import settings: loop_end=%d" % s.loop_end)
else:
s.loop = trueوأما day_loop.wav فقد فعلنا له الدوران من إعدادات الاستيراد، بتغيير edit/loop_mode إلى 2، أي Forward، وهو ما تفعله في المحرر من لوحة Import. والمخرج حول نقطة الدوران كان كما يلي:
day_pcm.wav AudioStreamWAV length=8.000 s format=16 bit data=1411200 bytes
left channel at the seam, samples 352796..352803: -0.021 -0.017 -0.014 -0.010 -0.007 -0.003 +0.000 +0.003
loop seam: longest near-silence 2 samples ( 0.0 ms) ending at 8.1864 s, biggest step 0.0161 at 8.0182 s (elsewhere at most 0.0266)
day.wav AudioStreamWAV length=8.000 s format=QOA data=285008 bytes
left channel at the seam, samples 352796..352803: -0.021 -0.017 -0.014 -0.010 -0.007 -0.003 +0.218 +0.004
loop seam: longest near-silence 2 samples ( 0.0 ms) ending at 8.1864 s, biggest step 0.2214 at 8.0000 s (elsewhere at most 0.0268)
day_loop.wav AudioStreamWAV length=8.000 s format=QOA data=285008 bytes
loop from the import settings: loop_end=352799
left channel at the seam, samples 352796..352803: -0.021 -0.017 -0.014 -0.010 -0.007 -0.003 +0.004 +0.007
loop seam: longest near-silence 2 samples ( 0.0 ms) ending at 8.1864 s, biggest step 0.0161 at 8.0182 s (elsewhere at most 0.0268)
day.ogg AudioStreamOggVorbis length=8.000 s packets=10
left channel at the seam, samples 352796..352803: -0.019 -0.016 -0.013 -0.009 -0.006 -0.003 +0.001 +0.005
loop seam: longest near-silence 2 samples ( 0.0 ms) ending at 8.1955 s, biggest step 0.0163 at 8.0182 s (elsewhere at most 0.0270)
day.mp3 AudioStreamMP3 length=8.000 s data=129193 bytes
left channel at the seam, samples 352796..352803: -0.020 -0.016 -0.013 -0.010 -0.007 -0.003 +0.001 +0.003
loop seam: longest near-silence 2 samples ( 0.0 ms) ending at 8.1864 s, biggest step 0.0153 at 8.0182 s (elsewhere at most 0.0253)والقراءة كما يلي:
- WAV بلا ضغط مع الدوران من الكود: العينات تكمل طريقها، -0.003 ثم 0.000 ثم +0.003، وهذا هو الصوت الممتد يعبر الصفر بهدوء، وأكبر قفز في المنطقة 0.0161، أقل من أكبر قفز في وسط المقطع 0.0266. أي أن الدوران سليم تماماً.
- WAV بضغط QOA مع الدوران من الكود: هنا المشكلة. عينة واحدة في الثانية 8.0000 قفزت إلى +0.218، ثم عادت إلى +0.004، وأكبر قفز 0.2214، أي ثمانية أضعاف أكبر قفز طبيعي في المقطع. وعينة واحدة بهذا الحجم تسمع كنقرة واضحة، تتكرر كل ثماني ثوان. والسبب أننا جعلنا نهاية الدوران 352800، أي ثماني ثوان في 44,100، وهي في الحقيقة أول عينة بعد نهاية الملف، فالملف عيناته من 0 إلى 352799. ومع PCM لم يظهر أثر لذلك، ولكن مع بيانات QOA المضغوطة قرأ المشغل عينة غير موجودة.
- WAV بضغط QOA مع الدوران من الاستيراد: المستورد جعل النهاية 352799، فلا توجد نقرة، وأكبر قفز 0.0161 كما في PCM. ولاحظ أن العينة بعد الدوران +0.004 بدل 0.000، أي أن الدورة تبدأ بفارق عينة واحدة، وهذا لا يسمع.
- Ogg Vorbis وMP3: دارا دون أي فجوة أو نقرة، والطول المحسوب 8.000 ثانية بالضبط. وكثير من المصادر القديمة تحذر من أن MP3 يضيف صمتاً صغيراً في بدايته ونهايته بسبب طريقة الترميز، فيظهر فراغ عند الدوران، ولكن ملف MP3 الذي أنتجه ffmpeg بالمرمز LAME دار في Godot 4.7.2 دون فراغ واحد. فإذا كنت تستخدم MP3 للموسيقى، فجرب ملفك أنت كما فعلنا قبل أن تحكم عليه.

والحل هنا ليس أن تحسب الرقم بشكل أدق، وإنما أن تترك الدوران لإعدادات الاستيراد: في المحرر اختر الملف، ومن لوحة Import اجعل Loop Mode على Forward، ثم اضغط Reimport، والمستورد يعرف عدد العينات الحقيقي بعد الضغط. وإذا احتجت أن تدور الموسيقى من نقطة غير البداية، مثل مقدمة لا تتكرر ثم مقطع يدور، فاستخدم Loop Begin في WAV، أو Loop Offset في Ogg وMP3، كما يشرح التوثيق، ولا تقطع الملف إلى ملفين.
decode في المختبر تطبع العينات حول نقطة الدوران لأي ملف تضيفه إلى قائمتها.نسمع ما يخرج من المحرك: التسجيل بوضع Movie Maker
المختبر يعمل في Container لا توجد فيه بطاقة صوت، و Godot يختار فيه المشغل الوهمي Dummy كما يظهر في أول سطر من كل مخرج. فكيف نقيس ما يسمعه اللاعب فعلاً؟ والإجابة في وضع Movie Maker: يشرح توثيق تسجيل الفيديو في Godot أن المحرك يستطيع تسجيل أي مشروع فيديو وصوتاً، دون أن يلتزم بالزمن الحقيقي، فيحسب كل إطار بزمن ثابت ولو أخذ حسابه وقتاً أطول، ويكتب الصوت الممزوج كما خرج من الحافلة الرئيسية. ويكفي أن تضيف إلى سطر الأوامر الخيار --write-movie ومعه اسم ملف بالامتداد .avi، فيكتب الفيديو بصيغة MJPEG والصوت دون ضغط، أو بالامتداد .png فيكتب صورة لكل إطار وملف WAV بجانبها.
ولأن Movie Maker يحتاج رسماً حقيقياً، شغلناه كما في المقالات السابقة مع شاشة وهمية من Xvfb ومكتبة Mesa التي ترسم بالمعالج، والدالة movie في run.sh تفعل ذلك:
# Movie Maker needs a real renderer: a virtual screen (Xvfb) and Mesa drawing on the CPU. xvfb-run sometimes waited forever here, so Xvfb is started by hand.
movie() { godot "Xvfb :99 -screen 0 960x540x24 > /dev/null 2>&1 & sleep 2; DISPLAY=:99 godot --rendering-driver opengl3 --write-movie /rec/$1.avi --fixed-fps 60 --path /game -- --lab $2"; }وقد استخدمنا في البداية الأداة xvfb-run كما في مقال الفيزياء، ولكنها علقت هنا مرتين دون أي مخرج، والـ Container يعمل دقائق ولا يفعل شيئاً، فاستبدلناها بتشغيل Xvfb بأنفسنا في الخلفية ثم تعريف المتغير DISPLAY. وإذا علق أمر في Container دون أن يطبع شيئاً، فالأمر docker logs يبين لك هل بدأ البرنامج أصلاً، وهذا ما كشف لنا أن Godot لم يبدأ.
ثم يستخرج ffmpeg الصوت من ملف AVI إلى WAV، ويقيسه بطريقتين: السكربت analyze.py يقرأ العينات ويحسب القمة Peak وعدد العينات المقصوصة ومتوسط المستوى RMS، والمرشح ebur128 في ffmpeg يحسب المستوى المدرك بوحدة LUFS والقمة الحقيقية True Peak. ويصف توثيق المرشح ebur128 نفسه بأنه ماسح للمستوى بحسب معيار EBU R128 يعطي المستوى اللحظي والقصير والمتكامل Integrated Loudness ومدى المستوى.
وقد يتساءل البعض: لماذا LUFS ولا نكتفي بالقمة أو بمتوسط RMS؟ والإجابة على ذلك أن الأذن لا تسمع كل الترددات بالقوة نفسها، فنغمة منخفضة وأخرى حادة بالقمة نفسها لا تبدوان بالارتفاع نفسه. ووحدة LUFS تقيس المستوى بعد ترشيح يقترب من حساسية الأذن، وتهمل لحظات الصمت عند حساب المستوى المتكامل، فهي أقرب إلى ما تسمعه الأذن من القمة أو المتوسط. وأما القمة الحقيقية True Peak فتقدر القمة بين العينات، لأن الموجة بعد تحويلها إلى صوت تناظري قد تتجاوز أعلى عينة فيها.
المزج Mixing: عندما يكون كل شيء على 0 dB
التجربة mix هي جولة قصيرة من جني التمر بالصوت فقط: موسيقى النهار تدور على حافلة Music، وأحد عشر صوتاً في أوقات محددة على حافلة SFX، منها ثلاثة في الثانية 4.5 معاً، القفز والتقاط تمرة وسقوط حجر، كما يحدث فعلاً عندما يقفز جامع التمر ليلتقط تمرة بجانب حجر يسقط. وفي اللعبة الحقيقية لا يوجد جدول أوقات، وإنما تربط الأصوات بالإشارات التي بنيناها في مقال الفيزياء، فيصبح صوت القفز سطراً واحداً مثل player.jumped.connect($JumpSound.play). وهذه التجربة كما هي في سكربت المختبر:
# --bug: every bus at 0 dB and no limiter, as in a new project where nobody mixed anything.
var events := [[1.0, "jump"], [1.6, "pickup"], [3.0, "jump"], [3.4, "thud"], [4.5, "jump"], [4.5, "pickup"], [4.5, "thud"],
[6.0, "pickup"], [6.6, "jump"], [7.2, "thud"], [7.2, "pickup"]]
var sfx := {}
var peaks := {}
func lab_mix() -> void:
if bug:
for i in AudioServer.bus_count:
AudioServer.set_bus_volume_db(i, 0.0)
AudioServer.set_bus_effect_enabled(0, 0, false) # the HardLimiter on Master
for i in AudioServer.bus_count:
print("bus %-6s volume %+5.1f dB effects: %s" % [AudioServer.get_bus_name(i), AudioServer.get_bus_volume_db(i),
", ".join(range(AudioServer.get_bus_effect_count(i)).map(func(e): return "%s(%s)" % [AudioServer.get_bus_effect(i, e).resource_name,
"on" if AudioServer.is_bus_effect_enabled(i, e) else "off"]))])
var music := player("res://music/day.ogg", "Music")
music.stream.loop = true
music.play()
for n in ["jump", "pickup", "thud"]:
sfx[n] = player("res://sfx/%s.wav" % n, "SFX")
set_physics_process(true)وفي _physics_process يشغل الصوت عندما يحين وقته، ويسأل AudioServer في كل خطوة عن أعلى قمة مرت بكل حافلة بالدالتين get_bus_peak_volume_left_db وget_bus_peak_volume_right_db، وهي القيم نفسها التي تراها في مقاييس VU في لوحة Audio في المحرر. وشغلنا التجربة مرتين: الأولى بالخيار --bug، كأنه مشروع جديد لم يمزج فيه أحد شيئاً، والثانية بإعدادات default_bus_layout.tres. والمخرج للأولى كان كما يلي:
Movie Maker mode enabled, recording movie in 960×540 @ 60 FPS...
Godot 4.7.2-stable (official) | audio driver: Dummy | mix rate: 48000 Hz | buses: Master +0 dB, Music -10 dB, SFX -4 dB
bus Master volume +0.0 dB effects: HardLimiter(off)
bus Music volume +0.0 dB effects:
bus SFX volume +0.0 dB effects: Reverb(on)
highest peak per bus (AudioServer): Master +5.4 dB, Music -6.4 dB, SFX +4.9 dB
Done recording movie at path: /rec/mix-bug.avi
510 frames at 60 FPS (movie length: 00:00:08:30), recorded in 00:00:27 (29% of real-time speed).في المخرج أعلاه لاحظ التالي:
- معدل المزج Mix Rate: 48,000 عينة في الثانية في Movie Maker، بينما كان 44,100 في التشغيل دون شاشة، والسبب أن Movie Maker له إعداد خاص بمعدل المزج في إعدادات المشروع، ويذكر التوثيق أنه يجب أن يقبل القسمة على عدد الإطارات في الثانية حتى لا يختل التزامن بين الصوت والصورة.
- السطر الثاني: يبين الحافلات كما في الملف، Music على -10، لأنه يطبع قبل أن تغيرها التجربة، والأسطر الثلاثة بعده تبين الحالة بعد التغيير: كل شيء على 0 dB والمحدد معطل.
- أعلى قمة لكل حافلة: SFX وصلت إلى +4.9 dB، وMaster إلى +5.4 dB، أي فوق الصفر بخمسة ديسيبل تقريباً. والقيم داخل المحرك أعداد عشرية لا تقص، ولكن الصوت الذي يخرج إلى السماعة أو إلى ملف بدقة 16 بت لا يمثل ما فوق الصفر.
- زمن التسجيل: 8.5 ثوان من اللعبة سجلت في 27 ثانية، لأن ترميز MJPEG بالمعالج بطيء، وهذا لا يغير شيئاً في الصوت، لأن Movie Maker لا يرتبط بالزمن الحقيقي.
وهذا ما قاسه ffmpeg والسكربت من الملفين المسجلين:
--- mix-bug
L: 8.50 s at 48000 Hz peak +0.00 dBFS clipped samples 329 RMS -13.7 dBFS
R: 8.50 s at 48000 Hz peak +0.00 dBFS clipped samples 387 RMS -13.5 dBFS
I: -11.6 LUFS
Peak: 0.2 dBFS
--- mix
L: 8.50 s at 48000 Hz peak -1.00 dBFS clipped samples 0 RMS -20.9 dBFS
R: 8.50 s at 48000 Hz peak -1.00 dBFS clipped samples 0 RMS -20.9 dBFS
I: -18.4 LUFS
Peak: -1.0 dBFSوالقراءة كما يلي:
- دون مزج: 329 عينة في القناة اليسرى و387 في اليمنى وصلت إلى أعلى قيمة ممكنة في 16 بت، أي أنها قصت Clipped، والقمة الحقيقية +0.2 dBTP فوق الصفر. والعينات المقصوصة تسمع كتشوه خشن في لحظة اجتماع الأصوات، وهو بالضبط ما يحدث في الثانية 4.5.
- بعد المزج: لا توجد عينة مقصوصة، والقمة -1.0 بالضبط، وهي سقف المحدد HardLimiter الذي وضعناه على Master. ومن مخرج AudioServer في التشغيل الثاني نعرف أن حافلة SFX نفسها وصلت إلى +0.9 dB قبل المحدد، أي أن المحدد هو الذي منع التشوه في تلك اللحظة، وهذا دوره: شبكة أمان لا بديل عن المزج.
- المستوى: انخفض من -11.6 إلى -18.4 LUFS، أي سبعة ديسيبل تقريباً، لأننا خفضنا الموسيقى عشرة ديسيبل والمؤثرات أربعة. فإذا شعرت أن اللعبة أصبحت أهدأ مما تريد، فلا ترفع الحافلات من جديد، وإنما ارفع Master قليلاً واترك المحدد يحمي القمم، أو قلل الأصوات التي تجتمع.
والشكل التالي يبين الجولتين كما رسمهما ffmpeg من الملفين المسجلين بالمرشح showwavespic:

ولاحظ في الشكل أمراً ثانياً لا تقوله الأرقام: في الجولة الأولى الموسيقى عريضة تملأ نصف الارتفاع، فالأصوات تبرز فوقها قليلاً فقط، وفي الثانية الموسيقى خلفية رفيعة والأصوات واضحة فوقها. والقاعدة التي يعمل بها مصممو الصوت في الألعاب هي أن الصوت الذي يحمل معلومة للاعب، مثل القفز والالتقاط والخطر، يجب أن يسمع فوق الموسيقى دائماً، والموسيقى تحمل المزاج لا المعلومة. وأما من أين جاءت الأرقام -10 و-4، فمن الأذن ثم القياس: بدأنا بالموسيقى أخفض من المؤثرات، واستمعنا، ثم قسنا حتى اختفت العينات المقصوصة. ولا يوجد رقم صحيح لكل لعبة، ولكن يوجد قياس صحيح لكل رقم تختاره.
max_polyphony هي 1، أي أن كل استدعاء للدالة play() يقطع الصوت السابق ويبدأ من جديد، كما يذكر توثيق AudioStreamPlayer. وإذا رفعتها لتتداخل الأصوات، فتذكر أن كل صوت إضافي يرفع القمة، وأن عشر نسخ من الصوت نفسه في اللحظة نفسها هي أسرع طريق إلى التشوه، فاجعل لها حداً معقولاً واترك المحدد على Master.وفي Godot أيضاً المؤثر AudioEffectCompressor، وله خاصية sidechain تجعله يخفض حافلة بحسب مستوى حافلة أخرى، ويذكر توثيق AudioEffectCompressor أن هذا الأسلوب شائع في مزج الألعاب لخفض الموسيقى والمؤثرات عندما يتكلم صوت بشري، ويسمى Ducking. فإذا كانت لعبتك فيها حوار، فضع ضاغطاً على حافلة Music واجعل الحافلة الجانبية حافلة الحوار، فتنخفض الموسيقى وحدها كلما تكلمت شخصية.
الانتقال بين مقطعين Crossfade: لماذا يسقط الصوت في المنتصف؟
في جني التمر نريد أن تتغير الموسيقى عندما ينتهي النهار ويبدأ الليل، دون أن تتوقف الأولى فجأة وتبدأ الثانية من الصمت. والطريقة المعروفة أن تشغل المقطعين معاً، وتخفض الأول وترفع الثاني في الوقت نفسه، وهذا هو الانتقال المتداخل Crossfade. وأول ما يكتبه أغلب المطورين في Godot عقدة Tween تحرك الخاصية volume_db في خط مستقيم: الأول من 0 إلى -80، والثاني من -80 إلى 0، خلال ثلاث ثوان. والتجربة تفعل ذلك، ثم تفعل الطريقة الثانية التي تسمى القدرة المتساوية Equal Power، ونسجل الاثنتين بوضع Movie Maker:
func lab_crossfade() -> void:
var day := player("res://music/day.ogg", "Music")
var night := player("res://music/night.ogg", "Music")
day.stream.loop = true
night.stream.loop = true
night.volume_db = -80.0
day.play()
night.play()
stop_at = 7.0
var mode := "equal-power" if "--equal-power" in OS.get_cmdline_user_args() else "db-line"
print("crossfade mode: %s, from 2.0 s to 5.0 s" % mode)
await get_tree().create_timer(2.0, true, true).timeout
tween = create_tween().set_process_mode(Tween.TWEEN_PROCESS_PHYSICS)
if mode == "db-line":
tween.tween_property(day, "volume_db", -80.0, 3.0)
tween.parallel().tween_property(night, "volume_db", 0.0, 3.0)
else:
tween.tween_method(func(x: float) -> void:
day.volume_db = linear_to_db(cos(x * PI / 2))
night.volume_db = linear_to_db(sin(x * PI / 2)), 0.0, 1.0, 3.0)
set_physics_process(true)والفرق بين الطريقتين في سطرين: الأولى تحرك الديسيبل مباشرة، والثانية تحرك رقماً من 0 إلى 1، وتحسب منه قيمة الموجة لكل مقطع بالجيب تمام والجيب، ثم تحولها إلى ديسيبل بالدالة linear_to_db. ولاحظ أننا جعلنا المؤقت والـ Tween على خطوات الفيزياء، كما تعلمنا في مقال أول لعبة، حتى يكون التوقيت في التسجيل متطابقاً في كل تشغيل. وهذا مستوى القناة اليسرى في التسجيلين كل ربع ثانية، من الثانية 1.5 إلى 5.5:
--- fade-db
1.50- 1.75 s L -24.9 dB R -24.3 dB
1.75- 2.00 s L -26.0 dB R -26.0 dB
2.00- 2.25 s L -27.4 dB R -26.8 dB
2.25- 2.50 s L -35.4 dB R -35.4 dB
2.50- 2.75 s L -40.7 dB R -40.1 dB
2.75- 3.00 s L -48.6 dB R -48.6 dB
3.00- 3.25 s L -53.6 dB R -53.0 dB
3.25- 3.50 s L -59.1 dB R -59.1 dB
3.50- 3.75 s L -59.1 dB R -59.0 dB
3.75- 4.00 s L -55.0 dB R -55.0 dB
4.00- 4.25 s L -48.0 dB R -47.5 dB
4.25- 4.50 s L -42.4 dB R -42.3 dB
4.50- 4.75 s L -35.8 dB R -35.8 dB
4.75- 5.00 s L -29.2 dB R -29.2 dB
5.00- 5.25 s L -24.9 dB R -24.3 dB
5.25- 5.50 s L -26.0 dB R -26.0 dB
--- fade-ep
1.50- 1.75 s L -24.9 dB R -24.3 dB
1.75- 2.00 s L -26.0 dB R -26.0 dB
2.00- 2.25 s L -24.5 dB R -24.0 dB
2.25- 2.50 s L -24.6 dB R -24.6 dB
2.50- 2.75 s L -23.3 dB R -22.9 dB
2.75- 3.00 s L -23.5 dB R -23.5 dB
3.00- 3.25 s L -22.6 dB R -22.3 dB
3.25- 3.50 s L -23.1 dB R -23.0 dB
3.50- 3.75 s L -22.8 dB R -22.6 dB
3.75- 4.00 s L -23.3 dB R -23.2 dB
4.00- 4.25 s L -22.3 dB R -21.8 dB
4.25- 4.50 s L -23.9 dB R -23.9 dB
4.50- 4.75 s L -24.6 dB R -24.6 dB
4.75- 5.00 s L -25.6 dB R -25.6 dB
5.00- 5.25 s L -24.9 dB R -24.3 dB
5.25- 5.50 s L -26.0 dB R -26.0 dBوالقراءة كما يلي:
- قبل الانتقال وبعده: المستوى حول -25 dB في الطريقتين، موسيقى النهار قبل الثانية 2، وموسيقى الليل بعد الثانية 5.
- الخط المستقيم: المستوى ينزل مع بداية الانتقال حتى يصل إلى -59.1 dB في المنتصف، أي أقل من البداية بـ 33 dB، وهو قريب من الحد الذي يقول التوثيق إن الصوت لا يكاد يسمع عنده. والسبب أن المقطعين في منتصف الطريق كلاهما عند -40 dB، والأول ما زال ينزل والثاني لم يرتفع بعد. وما يسمعه اللاعب ثانية ونصف من الصمت تقريباً بين المقطعين، وهذا ليس انتقالاً متداخلاً، وإنما توقف ثم بداية.
- القدرة المتساوية: المستوى بقي بين -22.3 و-25.6 dB طوال الانتقال، فلا يوجد سقوط. والفكرة أن مجموع مربعي الجيب والجيب تمام يساوي واحداً دائماً، فإذا كان المقطعان مختلفين فإن مجموع قدرتيهما يبقى ثابتاً. ولاحظ أن المستوى ارتفع قليلاً في المنتصف، حوالي 2 dB، والسبب أن المقطعين ليسا مختلفين تماماً: كلاهما فيه الصوت الممتد نفسه على 110 هرتز، فيجتمعان ويقوي أحدهما الآخر. ومع مقطعين مختلفين تماماً يقل هذا الارتفاع، ومع نسختين من المقطع نفسه يكون الخط المستقيم في القيم الخطية أنسب.

والدرس العام هنا أوسع من الانتقال: الديسيبل مقياس لوغاريتمي، فالخط المستقيم فيه ليس خطاً مستقيماً في ما تسمعه. وإذا أردت أن تخفض صوتاً بهدوء حتى يختفي، فحرك الديسيبل في خط مستقيم، وهذا يبدو طبيعياً للأذن. وإذا أردت أن تنقل المستوى من صوت إلى آخر، فحرك القيمة الخطية وحولها إلى ديسيبل. ويحتوي Godot على النوع AudioStreamInteractive، ويصفه توثيق AudioStreamInteractive بأنه يجمع مقاطع موسيقية وجدول انتقالات بينها، فينتقل المحرك من مقطع إلى آخر بحسب القاعدة التي تحددها. فإذا كانت لعبتك فيها موسيقى تتغير كثيراً مع الأحداث، فهو أنسب من أن تكتب كل انتقال بيدك.
الصوت الذي له مكان: AudioStreamPlayer2D و3D
الأصوات حتى الآن بلا مكان، تسمع من السماعتين بالمستوى نفسه. ولكن الحجر الذي يسقط على يمين الشاشة يجب أن يسمع من اليمين، والمطر البعيد يجب أن يكون أهدأ من القريب. وهذا ما تفعله العقدتان AudioStreamPlayer2D وAudioStreamPlayer3D. والتجربة الأولى تشغل نغمة 440 هرتز في AudioStreamPlayer2D وتحركها من يسار الشاشة إلى يمينها في أربع ثوان، والثانية تشغلها في AudioStreamPlayer3D أمام الكاميرا ثم تبعدها كل نصف ثانية: 1 ثم 2 ثم 5 ثم 10 ثم 20 ثم 40 ثم 80 متراً. والنغمة تدور من إعدادات الاستيراد كما تعلمنا في القسم السابق. والمخرج للتجربة الأولى كان كما يلي:
AudioStreamPlayer2D: tone moves from x=0 to x=960 in 4 s, screen centre x=480, max_distance=2000 attenuation=1.0 panning_strength=1.0
0.00- 0.50 s L -19.4 dB R -23.3 dB
0.50- 1.00 s L -19.2 dB R -21.9 dB
1.00- 1.50 s L -19.1 dB R -20.7 dB
1.50- 2.00 s L -19.1 dB R -19.6 dB
2.00- 2.50 s L -19.6 dB R -19.1 dB
2.50- 3.00 s L -20.7 dB R -19.1 dB
3.00- 3.50 s L -21.9 dB R -19.2 dB
3.50- 4.00 s L -23.2 dB R -19.4 dBوالفرق بين السماعتين عند طرف الشاشة 3.9 dB فقط، اليسرى -19.4 واليمنى -23.3، ثم يتساويان في الوسط، ثم ينعكس الفرق في الطرف الآخر. وقد تتوقع أن الصوت في أقصى اليسار يختفي من السماعة اليمنى، ولكن الإعداد audio/general/2d_panning_strength في المشروع قيمته الافتراضية 0.5، ويذكر توثيق إعدادات المشروع أن هذه القيمة مضبوطة لسماعات الرأس، وأن القيمة 1.0 تكتم إحدى القناتين تماماً إذا كان الصوت إلى اليسار أو اليمين، وأن سماعات الغرفة قد تحتاج قيمة أقل لأن الفصل بين قناتيها أضعف. ولاحظ أن المستوى في الطرف الأقرب، -19.4، أقل قليلاً منه في الوسط، -19.1، لأن العقدة تضعف الصوت أيضاً كلما ابتعد عن مركز الشاشة، بحسب max_distance وattenuation، ومسافة 480 بكسل من أصل 2000 تأثيرها صغير.
والمخرج للتجربة الثانية كان كما يلي:
AudioStreamPlayer3D: unit_size=10 max_db=3 attenuation_model=0 (0 = inverse distance); distances [1.0, 2.0, 5.0, 10.0, 20.0, 40.0, 80.0] m, 0.5 s each
0.00- 0.50 s L -13.1 dB R -13.1 dB
0.50- 1.00 s L -13.0 dB R -13.0 dB
1.00- 1.50 s L -13.0 dB R -13.0 dB
1.50- 2.00 s L -15.9 dB R -15.9 dB
2.00- 2.50 s L -21.7 dB R -21.7 dB
2.50- 3.00 s L -27.5 dB R -27.5 dB
3.00- 3.50 s L -33.4 dB R -33.4 dBفي المخرج أعلاه لاحظ التالي:
- القناتان متساويتان: المصدر أمام الكاميرا مباشرة، فلا يميل إلى أي جهة.
- المسافات 1 و2 و5 أمتار: المستوى نفسه، -13.0 dB، والسبب الخاصية
max_dbوقيمتها 3، فهي بحسب توثيق AudioStreamPlayer3D الحد الأعلى لمستوى الصوت مهما اقترب المصدر. ودونها يصبح الصوت على بعد متر واحد أعلى بعشرين ديسيبل من الصوت على بعد عشرة أمتار، وهذا مزعج جداً في الألعاب. - من 10 إلى 80 متراً: المستوى ينخفض حوالي 6 dB مع كل ضعف للمسافة، من -15.9 إلى -21.7 إلى -27.5 إلى -33.4، وهذا هو نموذج المسافة العكسية Inverse Distance الافتراضي، والخاصية
unit_sizeتحدد المسافة التي يبدأ عندها هذا الانخفاض، فكلما كبرت سمع الصوت من أبعد. - لا يوجد حد للمسافة: على بعد 80 متراً ما زال الصوت -33.4 dB ويمزجه المحرك. ويقترح التوثيق الخاصية
max_distanceليتوقف المحرك عن مزج الأصوات البعيدة جداً فيوفر المعالج، وهذا مهم إذا كان في مشهدك عشرات المصادر.

والسؤال العملي: متى أستخدم 2D في لعبة ثنائية الأبعاد؟ في جني التمر الشاشة كلها المرحلة، فصوت الحجر يمكن أن يكون AudioStreamPlayer2D يسقط معه، فيسمعه اللاعب من الجهة التي يسقط فيها قبل أن يراه. وأما صوت القفز والالتقاط فيخص جامع التمر نفسه، واللاعب يتابعه دائماً، فيبقى AudioStreamPlayer بلا مكان. وفي لعبة تتحرك فيها الكاميرا مع اللاعب، كل صوت في العالم يكون 2D، والمستمع هو مركز الشاشة أو عقدة AudioListener2D إذا أردت غيره.
من أين تأتي بالأصوات؟ الرخص Licenses قبل الملفات
ولدنا كل أصوات المقال بأنفسنا لسبب واحد: حتى لا يبقى في اللعبة ملف لا نعرف من يملكه. وفي لعبة حقيقية لن تولد صوت مطر أو باب خشبي من موجات جيبية، وإنما تبحث عن تسجيلات جاهزة، وأشهر مكانين لذلك هما Freesound وOpenGameArt. والقاعدة الأولى قبل أن تنزل أي ملف: الرخصة هي التي تقرر ماذا تفعل به، لا أن الموقع مجاني.
ويشرح سؤال وجواب Freesound أن الموقع يسمح لمن يرفع الصوت أن يختار واحدة من ثلاث رخص من Creative Commons، وكانت هناك رخصة رابعة قديمة. والجدول التالي يلخصها بحسب شرح الموقع نفسه:
| الرخصة | ماذا تسمح لك | ماذا تطلب منك | في لعبة تبيعها |
|---|---|---|---|
| CC0 | كل شيء تقريباً: النسخ والتعديل والتوزيع والاستخدام التجاري دون إذن | لا شيء، ولكن لا تدع أنك صاحب الصوت | مسموح |
| CC BY 4.0 | الاستخدام والتعديل، ومنه الاستخدام التجاري | ذكر صاحب الصوت والرخصة ورابط المصدر | مسموح مع ذكر المصدر |
| CC BY-NC 4.0 | مثل CC BY، ولكن دون أي ربح | ذكر المصدر، وعدم الاستخدام التجاري | غير مسموح |
| Sampling+ | رخصة قديمة من أيام الموقع الأولى، يشرحها الموقع بأنها قريبة من CC BY-NC مع منع الإعلانات التجارية | ذكر المصدر | تجنبها |
والصيغة التي يقترحها Freesound لذكر المصدر بسيطة: اسم الصوت، ثم اسم صاحبه، ثم رابط الصوت، ثم اسم الرخصة. والمكان المعتاد لها في الألعاب شاشة الشكر Credits، وملف نصي يرافق اللعبة. وأسهل طريقة ألا تنسى أن تكتبها في اليوم الذي تنزل فيه الملف، في ملف CREDITS.md داخل المشروع، لا في اليوم الذي تنشر فيه اللعبة وأنت لا تذكر من أين جاء صوت الباب.
وأما سؤال وجواب OpenGameArt فيشرح رخصاً أكثر، لأن الموقع للرسوم والأصوات معاً، ومنها ملاحظة مهمة لمن ينشر لعبته في متجر: الرخص CC BY وCC BY-SA بحسب شرح الموقع لا تسمح بتوزيع العمل بطريقة فيها حماية رقمية DRM تمنع إعادة توزيعه، ولهذا أنشأ الموقع رخصته الخاصة OGA-BY، وهي مثل CC BY دون هذا الشرط. وفيه أيضاً رخصتا GPL 2.0 وGPL 3.0، ويذكر الموقع أنهما كتبتا للكود في الأصل، وأن تطبيقهما على الرسوم والأصوات في الألعاب لم يتضح بعد. فإذا كان الصوت متاحاً بأكثر من رخصة، فاختر أوضحها لحالتك، وغالباً تكون CC0 أو CC BY أو OGA-BY.
ويضيف Freesound نقطة لا يتوقعها كثيرون: صوت برخصة CC0 قد يكون جزءاً من أغنية مسجلة في نظام كشف المحتوى في YouTube، فإذا نشرت فيديو من لعبتك قد يصلك اعتراض على صوت مجاني تماماً، والموقع يذكر أن الصوت المعدل أقل عرضة لذلك من الصوت كما هو. وهذا سبب إضافي لأن تعالج الأصوات الجاهزة قليلاً، بتغيير طبقتها أو دمجها مع غيرها، بدل استخدامها كما نزلت.
ملفات المختبر وتشغيله
المختبر كله في مجلد lab، وفيه ملفان Dockerfile: الأول هو نفسه في مقالات المرحلة، ينزل Godot 4.7.2 الرسمي من صفحة الإصدار ويتحقق منه بالبصمة SHA512، والثاني في tools صغير على Alpine فيه ffmpeg وPython لتوليد الأصوات وقياسها، فلا تحتاج اللعبة نفسها شيئاً منهما. ومجلد game فيه المشروع والحافلات وسكربت المختبر، أما ملفات الصوت فلا توجد فيه، لأن run.sh يولدها في كل تشغيل:
echo "### 1. Make the sounds (Python), then encode the music to Ogg Vorbis and MP3 (ffmpeg)"
tools 'python3 tools/gen_sounds.py game && cd game/music &&
ffmpeg -hide_banner -loglevel error -y -i day.wav -c:a libvorbis -q:a 4 day.ogg &&
ffmpeg -hide_banner -loglevel error -y -i day.wav -c:a libmp3lame -b:a 128k day.mp3 &&
ffmpeg -hide_banner -loglevel error -y -i night.wav -c:a libvorbis -q:a 4 night.ogg && rm night.wav &&
cp day.wav day_pcm.wav && cp day.wav day_loop.wav && ls -l *.wav *.ogg *.mp3 | awk "{print \$5, \$9}"' | tee out-01-files.txt
echo "### 2. Import into Godot, change three import settings, import again"
godot 'godot --headless --import --path /game > /dev/null 2>&1
sed -i "s/^compress\/mode=2/compress\/mode=0/" /game/music/day_pcm.wav.import
sed -i "s/^edit\/loop_mode=0/edit\/loop_mode=2/" /game/music/day_loop.wav.import /game/sfx/tone.wav.import
godot --headless --import --path /game > /dev/null 2>&1ولاحظ في الخطوة الثانية أن تغيير إعدادات الاستيراد من سطر الأوامر هو تعديل ملفات .import نفسها ثم استيراد المشروع مرة أخرى، وهذا بالضبط ما يحدث عندما تغير الإعداد في لوحة Import في المحرر وتضغط Reimport، ولذلك ارفع ملفات .import مع الصوت إلى Git، ولا ترفع مجلد .godot. وبقية الملف تشغل التجارب التي رأيتها بالترتيب، وتحفظ مخرج كل منها في ملف out-*.txt، والتسجيلات في rec. وتشغله كله من مجلد lab بالأمر bash run.sh، ويأخذ بضع دقائق، أغلبها في ترميز الفيديو الذي لا نحتاجه أصلاً.
أخطاء شائعة وكيف تقرأ أعراضها
- تشوه خشن عندما تجتمع الأصوات: الحافلات كلها على 0 dB ولا يوجد محدد، فتتجاوز القمم الصفر كما رأينا في 716 عينة مقصوصة. اخفض الموسيقى والمؤثرات، وضع HardLimiter على Master.
- زر خفض الموسيقى في قائمة الإعدادات لا يخفض كل شيء: عقدة نسي أحد أن يغير حافلتها، فبقيت على Master. ابحث في المشروع عن كل AudioStreamPlayer وتأكد من الخاصية
bus. - نقرة كل دورة في الموسيقى: نقطة الدوران محسوبة في الكود، أو الملف نفسه لا ينتهي حيث يبدأ. اجعل الدوران من إعدادات الاستيراد، واستمع إلى لحظة العودة بسماعة رأس.
- صمت في منتصف الانتقال بين مقطعين: تحريك
volume_dbفي خط مستقيم. حرك القيمة الخطية بالجيب والجيب تمام، أو استخدم AudioStreamInteractive. - الصوت يتقطع ولا يكمل أبداً: استدعاء
play()في كل خطوة ما دام الشرط صحيحاً، فيبدأ الصوت من أوله في كل مرة. شغله مرة عند الحدث، من إشارة، لا في كل إطار. - الصوت في 3D مرتفع جداً عن قرب: رفعت
max_dbأو جعلتunit_sizeكبيراً جداً. والمخرج في المختبر يبين أن السقف هو الذي جعل المسافات القريبة بالمستوى نفسه. - حجم اللعبة كبير بسبب الصوت: موسيقى بصيغة WAV بلا ضغط. حولها إلى Ogg Vorbis، فثماني ثوان كانت 1.38 ميجابايت وأصبحت 35 كيلوبايت.
- صوت بلا رخصة واضحة: ملف من موقع ينقل الأصوات، لا تعرف صاحبه. ارجع إلى الصفحة الأصلية، أو استبدله بصوت CC0 أو بصوت تصنعه أنت.
أي صيغة وأي عقدة؟
| الصوت في لعبتك | الصيغة | العقدة والحافلة | والسبب |
|---|---|---|---|
| قفز والتقاط وضربات قصيرة | WAV بضغط QOA الافتراضي | AudioStreamPlayer على SFX | صغير بعد الضغط، وفكه أرخص من Ogg وMP3 |
| صوت قصير يتكرر بسرعة كبيرة | WAV بلا ضغط PCM | AudioStreamPlayer مع max_polyphony أكبر من 1 | الأرخص في الفك، وكان أسرع من QOA بثلاث مرات تقريباً |
| موسيقى تدور | Ogg Vorbis مع Loop من الاستيراد | AudioStreamPlayer على Music | أصغر بأربعين مرة من WAV، ودار دون نقرة |
| موسيقى تتغير مع الأحداث | Ogg Vorbis | AudioStreamInteractive | الانتقالات تعرف مرة واحدة في جدول |
| شيء في العالم يسقط أو يتحرك | WAV أو Ogg بحسب الطول | AudioStreamPlayer2D أو 3D على SFX | يميل بين السماعتين ويضعف مع المسافة |
| كلام الشخصيات | Ogg Vorbis | حافلة Voice، وضاغط بحافلة جانبية على Music | تنخفض الموسيقى وحدها عندما يتكلم أحد |
تطبيق عملي
- افتح مشروع جني التمر من مقال الفيزياء، وأضف ثلاث عقد AudioStreamPlayer على حافلة SFX، واربط صوت القفز بالإشارة
jumpedفي جامع التمر، وصوت الالتقاط بالإشارةpickedفي التمرة. - اجعل صوت الحجر AudioStreamPlayer2D ابناً لمشهد الحجر، وشغله من الإشارة
body_entered، ثم أسقط حجراً على يسار الشاشة وآخر على يمينها واستمع بسماعة رأس. - في التجربة
mixغير سقف المحدد إلى -3 dB وشغلها، وقارن القمة والمستوى بوحدة LUFS بما رأيناه، ثم غيره إلى 0 dB وانظر هل تظهر عينات مقصوصة. - أضف إلى التجربة
decodeملف Ogg Vorbis بالجودة 8 بدل 4، وقارن حجمه وزمن فكه، واستمع إلى الفرق إن وجدته.
حذف المختبر Cleanup
docker image rm godot-lab:4.7.2 audio-tools:1
rm -rf rec game/.godot game/music game/sfxالخلاصة Summary
- الصوت في Godot يمر من العقدة إلى حافلتها إلى Master، فافصل الموسيقى عن المؤثرات من أول يوم، وضع المؤثرات على الحافلات لا على كل صوت.
- Godot يضغط ملفات WAV افتراضياً بصيغة QOA، فأصبحت ثماني ثوان 285 كيلوبايت بدل 1.41 ميجابايت، وOgg Vorbis جعلها 35.7 كيلوبايت. وفك ثانية من أي صيغة كلف أقل من 4 أجزاء من الألف من الثانية، وكان MP3 الأبطأ في قياسنا.
- اجعل الدوران من إعدادات الاستيراد لا من الكود: نهاية الدوران المحسوبة بيدنا صنعت عينة خاطئة بقيمة 0.218 ونقرة كل ثماني ثوان مع QOA، واختفت مع إعداد الاستيراد.
- كل الحافلات على 0 dB دون محدد أعطت 716 عينة مقصوصة وقمة +0.2 dBTP ومستوى -11.6 LUFS، والموسيقى على -10 والمؤثرات على -4 مع HardLimiter أعطت صفر عينات مقصوصة وقمة -1.0 ومستوى -18.4 LUFS.
- الانتقال بتحريك
volume_dbفي خط مستقيم أسقط الصوت 33 dB في منتصفه، والقدرة المتساوية أبقته بين -22.3 و-25.6 dB. - AudioStreamPlayer2D فرق بين السماعتين 3.9 dB عند طرف الشاشة بالإعداد الافتراضي، وAudioStreamPlayer3D أبقى المستوى ثابتاً حتى 5 أمتار بسبب
max_dbثم خفضه 6 dB مع كل ضعف للمسافة. - الرخصة قبل الملف: CC0 دون شروط، وCC BY مع ذكر المصدر، وCC BY-NC لا تصلح للعبة تبيعها.
وبهذا يكون في جني التمر صورة وحركة وصوت، وفي المقال التالي من هذه المرحلة بإذن الله نضيف الواجهة والنص العربي، ثم نصدر اللعبة إلى الويب والجوال وسطح المكتب:
دليلالفيزياء والتصادم والتحكم Input في لعبة 2Dنبني لعبة منصات صغيرة في Godot 4 ونقيس في مختبر دون شاشة كيف تتصرف الأجسام والطبقات وخطوة الفيزياء ويد التحكم، ولماذا تعبر الرصاصة السريعة الجدار وما الذي يوقفها.
دليلالنص العربي في واجهة اللعبة: RTL والخطوطنبني قائمة عربية للعبة في Godot 4 ونتتبع النص من ملف الترجمة إلى الشاشة: الخط والتشكيل واتجاه الواجهة والنص المختلط وصيغ الجمع، بلقطات حقيقية للخطأ والصحيح.
دليلتصدير اللعبة من Godot إلى الويب والجوال وسطح المكتبماذا يحدث فعلاً عند تصدير لعبة Godot، ولماذا تحتاج نسخة الويب Headers خاصة أحياناً، وما تطلبه كل منصة ومتجر، مع مختبر يصدر لعبة واحدة إلى خمس منصات.
دليلأول لعبة مع Godot: المشاهد والعقد وGDScriptنبني لعبة صغيرة كاملة في Godot 4 من ثلاثة مشاهد وأربعة سكربتات، ونفهم بها العقد والمشاهد والإشارات وحلقة اللعبة، ثم نشغلها في مختبر يلعبها فيه روبوت حتى تنتهي.
دليلكيف تعمل اللعبة من الداخل؟ حلقة اللعبة Game Loopلماذا تتحرك الشخصية بالسرعة نفسها على شاشة 144 هرتز وحاسوب بطيء: نبني حلقة اللعبة من الصفر حتى الخطوة الثابتة والاستيفاء، ونقيس كل طريقة في مختبر.سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتوليد الأصوات بـ Python وترميزها بـ ffmpeg 6.1.2، وتشغيل التجارب على Godot 4.7.2 في Docker، وتسجيل الصوت بوضع Movie Maker وقياسه بالمرشح ebur128.