Stand-Up Comedy Club テンプレート

このチュートリアルは Verse Stand-Up テンプレートの付属ドキュメントであり、コメディ劇場内でのソーシャルでシネマティックな体験を支える以下の仕掛けを使用する方法を示しています。

• キャラクターの仕掛けで、詳細度の高い MetaHumans Animator アセットを使用する

• 入力トリガーの仕掛けで、プレイヤー入力バインディングに対してゲームプレイ イベントをトリガーする

• イスの仕掛けで、体験を見る位置にプレイヤーを固定する

下記で解説している Verse コードの主なコンセプトにより、Verse の仕掛けによってショーが演じられます。

Verse Stand-Up テンプレートは、UEFN (Unreal Editor for Fortnite) の機能サンプル セクションにあります。

使用されている仕掛けは以下のとおりです。

• イス x 1

• 入力トリガー x 4

• キャラクター x 4

• ムービー シーケンス x 6

このチュートリアルで使用されている Verse のコンセプトは以下のとおりです。

• サブスクリプション

• if 文

• 配列

• ムービー シーケンス

• イスの仕掛けの API

• 入力トリガーの仕掛けの API

島設定

Verse Stand-Up テンプレートでは以下の島設定が変更されています。

イスの仕掛け

プレイヤーがコメディ劇場に足を踏み入れると、ライトアップされたステージの前にイスが見え、 プレイヤーはそのイスに座るように促されます。 イスに座るとプレイヤーの位置が固定され、プレイヤーがその後に体験する一連のイベントが開始されます。

イスの仕掛けでは以下のユーザー オプションが変更されています。

入力トリガーの仕掛け

入力トリガーの仕掛けは、イスの仕掛けと密接に関連しています。 プレイヤー入力をさまざまな行動にバインドし、その行動が再割り当てされたボタンをプレイヤーが押すごとにトリガーされます。 入力トリガーは、パフォーマンスが行われているときにプレイヤーがカメラを切り替えることができるように設定されています。

この仕掛けには利用可能な 12 個の入力があり、その中から選択して使用します。 入力を選択すると、HUD の説明を追加して、新しい入力が何をするものかを明確にすることができます。

この仕掛けでは以下のユーザー オプションが変更されています。 それぞれの仕掛けは異なるムービー シーケンスの仕掛けにバインドされているため、バインディングと HUD の説明は仕掛けごとに異なります。

キャラクターの仕掛け

キャラクターの仕掛けは、プレイヤーまたはシーン内の他のキャラクターと直接インタラクトする手段です。 このテンプレートでは、オンステージのルーチン中に切り替わる 4 つのキャラクターが使用されています。

キャラクターの仕掛けでは以下のユーザー オプションが変更されています。

メイン キャラクターは舞台裏の階段に座っていて、他のキャラクターは奥の小部屋で待機しています。

[Character (キャラクター)] ドロップダウン メニューにあるさまざまなキャラクター スキンを試し、ステージ上でどのように見えるかを確認します。

ムービー シーケンスの仕掛け

6 つのムービー シーケンスの仕掛けによって、プレイヤーはイスの仕掛けに座ったままでさまざまな角度からショーを見ることができます。

このページでは、ムービー シーケンスの作成の詳細については説明しません。 詳細については「シーケンサーおよびコントロール リグ」ページを参照し、さらに詳しくは「シーケンサーの基本」を参照してください。

この仕掛けで変更されているのは、ロード済みのムービー シーケンスだけです。

Verse でショーが演じられる仕組み

このテンプレートでは、Verse を使用して、プレイヤーがイスの仕掛けに座ったときにショーを開始し、カメラを TV モードというムービー ビューに変更します。 また、プレイヤーが複数のカメラを切り替えることができ、TV モードまたはフリールックに戻って異なる表示を体験できるようにしています。

プロジェクトで Verse Explorer を使用して show_template_device.verse という新しい Verse の仕掛けを作成し、その仕掛けをテンプレートにドラッグします。 Verse ファイルをダブルクリックすると、そのファイルが Visual Studio Code で開かれます。

スタンドアップ ショーを演じるのに役立つ仕掛けをテンプレートでセットアップしました。次にコードでそれらの仕掛けを参照します。

以下のフィールドを「show_template_device」ファイルに追加します。

1. まず、show_template_device クラス定義の上に log_show_template_device という名前の log_channel を追加します。

   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. 次に、show_template_device クラス定義の先頭で、log_show_template_device チャンネルを使用するロガーを追加して、どの Print() 文がこの仕掛けからのものであるかを見分けることができるようにします。

   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 という名前の、編集可能なイスの仕掛け。 これは、プレイヤーが座るとスタンドアップ ショーが始まるイスです。

   Verse

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

   Copy full snippet(3 lines long)

4. MainSequence と TVModeSequence という名前の、2 つの編集可能なムービー シーケンスの仕掛け。 MainSequence は、スタンドアップ ショーを演じるムービー シーケンスであり、レベルにあるキャラクターの仕掛け上でアニメーションとオーディオを操作します。 TVModeSequence は、プレイヤーのカメラを、MainSquence と連動して追従する表示モードに切り替え、複数の角度を切り替えます。

   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 という名前の、cinematic_sequence_device の編集可能な配列。 この配列には、ショーの上演中にプレイヤーが切り替えることができるそれぞれのカメラへの参照が保持されています。

   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. 4 つの編集可能な input_trigger_device。 これらのそれぞれの仕掛けは、プレイヤー入力を受け取って、異なるカメラ モードを切り替えます。 ReturnToFreeLook トリガーは、プレイヤーをデフォルトのカメラに戻し、ReturnToTVMode はプレイヤーを TVModeSequence に戻します。 NextCamera と PreviousMode カメラは、プレイヤーを CameraSwitches 配列内のさまざまなムービー シーケンスで切り替えます。

   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 という名前の、オプションのムービー シーケンスの仕掛け変数。 TVModeSequence などのムービー シーケンスが再生中であれば、そのシーケンスへの参照がこのオプションに格納されます。 キャラクターに対して同時に複数のムービー シーケンスを再生することは避けたいため、このオプションを使用して、新しいシーケンスに切り替わるときに現在のシーケンスをオフにすることができます。

   Verse

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

   Copy full snippet(2 lines long)

8. MainSequencePlaying と InTvMode という名前の、2 つのロジック変数。 これらの変数を使用して、MainSequence または TVModeSequence がそれぞれいつ再生されているかをトラックできます。

   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 という名前の int 変数。 これは、CameraSwitches 配列にある現在再生中のムービー シーケンスのインデックスをトラックします。

   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. このテンプレートで参照されているすべてのイベントのサブスクリプションをトラックする 5 つのオプションの cancelable 変数。 プレイヤーがカメラを切り替えるとき、フリールックまたは TV モードに戻るとき、イスの仕掛けから離れるとき、それぞれで異なる関数を実行する必要があります。 このチュートリアルの後半で、関数をトリガーするイベントをその関数でサブスクライブし、必要なくなったときにキャンセルできるようにそれぞれのサブスクリプションへの参照を格納します。

    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. このスクリプトを Visual Studio Code に保存してコンパイルし、レベル内の Verse で作成した仕掛けを更新します。

12. テンプレートで show_template_device を選択します。 [Details (詳細)] パネルで、入力トリガーとムービー シーケンスも含めて、スクリプト内の各仕掛けへの参照を、レベル内の関連付けられている仕掛けに割り当てます。

    

シーケンスをトリガーする

ショーはプレイヤーがイスの仕掛けに座ると始まるため、プレイヤーが着席するとムービー シーケンスが開始されるようにします。 以下のステップに従って、プレイヤーがイスに座ったときにメイン シーケンスをトリガーし、プレイヤーが見ることができるように TV モードを開始します。

1. 新しい関数 RunSequence() を show_template_device クラスに追加します。 この関数は、ショーを開始したエージェントを受け取り、MainSequence と TVModeSequence の両方を開始します。 非同期で実行されるように、RunSequence() に モディファイアを追加します。 他のコードをシーケンスと並列で実行でき、RunSequence() コードを中断することなくプレイヤーがカメラ ビューを切り替えることができるように、この関数は非同期である必要があります。

   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. RunSequence() 内で Sleep() を 1 秒間呼び出して、プレイヤーがイスに座るアニメーションが終了してから、ショーが開始されるようにします。 その後に、MainSequence の Play() を呼び出して、MainSequencePlaying を true に設定します。

   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. ショーを開始したエージェントを渡して TVModeSequence の Play() を呼び出して、エージェントのカメラをムービー ビューに変更します。 InTVMode を true に設定し、MainSequence の終了を待機する AwaitMainSequenceEnding() という新しい関数を、エージェントを渡して呼び出します。 この関数は次のステップでセットアップします。 完成した RunSequence() のコードは次のようになっています。

   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. RunSequence() から agent を受け取る新しい関数 AwaitMainSequecingEnding() を show_template_device クラスに追加します。 この関数はバックグラウンドで実行され、MainSequence が終了したときにトリガーされるようにするため、<suspends> モディファイアも必要とします。

   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() 内で MainSequence.StoppedEvent() の Await() を呼び出します。 MainSequence が終了したら、MainSequencePlaying を false に設定し、イスの Eject() 関数を使用して、プレイヤーをイスから追い出します。 完成した AwaitMainSequencingEnding() 関数は次のようになっています。

   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. 2 つの新しい関数 DoReturnToTVMode() と DoReturnToFreeLook() を show_template_device クラスに追加します。 これらの関数は、プレイヤーが TV モードまたはフリールックに戻った場合のロジックをそれぞれ処理しますが、今は空のままにしておき、この後のステップで記述します。

   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. TheChair に座ったエージェントを受け取る新しい関数 OnSeated() を show_template_device クラスに追加します。

   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() 内で、MainSequence がまだ再生されていなければ、イスの仕掛けに座ったエージェントを渡して RunSequence() 関数をスポーンします。 再生されている場合は、同じエージェントを渡して DoReturnToTVMode() を呼び出します。

   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. イスから離れたプレイヤーを受け取る新しい関数 OnChairExited() を show_template_device クラスに追加します。 この関数のロジックは、後のステップで記述します。

   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() 内で、TheChair.SeatedEvent を OnSeated() 関数にサブスクライブします。 これで、プレイヤーが TheChair に座るたびにショーが開始されるようになりました。

    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)

Visual Studio Code でスクリプトを保存してコンパイルし、UEFN ツールバーにある [Launch Session (セッションを起動)] をクリックして、テンプレートをプレイテストします。 ゲームを実行し、イスの仕掛けに座るとショーが始まり、プレイヤーのカメラをムービー モードに設定します。 ショーが終わると、プレイヤーはイスから追い出されます。

カメラを切り替える

ショーの上演中に、TheChair に座っているプレイヤーは、異なるムービー シーケンスで処理される複数の異なるカメラ ビューを切り替えることができます。 以下のステップに従って、異なるシーケンスを切り替えるロジックをセットアップします。

1. 新しい関数 DoCameraSwitch() を show_template_device クラスに追加します。 この関数は、切り替え先のカメラのエージェントと、CameraSwitches 内での該当するムービー シーケンスのインデックスを表す int を受け取ります。

   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() 内の if 文で、CameraSwitches 配列内の Value インデックスにあるムービー シーケンスを取得します。 そして、CurrentSequence にムービー シーケンスが入っているかどうかをチェックし、シーケンスに対して Stop() を呼び出すことで、再生中のすべてのシーケンスを停止します。

   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 の Play() を呼び出すことで、新しいムービー シーケンスの再生を開始します。 そして、現在再生中のシーケンスを指すように CurrentSequence を設定します。 最後に、Register() を呼び出して、切り替え先のカメラの agent を ReturnToTVMode と ReturnToFreeLook の各入力トリガーに登録し、他のカメラを表示しているときにそれぞれのモードに戻ることができるようにします。 完成した DoCameraSwitch() 関数は次のようになっています。

   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. 次のカメラと前のカメラを切り替えるために、よく似ている 2 つの関数 DoNextCamera() と DoPreviousCamera() をセットアップします。 まず、次のカメラのロジックを記述するために、新しい関数 DoNextCamera() を show_template_device クラスに追加します。 この関数は、切り替え先のカメラの agent を受け取ります。

   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() 関数内で、プレイヤーが現在 TV モードであるかどうかをチェックします。 TV モードであれば、Stop() を呼び出して TVModeSequence を停止し、InTVMode を false に設定して CurrentCameraIndex を -1 に設定します。 CameraSwitches 配列内の次のムービー シーケンスのインデックスがインデックス 0 になるようにするために、ここでは -1 を使用しています。

   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. 現在のカメラのインデックスに基づいて、切り替え先の次のカメラを割り出す必要があります。 そのために、新しい変数 NextCameraValue を、CurrentCameraIndex + 1 と CameraSwitches.Length の Mod に設定します。 これにより、NextCameraValue が 0 と CameraSwitches の長さの間の値にクランプされるため、NextCameraValue が CameraSwitches 配列の範囲外の値にならないようにできます。 NextCameraValue を算出したら、CurrentCameraValue を NextCameraValue に設定し、agent と CurrentCameraIndex を渡して、DoCameraSwitch() を呼び出します。 完成した DoNextCamera() 関数は次のようになっています。

   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. 前のカメラに切り替えるために、DoPreviousCamera() という新しい関数を show_template_device クラスに追加します。 DoNextCamera() のコードをこの関数にコピーします。 プレイヤーが現在 TV モードであるかどうかをチェックする際に、CurrentCameraIndex を -1 ではなく 0 に設定します。 また、NextCameraValue が CurrentCameraIndex - 1 と CameraSwitches.Length の Mod になるように変更します。完成した DoPreviousCamera() 関数は次のようになっています。

   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)

プレイヤーが TheChair に座っていて、CameraSwitches にある別のカメラから見ている場合に、TV モードまたはフリールックに戻ることができます。 以前にセットアップした DoReturnToFreeLook() 関数と DoReturnToTVMode() 関数を、ここで記述します。

1. DoReturnToFreeLook() 関数内で、プレイヤーが現在 TV モードであるかどうかをチェックします。 TV モードであれば、Stop() を呼び出して TVModeSequence を停止し、InTVMode を false に設定します。 CurrentSequence でも同様に、CurrentSequence にムービー シーケンスが入っているかどうかをチェックし、Stop() を呼び出して、入っている場合は false に設定します。

   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. 次に、Register() を呼び出してエージェントを ReturnToTVMode 入力トリガーに登録し、Unregister() を呼び出してエージェントを ReturnToFreeLook トリガーから登録解除します。これは、プレイヤーがすでにフリールック モードであればフリールック モードに戻らないようにするためです。 完成した DoReturnToFreeLook() 関数は次のようになっています。

   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() 関数では、TV モードに戻るときに、MainSequence の現在の経過時間で TVModeSequence を開始する必要があるため、より多くのロジックが必要です。 まず、この関数が呼び出されたときに、プレイヤーがすでに TV モードであるかどうかをチェックします。 TV モードであれば、何もする必要がないため、return するだけです。 次に、CurrentSequence にムービー シーケンスが入っているかどうかをチェックし、Stop() を呼び出して、入っている場合は false に設定します。

   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. 次に、MainSequence のどこが再生されているかを割り出し、それと同じ時間から TVModeSequence を開始します。 GetPlayBackTime() を呼び出して MainSequence の再生経過時間を取得し、それを変数 CurrentSeekTime に格納します。 SetPlaybackTime() を使用して TVModeSequence の再生経過時間を CurrentSeekTime に設定し、エージェントを渡して Play() を呼び出してシーケンスを再生します。 その後、InTVMode を true に設定します。

   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. 最後に、Unregister() を呼び出して ReturnToTVMode 入力トリガーからエージェントを登録解除し、Register() を呼び出してそのエージェントを ReturnToFreeLook トリガーに登録します。 完成した DoReturnToTVMode() 関数は次のようになっています。

   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)

すべてを一つに結合する

このチュートリアルのここまでの部分で多くの関数をセットアップしました。それらすべてを、それらを呼び出すさまざまな入力トリガーに結合します。

1. OnSeated() 内で、Register() を呼び出して、エージェントを ReturnToFreeLook、NextCamera、および PreviousCamera の各入力トリガーに登録します。これらは、プレイヤーが初めてイスに座ったときに最初からアクセスできるトリガーであるためです。 そして、それぞれの入力トリガーを関連付けられている関数にサブスクライブすることで、ReturnToFreeLookSubscription、NextCameraSubscription、および PreviousCameraSubscription を設定します。 同じように、ReturnToTVModeSubscription と ChairExitSubscription を設定します。

   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. オプションのキャンセル可能値を受け取る新しい関数 CancelSubscription() を show_template_device クラスに追加します。 CancelSubscription() 内で、Subscription に値が入っているかどうかをチェックします。 値が入っている場合は、Cancel() を呼び出してそれをキャンセルします。 完成した CancelSubscription() は次のようになっています。

   Verse

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

   Copy full snippet(4 lines long)

3. プレイヤーがイスを離れるときに、そのプレイヤーで現在再生されているすべてのシーケンスを停止し、そのプレイヤーに登録されている入力トリガーのすべてのサブスクリプションをキャンセルする必要があります。 OnChairExited() 関数内で、DoReturnToFreeLook() 内と同様に、プレイヤーが現在 TV モードであるかどうか、および CurrentSequence にムービー シーケンスが入っているかどうかをチェックします。 ムービー シーケンスが入っている場合は各シーケンスの Stop() を呼び出し、プレイヤーが TV モードであれば InTVMode を false に設定します。 その後、CurrentSequence を false に設定します。

   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. 次に、各サブスクリプションを CancelSubscription() 関数に渡すことで、プレイヤーのすべてのサブスクリプションをキャンセルします。 また、イスを離れるときにプレイヤーがボタンにアクセスできないようにするために、Unregister() を呼び出して各入力トリガーからプレイヤーを登録解除します。 完成した OnChairExited() 関数は次のようになっています。

   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)

Visual Studio Code でスクリプトを保存してコンパイルし、UEFN ツールバーにある [Launch Session (セッションを起動)] をクリックして、テンプレートをプレイテストします。 プレイテスト時に、イスの仕掛けに座ると、ショーが開始されるはずです。 ショーの上演中に、TV モード、フリールック、他の複数のカメラ角度の間を切り替えることができるはずです。 TV モードに戻ると、TV モードのシーケンスがメイン シーケンスと揃っているはずです。 ショーが終了すると、フリールックに戻っていて、イスを離れることができるはずです。