イベント

概要

簡単に言えば、イベントは実験の「頭脳」または「ロジック」です。 それは、あなたの研究が何をすべきか、いつすべきかを指示するために設定するルールです。

それらは、あなたの実験に命を吹き込むシンプルな**「もし-なら」文**や因果関係のルールのように考えてください。

  • もしこれが起きたら…（これはトリガーです）
  • ならそれを行います。（これはアクションです）

あなたの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)（例：'score'変数が増加したとき）。
  • メディアオブジェクトトリガー： Playback Started, Playback Ended.

2. アクション（「何を」）

アクションは、トリガーが発生した後に実験が実際に行うことです。それは、特定のトリガーが発生したときの「効果」とその後の結果です。

利用可能なアクションの完全なリストは、こちらを参照してください。

一般的なアクションには次のものがあります：

  • ジャンプアクション： Jump to Frame, Jump to Next Trial.
  • オブジェクトアクション： Set Object Property（例：画像を見えなくする）
  • 変数アクション： Set/Record Variable（例：'score'に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の視覚的なノーコードインターフェースで実験全体のロジックと流れをプログラムするために使用するビルディングブロックです。 それらをマスターすることが、オンラインおよびラボ内の実験や心理学研究のための洗練された専門的な研究を作成する鍵です。

イベントの作成

イベントを作成するには、タスクエディタで任意のタスクを開き、イベントパネルの+ Add Event [verify in codebase]をクリックします。

イベントウィザードが開き、最初のページに表示されたすべての利用可能なトリガーがグリッドレイアウトで表示されます。このビューから直接トリガーを選択します：トリガーピッカーを開くための追加のクリックは必要ありません。選択した後、ウィザードはアクションステップに進み、トリガーが発生したときに何が起こるかを定義します。

Note: 利用可能なすべてのトリガーとアクションの完全な参照については、イベントシステムのリファレンス。を参照してください。

役立つページ