عرض مصدر Godot/best practices/autoloads versus internal nodes

<noinclude>{{DISPLAYTITLE:الاختيار ما بين التحميل التلقائي والعقد العادية في جودو}}</noinclude>

يقدم جودوت ميزة تحميل العقد تلقائيًا في جذر المشروع، ويسمح لك بالوصول إليهم بشكل عام global، وتحمل هذه العقد مسؤولية واحدة [[Godot/scripting/singletons autoload|singleton]]، ولا تحرر هذه العقد المحملة تلقائيًا عندما تغير المشهد من الشيفرة البرمجية باستخدام [[Godot/scripting/scene tree|SceneTree.change_scene_to_file]]

سنتعلم هنا عن ميزة التحميل التلقائي Autoload والتقنيات التي يمكنك استخدامها لتفاديها.

== مشكلة قطع الصوت ==
تشجع المحركات الأخرى إنشاء أصناف للإدارة، أي متفردات singletons تنظم العديد من الميزات في كائن يمكن الوصول إليه بشكل عام، وتقدم جودو العديد من الطرق لتفادي الحالة العامة global بفضل شجرة العقد node tree والإشارات signals.

مثلًا، لنقل أننا نريد بناء لعبة تخطي عقبات ونريد جمع نقود تعطي تأثير صوتي عند تجميعها، هناك عقدة لذلك وهي AudioStreamPlayer، ولكن إذا استدعينا <code>AudioStreamPlayer</code> عندما نشغّل الصوت، سيقاطع الصوت الجديد الصوت الأول.

واحدة من الحلول هي كتاية شيفرة صنف إدارة صوت عام ومحمل تلقائيًا. تُنشئ مجمّع عقد <code>AudioStreamPlayer</code> يتم دورته كل مرة يُطلب فيه التأثير الصوتي. نسمي هذا الصنف <code>Sound</code>، ويمكنك استخدامه في أي مكان في المشروع الخاص بك باستدعاء <code>Sound.play("coin_pickup.ogg")</code>. يحل ذلك المشكلة على المدى القصير ولكنه يسبب مشاكل أخرى:

# '''الحالة العامة''': الآن يوجد كائن واحد مسؤول عن كل بيانات الكائن. إذا كان لدى الصنف <code>Sound</code> أخطاء أو ليس لديه <code>AudioStreamPlayer</code> متوفر، يمكن أن تتعطّل كل العقد التي تستدعيه.
# '''الوصول العام''': الآن يستطيع أي كائن استدعاء <code>Sound.play(sound_path)</code> من أي مكان ولا يوجد طريقة سهلة لمعرفة أصل الخطأ
# '''تخصيص الموارد العام''': بوجود مجمع عقد <code>AudioStreamPlayer</code> مخزنة من الأول يمكن إما أن يكون لديك عدد قليل وتواجه أخطاء أو عدد كبير و تستهلك ذاكرة أكثر من اللازم.

<blockquote>'''ملاحظة''': المشكلة في الوصول العام هي أنه يمكن لأي شيفرة في أي مكان تمرير بيانات خاطئة إلى المحمل التلقائي Sound كما في مثالنا. نتيجة لذلك تصبح عملية الكشف عن الأخطاء ومعالجتها عملية تتطلّب النظر إلى كامل المشروع.

سيتدخل فقط سكربت واحد أو اثنين في الصوت عندما تحافظ على الشيفرة داخل المشهد.</blockquote>قارن السابق مع كل مشهد يحتفظ بعدد عقد <code>AudioStreamPlayer</code> يحتاجها في داخله وكل هذه المشاكل ستُحلّ:

# يدير كل مشهد حالة المعلومات الخاصة به، تحصل المشاكل في هذا المشهد فقط إذا كان هناك مشاكل في البيانات.
# يستطيع كل مشهد الوصول إلى العقد الخاصة به فقط، الآن إذا كان هناك مشكلة من السهل إيجاد العقدة التي فيها مشكلة
# يحدد كل مشهد الموارد اللازمة له

== إدارة الوظائف المشتركة أو البيانات ==
سبب آخر لاستخدام المحمل التلقائي هو أنه نريد إعادة استخدام نفس التوابع أو البيانات على العديد من المشاهد.

يمكن استخدام نوع جديد من <code>Node</code> التي تؤمن ميزة لمشهد ما باستخدام الكلمة المفتاحية [[Godot/scripting/gdscript/gdscript basics|class_name]] في GDScript في حالة الدوال.

أما بالنسبة للبيانات فيمكنك:

# إنشاء نوع جديد Resource لمشاركة البيانات.
# تخزين البيانات في كائن تستطيع كل عقدة الوصول إليه، مثلًا استخدام الخاصية <code>owner</code> للوصول إلى العقدة الجذر للمشهد.

== متى يجب استخدام التحميل التلقائي ==
تدعم GDScripts إنشاء دوال <code>static</code> باستخدام <code>static func</code>يسمح ذلك بإنشاء مكتبة دوال مساعدة بدون الحاجة لإنشاء نسخة لاستدعائهم عندما تُجمع مع <code>class_name</code>، إلا أنه من محدوديات الدوال الساكنة هو أنها لا تستطيع أن تُرجع متغيرات العناصر أو الدوال غير الساكنة أو <code>self</code>.

من إصدار جودوت 4.1 وما بعد، تدعم GDScripts أيضًا المتغيرات <code>static</code> باستخدام <code>static var</code>، أي يمكنك الآن مشاركة المتغير عبر نسخ الصنف بدون الحاجة لإنشاء محمل تلقائي آخر.

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

كنتيجة يمكنك الحصول على العقدة المحملة تلقائيًا، كالعقدة المحملة تلقائيًا <code>Sound</code> مثلًا، وذلك باستدعاء <code>get_node("/root/Sound")</code>.</blockquote>
== مصادر ==
* [https://docs.godotengine.org/en/stable/tutorials/best_practices/introduction_best_practices.html صفحة Best Practices في توثيق جودو الرسمي.]
[[تصنيف:Godot|{{SUBPAGENAME}}]]
[[تصنيف:Godot Best Practices|{{SUBPAGENAME}}]]