هذه الصفحة مترجمة من الإنجليزية. إذا اختلفت النسختان، فالصفحة الإنجليزية هي الصحيحة. اقرأ الصفحة الإنجليزية
يوفّر Godot لغتين، ولدى Lingara حزمة لكل منهما. تستخدم لعبة GDScript إضافة Lingara. وتستخدم لعبة Godot بلغة C# الحزمة Lingara.Embed، وهي الحزمة نفسها التي تستخدمها لعبة Unity. استخدم إحداهما أو الأخرى في المشروع، ولا تستخدمهما معًا أبدًا. تعرض علامات التبويب أدناه كلًّا منهما.
التثبيت
GDScript. ثبّت إضافة Lingara من Godot Asset Library، ثم فعّلها من Project Settings، ضمن Plugins. يضيف تفعيلها تحميلًا تلقائيًا (autoload) باسم Lingara، يصل إليه كل مشهد عند /root/Lingara.
C#. أضِف Lingara.Embed إلى مشروعك كمرجع حزمة. العقدة النموذجية أدناه، LingaraEmbedNode، ليست جزءًا من الحزمة: أضِف شيفرتها المصدرية إلى مشروعك وضعها في مشهد.
احصل على الرموز من خادمك
لا تحتفظ أيّ من الحزمتين بسرّ. عندما تحتاج النواة إلى رمز، تطلبه من خادمك أنت، فيُصدر رمزًا باستخدام حزمة خادم ويجيب بالرمز وموعد انتهاء صلاحيته.
مع الإضافة، عيّن مسار الرموز في خادمك ضمن Project Settings، فتستدعيه Lingara على خيطها الخاص. إذا كان المسار يحتاج إلى جلسة اللاعب، فعيّنه وقت التشغيل بدلًا من ذلك، لأن إعدادات المشروع تُشحن داخل ملف التصدير. أو اربط token_needed وأجب عن كل طلب بنفسك. مع C#، ترسل العقدة النموذجية طلبًا إلى مسار الرموز كلما طلب العميل رمزًا. وفي الحالتين، أبلغ عن الفشل باستخدام token_unavailable أو TokenUnavailable، حتى تفشل الاستدعاءات المنتظرة فورًا.
عالج الأحداث في كل إطار
تشغّل النواة عمليات الإدخال والإخراج الشبكية على خيطها الخاص. يُفرغها التحميل التلقائي للإضافة مرة واحدة في كل إطار ويبثّ إشارة واحدة لكل حدث، فتربط الإشارات التي تحتاجها لعبتك ولا تُفرغ أي شيء بنفسك أبدًا. تُفرغ عقدة C# الأحداث في _process، بحد أقصى 256 حدثًا في الإطار، وتعيد بثّ كل منها على شكل إشارة Godot.
تحمل الإشارات نفسها ردود NPC المتدفّقة (انظر حوار NPC) وتحديثات التدريب (انظر نتائج التدريب).