Unreal Engine Pixel Streaming quraşdırılması: Layihəni brauzerə ötürmək

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

Unreal Engine Pixel Streaming tətbiqin görüntü və səsini uzaqdakı cihaza ötürməklə yanaşı, həmin cihazdan giriş qəbul etməyə də imkan verir. Beləliklə, Unreal Engine layihəsinə veb səhifədə baxmaq mümkündür; masaüstü və ya mobil cihazdakı istifadəçilər klaviatura, siçan və ya toxunma girişi ilə tətbiqlə qarşılıqlı əlaqə qura bilərlər. Brauzer tərəfdə əlavə proqram quraşdırmaq tələb olunmur.

Bu bələdçidə layihənin yayım üçün hazırlanması, server komponentlərinin işə salınması və eyni lokal şəbəkədəki brauzerdən qoşulma izah edilir. Epic Games-in ilkin təlimatı nümunələri Windows üzərindən göstərir; Linux və Mac üçün server skriptlərinin başqa qovluqda yerləşdiyini bildirir.

Tələblər və hazırlıq

Pixel Streaming plagini video kodlamanı Windows, Linux və ya Mac əməliyyat sistemli kompüterlərdə, dəstəklənən müəyyən GPU avadanlıqları ilə həyata keçirə bilər. Mənbə təlimatı uyğun avadanlıq növləri barədə ətraflı məlumat üçün Pixel Streaming Reference sənədinə yönləndirir. Burada konkret GPU modelləri sadalanmadığına görə, yayım öncəsi uyğunluq ayrıca yoxlanmalıdır.

Lokal şəbəkədə ilkin quraşdırma üçün 80 və 8888 nömrəli şəbəkə portları əlaqə üçün açıq olmalıdır. Kompüterdə başqa veb serverlər işləyirsə, təlimat quraşdırmaya başlamazdan əvvəl onları dayandırmağı tövsiyə edir. İnternet üzərindən və ya müxtəlif şəbəkələr arasında qoşulmaq üçün əlavə şəbəkə konfiqurasiyası lazım ola bilər. İlk sınağı eyni kompüterdə localhost və ya 127.0.0.1 ünvanı ilə etmək daha sadə başlanğıc imkanı yaradır.

Təlimatda istifadəçi hesabı tələbindən bəhs edilmir. Server infrastrukturu Epic Games-in GitHub-dakı Pixel Streaming Infrastructure deposundan əldə edilir. Layihə paketlənmiş tətbiq kimi və ya Unreal Editor daxilində Standalone Game seçimi ilə başladılmalıdır; plaginin istifadəsi bu iki işə salma üsulu əsasında izah olunur.

Quraşdırma: layihəni və serverləri hazırlamaq

1. Layihəni Unreal Editor-da açın. Əsas menyudan Edit > Plugins yolunu seçin; Graphics kateqoriyasında Pixel Streaming və ya Pixel Streaming 2 plaginini aktivləşdirib layihəni yenidən başladın. Personaj olan layihədə mobil toxunma nəzarəti lazımdırsa, Edit > Project Settings altında Engine > Input kateqoriyasındakı Always Show Touch Interface seçimindən istifadə etmək olar. Bu ayar məcburi deyil; personajın Player Controller komponenti də toxunma girişini dəstəkləməlidir.

2. Layihənin işə salınma parametrini təyin edin. Edit > Editor Preferences... menyusunda Level Editor > Play kateqoriyasındakı Additional Launch Parameters sahəsinə lokal qoşulma ünvanını əlavə edin:

-PixelStreamingURL=ws://127.0.0.1:8888

Bu parametr tətbiqin qoşulacağı Pixel Streaming serverinin ünvanını göstərir. Layihəni Windows üçün paketləyirsinizsə, Unreal Editor menyusunda Files > Package Project > Windows (64-bit) yolunu seçin və çıxış qovluğunu göstərin. Tətbiq hər dəfə başladıldıqda eyni parametr ötürülməlidir. Təlimatda parametrin işəsalma qısayolunun Target sahəsinə əlavə edilməsi seçimi də izah olunur.

1. Pixel Streaming server komponentlərini əldə edin. Təlimatda infrastrukturun birbaşa GitHub deposundan endirilə biləcəyi və ya seçdiyiniz terminalda aşağıdakı əmrdən istifadə edilə biləcəyi bildirilir. Nümunədəki UEX.Y yerinə istifadə ediləcək budağın adı yazılır; sənəddə nümunə olaraq 5.7 göstərilir.

git clone --branch UEX.Y https://github.com/EpicGamesExt/PixelStreamingInfrastructure.git

Alternativ olaraq Unreal Engine quraşdırılmasındakı \Engine\Plugins\Media\PixelStreaming\Resources\WebServers qovluğuna keçib Windows-da .bat, Linux və ya Mac-də isə .sh uzantılı get_ps_servers skriptini işə sala bilərsiniz. Bu əməliyyat müvafiq infrastruktur budağını qovluğa endirir.

1. Windows nümunəsində endirilmiş infrastrukturun SignallingWebServer qovluğundakı quraşdırma skriptini administrator kimi açılmış PowerShell-də işə salın:

SignallingWebServer\platform_scripts\cmd\setup.bat

Quraşdırma tamamlandıqdan sonra eyni qovluq strukturundakı serveri başlatma skriptini işlədin:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

Linux və Mac-də təlimatda SignallingWebServer\platform_scripts\bash qovluğundakı skriptlərdən istifadə olunacağı bildirilir. Server hazır olduqda konsolda 8888 nömrəli portda yayımçı bağlantısı, 80 nömrəli portda oyunçu bağlantısı və HTTP xidməti ilə bağlı dinləmə mesajları görünməlidir.

Tətbiqi işə salmaq və brauzerdən qoşulmaq

Serverlər işləyərkən paketlənmiş tətbiqi Pixel Streaming qoşulma ünvanı parametri ilə başladın. Nümunə əmr:

MyPixelStreamingApplication.exe -PixelStreamingURL=ws://127.0.0.1:8888

MyPixelStreamingApplication.exe nümunə fayl adıdır; öz paketlənmiş tətbiqinizin adından istifadə edin. Tətbiq serverə qoşulduqda server konsolunda Streamer connected mesajının görünməsi gözlənilir.

Eyni kompüterdə dəstəklənən brauzeri açıb http://127.0.0.1 ünvanına keçin. Epic-in təlimatında Google Chrome və Mozilla Firefox uyğun seçimlər kimi göstərilir. Səhifəyə klikləyib sonra oynat düyməsinə basaraq yayımı başladın. Standart oyunçu səhifəsi klaviatura, siçan və toxunma girişlərini Unreal Engine tətbiqinə ötürə bilər.

Eyni lokal şəbəkədəki başqa kompüter və ya mobil cihazdan qoşulmaq üçün brauzerdə yayım edən kompüterin IP ünvanı daxil edilir. Bu üsulda qoşulan bütün cihazlar eyni Unreal Engine instansiyasının eyni səhnə görünüşünü izləyir; standart ayarda cihazlardan gələn girişlər də eyni tətbiqə yönləndirilir. İnternetdən və ya müxtəlif alt şəbəkələrdən qoşulmaq üçün daha geniş şəbəkə konfiqurasiyası lazım ola bilər. Mənbə təlimatında belə bağlantılar üçün STUN/TURN serveri ayarlarından bəhs olunur.

Yayğın problemlər və arxitektura iş axınındakı yeri

Qoşulma baş tutmadıqda əvvəlcə server komponentlərinin işlədiyini, tətbiqin düzgün PixelStreamingURL parametri ilə açıldığını və 80 ilə 8888 nömrəli portlara girişin mümkün olduğunu yoxlayın. Eyni kompüterdə başqa veb serverin işləməsi də ilkin quraşdırmaya təsir göstərə bilər. Tətbiq pəncərəsi kiçildildikdə giriş axını kəsilirsə, təlimatda -RenderOffScreen parametrinin tətbiqi görünən pəncərə olmadan işlətmək seçimi olduğu bildirilir.

Memarlıq, interyer dizaynı və archviz iş axınlarında bu quraşdırma eyni səhnəni bir neçə kompüterdə və ya mobil cihazda göstərmək, eləcə də brauzer vasitəsilə interaktiv təqdimat etmək istəyən komandalar üçün faydalı ola bilər. Render tətbiqin işlədiyi əsas kompüterdə yaradılır; qoşulan cihazlar eyni görüntünü alır. Buna görə əsas kompüterin GPU uyğunluğu və şəbəkə konfiqurasiyası vacibdir. Təlimatda təsvir ölçüsü, ekran ölçüsü, IP ünvanları və portlar kimi ayarların konfiqurasiya edilə bildiyi qeyd olunur. Mənbələrdə məhsulun lisenziya və ödəniş şərtləri, yaxud konkret archviz proqramı ilə uyğunluğu açıqlanmır.

Növbəti addımlar

Əsas yayım işlədikdən sonra oyunçu veb səhifəsini layihəyə uyğun fərdiləşdirmək olar. Giriş göndərəcək istifadəçiləri yoxlamaq və ya səhifəyə HTML5 interfeys elementləri əlavə etmək də mümkündür. Epic keyfiyyət, gecikmə və bağlantının dayanıqlığı arasındakı ayarları izah edən yayım optimallaşdırma təlimatı təqdim edir. Bir neçə server, müxtəlif müştərilər və ya internet üzərindən xidmət göstərmək kimi ehtiyaclar üçün Hosting and Networking Guide sənədinə baxmaq olar.

İnfrastruktur fayllarında dəyişiklik ediləcəksə, təlimatda paket qovluğundakı nüsxə əvəzinə ilkin quraşdırma yerinin redaktə olunması tövsiyə edilir. Paket qovluğundakı fayllar dəyişdirildikdə, növbəti paketləmə əməliyyatı həmin dəyişikliklərin üzərinə yaza bilər. İlkin quraşdırmanı lokal şəbəkədə tamamladıqdan sonra daha mürəkkəb qoşulma ssenarilərinə keçməzdən əvvəl layihə tələblərini və istifadə olunacaq şəbəkə ayarlarını nəzərdən keçirmək lazımdır.

Mənbə və lisenziya

Bu bələdçi Epic Games-in Unreal Engine Pixel Streaming sənədi və Pixel Streaming ilkin təlimatındakı məlumatlar əsasında Azərbaycan dilinə uyğunlaşdırılıb. Hər iki mənbə sərbəst lisenziya ilə təqdim olunub.