1. Epic GamesDeveloper
  3. 5. パズルが解かれたタイミングを検出する

5. パズルが解かれたタイミングを検出する

Verse で作成した仕掛けを使用して、アイテムをスポーンするために、各ライトのオン/オフの適切な組み合わせをプレイヤーが見つけるパズルを作成します。

5. パズルが解かれたタイミングを検出する
Prerequisite topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

「タグ付きライト パズル」チュートリアルのこのステップを完了すると、プレイヤーがパズルを解いたタイミングを検出して、アイテムをスポーンし、そのパズルをさらに操作できないようにする方法を習得できます。

解かれたパズルを検出する

このセクションでは、ライトの適切な組み合わせを見つけることで、プレイヤーがパズルを解いたタイミングを検出する方法を示します。 パズルが解かれたとき、アイテムをスポーンできるように、アイテム スポナーの仕掛けを有効にする必要があります。

プレイヤーがパズルを解いたタイミングを検出するには次のステップに従います。

  1. アイテム スポナーの仕掛けを表すための、ItemSpawner という名前の編集可能な item_spawner_device フィールドを tagged_lights_puzzle クラスに追加します。 
     @editable
 ItemSpawner:item_spawner_device = item_spawner_device{}
  2. 次に、パズルを解くにはライトがどのステートになっている必要があるかを定義します。ライトのステートの表現は logic 配列であるため、容易に比較できるように、解かれたライトのステートも logic 配列にします。SolvedLightsState という名前の編集可能な logic 配列フィールドを tagged_lights_puzzle クラス内に作成します。この例では、プレイヤーはパズルを解くにはすべてのライトを点灯させる必要があるため、各要素を値 true で初期化して、ライトが点灯していることを表します。 
     @editable
 SolvedLightsState : []logic = array{true, true, true, true}
  3. Visual Studio Code でファイルを保存します。
  4. UEFN ツールバーの [Build Verse Scripts (Verse スクリプトをビルド)] をクリックし、レベルにある Verse の仕掛けを更新します。
  5. アウトライナー で tagged_lights_puzzle を選択すると、[Details] パネルが開きます。
  6. [Details] パネルで、Item Spawner プロパティをレベルにあるアイテム スポナーの仕掛けに設定します。
  7. 次に、現在の LightsState が SolvedLightsState と一致しているかどうかをチェックするコードを作成します。IsPuzzleSolved() という名前の新しいメソッドを tagged_lights_puzzle クラスに追加します。このメソッドはパズルが解かれていれば成功し、解かれていなければ失敗し、そのチェックの結果を呼び出し元に知らせます。つまりこのメソッドは decides 指定子で失敗可能とマークする必要があります。このメソッドには decides 指定子が付いているため、transacts 指定子も付いている必要があります。そのため、このメソッドで実行されるアクションは、メソッド内のどこかで失敗が発生した場合に (そのアクションは実行されなかったかのように) ロールバックできます。 
     IsPuzzleSolved()<decides><transacts> : void =
     Logger.Print("Checking if puzzle is solved")

    Verse では成功/失敗を使用して意思決定を行います。Verse で失敗を使用する方法の詳細については、「失敗」を参照してください。
  8. パズルが解かれたことを、いつ仕掛けでチェックすればよいでしょうか。最適なタイミングは LightsState 配列が更新されたときです。これは ToggleLights() メソッドの内部で発生します。for 式で LightsState 配列の更新が終わったら、IsPuzzleSolved[] メソッドを呼び出してパズルが解かれているかどうかを判断し、解かれていればアイテムをスポーンします (ItemSpawner.Enable() を呼び出す)。IsPuzzleSolved[] は失敗する可能性がある式である (そのため、このメソッドの呼び出し時に、() ではなく [] を使用する) ため、失敗コンテキストで呼び出す必要があります。この例では、失敗コンテキストは [if`](if-in-verse) 式であり、パズルが解かれているかどうかという条件に応じて式を実行できます。 
     ToggleLights(LightIndices : []int) : void =
     for:
         LightIndex : LightIndices
         IsLightOn := LightsState[LightIndex]
         Light := Lights[LightIndex]
     do:
         Logger.Print("Turning light at index {LightIndex} {if (IsLightOn?) then "Off" else "On"}")
         NewLightState :=
             if (IsLightOn?):
                 Light.TurnOff()
                 false
             else:
                 Light.TurnOn()
                 true
         if (set LightsState[LightIndex] = NewLightState):
             Logger.Print("Updated the state for light at {LightIndex}")
    
     if (IsPuzzleSolved[]):
         Logger.Print("Puzzle solved!")
         ItemSpawner.Enable()
  9. 次に、パズルが解かれているかどうかを検出する IsPuzzleSolved() メソッドを作成します。IsPuzzleSolved() は失敗コンテキストであるため、別の失敗コンテキスト (if 式など) を使用することなく、失敗する可能性がある式をメソッド本体内で使用できます。この場合、すべてのライトのステートが、解決したパズルのステートと同じであるかをチェックする必要があります。2 つの logic 値が同じであるかどうかをテストするには、失敗する可能性がある式である等号演算子 = を使用できます。チェックした 2 つの値が初めて同じでなかったときにこの式は失敗するため、このメソッドは失敗し、呼び出し元のコンテキスト (この場合は ToggleLights() メソッド内の if 式) に戻ります。 
     IsPuzzleSolved()<decides><transacts> : void =
     Logger.Print(“Checking if puzzle is solved”)
        
     for:
         LightIndex -> IsLightOn : LightsState
         IsLightOnInSolution := SolvedLightsState[LightIndex]
     do:
         IsLightOn = IsLightOnInSolution
  10. Visual Studio Code で変更内容を保存します。
  11. UEFN ツールバーの [Build Verse Scripts (Verse スクリプトをビルド)] をクリックして、作成したコードをコンパイルします。
  12. UEFN ツールバーの [Play (プレイ)] をクリックして、レベルをプレイテストします。

この例で示した設定でレベルをプレイテストするとき、すべてのボタンを 1 回操作するとパズルが解けて、アイテムがスポーンされます。

Player interacting with buttons to find the right combination of lights to solve the puzzle and spawn an item

パズルが解かれたときにボタンのインタラクションを除去する

プレイヤーがパズルを完了した後、ボタンを操作できない、つまりライトのオンとオフを切り替えられないようにします。 このセクションで示すのはイベントのサブスクライブを解除する方法で、プレイヤーがボタンを操作したときにイベント ハンドラが呼び出されなくなります。

仕掛けのイベントに対して Subscribe() を呼び出すと、その関数呼び出しに cancelable 結果があります。Cancel() を cancelable 変数に対して呼び出すと、そのイベントを処理する関数のサブスクライブが解除されるため、その関数はそのイベントがディスパッチされたときに呼び出されなくなります。

パズルが解かれたときに、ボタンのインタラクションを除去するために次のステップに従います。

  1. 各ボタンのイベントをサブスクライブした結果を格納するための、ButtonSubscriptions という名前の cancelable 配列変数フィールドを tagged_lights_puzzle クラスに追加し、空の配列でフィールドを初期化します。 
     var ButtonSubscriptions : []cancelable = array{}
  2. これは for 式の最後の文であるため、成功したすべてのイテレーションの戻り値がその式の戻り値の型の配列に集められます。前に説明したとおり、イベント Subscribe 呼び出しの戻り値の型は cancelable です。これは cancelable の配列 ([]cancellable) になる for の ToggleLights を参照します。これは ButtonsSubscription 型と一致しているため、for 式の結果を ButtonsSubscription 配列に割り当てることができます。このコードを OnBegin 関数内の SetupPuzzleLights の後に追加します。 
     OnBegin<override>()<suspends> : void =
     SetupPuzzleLights()
    
     set ButtonSubscriptions = for:
         ButtonIndex -> Button : Buttons
         LightIndices := ButtonsToLights[ButtonIndex]
     do:
         Button.InteractedWithEvent.Subscribe(button_event_handler{Indices := LightIndices, PuzzleDevice := Self}.OnButtonPressed)
  3. 最後に、プレイヤーがこれ以上 LightsState を変更できないように、忘れずにボタンを無効にします。これを実行するには、cancelable サブスクリプションの呼び出しで、各ボタンの InteractedWithEvent ハンドラのサブスクライブを解除します。これらの ButtonSubscriptions はイベント ハンドラが OnBegin で作成されたときに保存されました。残っているのは、この配列でイテレートして、各 ButtonSubcription に対してキャンセルを呼び出すことだけです。 
     ToggleLights(LightIndices : []int) : void =
     for:
         LightIndex : LightIndices
         IsLightOn := LightsState[LightIndex]
         Light := Lights[LightIndex]
     do:
         Logger.Print("Turning light at index {LightIndex} {if (IsLightOn?) then "Off" else "On"}")
         NewLightState :=
             if (IsLightOn?):
                 Light.TurnOff()
                 false
             else:
                 Light.TurnOn()
                 true
         if (set LightsState[LightIndex] = NewLightState):
             Logger.Print("Updated the state for light at {LightIndex}")
    
     if (IsPuzzleSolved[]):
         Logger.Print("Puzzle solved!")
         ItemSpawner.Enable()
    
         for (ButtonSubscription : ButtonSubscriptions):
             ButtonSubscription.Cancel()
  4. Visual Studio Code で変更内容を保存します。
  5. UEFN ツールバーの [Build Verse Scripts (Verse スクリプトをビルド)] をクリックして、作成したコードをコンパイルします。
  6. UEFN ツールバーの [Play (プレイ)] をクリックして、レベルをプレイテストします。

このデフォルト プロパティでは、1 回すべてのボタンを操作すると、パズルが解けて、アイテムがスポーンされ、それからボタンの操作が無効になります。

次のステップ

このチュートリアルの 最終ステップ では、このチュートリアルの完全なスクリプトを示し、この例をさらに変更するアイデアを紹介します。

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page