تحديد المشكلات

جمع الوسائط للاختبار

الخطوة الأولى في أي عملية للإبلاغ عن الأخطاء هي جمع دليل على وجود خلل ما. فالرسائل البسيطة مثل “مرحبًا، هذه اللعبة لا تعمل” لا تفيد فريق الصيانة لدينا. ولإصلاح المشكلة بكفاءة، نحتاج إلى ثلاثة أشياء في كل مرة:

• فيديو يُظهر حدوث الخطأ. نحن نتفهم أنه لا يمكنك تصوير التأثير الخاطئ على لوحة المفاتيح، لكن فيديو لطريقة اللعب سيكون كافيًا.
• وصف للإجراءات التي تسببت في الخطأ. يُرجى أن تكون مفصّلًا قدر الإمكان، فحتى التفاصيل الصغيرة يمكن أن تساعدنا في تحديد مصدر المشكلة بسرعة.
• دقة الشاشة التي تلعب عليها. بدون هذه المعلومة، يتعين على مطورينا التحقق من كل دقة ندعمها للعثور على المشكلة، وهو ما قد يستغرق وقتًا طويلًا.

إذا كنت منشئ Lightscript غير تابع لشركتنا بشكل مباشر، فإن هذه الخطوات البسيطة ستساعدك أيضًا كثيرًا في شيفرتك الخاصة. فالتوثيق الشامل، إلى جانب فهم بنية الشيفرة، يجعل تحديد المشكلات عملية مباشرة.

إذا كنت من محبي اللعبة وتحاول إجراء الصيانة بنفسك، فاحرص على إرسال لقطات من طريقة اللعب تظهر فيها المشكلة. فقد نتمكن من تسريع إصلاحك!

تحديد المشكلات

عادةً ما يكون من السهل ملاحظة أخطاء التكامل - فإذا لم يُشغَّل التأثير أبدًا أو شُغِّل كثيرًا، فمن الواضح أن هناك خللًا ما. الجزء الصعب هو تحديد القسم الدقيق من الشيفرة المسبب للمشكلة. ابدأ دائمًا بتحديد المشكلة باتباع الخطوات الموضحة في القسم السابق، فهذا سيوفر لك أوضح مسار للمتابعة. فيما يلي عملية مقترحة لإصلاح الأخطاء:

• تحقق من سجل وحدة التحكم (Console Log):

  • هل نحصل على أي سجلات في وحدة التحكم تحدد المشكلة؟ من المشكلات الشائعة هنا المتغيرات غير المُعرَّفة، والكلمات المكتوبة بشكل خاطئ، ونطاقات رسم العدّادات أو الأشكال غير الصحيحة. لن يكتشف SignalRGB حالات تجاوز سعة المكدّس (stack overflow)، لكن من السهل ملاحظتها: سيتعطل SignalRGB أولًا، ثم جهاز الكمبيوتر الخاص بك. كن مبرمجًا مسؤولًا وتجنب جعل تطبيقك يعدّ إلى ما لا نهاية.

• تحقق من العدّادات:

  • هل يُشغّل التأثير عدّاداتك في Meter Inspector أثناء اللعب؟ إذا كان كذلك، فيجب أن ترى اللون الأبيض يظهر في المنطقة السوداء أسفل عرض العدّاد.
    • إذا كان العدّاد في غير موضعه الصحيح، فاستخدم أداتنا الخاصة (WindowSpy) لأخذ قياسات الشاشة وضبط موضع العدّاد في قسم **<head>**.
    • إذا أدى ذلك إلى إصلاح المشكلة، فتذكّر ضبط العدّاد لكل دقة أخرى في قسم الضبط. يمكنك العثور على تعليمات حول وضع العدّادات والإحداثيات المُسوّاة في قسم “Smart Tags” من هذا المستند.
    • إذا كانت العدّادات تعمل بشكل صحيح، فإن المشكلة تكمن في مكان آخر.

• تحقق من دالة Update:

  • هل تُمرَّر بيانات العدّاد بشكل صحيح إلى صنف Meter؟
    • هل أدرجت تحديثات شرطية لـ Meter لمراعاة السلوك المعقد لواجهة المستخدم؟
    • إذا بدا كل شيء جيدًا، فضع console.log مباشرة داخل دالة الاستدعاء الراجع. يجب أن يُطبع السجل في كل مرة يستقر فيها العدّاد، حتى لو لم يُشغَّل التأثير بشكل صحيح.
    • إذا ظهر السجل باستمرار، فإن المشكلة تكمن في مكان آخر.

• قيّم دالة الاستدعاء الراجع:

  • نحن نعلم أن دالة الاستدعاء الراجع تُفعَّل بشكل صحيح لأننا رأينا السجلات سابقًا. الآن، راجع العبارات الشرطية داخل التأثير للتأكد من دقتها.
    • إذا لم يبدُ أي شيء خاطئًا بشكل واضح، فأضف عبارات console.log داخل العبارات الشرطية لمعرفة ما إذا كان أي منها يُشغَّل بشكل خاطئ أثناء اللعب.
    • إذا بدا كل شيء على ما يرام، فقد تكون المشكلة داخل التأثير نفسه.

• تحقق من دالة الرسم المتحرك للتأثير:

  • يمكن أن تتباين دوال الرسوم المتحركة بشكل كبير، لذا لا توجد نصيحة واحدة تناسب الجميع. ومع ذلك، لتصحيح الأخطاء بكفاءة:
    • انقل التأثير إلى قالب Lightscript فارغ، وتحقق من أنه يمكنك تفعيله لعرض الرسم المتحرك في SignalRGB.
    • انتبه إلى وحدة التحكم ولاحظ أين يتعطل الرسم المتحرك.
    • سيوفر لك عزل الشيفرة المسببة للمشكلة الوقت، لذا احرص على اتباع هذه الخطوة.