イベント
概要
簡単に言うと、イベントは実験の「頭脳」または「ロジック」です。 それは、あなたが自分の研究に何をどのようにするべきかを指示するルールです。
それらを単純な**「もし〜なら」ステートメント**や因果関係のルールとして考えてください。これがあなたの実験を生き生きとさせます。
- もしこれが起こったら...(これはトリガーです)
- ならばそれを行います。(これはアクションです)
あなたのLabvanced研究のすべてのインタラクティブな要素、すべての動的タイミング、そしてすべての条件付き変更は、イベントによって制御されています。
イベントの2つのコアコンポーネント
Labvancedでイベントを作成する際には、常にこれらの2つの部分で作業します：
1. トリガー（"いつ"）
トリガーは、イベントを発火させる特定の条件です。リスナーのように求められているものと考えてください。トリガーは、因果関係における「原因」のようなものです。
一般的なトリガーには以下が含まれます：
- ユーザー入力トリガー：
Mouse Move,On Key Press,Joystick。 - 生理的信号トリガー：
Eye Tracking Gaze（例えば、特定の画像を見るとき）、Head Tracking - 試行およびフレームトリガー：
On Trial Start,On Frame Start。 - 変数変更：
Variable (Value Change)（例えば、'スコア'変数が増加するとき）。 - メディアオブジェクトトリガー：
Playback Started,Playback Ended。
2. アクション（"何"）
アクションは、トリガーが発生した後に実験が実際に行うことです。それは、特定のトリガーが発生したときの「効果」とその後の結果です。
一般的なアクションには以下が含まれます：
- ジャンプアクション：
Jump to Frame,Jump to Next Trial。 - オブジェクトアクション：
Set Object Property（例えば、画像を見えなくする）。 - 変数アクション：
Set/Record Variable（例えば、'スコア'に1を加算する、反応時間を記録する）。 - APIアクション：
Send to WebSocket,Send to OpenAI。
イベントの実用例
以下は、心理学実験における一般的なシナリオと、それらがイベントを使用して構築される方法です：
シナリオ 1: "次へ"ボタンをクリックして進行。
- トリガー：
On Mouse Click（ボタンオブジェクト上） - アクション：
Jump to Next Frame
シナリオ 2: シンプルな反応時間タスク（円を見たら'J'を押す）。
- トリガー：
On Key Press - アクション 1：
Set/Record Variable（キー入力を記録するための変数） - アクション 2：
Set/Record Variable（例えば、反応時間のためのフレーム開始からの時間を記録する変数） - アクション 3：
Jump to Next Trial
1つのトリガーに対して複数のアクションを持つことができます。
シナリオ 3: ちょうど500msテキストを表示。
- イベント 1:
- トリガー：
On Frame Start - アクション：
Control Action特にDelayed Actionオプションを500msに設定し、テキストオブジェクトのアクションシーケンスをSet Object Propertyに指定して、Visibilityプロパティが0であることを指定します。
- トリガー：
イベントが重要な理由
イベントなしでは、Labvancedの研究は静的なものになります。イベントはあなたの実験を次のようにします：
- インタラクティブ： 参加者の行動に応じて研究が反応します。
- 動的： パフォーマンスに基づいて実験の流れを変更することができます（例えば、適応タスクの場合）。
- 正確なタイミング： 刺激が表示される瞬間をミリ秒単位で制御することができます。
- データが豊富： 反応時間、選択、正確さなどの重要なデータポイントを発生する正確な瞬間に記録するためのメカニズムです。
要約すると、イベントはLabvancedの視覚的なノーコードインターフェースで実験の全ロジックと流れをプログラムするために使用する構成要素です。 これらをマスターすることが、オンラインおよび実験室での洗練されたプロフェッショナルな研究、心理学研究を作成するための鍵です。
イベントの作成
イベントを作成するには、タスクエディターのイベントパネルで任意のタスクを開き、現在のフレームにスコープされたイベントを追加するためにFrame Event (this frame only)をクリックするか、各試行のすべてのフレームで実行されるイベントを追加するためにTrial Event (on each frame)をクリックします。
イベントウィザードが開き、利用可能なトリガーが最初のページにグリッドレイアウトで表示されます。このビューから直接トリガーを選択できます：トリガーピッカーを開くために余分なクリックは必要ありません。選択すると、ウィザードはトリガーが発生したときに何が起こるかを定義するアクションステップに進みます。
Note: 利用可能なすべてのトリガーとアクションの完全なリファレンスについては、イベントシステムリファレンスを参照してください。
さらなる読み物 - トリガー
さらなる読み物 - アクション