Unreal Engine-də Python avtomatlaşdırması: redaktor iş axınına giriş

Bu bələdçidə nə öyrənəcəksiniz?

Unreal Editor-da Python-u aktivləşdirməyi, sadə skripti işə salmağı və müxtəlif avtomatlaşdırma üsulları arasından işinizə uyğun olanı seçməyi öyrənəcəksiniz. Epic Games-in sənədlərində Python dəstəyi eksperimental kimi qeyd olunur və xüsusilə məhsul buraxılışı zamanı ehtiyatlı olmaq tövsiyə edilir. Buna görə burada izah edilən istifadə sahəsi oyun işləyərkən icra olunan oynanış kodu deyil, redaktor daxilində istehsal və məzmun idarəetmə tapşırıqlarıdır.

Python müxtəlif 3D tətbiqlərini birləşdirən istehsal proseslərində ümumi skript dili kimi istifadə oluna bilər. Unreal Editor-da da aktivlərin idarə olunması iş axınlarını avtomatlaşdırmaq, Static Mesh-lər üçün LOD yaratmaq kimi vaxt aparan işləri görmək, səviyyə məzmununu prosedurla yerləşdirmək və redaktora məxsus interfeyslər hazırlamaq mümkündür. Bunlar sənədlərdə göstərilən istifadə nümunələridir; hər layihə üçün hazır avtomatlaşdırmanın mövcud olduğu anlamına gəlmir.

Tələblər və layihənin hazırlanması

Python imkanları Unreal Editor-dakı Python Editor Script Plugin vasitəsilə təmin edilir. Plugin layihə səviyyəsində aktivləşdirilməlidir; onun bir layihədə aktiv edilməsi digər layihələrə avtomatik tətbiq olunmur. Epic Games ümumi redaktor tapşırıqları üçün sadələşdirilmiş API-lər təqdim edən Editor Scripting Utilities plugin-inin də aktivləşdirilməsini tövsiyə edir.

Redaktor plugin-lə birlikdə gələn Python 3.11.8 versiyasından istifadə edir. Buna görə yalnız Unreal Editor-da skript işlətmək üçün kompüterə ayrıca Python quraşdırmaq lazım deyil. Fərqli Python versiyasını daxilə yerləşdirmək istəyənlər əməliyyat sistemində UE_PYTHON_DIR mühit dəyişənini təyin etməli və Unreal Engine-i mənbə kodundan yenidən kompilyasiya etməlidirlər; bu, başlamaq üçün zəruri addım deyil.

Addım-addım: Python-u aktivləşdirin və ilk skripti işə salın

1. İstifadə edəcəyiniz Unreal layihəsini açın. Əsas menyudan Edit > Plugins yolunu seçin.

2. Plugins pəncərəsində Scripting bölməsini tapın və Python Editor Script Plugin seçimini aktivləşdirin. Epic Games-in tövsiyəsinə əsasən Editor Scripting Utilities plugin-ini də aktivləşdirə bilərsiniz.

3. Unreal Editor-ı yenidən başladın. Plugin-i aktivləşdirmək kifayət deyil; skript işlətməzdən əvvəl redaktoru yenidən başlatmaq lazımdır.

4. İlk sınaq üçün Output Log panelini açın və konsol girişini Python rejiminə keçirin. Konsolu tərs dırnaq () düyməsi ilə də açmaq olar. Bu rejimdə daxil edilən Python sətirləri dərhal icra olunur; bir neçə sətir üçün **Shift + Enter** istifadə edilə bilər. print` çıxışları da Output Log panelində göstərilir.

5. Fayldan skript işlətmək üçün əsas menyudakı File > Execute Python Script seçimini seçərək kompüterdəki skript faylını göstərin. Əvvəllər işlədilmiş faylları Recent Python scripts siyahısından yenidən başlada bilərsiniz. Siyahı skriptin fayldakı ən son versiyasını oxuyur.

Konsol adi komanda rejimində olarkən py əmri ilə Python sətrini və ya faylını da işlətmək olar. Sənədlərdəki fayl nümunəsi belədir:

py "C:\MyScripts\my_script.py"

Bu nümunədəki yolu işə salınacaq skriptin yerləşdiyi yol ilə əvəz edin. Skript əlavə komanda sətri arqumentləri gözləyirsə, onları fayl adından sonra göstərmək mümkündür.

Təkrarlanan işlərin avtomatlaşdırılması

Skriptin hər açılışda işləməsini istəyirsinizsə, iki üsul mövcuddur. Layihəyə məxsus Project Settings bölməsində, Plugins > Python altındakı Startup scripts parametrinə skriptləri əlavə edə bilərsiniz. Unreal Editor bu skriptləri standart başlanğıc səviyyəsi tam yükləndikdən sonra işə salır. Dəyişikliklərdən sonra redaktoru yenidən başladın; skriptlər layihənin növbəti açılışında işə düşəcək.

Digər üsul layihə və ya plugin daxilindəki Content/Python qovluğuna init_unreal.py adlı fayl yerləşdirməkdir. Redaktor konfiqurasiya edilmiş yollardan birində bu adda skript tapsa, onu avtomatik işə salır. Epic Games bu yanaşmanı eyni məzmunla işləyən şəxslərin redaktorun hər başlanğıcında ortaq başlanğıc kodunu icra etməli olduğu hallar üçün izah edir.

Komanda sətri təkrarlana bilən əməliyyatlar və ya interfeys açmadan işlətmək üçün seçimlər təqdim edir. Tam redaktor üsulu layihəni və standart başlanğıc səviyyəsini yüklədikdən sonra skripti işə salır; sənədlərə görə bu üsul üçün hər iki müvafiq plugin layihədə aktiv olmalıdır. Komanda sətiri üsulu isə başsız işləyə və daha sürətli ola bilər. Ancaq səviyyələri özü yükləmir; skriptin səviyyə məzmununa ehtiyacı varsa, yükləmə addımı ayrıca nəzərə alınmalıdır. Hər iki komanda sətri yanaşmasında skript icra olunduqdan sonra Unreal Editor bağlanır.

Blueprint istifadə edən komandalar Python icra düyünlərindən də yararlana bilər; lakin bu düyünlər yalnız Editor Utility Widget və Editor Utility Blueprint kimi redaktora məxsus siniflərdə mövcuddur. Sənədlərdə Blueprint daxilindən Python çağırmaq üçün Execute Python Script düyünündən istifadə tövsiyə edilir. Bu düyündəki girişlər skript işə salınmazdan əvvəl oxuna, çıxışlar isə icradan sonra təyin edilə bilər. Uğur vəziyyəti Return Value çıxışından izlənir; xətaların təfərrüatları Output Log-da göstərilir. Bu düyün fayl işə salmır, Python sətirlərini icra edir.

Tez-tez rast gəlinən xətalar və məhdudiyyətlər

Ən vacib fərq redaktor avtomatlaşdırması ilə oyunun iş vaxtı arasındadır. Python mühiti Unreal Editor-da istifadə oluna bilər; Play In Editor (PIE), Standalone Game və paketlənmiş icra fayllarında istifadə edilə bilməz. Buna görə Python oynanış skript dili kimi nəzərdən keçirilməməlidir.

Digər geniş yayılmış problem plugin-in yalnız başqa bir layihədə aktivləşdirilməsidir. Hər layihə üçün onu ayrıca aktivləşdirmək və redaktoru yenidən başlatmaq lazımdır. Komanda sətri ilə işləyən skriptlərin səviyyəni avtomatik yükləyəcəyini fərz etmək də xətaya səbəb ola bilər. Həmçinin skript Blueprint düyünündə uğursuz olarsa, xəta mesajı üçün Output Log yoxlanmalıdır.

Növbəti addımlar: memarlıq və vizuallaşdırma iş axınları

Memarlıq, interyer dizaynı və archviz komandaları üçün Python Unreal Editor-da təkrarlanan məzmun idarəetmə işlərini azaltmaq və müxtəlif 3D tətbiqlərinin daxil olduğu istehsal proseslərini birləşdirmək potensialına malikdir. Məsələn, komandaların öz aktiv idarəetmə mərhələlərini və ya səviyyəyə məzmun yerləşdirmə proseslərini avtomatlaşdırması sənədlərdə göstərilən istifadə sahələrinə uyğundur. Bu, müəyyən BIM idxalının və ya konkret proqram təminatı ilə uyğunluğun təmin edildiyi demək deyil; inteqrasiya layihənin məzmununa uyğun qurulmalıdır.

İlk mərhələdə əhatə dairəsi aydın olan və redaktor daxilində yoxlana bilən kiçik bir iş seçin, sonra skripti konsoldan və ya Execute Python Script vasitəsilə sınaqdan keçirin. Daha sonra əməliyyat təkrarlanırsa, başlanğıc skriptlərinə və ya komanda sətri ilə işə salmağa keçin. Python dəstəyinin eksperimental olması barədə xəbərdarlığı, plugin-in layihə üzrə aktivləşdirilməsi tələbini və oyun iş vaxtında istifadə edilə bilməməsini istehsal planınıza daxil edin. Unreal Python 5.8 API sənədləri mövcud API bölmələrini və növlərini araşdırmaq üçün istinad mənbəyidir.

Mənbə və lisenziya

Bu bələdçi Epic Games-in Scripting the Unreal Editor using Python təlimatı və Unreal Python 5.8 API Documentation səhifəsi əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər iki mənbə Epic Games-in rəsmi sənədləridir.