Stand-Up Komedi Kulübü Şablonu

Bu eğitim Verse Stand-Up şablonu için yardımcı bir belgedir ve bir komedi kulübünde sosyal ve sinematik deneyimi destekleyen aşağıdaki cihazların nasıl kullanılacağını gösterir:

• Karakter cihazları ile ayrıntılı MetaHumans Animatörü öğelerini kullanma

• Girdi Tetikleyici cihazları ile oyuncu girdisi bağlamalarında oynanış olaylarını tetikleme

• Koltuk cihazı ile deneyimi görüntülemek için oyuncuyu yerinde sabitleme

Gösteri bir Verse cihazı tarafından yürütülür ve Verse kodunun temel kavramları aşağıda açıklanmaktadır.

Verse Stand-Up şablonunu UEFN’in (Fortnite İçin Unreal Editor) Öne Çıkan Örnekler bölümünde bulabilirsin.

Kullanılan cihazlar:

• 1 adet Koltuk

• 4 adet Girdi Tetikleyici

• 4 adet Karakter

• 6 adet Sinematik Sekans

Bu eğitimde kullanılan Verse kavramları şunlardır:

• Abonelikler

• If İfadeleri

• Diziler

• Sinematik Sekanslar

• Koltuk cihazı API'si

• Girdi Tetikleyici cihazı API’si

Ada Ayarları

Verse Stand-Up şablonu için değiştirilen Ada Ayarları şunlardır:

Koltuk Cihazı

Oyuncu komedi kulübüne girerken ışıklı bir sahnenin önünde bir koltuk görür. Bu koltuğa oturması istenir. Koltuğa oturmak, oyuncuyu sabit bir konumda tutar ve onu deneyim boyunca taşıyacak olaylar zincirini harekete geçirir.

Koltuk cihazı için değiştirilen Kullanıcı Seçenekleri şunlardır:

Girdi Tetikleyici Cihazları

Koltuk cihazının beraberinde bir Girdi Tetikleyici cihazı bulunur. Oyuncu girdilerini, oyuncunun yeniden atanan düğmeye basmasıyla tetiklenen çeşitli eylemlere bağlar. Girdi tetikleyiciler, performans gerçekleşirken oyuncunun kamera değiştirmesine izin verecek şekilde yapılandırılmıştır.

Cihaz, aralarından seçim yapılabilecek on iki kullanılabilir girdi içerir. Bir girdi seçtikten sonra, yeni girdinin ne yaptığını netleştirmek için bir gösterge paneli açıklaması ekleyebilirsin.

Bu cihaz için aşağıdaki Kullanıcı Seçenekleri değiştirilmiştir. Her cihaz farklı Sinematik Sekans cihazlarına bağlı olduğundan farklı bir bağlamaya ve Gösterge Paneli Açıklamasına sahip olacaktır.

Karakter Cihazları

Karakter cihazları, oyuncuyla veya bir sahnedeki diğer karakterlerle doğrudan etkileşim kurmak için bir yol sağlar. Bu şablonda, sahnedeki rutin sırasında birbirinin yerini alan dört karakter kullanılıyor.

Karakter cihazı için aşağıdaki **Kullanıcı Seçenekleri** değiştirilmiştir:

Ana karakter sahne arkasında merdivende oturuyor, diğer karakterler arkadaki küçük bir odada bekliyor.

Karakter açılır menüsünden farklı karakter dış görünümlerini dene ve sahnede nasıl göründüklerine bak!

Sinematik Sekans Cihazları

Altı Sinematik Sekans cihazı, oyuncunun koltuk cihazında otururken gösteriyi çeşitli açılardan izlemesine olanak sağlar.

Bu eğitimde sinematik sekansların oluşturulmasıyla ilgili ayrıntılara girilmiyor. Daha fazla bilgi almak için Sequencer ve Control Rig sayfasına bakabilir ve daha derin bir kavrayış için Unreal Engine’de Film Nasıl Yapılır? sayfasını inceleyebilirsin.

Bu cihazdaki tek değişiklik, yüklenen si̇nemati̇k sekanstır.

Verse Gösteriyi Nasıl Yürütür?

Bu şablon, bir oyuncu koltuk cihazına oturduğunda gösteriyi başlatmak ve oyuncunun kamerasını TV modu adı verilen bir sinematik görünüme geçirmek için Verse kullanır. Ayrıca oyuncunun birden fazla kamera arasında geçiş yapmasına ve farklı izleme deneyimleri için TV modu veya Serbest Bakış görünümlerine dönmesine izin verir.

Verse Gezgini‘ni kullanarak projende show_template_device.verse adlı yeni bir Verse cihazı oluştur ve cihazı şablona sürükle. Verse dosyana çift tıklayarak dosyayı Visual Studio Code ile aç.

Şablonunda stand-up gösterisinin yürütülmesine yardımcı olacak cihazları kurmuştun; şimdi de kodunda bu cihazlara referans vereceksin.

show_template_device dosyasına aşağıdaki alanları ekle:

1. İlk olarak show_template_device sınıf tanımının üzerine log_show_template_device adlı bir log_channel ekle.

   Verse

        # Create a custom log channel for the show_template_device. This helps with log filtering in complex games with lots of log sources.
        log_show_template_device := class(log_channel){}
   		
        # A Verse-authored creative device that can be placed in a level
        show_template_device := class(creative_device):
   

   Copy full snippet(5 lines long)

2. Şimdi show_template_device sınıf tanımının en üstüne, log_show_template_device kanalını kullanan bir günlük kaydedici ekle. Böylece hangi Print() ifadesinin bu cihazdan geldiğini anlayabilirsin.

   Verse

        # A Verse-authored creative device that can be placed in a level
        show_template_device := class(creative_device):
   		
            # Logger that uses custom log channel.
            Logger:log = log{Channel := log_show_template_device}
   

   Copy full snippet(5 lines long)

3. TheChair adlı düzenlenebilir koltuk cihazı. Bu, stand-up gösterisini başlatmak için oyuncuların oturacağı koltuktur.

   Verse

        # The chair device the player should sit in.
        @editable
        TheChair:chair_device = chair_device{}
   

   Copy full snippet(3 lines long)

4. MainSequence ve TVModeSequence adlı iki düzenlenebilir sinematik sekans cihazı. MainSequence, bölümdeki karakter cihazında animasyonu ve sesi yöneterek stand-up gösterisini yürüten sinematik sekanstır. TVModeSequence, oyuncunun kamerasını MainSquence ile beraber birden fazla açı arasında geçiş yapan bir izleme moduna geçirir.

   Verse

        # The sequence that drives animation and audio on the character device in the level.
        @editable
        MainSequence:cinematic_sequence_device = cinematic_sequence_device{}
        # The sequence that drives the TV mode sequence for viewing in the level.
        @editable
        TVModeSequence:cinematic_sequence_device = cinematic_sequence_device{}
   

   Copy full snippet(6 lines long)

5. CameraSwitches adlı düzenlenebilir bir cinematic_sequence_device dizisi. Bu dizi, oyuncuların gösteri sırasında geçiş yapabileceği her kameraya referansları tutar.

   Verse

        # A list of alternative camera sequences that are provided to view from during the main sequence.
        @editable
        CameraSwitches:[]cinematic_sequence_device = array{}
   

   Copy full snippet(3 lines long)

6. Dört adet düzenlenebilir input_trigger_device. Bu cihazların her biri, farklı kamera modları arasında geçiş yapmak için oyuncu girdisi alır. ReturnToFreeLook tetikleyicisi oyuncuyu varsayılan kameraya döndürürken ReturnToTVMode oyuncuyu TVModeSequence’a geri döndürür. NextCamera ve PreviousMode kamerası, oyuncunun CameraSwitches dizisindeki farklı si̇nemati̇k sekanslar arasında geçiş yapmasını sağlar.

   Verse

        # An input trigger that will return us to free look while in the chair.
        @editable
        ReturnToFreeLook:input_trigger_device = input_trigger_device{}
   		
        # An input trigger that will return us to TV mode when appropriate in the chair.
        @editable
        ReturnToTVMode:input_trigger_device = input_trigger_device{}
   		
        # An input trigger that will choose the next camera while in the chair.
        @editable
   
   Expand code Copy full snippet(15 lines long)

7. CurrentSequence adlı isteğe bağlı bir si̇nemati̇k sekans cihaz değişkeni. TVModeSequence gibi bir sinematik sekans oynatılıyorsa bu seçenek onun bir referansını depolar. Karakter için aynı anda birden fazla si̇nemati̇k sekans oynatmak istemeyiz; bu nedenle yeni bir sekansa geçerken mevcut sekansı kapatmak için bu seçeneği kullanabilirsin.

   Verse

        # The alternative camera sequence that is playing if valid.
        var CurrentSequence:?cinematic_sequence_device = false
   

   Copy full snippet(2 lines long)

8. MainSequencePlaying ve InTvMode adlı iki logic değişkeni. Bunlar sırasıyla MainSequence veya TVModeSequence sekanslarının ne zaman oynatıldığını takip etmeni sağlar.

   Verse

        # Helps us track when the main sequence on the character device is playing.
        var MainSequencePlaying:logic = false
   		
        # When we are in TV mode.
        var InTVMode:logic = false
   

   Copy full snippet(5 lines long)

9. CurrentCameraIndex adlı bir değişken tamsayı. CameraSwitches dizisindeki şu anda oynatılmakta olan sinematik sekansın dizinini takip eder.

   Verse

        # Keeps track of what camera we are viewing when using other cameras besides TV Mode.
        var CurrentCameraIndex:int = -1
   

   Copy full snippet(2 lines long)

10. Bu şablonda referans verilen tüm olaylar için bağlanmaları izleyen beş adet isteğe bağlı cancelable değişkeni. Oyuncu kameralar arasında geçiş yaptığında serbest bakışa veya TV moduna döndüğünde veya koltuk cihazından çıktığında farklı fonksiyonların yürütülmesi gerekir. Bu eğitimin ileriki bölümlerinde fonksiyonları onları tetikleyen olaylara bağlayacak ve her bağlama için bir referans depolayacak, böylece artık gerekmediklerinde bunları iptal edebileceksin.

    Verse

         # Subscriptions to all the events we listen for while running.
         var ReturnToFreeLookSubscription:?cancelable = false
         var NextCameraSubscription:?cancelable = false
         var PrevCameraSubscription:?cancelable = false
         var ReturnToTVModeSubscription:?cancelable = false
         var ChairExitSubscription:?cancelable = false
    

    Copy full snippet(6 lines long)

11. Kodu Visual Studio Code’a kaydet ve bölümdeki Verse ile yazılan cihazını güncellemek için kodunu derle.

12. Şablonunda show_template_device cihazını seç. Ayrıntılar panelinde, kodundaki her bir cihaz referansını, girdi tetikleyicilerin ve si̇nemati̇k sekansların dahil olmak üzere bölümdeki ilişkili cihaza ata.

    

Sekansın Tetiklenmesi

Bir oyuncu koltuk cihazına oturduğunda gösteri başlar; oyuncu oturduğunda sinematik sekansın başlaması gerekir. Bir oyuncu koltuğa oturduğunda ana sekansı tetiklemek için aşağıdaki adımları takip et, aynı zamanda oyuncunun izleyebilmesi için TV modunu başlat.

1. show_template_device sınıfına RunSequence() adlı yeni bir fonksiyon ekle. Bu fonksiyon, gösteriyi başlatan aracıyı alır ve hem MainSequence hem de TVModeSequence’ı başlatır. Asenkron şekilde çalışmasına izin vermek için RunSequence() fonksiyonuna değiştiricisini ekle. Bu fonksiyonun asenkron olması gerekir; böylece başka bir kodu onunla eşzamanlı olarak çalıştırabilir ve RunSequence() kodu kesintiye uğramadan oyuncunun kamera görünümleri arasında geçiş yapmasına izin verebilirsin.

   Verse

        # Handles running the main sequence which runs the character and TV mode sequences for viewing and then calls a function to await finishing.
        RunSequence(Agent:agent)<suspends>:void =

   Copy full snippet(2 lines long)

2. Gösteriye başlamadan önce koltuğa oturan oyuncu animasyonunun bitmesine izin vermek için RunSequence() fonksiyonunda bir saniyeliğine Sleep() fonksiyonunu çağır. Ardından MainSequence’ta Play() çağrısı yap ve MainSequencePlaying’i true olarak ayarla.

   Verse

        # Sleep for a second because we just entered the chair and the animation to sit takes a moment.
        Sleep(1.0)
   		
        # Run the Main sequence on the character device and the TV mode viewing sequence.
        Logger.Print("Main Sequence Playing")
        set MainSequencePlaying = true
        MainSequence.Play()
   

   Copy full snippet(7 lines long)

3. Oyuncunun kamerasını sinematik görünüme geçirmek için gösteriyi başlatan aracıyı geçirerek TVModeSequence’ta Play() çağrısı yap. InTVMode’u true olarak ayarla ve aracıyı ileterek MainSequence’ın bitmesini bekleyen AwaitMainSequenceEnding() adlı yeni bir fonksiyonu çağır. Bu fonksiyonu bir sonraki adımda ayarlayacaksın. Tamamladığın RunSequence() kodun aşağıdaki gibi görünmelidir:

   Verse

        # Handles running the main sequence which runs the character and TV mode sequences for viewing and then calls a function to await finishing.
        RunSequence(Agent:agent)<suspends>:void =
   
            # Sleep for a second because we just entered the chair and the animation to sit takes a moment.
            Sleep(1.0)
   
            # Run the Main sequence on the character device and the TV mode viewing sequence.
            Logger.Print("Main Sequence Playing")
            set MainSequencePlaying = true
            MainSequence.Play()
   
   Expand code Copy full snippet(16 lines long)

4. show_template_device sınıfına, RunSequence() fonksiyonundan agent’ı alan AwaitMainSequecingEnding() adlı yeni bir fonksiyon ekle. Bu fonksiyon aynı zamanda <suspends> değiştiricisine ihtiyaç duyar çünkü arka planda çalışmasını ve MainSequence bittiğinde tetiklenmesini istiyoruz.

   Verse

        # When the main sequence finishes, we clear the flag so that if the player sits back down, it will play again.
        AwaitMainSequencingEnding(Agent:agent)<suspends>:void =

   Copy full snippet(2 lines long)

5. AwaitMainSequencingEnding() fonksiyonunda MainSequence.StoppedEvent() üzerinde Await() çağrısı yap. MainSequence bittiğinde MainSequencePlaying’i false olarak ayarla ve koltuğun Eject() fonksiyonunu kullanarak oyuncuyu koltuktan at. Tamamladığın AwaitMainSequencingEnding fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # When the main sequence finishes, we clear the flag so that if the player sits back down, it will play again.
        AwaitMainSequencingEnding(Agent:agent)<suspends>:void =
            MainSequence.StoppedEvent.Await()
            Logger.Print("Main Sequence Ended")
            set MainSequencePlaying = false
   
            # Kick the player out of the chair after the performance
            TheChair.Eject(Agent)

   Copy full snippet(8 lines long)

6. show_template_device sınıfına DoReturnToTVMode() ve DoReturnToFreeLook() adlı iki yeni fonksiyon ekle. Bu fonksiyonlar, bir oyuncu sırasıyla TV moduna veya serbest bakışa döndüğündeki mantığı işler ancak bunları şimdilik boş bırakacaksın ve daha sonraki bir adımda dolduracaksın.

   Verse

        # Returns us to our TV viewing mode sequence by checking where the main sequence is and aligning our playback to that point.
        DoReturnToTVMode(Agent:agent):void =
            Logger.Print("Return to TV Mode")
   		
        # Determine if we are in TV mode or another camera sequence and return control to the main player camera.
        DoReturnToFreeLook(Agent: agent):void =
            Logger.Print("Return to Free Look")
   

   Copy full snippet(7 lines long)

7. show_template_device sınıfına, TheChair cihazına oturan aracıyı alan OnSeated() adlı yeni bir fonksiyon ekle.

   Verse

        # This function handles the player sitting down and starting up the performance if it isn't already running and setting up the input triggers.
        OnSeated(Agent:agent):void =
            Logger.Print("Player sat down")
   

   Copy full snippet(3 lines long)

8. OnSeated() fonksiyonu içinde MainSequence zaten oynatılmakta değilse koltuk cihazında oturan aracıyı geçirerek RunSequence() adlı bir fonksiyon oluştur. Aksi takdirde aynı aracıyla DoReturnToTVMode() çağrısı yap.

   Verse

        # This function handles the player sitting down and starting up the performance if it isn't already running and setting up the input triggers.
        OnSeated(Agent:agent):void =
            Logger.Print("Player sat down")
   		
            # If the main sequence is not playing on the character device in the level, run it, otherwise if it is running then just return to the TV mode viewing experience.
            if (MainSequencePlaying = false):
                spawn{RunSequence(Agent)}
            else:
                DoReturnToTVMode(Agent)
   

   Copy full snippet(9 lines long)

9. show_template_device sınıfına, koltuktan çıkan oyuncuyu alan OnChairExited() adlı yeni bir fonksiyon ekle. Bu fonksiyonun mantığını daha sonraki bir adımda dolduracaksın.

   Verse

        # Handles the player leaving the chair and removing access to the input triggers that are available while in the chair.
        OnChairExited(Agent:agent):void =
            Logger.Print("Player got up")
   

   Copy full snippet(3 lines long)

10. OnBegin() fonksiyonunda TheChair.SeatedEvent olayını OnSeated() fonksiyonuna bağla. Artık bir oyuncu ne zaman TheChair cihazına oturursa gösteri başlayacak.

    Verse

         # Runs when the device is started in a running game.
         OnBegin<override>()<suspends>:void =
             Logger.Print("Standup Template device started")
             TheChair.SeatedEvent.Subscribe(OnSeated)

    Copy full snippet(4 lines long)

Kodu Visual Studio Code’a kaydet, derle ve şablona oynanış testi uygulamak için UEFN araç çubuğunda Oturumu Başlat butonuna tıkla. Oyununu çalıştırdığında, koltuk cihazına oturmak gösterini başlatmalı ve oyuncunun kamerasını sinematik moda ayarlamalıdır. Gösteri bittiğinde oyuncu koltuktan atılmalıdır.

Kamera Değiştirme

Gösteri sırasında, TheChair cihazında oturan oyuncu, farklı sinematik sekanslar tarafından işlenen birden fazla farklı kamera görünümü arasında geçiş yapabilir. Bu farklı sekanslar arasında geçiş yapma mantığını ayarlamak için aşağıdaki adımları takip et.

1. show_template_device sınıfına DoCameraSwitch() adlı yeni bir fonksiyon ekle. Bu fonksiyon, kamerasını değiştirdiğin aracıyı ve CameraSwitches cihazındaki sinematik sekans dizinine karşılık gelen bir int değişkenini alır.

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
   

   Copy full snippet(2 lines long)

2. DoCameraSwitch() fonksiyonunda bir if ifadesi içinde, CameraSwitches dizisinde bir Değer dizinindeki si̇nemati̇k sekansı al. Ardından, CurrentSequence’ın bir sinematik sekans içerip içermediğini kontrol ederek ve üzerinde Stop() çağrısı yaparak, oynatılmakta olan sekansı durdur.

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
            if (CameraSwitch := CameraSwitches[Value]):
                Logger.Print("Switching Cameras to {Value}")
   		
                # Stop any currently playing other camera sequence.
                if (PlayingSequence := CurrentSequence?):
                    PlayingSequence.Stop(Agent)
   

   Copy full snippet(8 lines long)

3. CameraSwitch’te Play() çağrısı yaparak yeni si̇nemati̇k sekansı oynatmaya başla. Ardından, o sırada hangi sekansın oynatıldığını söyleyecek olan CurrentSequence’ı ayarla. Son olarak, kamerasını değiştirdiğin agent’ı, diğer kameraları görüntülerken bu modlara geri dönmesine izin vermek için Register() çağrısıyla ReturnToTVMode ve ReturnToFreeLook girdi tetikleyicilerine kaydet. Tamamladığın DoCameraSwitch() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
            if (CameraSwitch := CameraSwitches[Value]):
                Logger.Print("Switching Cameras to {Value}")
   		
                # Stop any currently playing other camera sequence.
                if (PlayingSequence := CurrentSequence?):
                    PlayingSequence.Stop(Agent)
   		
                # Start up the new camera viewing sequence.
   
   Expand code Copy full snippet(16 lines long)

4. Sonraki ve önceki kameralar arasında geçiş yapmak için birbirine çok benzeyen şu iki fonksiyonu ayarla: DoNextCamera() ve DoPreviousCamera(). Öncelikle bir sonraki kamera için mantığı dolduracaksın, bu nedenle show_template_device sınıfına DoNextCamera() adlı yeni bir fonksiyon ekle. Bu fonksiyon, kamerasını değiştirdiğin agent’ı alır.

   Verse

        # Switches to the next camera on our list, or the first if we are in TV mode.
        DoNextCamera(Agent:agent):void =
            Logger.Print("Next Camera")
   

   Copy full snippet(3 lines long)

5. DoNextCamera() fonksiyonu içinde, oyuncunun şu anda TV modunda olup olmadığını kontrol et. Oyuncu TV modundaysa TVModeSequence’ı durdurmak için Stop() çağrısı yap, InTVMode’u false olarak ayarla ve CurrentCameraIndex değerini -1 olarak ayarla. Burada -1 kullanırsın çünkü bir sonraki si̇nematik sekansı CameraSwitches dizisi içinde dizinlemen gerekiyor; bu da dizin 0 olacak.

   Verse

        # If we are currently viewing from TV Mode, end that sequence and clear associated values.
        if (InTVMode?):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
            set CurrentCameraIndex = -1
   

   Copy full snippet(5 lines long)

6. Ardından, geçerli kameranın dizinine göre geçiş yapacağın bir sonraki kamerayı bulman gerekiyor. Bunun için CurrentCameraIndex + 1 ve CameraSwitches.Length’in Mod’una NextCameraValue adlı yeni bir değişken ayarla. Bu, NextCameraValue değerini 0 ile CameraSwitches dizisinin uzunluğu arasında olan ve CameraSwitches dizisinin dışında bir NextCameraValue değeri almanı önleyen bir değere sıkıştırmana olanak sağlar. Bir NextCameraValue değeri belirledikten sonra CurrentCameraValue değerini NextCameraValue olarak ayarla ve agent ile CurrentCameraIndex’i ileterek DoCameraSwitch() fonksiyonunu çağır. Tamamladığın DoNextCamera() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Switches to the next camera on our list, or the first if we are in TV mode.
        DoNextCamera(Agent:agent):void =
            Logger.Print("Next Camera")
   		
            # If we are currently viewing from TV Mode, end that sequence and clear associated values.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
                set CurrentCameraIndex = -1
   		
   
   Expand code Copy full snippet(14 lines long)

7. Önceki kameraya geçmek için show_template_device sınıfına DoPreviousCamera() adlı yeni bir fonksiyon ekle. DoNextCamera() kodunu bu fonksiyona kopyala. Oyuncunun TV modunda olup olmadığını kontrol ederken CurrentCameraIndex değerini -1 yerine 0 olarak ayarla. Ayrıca,NextCameraValue değerini CurrentCameraIndex - 1 ve CameraSwitches.Length Mod olarak belirle. Tamamladığın DoPreviousCamera() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Switches us to the previous camera on the list or last camera if we are leaving TV mode.
        DoPreviousCamera(Agent:agent):void =
            Logger.Print("Prev Camera")
   		
            # If we are currently viewing from TV Mode, end that sequence and clear associated values.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
                set CurrentCameraIndex = 0
   		
   
   Expand code Copy full snippet(14 lines long)

Oyuncu, TheChair cihazında otururken ve CameraSwitches dizisindeki farklı bir kameradan izlerken TV moduna veya Serbest Bakış’a dönebilir. DoReturnToFreeLook() ve DoReturnToTVMode() fonksiyonlarını daha önce ayarlamıştın, şimdi de bunları dolduracaksın.

1. DoReturnToFreeLook() fonksiyonu içinde, oyuncunun şu anda TV modunda olup olmadığını kontrol et. Oyuncu TV modundaysa TVModeSequence’ı durdurmak için Stop() çağrısı yap ve InTVMode’u false olarak ayarla. CurrentSequence’ın bir sinematik sekans içerip içermediğini kontrol edip içeriyorsa Stop() çağrısı yaparak ve bunu false olarak ayarlayarak aynısını CurrentSequence için yap.

   Verse

        # If TV Mode is active, stop it.
        if (InTVMode?):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
   		
        # If we are playing another viewing experience, stop it.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
            set CurrentSequence = false
   

   Copy full snippet(9 lines long)

2. Artık aracıyı ReturnToTVMode girdi tetikleyiciye Register() ile kaydedip ReturnToFreeLook tetikleyicisinden kaydını Unregister() ile kaldır çünkü oyuncu zaten serbest bakıştayken buna geri dönmek gerekmez. Tamamladığın DoReturnToFreeLook() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Determine if we are in TV mode or another camera sequence and return control to the main player camera.
        DoReturnToFreeLook(Agent: agent):void =
            Logger.Print("Return to Free Look")
   		
            # If TV Mode is active, stop it.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
   		
            # If we are playing another viewing experience, stop it.
   
   Expand code Copy full snippet(17 lines long)

3. DoReturnToTVMode() fonksiyonu daha fazla mantık gerektirir çünkü TV moduna döndüğünde TVModeSequence’ı MainSequence’ın geçerli zamanında başlatman gerekir. Önce, bu fonksiyon çağrıldığında oyuncunun zaten TV modunda olup olmadığını kontrol et. Durum böyleyse yapman gereken bir şey olmadığından geri dönmen yeterlidir. Ardından CurrentSequence’ın bir sinematik sekans içerip içermediğini kontrol edip içeriyorsa Stop() çağrısı yap ve bunu false olarak ayarla.

   Verse

        # If we are already in TV mode no need to return to it.
        if (InTVMode?):
            return
   		
        # If we have another camera sequence playing, stop it and clear associated values.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
            set CurrentSequence = false
   

   Copy full snippet(8 lines long)

4. Şimdi MainSequence’ın kayıttan oynatmanın neresinde olduğunu bulman ve TVModeSequence’ı aynı noktadan başlatman gerekiyor. GetPlayBackTime() çağrısıyla MainSequence’ın kayıttan oynatma zamanını al ve bir CurrentSeekTime değişkenine kaydet. TVModeSequence’ın kayıttan oynatma zamanını, SetPlaybackTime() fonksiyonunu kullanarak CurrentSeekTime değişkenine ayarla ve aracıyı ileterek sekansı Play() çağrısıyla oynat. Ardından InTVMode değerini true olarak ayarla.

   Verse

        # Figure out where the main sequence is in its playback and start up the TV mode sequence at the same spot to provide the proper viewing experience.
        CurrentSeekTime := MainSequence.GetPlaybackTime()
        TVModeSequence.SetPlaybackTime(CurrentSeekTime)
        TVModeSequence.Play(Agent)
        set InTVMode = true
   

   Copy full snippet(5 lines long)

5. Son olarak, Unregister() çağrısıyla aracının ReturnToTVMode girdi tetikleyicisinden kaydını kaldırıp Register() çağrısıyla ReturnToFreeLook tetikleyicisine kaydet. Tamamladığın DoReturnToTVMode() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Returns us to our TV viewing mode sequence by checking where the main sequence is and aligning our playback to that point.
        DoReturnToTVMode(Agent:agent):void =
            Logger.Print("Return to TV Mode")
   		
            # If we are already in TV mode no need to return to it.
            if (InTVMode?):
                return
   		
            # If we have another camera sequence playing, stop it and clear associated values.
            if (TempSeq := CurrentSequence?):
   
   Expand code Copy full snippet(22 lines long)

Tüm Parçaları Bir Araya Getirme

Bu eğitimin önceki bölümünde birçok fonksiyonu ayarladın, şimdiyse sıra bu fonksiyonların hepsini, onları çağıran farklı girdi tetikleyicilere bağlamaya geldi.

1. OnSeated() fonksiyonu içinde, Register() ile aracıyı ReturnToFreeLook, NextCamera ve PreviousCamera girdi tetikleyicilerine kaydet çünkü bunlar oyuncunun başlangıçta koltuğa ilk oturduğunda erişime sahip olduğu tetikleyicilerdir. Ardından her bir girdi tetikleyiciyi ilişkili fonksiyonlarına bağlayarak ReturnToFreeLookSubscription, NextCameraSubscription ve PreviousCameraSubscription bağlamalarını ayarla. ReturnToTVModeSubscription ve ChairExitSubscription bağlamalarını da aynı şekilde ayarla.

   Verse

        # Register for the input trigger for free look and subscribe to the pressed event when sitting.
        ReturnToFreeLook.Register(Agent)
        set ReturnToFreeLookSubscription = option{ReturnToFreeLook.PressedEvent.Subscribe(DoReturnToFreeLook)}
   		
        # Register for the input trigger for the next camera and subscribe to the pressed event when sitting.
        NextCamera.Register(Agent)
        set NextCameraSubscription = option{NextCamera.PressedEvent.Subscribe(DoNextCamera)}
   		
        # Register for the input trigger for the previous camera and subscribe to the pressed event when sitting.
        PreviousCamera.Register(Agent)
   
   Expand code Copy full snippet(17 lines long)

2. show_template_device sınıfına isteğe bağlı iptal edilebilir değer alan CancelSubscription() adlı yeni bir fonksiyon ekle. CancelSubscription() fonksiyonu içinde, Subscription ifadesinin bir değer içerip içermediğini kontrol et. İçeriyorsa Cancel() ile iptal et. Tamamladığın CancelSubscription() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Cancel a subscription if it is valid.
        CancelSubscription(Subscription:?cancelable):void =
            if (SubscriptionToCancel := Subscription?):
                SubscriptionToCancel.Cancel()
   

   Copy full snippet(4 lines long)

3. Bir oyuncu koltuktan çıktığında, oyuncuda oynatılmakta olan tüm sekansları durdurman ve ayrıca oyuncunun kayıtlı olduğu girdi tetikleyicilere yönelik tüm bağlanmaları iptal etmen gerekir. DoReturnToFreeLook() için yaptığın gibi OnChairExited() fonksiyonu için oyuncunun TV modunda olup olmadığını ve CurrentSequence’ın bir si̇nemati̇k sekans içerip içermediğini kontrol et. İçeriyorsa her sekans üzerinde Stop() çağrısı yap ve oyuncu TV modundaysa InTVMode değerini false olarak ayarla. Ardından CurrentSequence değerini false olarak ayarla.

   Verse

        # Stop the TV camera view when we leave the chair if it is active.
        if (InTVMode = true):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
   		
        # Stop the camera sequence we were using if it is active when we leave the chair.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
   		
        # Clear whatever the current sequence was when we leave the chair.
   
   Expand code Copy full snippet(11 lines long)

4. Şimdi, her bağlanmayı CancelSubscription() fonksiyonuna geçirerek tüm oyuncu bağlanmalarını iptal et. Ayrıca, koltuktan ayrılırken bu düğmelere erişememeleri gerektiğinden Unregister() ile tüm girdi tetikleyicilerden oyuncunun kaydını kaldır. Tamamladığın OnChairExited() fonksiyonu aşağıdaki gibi görünmelidir:

   Verse

        # Handles the player leaving the chair and removing access to the input triggers that are available while in the chair.
        OnChairExited(Agent:agent):void =
            Logger.Print("Player got up")
   		
            # Stop the TV camera view when we leave the chair if it is active.
            if (InTVMode = true):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
   		
            # Stop the camera sequence we were using if it is active when we leave the chair.
   
   Expand code Copy full snippet(28 lines long)

Kodu Visual Studio Code’a kaydet, derle ve şablona oynanış testi uygulamak için UEFN araç çubuğunda Oturumu Başlat butonuna tıkla. Oynanış testi yaptığında, koltuk cihazına oturmak gösteriyi başlatmalıdır. Gösteri sırasında TV modu, serbest bakış ve diğer birden fazla kamera açısı arasında geçiş yapabilmelisin. TV moduna dönmek, TV modu sekansını ana sekansla hizalamalıdır. Gösteri bittiğinde serbest bakışa döndürülmeli ve koltuktan çıkmalısın.