UI イベント

4 分

ZEPETOScriptはUnity UIシステムの統合サポートを提供しています。

パネル、ボタン、テキスト入力ボックス、トグルメニューなどの異なるGUIコンポーネントを使用して、あなたの世界のユーザーインターフェースを作成できます。

ZEPETOScriptでUnity UI要素を使用するには、まずそれらをインポートする必要があります。

import { Slider, Button } from 'UnityEngine.UI';

次に、追加したいUnity UI要素をプロパティとして宣言します。

public sliderUI: Slider;
public btnUI: Button;

宣言されたプロパティは、現在ZEPETOScriptインスペクタウィンドウで表示およびアクセス可能です。

階層ウィンドウを開き、Unity UIコンポーネントをZEPETOScriptインスペクタウィンドウの各プロパティフィールドにドラッグアンドドロップします。プロパティ値が割り当てられると、スクリプト内からそれらにアクセスして操作できます。これを使用して、コントロールのイベントのハンドラーを追加します。

Start() {
    this.btnUI.onClick.AddListener(() => {
        // ボタンクリックイベントを追加
        console.log('btnUI onClick');
    });

    this.sliderUI.onValueChanged.AddListener(v => {
        // スライダーイベントを追加
        console.log(`[${v}] sliderUI onValueChanged`);
    });
}

UIイベントが正しく処理されているか確認するためにプレイしてください。

サンプルコード全体を確認してください。

import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { Slider, Button } from 'UnityEngine.UI';

export default class UIEvent extends ZepetoScriptBehaviour {

    public sliderUI: Slider;
    public btnUI: Button;

    Start() {
        this.btnUI.onClick.AddListener(() => {
            // ボタンクリックイベントを追加
            console.log('btnUI onClick');
        });
        
        this.sliderUI.onValueChanged.AddListener(v => {
            // スライダーイベントを追加
            console.log(`[${v}] sliderUI onValueChanged`);
        });
    }
}

ZEPETOScriptが提供するUnity UIについては、以下のリンクをクリックして詳しく学ぶことができます。

📘 Unity UI https://docs.unity3d.com/kr/current/Manual/com.unity.ugui.html

📘 インタラクションコンポーネント https://docs.unity3d.com/kr/current/Manual/comp-UIInteraction.html