イベントシステム {/examples/}

説明

イベントシステムは、あらゆる研究において不可欠です。これにより、記録すべき値を設定し、実験を進行させ、タスクを作成します。ユーザーはタスク内のすべての機能、ロジック、および相互作用を実行するためにイベントシステムを作成できます。イベントはしばしばオブジェクトと変数の間の媒介者として機能します。

イベントシステムは、トリガーとアクションで構成されています。ここでは、「これが発生したとき」（トリガー）「次にこれを実行する」（アクション）というルールを設定します。たとえば、参加者が特定の画像をクリックした（トリガー）場合、異なるランダムな画像を表示する（アクション）というように。

Labvancedにおけるイベントの動作についての紹介は、こちらの短い動画をご参照ください：

イベントは、画面右上の「イベント」タブにあるタスクエディタで管理されます。「+フレームイベント」をクリックすると、そのフレームで発生すべきイベントを新しく作成することができ、「+トライアルイベント」をクリックすることで、すべてのフレームにこのイベントを適用できます。すべての既存のイベントは、右側のパネルのリストビューに表示されます。イベントはフレームレベルで定義され、各フレームごとに別個または特定のものにすることも、試行全体の各フレームで複製または同一にすることもできます。

Labvancedでのイベントの追加

いずれの場合でも、イベントは指定されたフレームの試行グループ内のすべての試行に対して常に定義されます。ただし、カスタムロジックにより、ユーザーは特定の試行、条件、または他の状況でのみイベントを実行することができます。

以下の動画では、Labvancedで利用できるトリガーとアクションの概要が示されています：

イベントの実行順序は調整可能です。デフォルトでは、同じトリガーを持つイベントはリストの上位にあり、最初に実行されます。イベントはまた、コピーされたり削除されたりすることもできます。既存のイベントを選択すると、詳細は右下の（イベントプロパティ）パネルに表示されます。より良い概要を得るために、既存のイベントは再開することもできます（名前フィールドの隣にあるアイコン）。

トリガー {/examples/}

トリガーは、イベントが実行されるタイミングを定義します。これは、特定のオブジェクトに対するマウスクリック、特定のキーボード入力、変数の変更、ビデオファイルの開始、またはその他多くのことが含まれます。すべてのトリガーとその設定/パラメータは、以下のリストで説明されています。

トリガーカテゴリ	トリガーオプション	説明
`ユーザー入力トリガー`	マウストリガーキーボードトリガーボタンクリック入力でEnter スクロールトリガーゲームパッド/ジョイスティックトリガー	ユーザー入力トリガーは、ユーザーや参加者がマウスを動かしたり、キーボード要素をクリックしたり、スクロールしたりするなどの手動でアクティブ化できる任意のトリガーを指します。
`生理信号トリガー`	眼追跡凝視眼追跡固定頭追跡	生理信号トリガーは、特定の要素を見ているときや、頭の動きの変化があるときに発生します。
`試行とフレームトリガー`	タスク初期化フレーム初期化フレーム開始フレーム終了	これらのトリガーは、試行やフレームに関するものであり、フレームの開始や終了などが該当します。
`変数値変更トリガー`	変数（値が変更された）	特定の変数値に変更があったときにイベントがトリガーされます。
`メディアオブジェクトトリガー`	メディアオブジェクトトリガー	メディアオブジェクトに関連するトリガーであり、ビデオ/音声ファイルの一時停止、録音の完了などに関して発生します。
`APIトリガー`	ウェブソケットトリガーオープンAIトリガー	APIからの受信データがあるときに発生するトリガーです。
`グローバルトリガー`	実験の一時停止/再開参加者がマルチユーザー研究を離れた	グローバルトリガーは、実験の重大な変更、実験が一時停止されたり、マルチユーザー研究の参加者が退出するときのことを指します。

ユーザー入力トリガー {/examples/}

ユーザー入力トリガーは、ユーザーや参加者が手動でアクティブ化できる任意のトリガーを指します。

Labvancedのユーザー入力トリガーメニュー

下の表は、Labvancedで利用可能なすべてのユーザー入力トリガーの概要を提供します。それぞれについては、次のセクションで詳細に説明します。

ユーザー入力トリガーオプション	概要
`マウストリガー`	マウスの動きは、イベントを開始するためのトリガーとして使用できます。例えば、スクロール、クリック、ホバーなどがあります。特定の要素やターゲットをトリガーに関連付けることもできます。たとえば、特定の画像をクリックしたときにのみマウスのクリックをトリガーとして使用します。
`キーボードトリガー`	キーボードの任意のキーをトリガーとして使用できます。特定のキーボードの文字や数字をトリガーとして指定できます。
`ボタンクリック`	Labvancedで作成されたボタンオブジェクトをトリガーとして、イベントを開始することができます。
`入力でEnter`	このトリガーは、参加者が実験中に「Enter」を押したときによく使用されます。これは、テキストフィールドエリアに入力された応答を送信する手段として使用されます。
`スクロールトリガー`	このトリガーは、参加者がスクロールしたときに発生します。スクロールの方向をx軸またはy軸として指定でき、スクロールが発生する要素をイベントトリガーとして使用できます。
`ゲームパッド/ジョイスティックトリガー`	このトリガーを使用すると、ゲームパッドやジョイスティックコントローラーを入力デバイスとして使用し、データを記録することができます。

マウストリガー {/examples/}

「マウストリガー」オプションは、任意のマウスの操作に基づいてイベントを開始する非常に人気のあるトリガーです。例えば、マウスを上下に移動したり、クリックしたり、特定のオブジェクトにホバーしたり、特定のオブジェクトから離れたり、あらゆる動きをトリガーにすることができます！

Labvancedの入力トリガーメニュー内の「マウストリガーメニュー」オプション。

以下の例は、「ターゲット」と呼ばれるオブジェクト「Image_1」に対して「左」マウスクリックによって「クリック」が行われるときに発生する「マウストリガー」を示しています：

Labvancedでのマウストリガーオプションの使用例。

以下は、マウストリガーを使用する際に選択できるオプションの全体的な概要です。

メニュー項目	メニューエリア	マウストリガーオプションと仕様
`アクション` ドロップダウンリスト:		以下のマウストリガーオプションがドロップダウンリストから利用可能です: クリック: マウスクリックによってトリガーされます PressDown: マウスダウンでトリガーされます PressUp: マウスアップでトリガーされます Hover: オブジェクト上にマウスを移動させるとトリガーされます Leave: オブジェクトからマウスを離すとトリガーされます Move: 任意のマウスの動きでトリガーされます
`ボタン` ドロップダウンリスト:		左: 左マウスボタンでトリガーされます右: 右マウスボタンでトリガーされます
`ターゲット` オプション:	上の例では、‘Image_1’がイベントをトリガーするボタンクリックのターゲットです。複数のターゲットは、下部の`‘+ターゲット追加’`オプションをクリックすることで追加できます。	ターゲットを指定する際、以下のオプションが利用可能です: フレーム背景でトリガー: オブジェクトや要素をクリックせずにマウストリガーをアクティブ化できます。任意の要素: フレーム上の任意の要素をクリックするとマウストリガーがアクティブ化されます。ターゲットを追加: トリガーをアクティブ化するためにクリックする必要がある特定の要素を選択します。

注: イベントシステムでマウストリガーを選択した後、トリガー固有のマウス値をさまざまなアクションにわたって利用および参照するオプションがあります。

キーボードトリガー {/examples/}

「キーボードトリガー」オプションは、イベントトリガーとして他の人気のある方法です。基本的に、キーボードからの任意の入力をトリガーとして使用できます。これは、キーを押したり、長押ししたり、キーを離したりすることを含みます。

Labvancedのキーボードトリガーオプション

以下の例では、指定されたターゲット数値（0、2、または6）が押されたときに発生するキーボードキーをトリガーとして設定しています：

キーボードトリガーの使用例。

以下は、キーボードトリガーを使用する際に選択できるキーとオプションの全体的な概要です。

メニュー項目	メニューエリア	キーボードトリガーオプション
`アクション` ドロップダウンリスト:		これらは利用可能なキーボードアクションオプションです: PressKey: キーが押されたときにトリガーされます（キーが押し下がっている状態） Press OR Hold Key: キーが押されているか長押しされたときにトリガーされます ReleaseKey: キーが離されたときにトリガーされます注: キーは再度トリガーとして“発火”する前にリリースする必要があります。
`キー` どのキーがイベントをトリガーするか		どのキーがトリガーとして使用されるかを、ここで指定するためにオプションを選択します。 `+追加:`をクリックすることで追加できます。矢印: 4つの矢印キー数字: 0から9までの数字文字: 英語アルファベットのすべての文字特殊: 特殊キー（Enter、Space、Control、Tab、Shift） Fキー: F1からF10まで任意のキー: これらのいずれかのキーが受け入れられます複数のキーボードトリガーは、再度`+追加:`ボタンをクリックすることで追加できます。
追加オプション		ナンバーパッドボタンを有効にするオプションにより、ナンバーパッドキーを実験内のトリガーとして使用できます。イベントの伝播を許可オプションの場合、複数のイベントが同じキーボードトリガーを持つ場合、それらはすべてトリガーされます。最初のものだけが発火し、最初のイベントが完了するとイベント実行が停止します。

注: イベントシステムでキーボードトリガーを選択した後、トリガー固有のキーボード値をさまざまなアクションにわたって利用および参照するオプションがあります。

ボタンクリックトリガー {/examples/}

エディタにボタンまたはナビゲーションオブジェクトを配置した場合、ボタンクリックがアクションのトリガーとして機能するイベントの一部として利用できます。

Labvancedのボタンクリックメニュー

このトリガーをクリックすると、どの特定のボタンがトリガーとして機能するかを指定できるメニューが表示されます：

ボタンクリックトリガーに利用可能なオプション

アイテムの詳細は次のとおりです：

メニュー項目	メニューエリア	ボタンクリックトリガーオプション
ターゲット: `+ターゲットを設定`		ボタン要素をターゲットとして選択
`ボタン:` オプション		フレーム上のどの特定のボタンを指定

注: イベントシステムでボタンクリックトリガーを選択した後、トリガー固有のボタンクリック値をさまざまなアクションにわたって利用および参照するオプションがあります。

入力でEnterトリガー {/examples/}

トリガーは、特定の要素がアクティブなときにキーボードのEnter/Returnキーが押されたときに発生します。

パラメータ：

ターゲット追加: イベントに入力要素を追加します。
注: イベントシステムで入力でEnterトリガーを選択した後、トリガー固有の入力でEnter値をさまざまなアクションにわたって利用および参照するオプションがあります。

スクロールトリガー {/examples/}

トリガーは、特定の要素に対してスクロールバー、トラックパッド、またはマウスのスクロールホイールが使用されたときに発生します。

パラメータ：

スクロールがY軸またはX軸（垂直スクロールまたは水平スクロール）かを選択します。

ターゲット: スクロールトリガーが適用されるターゲット要素を設定します。

注意：長いテキストの場合は、'オブジェクトのプロパティ'パネルの'スタイル'セクションで、Overflow-Xおよび/またはOverflow-Yオプションがscrollに設定される必要があります。

注: イベントシステムでスクロールトリガーを選択した後、トリガー固有のスクロール値をさまざまなアクションにわたって利用および参照するオプションがあります。

ゲームパッド/ジョイスティックトリガー {/examples/}

ゲームパッド/ジョイスティックトリガーを使用すると、実験デザインでゲームパッドおよびジョイスティックコントローラーをデータ記録のための入力デバイスとして利用できます。注: このオプションを設定タブで有効にすることを忘れないでください。

このトリガーを選択すると、以下のダイアログボックスが表示されます。

ゲームパッドを接続すると、トリガーとして使用する具体的なキーを指定できます。特定のキーを押すと、そのIDが表示されます。

以下の例では、2は◎キーを、3は▵キーを指します。注: ゲームパッドのキーID割り当てには、いくつかのばらつきがあることに注意してください。

キーを押すと、ライブデータもこのトリガーダイアログボックスの後半に表示され、押すまたは離す内容に基づいて値がリアルタイムで変化する様子を見ることができます：

ゲームパッドトリガーのライブデータフィード

このトリガーを利用した研究の詳細や例については、このウォークスルーをご覧ください。

以下の表は、これらのオプションについてさらなる詳細を説明します。

メニュー項目	メニューエリア	ゲームパッド/ジョイスティックトリガーオプション
`ボタンのリスニング`		I.) トリガーがボタンに関連し、押下キー、押下または離すキー、または離すキーのいずれかであるかを指定します。 II.) トリガーが任意のボタン用か特定のボタン用かを指定します。特定のオプションが選択された場合、ゲームパッドのボタンを押すように促されます。
`軸のリスニング`		軸の動きが必要な場合、しきい値が特定の値で変化するたびにトリガーが発生することを指定できます。デフォルト値は0.01です。
接続状況		デバイスが接続されているかどうかを示します。
ライブデータストリーム		デバイスを接続し、キーを押したり軸を動かしたりすると、ライブデータが表示され、デバイスで行う入力が表示されます。これは、研究を設定する際に、利用したいキーや軸を特定するのに役立ちます。

注: イベントシステムでゲームパッド/ジョイスティックトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有の値を利用および参照するオプションがあります。値選択メニューを使用します。

生理信号トリガー {/examples/}

これらのトリガーは、眼追跡および/または頭追跡がタスクに対して有効になっている場合にのみ適用されます。

眼追跡凝視トリガー {/examples/}

トリガーは：

全体として、このトリガーは眼追跡が有効になっているときに適用されます。
特定の要素を見ているときのみトリガーします。

パラメータ：

特定の要素でのみトリガーすることを選択している場合、これらの要素をターゲットとして追加します。
注: イベントシステムで眼追跡凝視トリガーを選択した後、トリガー固有の凝視値をさまざまなアクションにわたって利用および参照するオプションがあります。

眼追跡固定トリガー {/examples/}

このトリガーは現在BETA版です。

注: イベントシステムでキーボードトリガーを選択した後、トリガー固有の固定値をさまざまなアクションにわたって利用および参照するオプションがあります。

頭追跡トリガー {/examples/}

トリガーは：

頭の向きや動きの変化に対して発生します。
注: イベントシステムで頭追跡トリガーを選択した後、トリガー固有の頭追跡値をさまざまなアクションにわたって利用および参照するオプションがあります。

試行とフレームトリガー {/examples/}

タスク初期化トリガー {*}

トリガーは：

タスクの最初の試行の最初のフレームにて。一つのタスクにつき一回のみ実行されますが、すべてのインスタンスのフレームのイベントタブに表示されます。

このトリガーは、シャッフルおよび読み込みアクションと組み合わせるのに適しています。この組み合わせを使用すると、タスクが開始される際に配列のエントリやデータフレームをシャッフルし、被験者を刺激のセットに割り当てることができ、刺激やデータを読み取るための複数のイベントを作成する必要がありません。

パラメータ：なし

注: イベントシステムでタスク初期化トリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のタスク初期化値を利用および参照するオプションがあります。値選択メニューを使用します。

フレーム初期化トリガー {/examples/}

トリガーは：

フレームの初期化時に、参加者に可視化される前に発生します。

このトリガーは、シャッフル、読み込みおよびランダム数描画アクションと組み合わせるのが効果的です。このアクションの組み合わせは、フレームが表示される前に完了することができ、フレーム開始時に他のアクションが開始できる明確な経路を残します。

注: フレーム初期化トリガーを変数の記録や、試行番号や条件番号などのシステム変数に関連するイベントで使用しないでください。これは、フレーム初期化トリガーが試行の間に発生するため、表示される試行や条件の正確なカウントがないからです。

パラメータ：なし

注: イベントシステムでフレーム初期化トリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のフレーム初期化値を利用および参照するオプションがあります。値選択メニューを使用します。

タスク及びフレーム初期化トリガーに関する注意: タスク及びフレーム初期化トリガーは、タスクまたはフレームが始まる前に発生するため、この時間に作成された変数はタスク/フレームが実際に開始されるとリセットされます。このイベントを使用する際に警告が表示されます。

フレーム初期化警告

試行スタート時に変数値をリセットしないようにするには、変数プロパティウィンドウの「試行開始時にリセット」のチェックを外してください。

フレームスタートトリガー {/examples/}

トリガーは：

フレームの開始時に発生します。

パラメータ：なし

注: イベントシステムでフレームスタートトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のフレームスタート値を利用および参照するオプションがあります。値選択メニューを使用します。

フレームエンドトリガー {/examples/}

トリガーは：

フレームの終了時（フレームがもはや可視でないとき）に発生します。

パラメータ：なし

注: イベントシステムでフレームエンドトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のフレームエンド値を利用および参照するオプションがあります。値選択メニューを使用します。

変数値変更トリガー {/examples/}

変数値変更

トリガーは：

変数の値がその初期値から変更されたときに発生します。

パラメータ：

変数: 変更を「リスン」したい1つ以上の変数を選択します。これらの変数の値が変更されると、対応するアクションが直ちにトリガーされます。
注: イベントシステムで変数値変更トリガーを選択した後、さまざまなアクションにわたってそのトリガー固有の変数値変更値を利用および参照するオプションがあります。値選択メニューを使用します。

メディアオブジェクトトリガー {/examples/}

メディアオブジェクトトリガー

以前は別々の「オーディオ/ビデオトリガー」と「オブジェクト制御」トリガーとして知られていました。

トリガーは：

ビデオやオーディオファイルの開始、一時停止、または停止
録音オブジェクトのファイルアップロード完了、ファイル選択、録音完了
カメラスナップショットオブジェクトのスナップショット完了またはアップロードの完了

パラメータ：

ターゲット: フレーム上に存在するオブジェクト要素を選択します
実行時: トリガーのサブタイプを選択します。
- オーディオまたはビデオオブジェクトオプション:
  - 再生開始: 要素が再生を開始したときにトリガーされます。
  - 再生停止: 要素が一時停止したときにトリガーされます。
  - 再生終了: 要素の再生が停止したときにトリガーされます。
- ビデオ、オーディオ、または画面録画オブジェクトオプション:
  - 録音完了: オーディオ録音が停止したときにトリガーされます。
  - アップロード完了: ファイルのアップロードが完了したときにトリガーされます。
- ファイルアップロードオブジェクトオプション:
  - ファイル選択: ファイルが選択されたときにトリガーされます。
  - アップロード完了: ファイルのアップロードが完了したときにトリガーされます。
- カメラスナップショットオブジェクトオプション:
  - スナップショット完了: カメラがスナップショットを正常に撮影したときにトリガーされます。
  - アップロード完了: スナップショットのアップロードが完了したときにトリガーされます。
注: イベントシステムでメディアオブジェクトトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のメディアオブジェクト値を利用および参照するオプションがあります。値選択メニューを使用します。

APIトリガー {/examples/}

外部サーバーからLabvancedにデータを送信または通信する必要がある場合は、‘APIトリガー’と‘APIアクション’を使用できます。以下は、トリガーとして使用できるものです。

ウェブソケットトリガー
OpenAIトリガー

LabvancedのAPIトリガーメニュー。

ウェブソケットトリガー {/examples/}

ウェブソケットトリガーは、ウェブソケット/APIからのメッセージを受信し、アクションのトリガーとして処理する際に使用されます。

ウェブソケットトリガーメニューオプション。

このオプションをクリックすると、以下の項目が表示されます。

ウェブソケットトリガーダイアログメニュー。

* **受け入れ/受信先:** 自動的にローカルホストのIPアドレスを検出します。これで手動で変更できます。 [`設定`](/content/learn/ja/guide/settings/)タブの`特別な機能`で変更できます。 * **トリガー/メッセージ:** トリガーとして使用されるメッセージを入力します。複数のメッセージをトリガーとして受け入れるには、「任意」と入力します。

APIトリガー/アクションがどのように使用されるかの例については、このデモhttps://www.labvanced.com/page/library/51053を' Inspect 'オプションをクリックしてご覧ください。

APIアクセスに関する詳細情報は、こちらのページをご覧ください。

注: イベントシステムでウェブソケットトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のウェブソケット値を利用および参照するオプションがあります。値選択メニューを使用します。

OpenAIトリガー {/examples/}

‘OpenAIトリガー’は、OpenAIからの受信情報に基づいてアクションを開始するために使用できます。

LabvancedのOpenAIトリガーメニュー。

このオプションを選択すると、以下のパラメータが表示されます。

OpenAIトリガーメニューオプション。

注: このウォークスルーも参照してください。そこで、ChatGPTを研究に統合し、このトリガーを使用して段階的に研究を構築します。

以下の例では、割り当てられたデータフレームを'df'と呼び、'OpenAIトリガー'からの結果がこのデータフレームに追加されます。このデータフレームには2つの列が必要です。最初の列は「役割」を示し、2番目の列は「チャットメッセージ」を示します。アクションからの値は、自動的にここにリンクされたデータフレームに追加されます。

LabvancedのOpenAIトリガーの例。

‘OpenAIに送信するアクション’も使用している場合は、そこでもここに示したのと同じデータフレームを利用する必要があります。

注: イベントシステムでOpenAIトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有のOpenAI値を利用および参照するオプションがあります。値選択メニューを使用します。

グローバルトリガー {/examples/}

グローバルトリガーは、実験内で重大な変更が発生したときに発生します。つまり、実験を一時停止したり、参加者がマルチユーザー研究を離れたりすることなどです！以下は、グローバルトリガーとしてリストされているオプションです。

実験の一時停止/再開
参加者がマルチユーザー研究を離れた

Labvancedのグローバルトリガーメニュー。

一時停止/再開実験 {/examples/}

‘一時停止/再開実験’トリガーは、実験が一時停止または再開される際にイベントを実行するオプションです。

トリガーとして実験を一時停止するオプション。

このトリガーを選択すると、以下のビューが表示され、トリガーの性質を更に指定できます。実験が一時停止または続行されたときに実行するかを選択できます：

このグローバルトリガーのためのダイアログメニューグローバルトリガーメニューで利用可能なオプション

実験が一時停止: 参加者が（フルスクリーンを終了して）研究を一時停止します。
実験が再開: 参加者が研究を再開します。このトリガーは眼追跡研究に適しています。参加者がバーチャルチンレストから離れた場合、その試行やフレームに戻すために使用できます。
注: イベントシステムで一時停止/再開実験トリガーを選択した後、さまざまなアクションにわたってそのトリガー固有の値を利用および参照するオプションがあります。値選択メニューを使用します。

参加者がマルチユーザー研究を離れた {/examples/}

参加者がマルチユーザー研究を離れた場合、これもイベントのトリガーとして使用できる場合があります。参加者がマルチユーザー研究を離れることで、他の参加者が研究を続けることを妨げるため、実験に対してグローバルな影響を与えます。

Labvancedのトリガーとしてマルチユーザー研究を離れた参加者

このトリガーを選択すると、参加者がマルチユーザー研究を離れた場合に発生するアクションの種類を指定できます。

マルチユーザー研究を離れた参加者トリガーダイアログボックス。

注: イベントシステムで参加者がマルチユーザー研究を離れたトリガーを選択した後、さまざまなアクションにわたってそのトリガー固有の値を利用および参照するオプションがあります。値選択メニューを使用します。

アクション {/examples/}

アクションは、イベントが実行されたときに何が発生すべきかを定義します。これらは変数やオブジェクトのプロパティを変更したり、データを記録したり、配列からのデータの読み書きを行ったり、次の試行やタスクにジャンプしたりするために使用できます。通常、1つのイベントに対して複数のアクションがあります。"ControlActions"を使用すると、論理演算（If-Elseステートメント）、ループ、コールバック関数を使用し、アクションを入れ子にできます（例：if文内のwhileループ）。したがって、イベントシステムはグラフィカルプログラミング環境と見なすことができます。この見方では、トリガーは関数の呼び出しとして機能し、アクションは機能の論理を説明します。このアプローチにより、特定のプログラム的/構文的構造を使用することなく、ほとんどすべての実験ロジックを実装できます。

以下の表は、Labvancedで利用可能なアクションの概要を提供します：

アクションカテゴリ	アクションオプション	説明
`オブジェクトアクション`	オブジェクトプロパティを設定メディアオブジェクトを制御オブジェクトをコピーオブジェクトごとに	オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる任意の操作を指します。
`変数アクション`	変数を設定/記録クリップボードにコピーランダム数を描画 URLパラメータを取得デバイスから読み取り/書き込み共有変数から読み取り/書き込み数学と統計変数を瞬時に記録移動平均フィルタ変数を配布	変数の値を読み取るか記録するアクションです。
`配列アクション`	配列から選択（読み取り）配列エントリの追加/削除配列エントリの変更（置換）配列エントリをシャッフル	配列操作は、配列とそのエントリを選択、追加、削除、変更、シャッフルすることを含みます。
`データフレーム操作`	データフレームから読み取る/書き込むデータフレームエントリをシャッフル	これらのアクションは、実験内で.csvファイル（データフレーム）を扱う際に関連しています。
`ジャンプアクション`	ジャンプ先セッションを受け入れる/終了するセッションを拒否する/終了する URLにリダイレクト	特定のセクションにジャンプしたり、参加者セクションを受け入れたり拒否したりすることで、実験をナビゲートできます。
`制御アクション`	要件アクション（If…Then）繰り返しアクション（Whileループ）遅延アクション（時間コールバック）アクショングループ	制御アクションは、特定のイベントシーケンスを実行するために使用されます。たとえば、if/thenロジック、ループ（繰り返し音を再生したり画像を点滅させたりするなど）、またはアクションが発生するまでの遅延を設定するなどの機能です。
`APIアクション`	ウェブソケットに送信 OpenAIに送信	APIにデータを送信するためのAPI特有のアクションです。
`コードアクション`	JavaScriptを実行グローバルCSSを設定	コードアクションは、JavaScriptまたはCSSを使用して作業できます。
`ペーストアクション`	ペーストアクション	以前にコピーしたアクションをペーストできます。
オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる任意の操作を指します。いくつかのオブジェクトアクションのオプションがあります：

オブジェクトプロパティを設定
メディアオブジェクトを制御
オブジェクトをコピー
各オブジェクトに対して

Labvancedのオブジェクトアクションオプション。

オブジェクトプロパティ設定アクション

「オブジェクトプロパティを設定」アクションを使用すると、問題のオブジェクト、変更するプロパティ、および新しい値を指定することで、オブジェクトの外観を任意の方法で変更できます。

以下の例では、アクションが対象の画像の2つのプロパティを変更し、「visibility」を「1」に設定し、「height」を「400」に設定する一方で、この変更が画面に表示された時間を「Object_Prop_Change_Time」という名前の数値変数に保存して記録します。

Labvancedのオブジェクトアクションの例。

以下は、「オブジェクトプロパティを設定」アクションを使用する際に遭遇するフィールドの全体像です：

メニュー項目	メニューエリア	オブジェクトプロパティ設定トリガーオプション
`Target` オブジェクト選択ドロップダウンリスト:		最初のドロップダウンリストには、そのフレームにあるオブジェクトが表示され、選択できます。このアクションがどの特定のオブジェクトに対して行われるかを示します。
`Target` プロパティ選択ドロップダウンリスト:		二番目のドロップダウンメニューは、変更されるオブジェクトのプロパティを示します。利用可能なオプションおよびそのパラメータの完全な説明については、オブジェクトプロパティテーブルを参照してください。
`Value Select Menu`		新しい値を定義します。つまり、アクションによって新しいオブジェクトプロパティの値として何を設定すべきかを指定します。 `Value Select Menu`を利用します。
`‘+ Add Property’`		このアイコンをクリックすると、アクションの下に複数のプロパティを追加して変更できます。
チェックボックス - この変更が画面に反映されたときの時間を記録する (フレームの開始からミリ秒単位で計測)。		プロパティが変更されると、短時間 (約 ~10ms) の後に変更が表示されます。このオプションを使用すると、変更されたプロパティが次回の表示更新で本当に表示される時間をより正確に記録できます。注意: このオプションを選択すると、キャプチャした値を保存するための変数を示すダイアログボックスが表示されます。変数は「データ型」として数値である必要があります。

メディアオブジェクト制御アクション

以前の「オーディオ/ビデオ制御」および「オブジェクト制御」アクション。

効果：ビデオ/オーディオ要素の再生を変更するか、アップロード/録音要素の状態を変更します。

パラメータ：

ターゲット: 1つのメディアオブジェクトを選択
効果: サブアクションを選択
- オーディオまたはビデオオブジェクトオプション:
  - 再生開始: ビデオ/オーディオファイルの再生を開始
  - 再生停止: ビデオ/オーディオファイルの再生を停止
  - 再生一時停止: ビデオ/オーディオファイルの再生を一時停止
  - JumpToTime: オーディオ/ビデオファイル内でジャンプするミリ秒の時間を指定することができます
  - ミュート: オブジェクトの音をオフにします
  - オフミュート: オブジェクトの音を復元します
- オーディオ、ビデオ、または画面録画オブジェクトオプション:
  - 録音開始: 新しい (オーディオ) 録音を開始します
  - 録音停止: (オーディオ) 録音を停止します
  - アップロード開始: ファイルのアップロードを開始します
  - 録音クリア: (オーディオ) 録音データを削除します
  - 再生開始: 録音されたファイルを再生します
  - 再生停止: 録音されたファイルの再生を停止します
  - 録音一時停止: オブジェクトの録音を一時停止します
  - 録音再開: オブジェクトの録音を再開します
- ファイルアップロードオブジェクトオプション:
  - アップロード開始: 選択したファイルのアップロードプロセスを開始します
  - ファイルクリア: 選択したファイルを削除します
  - ファイル選択: 参加者が望むファイルを選択できるようにします
- カメラスナップショットオブジェクトオプション:
  - カメラ開始: 参加者のカメラをオンにします
  - カメラ停止: 参加者のカメラをオフにします
  - アップロード開始: スナップショットを実験にアップロードします
  - スナップショット取得: 参加者のカメラを使用して写真を撮ります

オブジェクトコピーアクション

効果：オブジェクトをコピーし、複数の個別オブジェクトや重複イベントを必要とする代わりに使用します。

パラメータ：

ソース: コピーするフレームのオブジェクトを選択します。
コピー数: ソースオブジェクトのコピー数を入力します。
新しい要素名を設定: 複数のパラメータから選択してコピーの名前を決定します。
インクリメントポストフィックスで名前を割り当て: コピーを区別するために新しい要素名の末尾に数値タグを追加します。
アクションシーケンス: 同じくアクションのリストからコピーに対して発生することを選択できます。「CurrentObject」をターゲットとして選択すると、すべてのコピーにアクションが適用されます。

各オブジェクトアクション

効果：同じタイプの複数のオブジェクトにアクションを適用します。

パラメータ：

フィルター: ターゲットにする要素のタイプを選択します。
追加の名前フィルターを許可: ターゲットにするオブジェクトの名前を入力します。フレーム上に同じ名前のオブジェクトがある場合に便利です。
アクションシーケンス: 選択した要素に何が起こるかを選択するための通常のアクションリストから選択できます。「CurrentObject」をターゲットにすると、上記の指定された条件を満たすすべての要素にアクションが適用されます。

変数アクション

変数アクションは、変数の値を設定または作成し、値を記録および定義する際に使用され、セッション間の値も含まれます。

イベントシステムにおける変数アクションの位置

以下の表は、Labvancedで利用可能なすべての変数アクションオプションの入門概要を提供します。それぞれは、今後のセクションで詳細に説明されます。

変数アクションオプション	説明
`Set / Record Variable`	変数値を書き込むか設定する
`Copy to Clipboard`	変数値をコンピュータの内部クリップボードにコピーします。
`Draw Random Number`	1つまたは複数のランダムな数値を描画し、それらを変数に保存します。
`Get URL Parameter`	参加者のユニークURLから値を保存します。
`Read from / Write to Device`	ローカルデバイスのストレージから変数を読み取るか書き込みます。このアクションはデータをLabvancedのサーバーに送信するのではなく、参加者のデバイスにデータを保存します。
`Read from / Write to Shared Variable`	研究のセッション間で共有される変数から読み込むか書き込みます。この変数はすべての参加者と共有されるか、各個人のプライベートであるかどちらかです。
`Math & Statistics`	入力変数（配列）の数学的操作を行い、結果を出力変数に保存します。
`Record Variables Instantly`	すべての変数値のスナップショットを作成し、これをLabvancedサーバーに送信します。
`Moving Average Filter`	入力の移動平均（データの絶えず更新される平均）を算出し、結果を新しい変数に保存します。
`Distribute Variable`	参加者に値を送信します。値は変数に保存されます。

Set / Record Variable アクション

「Set / Record Variable」アクションは、Labvancedのすべての実験で使用される予定です。なぜなら、値と行動計測が保存され、記録される方法だからです。

イベントシステムにおける設定/記録変数アクションの位置

このアクションをクリックすると、次のダイアログメニューが表示され、どの変数が記録され、どの値が関心の対象であるかを指定できます：

イベントシステムにおける設定/記録変数オプション

メニュー項目	メニューエリア	説明
`Select`		選択をクリックすると、どの変数が値を保存するかを示します。ここから新しい変数を作成することもできます。
ペンアイコン		ペンアイコンは、選択された変数に割り当てられる正確な値を定義および指定するために使用される値選択メニューを象徴します（等号（=）の左側の緑色のボタンで指定されます）。

以下の例では、counterという新しい変数を作成し、前のステップで定義されたトリガーに基づいて変数の値を1増加させるために値選択メニューから算術オプションを使用しました。

Labvancedでカウンター変数を作成する

以下の画像は、研究中のマウストラッキングをキャプチャするためにマウスのX、Y座標を記録します。以下の画像は、変数値の記録を可能にするために3つのアクションが使用されている様子を示しています。左側の変数は手動で作成されており、等号（=）の右側の値はマウストリガー特有の値で、システムが提供し、値を記録する際に参照できます。

Labvancedでマウストラッキングと座標測定のための変数を作成する

注意: Set / Record Variable アクションは、変数値に基づいて「if / then」および「whileループ」を使用して条件を指定できるControl Actionsの文脈でも一般的に使用されます。

クリップボードにコピーアクション

効果：変数値をコンピュータの内部クリップボードにコピーします。

ランダム数を描画するアクション

効果：1つまたは複数のランダムな数値を描画し、それらを変数に保存します。

パラメータ：

タイプ: 連続値と離散値の間で選択します。
分布: ガウス分布と一様分布の間で選択します。
複数抽選 (ブール値 true/false): 1回または複数回を描画します。
抽選数: 抽選の数を選択します。
最小: 一様分布の最小値を定義します。
最大: 一様分布の最大値を定義します。
平均: ガウス分布の平均値を定義します。
標準偏差: ガウス分布の標準偏差を定義します。
変数に保存: 値が保存される変数を選択します。

URLパラメータを取得するアクション

効果：参加者のユニークURLから値を保存します。

パラメータ：

パラメータ名: 希望するパラメータの名前を入力します。
変数に保存: パラメータ値を保存する変数を選択します。

このアクションは、参加者のためにユニークなURLを構築したり、データ分析に必要な情報を抽出したりするために他のアクションと組み合わせることができます。

デバイスから読み込む/デバイスに書き込むアクション

効果：ローカルデバイスのストレージから変数を読み取るまたは書き込みます。このアクションはデータをLabvancedのサーバーに送信するのではなく、参加者のデバイスにデータを保存します。

パラメータ：

ローカルデバイスから読み取るか、書き込むかを選択します。
読み取りまたは書き込む変数を選択します。

ユースケース: 縦断的/マルチセッション研究

このアクションを使用すると、セッションごとにデバイス特有のデータを持ち越すことができます。参加者が各セッションで同じデバイスを使用している限り。
例えば、各参加者にセッション1で表示された画像を記録し、セッション2で異なる画像が表示されることを保証するためにこのアクションを使用できます。
- 画像の配列を作成し、各セッションで表示するためにランダムにいくつかを選択します。
- デバイスに書き出す: セッション1で表示された画像のインデックス番号。
- デバイスから読み込む: セッション2では、セッション1での画像のインデックスを読み出し、これらのインデックスが第2セッションで選択されないようにするJavaScriptアクションを含めます。

共有変数から読み込む/書き込むアクション

効果：研究のセッション間で共有される変数から読み取るか書き込みます。この変数はすべての参加者と共有されるか、各個人のプライベートであるかどちらかです。

パラメータ：

同期する変数を選択します。スカラーまたは配列である必要があります。
高度なオプション
- ストレージキー: 同期された変数にアクセスするためのキーとして使用する変数の名前を選択します。
- 読み取りまたは書き込み方法:
  - 共有変数を読み取り、変更し、その後書き込み: 変数を読み取り、変更を加えた後、研究に変数を送信します。
  - サーバーから共有値をのみ読み取り: 研究内で共有される変数を呼び出しますが、変更は加えません。
  - サーバーに変数をのみ書き込み: 共有変数に対して変更を加えますが、参加者には表示されません。
  - 異なる参加者間で値を共有する（セッション間だけでなく）: セッション間で参加者がお互いの同期された変数値を確認できるようにします。このオプションはデフォルトで選択されていますが、チェックボックスをクリックすることで解除できます。
アクションシーケンス:
- 共有/同期された変数に対して、利用可能なすべてのアクションのリストから何が起こるかを選択します。

ユースケース: 縦断的/マルチセッション研究

このアクションを使用すると、参加者固有のデータをセッション間で持ち越すことができ、セッション間で参加者同士で共有できます。
例えば、テストのスコアを記録し、その後、参加者が自分のスコアを完了した他の参加者の平均スコアと比較できるようにするためにこのアクションを使用できます。
もう一つの例（デバイスから読み込み/書き込みアクションと類似）は、参加者が配列から好きな5つの画像を選び、タスクを実行し、その後、別のセッションで再度その5つの画像を表示することです。このアクションは、他の参加者が選択した画像を表示させたり、別の参加者の利用可能な選択肢から除外するために使用できます。

数学 & 統計アクション

効果：入力変数（配列）の数学的操作を行い、結果を出力変数に保存します。

パラメータ：

タイプ: 配列操作、線形代数、統計テストの中から選択します。
操作: 数学的操作（例: 合計、最小、標準偏差など）を選択します。
入力配列: 操作が実行される入力変数（配列）を選択します。
パラメータ: 一部の操作には追加のパラメータがあります。
出力: 結果が保存される出力変数を選択します。

変数を即座に記録するアクション

効果：すべての変数値のスナップショットを作成し、これをLabvancedサーバーに送信します。

パラメータ：なし

移動平均フィルターアクション

効果：入力の移動平均（データの絶えず更新される平均）を計算し、結果を新しい変数に保存します。

パラメータ：

フィルター形状: フィルタータイプを選択します。
- シンプル移動平均: すべてのサンプルに同じ重みを持たせたシンプルな移動平均を計算します。
- 線形加重移動平均: サンプルの重みを線形に減少させてサンプルに重みを付けます。
- 指数移動平均: サンプルの重みを指数的に減少させてサンプルに重みを付けます。
サンプル数: 各ステップで使用されるサンプルの数を決定します。
入力: 移動平均が計算される入力変数（配列）を選択します。
出力: 結果が保存される出力変数を選択します。

変数を配布するアクション

変数を配布するアクションは、Labvancedのマルチユーザー研究にとって不可欠です。このアクションを使用すると、変数の値を参加者間で共有でき、実質的に情報（刺激の位置や変更を含む）が参加者の画面に反映されることになります。

Labvancedのアクションメニューにおける配布変数アクション。

このアクションを選択すると、次のダイアログボックスが表示され、参加者間で配布される変数値を指定できます。

以下の画像は、すべてのメニュー項目が入力された状態の機能的配布変数アクションのダイアログボックスの様子です。この例では、配布変数が入力フィールドオブジェクトから変数の値を配布することによって2人の参加者間でチャットを作成する手法として使用されています。

すべてのメニューオプションを設定した配布変数の例。

配布変数とチャットボックス機能を組み込んだこのデモをこちらでチェックしてください: 画像説明タスクとチャットアドオン。

ダイアログメニュー項目の完全な説明は以下で確認できます:

メニュー項目	メニューエリア	配布変数アクションオプションおよび説明
`発信先`		値がどの他の参加者に送信されるべきかを選択します。全ての参加者: この値を全参加者に送信選択された参加者: 選択した参加者に値を送信
`ターゲット変数と値を選択`		ターゲット変数: 値が保存されるターゲット変数を選択します。値: 他の参加者に送信されるべき値を決定します。
`ブロック`		有効にすると、現在の値の配布が完了するまでターゲット変数を変更できなくなります。
`レート制限戦略`		レート制限戦略は、サーバーへの過剰な負荷から実験を保護する手段であり、配布変数によるリクエスト（つまり、更新）の送信速度を制御するための予防策として機能します。以下の戦略オプションがあります: デバウンス: このアクションが100msの時間ウィンドウ内に1回以上実行される場合、新しいサーバーメッセージは「デバウンス」されます（このアクションの実行が100msの間隔で行われない最も最近のメッセージのみが送信されます）。スロットル: このアクションが100msの時間ウィンドウ内に1回以上実行される場合、新しいメッセージはスロットルされます（つまり、最後のメッセージが送信されてから100msが経過した後のみ、最も最近のメッセージが配布されます）。破棄: このアクションが100msの時間ウィンドウ内に1回以上実行される場合、その時間ウィンドウ内の新しいメッセージは破棄されます。キュー: このアクションが100msの時間ウィンドウ内に1回以上実行される場合、新しい変数値がキューされます（最大キューサイズは10メッセージまで）。

配列アクション

配列から選択（読み取り）アクション

効果：配列から1つの変数を読み取り、この値をスカラー変数に保存します。

パラメータ：

配列変数: 値を読み取るための入力配列。
インデックスタイプ: どのタイプのインデックスが使用されるかを決定します。
- 固定: 読み取り操作のための固定インデックスを使用します。この場合、情報を読み取る位置を入力します（1から始まります）。
- 変数: 読み取り操作のためのインデックスとして数値変数を使用します。この場合、読み出す位置を決定するためにスカラ数値変数を選択します。
- 配列の終わり: 配列の終わりから読み取ります。
出力変数: 読み取られた値が保存されるスカラ変数を選択します。

配列エントリーを追加/削除するアクション

効果：配列から/配列にエントリーを追加および/または削除します。

パラメータ：

配列変数: 追加または削除操作を実行する配列変数。
インデックスタイプ: どのタイプのインデックスが使用されるかを決定します。
- 固定: 挿入/削除操作のための固定インデックスを使用します。この場合、エントリーを挿入/削除する配列の位置を入力します（1から始まります）。
- 変数: 挿入/削除操作のためのインデックスとして数値変数を使用します。この場合、挿入/削除されるエントリーの位置を決定するためにスカラ数値変数を選択します。
- 配列の終わり: 配列の終わりから挿入/削除します。
削除するエントリー数: 新しいエントリーを挿入する前に、定義されたインデックス位置からエントリーを削除します。0は値が削除されないことを示します。
挿入する変数: 定義されたインデックス位置で配列変数に追加される1つ以上のスカラ変数を選択します。

配列エントリーを変更（置き換え）するアクション

効果：配列内の1つの値を置き換え/変更します。

パラメータ：

配列変数: 1つの値を変更する配列変数
インデックスタイプ: どのタイプのインデックスが使用されるかを決定します。
- 固定: 置き換え操作のための固定インデックスを使用します。この場合、変更する配列の位置を入力します（1から始まります）。
- 変数: 置き換え操作のためのインデックスとして数値変数を使用します。この場合、置き換え操作の位置を決定するためにスカラ数値変数を選択します。
- 配列の終わり: 配列の最後のエントリーを置き換えます。
入力変数: 新しい値を保持する（スカラ）変数を選択します。

配列エントリーをシャッフルするアクション

効果：配列内のエントリー/順序を再シャッフルします。

パラメータ：なし

データフレーム操作

データフレームから読み込む/書き込むアクション

効果：データフレームから値を読み出すか、データフレームに値を書き込み、新しい配列変数に保存します。

パラメータ：

データフレーム変数: 読み取るデータフレームの変数を選択します。
読み取るか書き込むか: 選択したデータフレームから読み取るか、または選択したデータフレームに書き込むことを選択します。
行単位または列単位: データをどのように読み取るかを選択します。
インデックスタイプ: データフレームを読み取るために使用されるインデックス変数のタイプを選択します。固定、変数、または最後の行が使えます。
インデックス変数: データフレームを読み取る際にインデックスとして使用される変数を選択します。
出力変数: 読み取られた/書き込まれたデータが出力として保存される変数を選択します。配列変数でなければなりません。

データフレームエントリーをシャッフルするアクション

効果：データフレーム内のエントリーの順序をシャッフルします。

パラメータ：

シャッフルするデータフレームを選択します。
データフレームが行単位または列単位でシャッフルされるかを選択します。

ジャンプアクション

効果：参加者を実験内の異なるステップに「ジャンプ」させます。このアクションは、実験内の試行やタスクの順序を変更でき、各参加者のために個別の実験ロジックを作成するために使用できます。

パラメータ：

ジャンプ先: 実験内でジャンプする場所を決定します。
- 次のフレーム: 次のフレームにジャンプします。試行内に定義されたフレームがない場合、次の試行の最初のフレームにジャンプします。
- 次の試行: 次の試行にジャンプします。試行がもう定義されていない場合、次のタスクの最初の試行にジャンプします。
- 次のタスク: 次のタスクにジャンプします。タスクがもう定義されていない場合、次のブロックの最初のタスクにジャンプします。
- 次のブロック: 次のブロックにジャンプします。ブロックがもう定義されていない場合、セッションは終了します。
- 前のフレーム: 前のフレームにジャンプします。前のフレームがない場合、このアクションは実行されません。
- 特定のフレーム: 特定のフレームにジャンプします。ユーザーは直接ジャンプするフレームを選択します。
- 特定の試行: 特定の試行にジャンプします。ユーザーは直接ジャンプする試行番号を選択します。
- 特定のタスク: 現在のブロックで指定されたタスクの最初のインスタンスにジャンプします。ユーザーは直接ジャンプするタスクを選択します。
- 特定のブロック: 指定されたブロックの最初のインスタンスにジャンプします。ユーザーは直接ジャンプするブロックを選択します。
必須回答の確認前にチェック: 有効にすると、実験はすべての必須回答がすでに回答されているかを確認します。そうでない場合、ジャンプアクションは実行されません。

受け入れ/セッション終了アクション

効果：参加者のデータを受け入れ、記録セッションを終了し、クラウドソーシングコードを表示します。

パラメータ：

セッション終了前に試行データを記録する: 有効にすると、最新の試行データが保存され（サーバーに送信され）、研究から退出する前に保存されます。
デフォルトの終了ページを表示: 有効にすると、デフォルトのLabvanced終了画面が表示されます。これはクラウドソーシングセッションの場合（クラウドソーシングリンクが使用された場合）で、補償コードが参加者に表示されます。無効にすると、実験は現在のフレームを表示した後終了し、補償コードを含むデフォルトの終了画面は表示されません。

拒否/セッション終了アクション

効果：記録セッションを終了し、参加者のデータを完了としてマークしないこと、

このアクションを使用して参加者のデータを拒否する際には、参加者に報酬が与えられない理由を説明する適切なメッセージを表示する必要があります。

パラメータ：なし

URLにリダイレクトするアクション

効果：参加者を特定のURLにリダイレクトします。

注意：このアクションが機能するためには、URLの先頭にhttps://を含める必要があります。

制御アクション

要件アクション（If... Then... Else If）アクション

効果：if-thenステートメントを評価し、一連のアクションを依存的に実行します。各If / Else-Ifステートメントは、すべての要件が満たされているかどうかを評価するためのネストされたAND / OR比較から構成されます（ステートメントが真の場合）か、そうでない場合（ステートメントが偽の場合）。ステートメントが真であれば、「Then」以下のアクションが実行されます。

パラメータ：

要件を追加: ステートメントに新しい要件を追加します。ロジカル比較を行うための「値選択」メニューが両側に表示されます。ステートメントの中央では、両側をどのように比較するかを選択します（例: 等しい、小さい、異なるなど）。
ORグループを追加: ORグループ内のすべての要件のうち、1つが真であればグループ全体が真となります。いくつかのケースでサブアクションを実行すべき場合、ORグループを追加します。
ANDグループを追加: ANDグループ内のすべての要件が真でなければ、グループ全体が真になりません。いくつかの要件が満たされたときにサブアクションを実行する場合は、ANDグループを追加します。
アクションシーケンス: 各If / Else-Ifステートメントには、「Then」の下に定義されたアクションのリストがあります。アクションシーケンスは特定のIf / Else-Ifステートメントに対応するアクションのすべてをリストします。「アクション追加」アイコンを使って新しいアクションが追加されます。アクションシーケンスは、関連するIf / Else-ifステートメントの要件が満たされた場合にのみ実行されます。
Else-Ifケースを追加: 要件アクションは、複数の個別のIf / Else-If --> Thenステートメントで構成される場合があります。ただし、実行できるのは1つのステートメントのみです。あるIf / Else-Ifステートメントがポジティブに評価される場合（真を返す場合）、Thenブロック内のアクションが実行され、他の要求アクションはスキップされます。
Elseケースを追加（真 / 偽）: 有効にすると、要件アクションにデフォルトのフォールバックオプションが追加されます。If / Else-Ifステートメントのどれも実行されない場合（真が返されない場合）、Elseケースに定義されたアクションが実行されます。

繰り返しアクション（Whileループ）アクション

効果：一連のアクションを直ちに、または定義された間隔内で繰り返し実行します。ストップ条件を指定できるので、ループの実行を停止できます。

パラメータ：

実行タイプ: 即時実行か、定時実行のいずれかを選択します。
- ループを完全に実行: この選択肢を選ぶと、ストップ条件が満たされるまでループが継続的に実行されます。
- 毎...ms実行: ループが定義された間隔で実行されます（例: ループが50msごとに実行されます）。
ループ回数を定義: 「毎...ms実行」が選択された場合、ループが実行される回数として数値の整数値を指定することができ、ストップ条件を設定する必要がなくなります。
実行間隔: 実行間隔を決定します。
すぐに開始する（真 / 偽）: 有効にすると、すぐにループが実行されます。無効にすると、次の実行間隔でループが開始されます。
複数の開始を許可する（真 / 偽）: 有効にすると、複数のループインスタンスが並行して開始されます。無効にすると、一度に1つのループインスタンスしか実行できません。
ストップ条件を有効にする（真 / 偽）: 有効にすると、ループのためのストップ条件を設定できます。
ストップ条件: ストップ条件は、ループの実行を停止する必要のある論理式を指定するために使用されます。If / Else-Ifステートメントと同様に、ANDグループ、ORグループ、および要件を論理比較のために結合できます。
アクションシーケンス: アクションシーケンスは、ループの各イテレーションで実行されるすべてのアクションをリストします。「アクション追加」アイコンを使って新しいアクションが追加されます。

遅延アクション（時間コールバック）アクション

効果：指定された時間遅延後に一連のアクションを実行します。

パラメータ：

遅延タイプ: 固定遅延または可変遅延の間で選択します。
- 固定遅延: アクションが固定遅延の後に実行されます。
- 可変遅延: アクションが（数値）変数で指定された遅延の後に実行されます。
遅延: 遅延の長さ（ミリ秒単位）。
アクションシーケンス: アクションシーケンスは、指定された時間遅延後に実行されるすべてのアクションをリストします。「アクション追加」アイコンを使って新しいアクションが追加されます。

アクショングループ

アクションはアクショングループにも整理できます。アクショングループを使用することで、特定のアクションをまとめて視覚的に構造を整理することができ、複数のアクションを一度にコピー、複製、または削除したい場合に便利です。アクショングループを追加するには、カスタムアクションの下にあるオプションを見つけることができます。

アクショングループを追加

イベントウィンドウのアクショングループ

APIアクション

外部サーバーからLabvancedにデータを送信または通信する必要がある場合は、「APIアクション」と「APIトリガー」を使用できます。このカテゴリには以下のアクションが利用できます:

Websocketに送信
OpenAIに送信

これらのアクションを「使用可能」または「使用できる」ものにするには、Settings タブの下にAPIキーを入力する必要があります。

LabvancedアクションメニューのAPIアクション。

Websocketに送信アクション

LabvancedアクションメニューのWebsocketに送信アクション。

このアクションを選択すると、次のオプションが表示されます。

Websocketに送信アクションのオプション。

上記の例とフルイベント構造は、こちらでアクセスできます: https://www.labvanced.com/page/library/51053、「Inspect」をクリックすることで確認できます。

メニュー項目	説明
送信先:	`Settings` タブの `特別機能` に記載されているWebsocketアドレスを指定します。
トリガー/送信メッセージ:	送信したいトリガーまたはメッセージを指定します。
変数を送信（オプション）:	アクションの一部として送信される可能性のある変数を示します。

APIアクセスに関する詳細情報については、こちらのページを参照してください。

OpenAIに送信アクション

「OpenAIに送信」アクションは、文字列の入力値などの情報をOpenAIに送信することを可能にします。このオプションが利用可能であるためには、Settings タブの 特別機能 にAPIキーを記載する必要があります。

LabvancedアクションメニューのOpenAIに送信アクション。

このイベントをクリックすると次のオプションが表示されます：

OpenAIに送信アクションのオプション。

必要な情報がすべて提供された状態でこのイベントがどのように機能するかの実例は以下の通りです：

OpenAIに送信アクションが利用されている例。

この機能を利用する方法と実際に使用される様子についての詳細を理解するために、このお問い合わせフォームを提出してデモをリクエストしてください。

注意: このウォークスルーも参照してください。ここでは、ステップバイステップで研究を構築し、研究にChatGPTを統合し、このアクションを利用します。

「OpenAIに送信」アクションに含まれるフィールドについての詳細な説明は以下の通りです：

メニュー項目	メニューエリア	'OpenAIに送信' アクションオプション
`モデルタイプ`		使用されるAIモデルを指定します。
`チャット履歴データフレーム`		2つの列を持つデータフレーム変数へのリンク。最初の列は「役割」を示し、2番目の列は「チャットメッセージ」を示します。アクションからの値はここでリンクされたデータフレームに自動的に追加されます。データフレームはデータフレームアクションで操作することもできます。さらなる参考については、OpenAIのドキュメントを確認してください。
`メッセージを挿入‘+’`		これをクリックすると、変数ダイアログボックスが表示されます。どの「変数」値がOpenAIに送信されるか、および関連するメッセージの「役割」を示す必要があります： system: 高レベルのChatGPTシステムを指します。 user: 参加者 assistant: システム内で作成された特定のサブ役割を指します。

コードアクション

場合によっては、実験にカスタムコードを使用する必要があります。これらのアクションを使用すれば、そのことが可能になります！「コードアクション」メニューでは次のオプションが利用できます：

JavaScriptを実行
グローバルCSSを設定

Labvancedのアクションメニューのコードアクション。

JavaScriptを実行するアクション

「JavaScriptを実行」アクションを使用すると、特定のイベントをプログラムし、カスタムJavaScriptを入力して研究内でLabvancedの変数を読み取ったり設定したりすることができます。このJavaScriptはトリガーが発生した時にアクションとして実行されます。

Labvancedのアクションメニューの「JavaScriptを実行」アクション。

上記の「JavaScriptを実行」アクションが選択されると、JavaScriptコードを記述するエリア（コードエディタ）が表示され、使用方法に関する指示も表示されます：

LabvancedのJavaScriptコードエディタ。

グローバルCSSを設定するアクション

「グローバルCSSを設定」アクションを使用すると、トリガー時に研究のある側面を変更することができるカスタムCSSコードを使用できます。

Labvancedのアクションメニューの「グローバルCSSを設定」アクション。

このアクションをクリックすると、次のフィールドが開きます：

LabvancedのCSSコードエディタ。

「グローバルCSSを設定」アクションの例としては、参加者が選択肢の中から特定の色を選択した際に、研究の背景色を変更することが挙げられます。

ペーストアクション

このオプションは、以前に作成してコピーしたアクションをペーストすることを可能にします。これにより、実験デザインを行う際に同じアイテムを何度も選択しなくて済むため、より迅速に作業を行うことができます。例えば、すでに存在するイベントに似たイベントがある場合、それをコピーしてペーストし、修正することができます。

値選択メニュー

特定のイベントで作業していると、ペンアイコンが表示されることに気づくでしょう。これは値選択メニューと呼ばれ、記録または追跡する値の種類を選択して指示することができます。これは、実験デザインと設定において使用する非常に強力で重要なオプションです。

このペンアイコン/値選択メニューは、次のようなイベントシステムの特定のアクションのさまざまな場所に表示されます：セット/レコード変数アクション、オブジェクトプロパティの設定アクション、及び要件（If... Then）アクションとして示されています。

Labvancedの値選択の場所。

ペンアイコンをクリックすると、読み取りまたは書き込む値を指定するドロップダウンメニューが表示されます。ドロップダウンメニューは常にトリガー特定の値オプションをリストした後、他の5つのカテゴリー（現在の時間、定数値、変数、フレーム/タスク/オプション、操作）に進み、それぞれに独自のオプションを持っています。これらは以下で詳しく説明されます。

Labvancedの値選択メニュー。

上記の画像は、マウストリガーを使用している際の値選択メニューの外観を示しています。ご覧のように、左側の最初のメニュー項目はトリガー特定のカテゴリーから始まり、他の5つのカテゴリー（現在の時間など）に移行します。

メニューオプション

下の表は、カテゴリーとオプションについてさらに説明しています：

カテゴリー	オプション	説明
`トリガー特定`	前回選択したトリガーの種類に依存します。	イベントのために選択したトリガーに基づいて、値選択メニューの上部に選択肢の特定のリストが表示されます。トリガー特定の値のセクションを参照して、オプションと説明の完全なリストを確認してください。
`現在の時間`	UNIXタイムスタンプフレーム開始からの時間	時間値を測定し、呼び出します。
`定数値`	文字列数値ブール値カテゴリカル日付時間色	文字列や数値など、必要な変数のタイプに基づいて定数値を割り当てます。これらは、しばしば`算術`などの他のオプションと組み合わせてカウンターを作成するために使用されます。
`変数`	変数を選択配列から値を選択データフレームから値を選択	変数を指定または参照するか、配列またはデータフレームから値を選択します。
`フレーム / タスク / オブジェクト`	オブジェクトプロパティフレーム目の追跡デバイス	オブジェクトプロパティ、フレーム、目の追跡（有効にされている場合）、およびデバイス（画面のリフレッシュレート）に関連する値を取得できるようにします。
`操作`	算術文字列操作数学的操作	操作を使用して、変数に指定された変更を加え、変数の値を結合したり、文字列を小文字に変換したり、数学的操作を実行します。

現在の時間の値

「現在の時間」オプションを使用すると、時間に関する値を記録または参照することができます。

利用可能なオプションは次のとおりです：

UNIXタイムスタンプ
フレーム開始からの時間

現在の時間：UNIXタイムスタンプ

この値は、ミリ秒単位のUNIX形式のタイムスタンプをキャプチャします。

現在の時間：フレーム開始からの時間

この値は、フレームの開始から経過した時間の量をキャプチャします。ほとんどの場合、これは反応時間に相当します。

定数の値

必要に応じて、文字列や数値のような変数のタイプに基づいて定数値を割り当てます。これらは、しばしば他のオプション（例：算術）と組み合わせてカウンターを作成するために使用されます。

利用可能なオプションは次のとおりです：

文字列
数値
ブール値
カテゴリカル
日付
時間
色

定数：文字列

文字列 / テキスト値を割り当てます。

定数：数値

数値 / 数値を割り当てます。

定数：ブール値

真または偽の値を割り当てます。

定数：カテゴリカル

レベル値を割り当てます（主に要因用）。

定数：日付

日付値を割り当てます。

定数：時間

時間値を割り当てます。

定数：色

色（16進数文字列）値を割り当てます。

変数の値

変数を指定または参照するか、配列またはデータフレームから値を選択します。利用可能なオプションは次のとおりです：

変数を選択
配列から値を選択
データフレームから値を選択

変数を選択

変数を選択して示すことができます。

配列から値を選択

配列から値を選択できます。

データフレームから値を選択

作成したデータフレームから値を選択できます。

フレーム / タスク / オブジェクトの値

オブジェクトプロパティ、フレーム、目の追跡（有効になっていれば）、デバイス（画面のリフレッシュレート）に関連する値を取得できます。

オブジェクトプロパティ
フレーム
目の追跡
デバイス

オブジェクトプロパティ

オブジェクトプロパティを読み取ります。

フレーム

フレームの値オプション	説明
`最後にキャッシュされたマウスX位置`	参加者のマウスの最後のX座標の値です。
`最後にキャッシュされたマウスY位置`	参加者のマウスの最後のY座標の値です。
`最後にキャッシュされたマウス[X,Y]配列`	参加者のマウスの最後の[X,Y]座標の値を配列形式で示します。
`フレーム名`	フレームの名前です。

目の追跡

目の追跡の値オプション	説明
`最後にキャッシュされた座標X`	参加者の視線の最後のX座標の値です。
`最後にキャッシュされた座標Y`	参加者の視線の最後のY座標の値です。
`最後にキャッシュされた座標[X,Y]配列`	参加者の視線の最後の[X,Y]座標の値を配列形式で示します。
`最後にキャッシュされた座標 + 時間[X,Y,T]配列`	参加者の視線の最後の[X,Y]座標の値とカメラキャプチャT値を配列形式で示します。

デバイス

リフレッシュレート： 参加者のデバイスのリフレッシュレートの値です。

操作

指定された変更を変数に加えるために、操作を使用して、変数の値を結合したり、文字列を小文字に変換したり、数学的操作を実行します。

利用可能なオプションは次のとおりです：

算術
文字列操作
数学的操作

算術

算術操作は、文字列を結合したり、オブジェクトプロパティを修正したりするためを含むさまざまな目的に役立ちます。

Labvancedの算術メニュー。

本質的に、算術操作は複数の値に対して操作を実行します。

このオプションを選択すると、追加のペンアイコン（例：値選択メニュー）が表示され、加算のような操作のリストも表示されます。

Labvancedの算術オプションの位置。

値は次の5つの異なる操作を使用して操作できます：

(+) 加算
(-) 減算
(/) 除算
(*) 乗算
(%) モジュロ

以下の例は、新しい文字列変数（緑色のボタンで呼ばれる）を作成するために算術操作を利用する方法を示しています。

新しい文字列変数を作成するために算術操作を使用している例。

新しい変数値（「intermediateVar」）は、複数の算術操作を使って定義され、以前に作成された変数（例：「userChatName」と「chatInput」）の組み合わせと、定数文字列値（例：セミコロン : と改行 <br>）を用います。このアクションは、マルチユーザー研究で使用できるユーザーチャットの効果を作り出します。

文字列操作

文字列操作のオプション	説明
`小文字に変換`	文字列変数内のすべての文字を小文字に変更します。 → 例: (AAABBB) は (aaabbb)に変換されます。
`大文字に変換`	文字列変数内のすべての文字を大文字に変換します。 → 例: (aaabbb) は (AAABBB)に変換されます。
`リンクに変換`	変数内の文字列を別ウィンドウで開くURLに変換します。
`空白文字を削除`	文字列変数内の文字の間の任意のスペースを削除します。 → 例: (aaa bbbb cccc) は (aaabbbbccc)に変換されます。
`空白文字をトリム`	文字列変数の先頭にあるスペースを削除します。 → 例: ( aaabbbcccc) は (aaabbbcccc)に変換されます。
`部分文字列を正規表現で置換`	文字列値変数の特定の文字を置き換えます。 → 例: (aaabbbccc)は_bbb_を_xxx_に置換し、値を(aaaxxxccc)に変換します。

数学的操作

スカラ値に数学操作を実行します。

数学的操作のオプション	説明
`abs`	値の絶対値を返します。
`sqrt`	値の平方根を返します。
`round`	小数点以下0〜3桁で丸めた値を返します。
`floor`	フロア値を返します。
`ceil`	天井値を返します。
`cos`	コサイン値を返します。
`sin`	サイン値を返します。
`tan`	タンジェント値を返します。

トリガー特定の値

トリガー特定の値は、特定のイベント内で定義されたトリガーに関連する値を指します。例えば、イベントがマウストリガーを使用する場合、アクションが指定されている特定の領域（セット/レコード変数アクションやオブジェクトプロパティを設定アクションを使用する場合など）でマウストリガー特定の値を参照できます。

以下の例は、マウストリガーのトリガー特定の値を使用して、x値とy値、[X,Y]配列をセット/レコード変数アクションを用いて記録する方法を示しています。

マウス特定のトリガー値を使用してマウストラッキングをキャプチャする方法を示しています。

以下に、Labvancedで見つかるすべてのタイプのトリガー特定の値の表を示し、それぞれのオプションの詳細な説明を続けます。

名前	値オプション - 概要
`トリガー (マウス)`	マウスX マウスY マウス[X,Y]配列刺激名刺激情報トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (キーボード)`	キーのID トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (ボタンバー)`	刺激名刺激情報トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (入力時のエンター)`	キーのID トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (スクロール)`	刺激名刺激情報スクロール位置X スクロール位置Y トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (ゲームパッド/ジョイスティック)`	ゲームパッドデバイスID 押されたキー（配列）押されたまたは保持されたキー（配列）解放されたキー（配列）軸（配列）ゲームパッドタイムスタンプ（ユニクスタイム）トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (目の追跡の視線)`	座標X 座標Y 座標[X,Y]配列刺激名刺激情報カメラキャプチャ時刻T 視線信頼度C 座標+時間[X,Y,T]配列座標+時間+信頼度[X,Y,T,C]配列トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (目の追跡の注視)`	注視の重心X 注視の重心Y 注視の持続時間注視の開始時刻注視の終了時刻注視の拡散刺激名刺激情報 [X,Y,DUR,START,END,DISP] トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (頭部追跡)`	カメラキャプチャ時刻T 頭を左から右に回す頭を上下に傾ける頭を左右に回す頭の位置[X,Y,T]配列鼻の位置[X,Y,T]配列鼻のベクトル[X,Y,Z,T]配列トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (タスク初期化時)`	トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー (フレーム初期化時)`	試行番号トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（フレーム開始時）`	トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（フレーム終了時）`	総フレーム時間トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（変数値が変更された）`	変数の新しい値トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（メディアオブジェクトトリガー）`	トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（WebSocketトリガー）`	メッセージデータトリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（OpenAIトリガー）`	Chat GPTの回答トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（グローバル実験イベント）`	総フレーム時間グローバルイベントの理由トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）
`トリガー（ユーザーが実験から離れる）`	残りの参加者の数トリガータイムスタンプ（ユニクスタイム）トリガー時刻（フレーム開始から）

トリガー (マウス) の値

マウストリガーが使用される場合、次のトリガー特定の値が特定のアクションを操作する際に呼び出すことができます：

利用可能なマウストリガー値オプション

トリガー (マウス) オプション	説明
`マウスX`	フレーム座標における現在のマウスX位置を返します。
`マウスY`	フレーム座標における現在のマウスY位置を返します。
`マウス[X,Y]配列`	マウスの[X,Y]座標を配列形式で示します。
`刺激名`	イベントをトリガーしたオブジェクトの名前（例：クリックした画像）。
`刺激情報`	イベントをトリガーしたオブジェクトの刺激情報。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー (キーボード) の値

キーボードトリガーが使用される場合、特定のアクションを操作する際に呼び出すことができるトリガー特定の値は以下の通りです：

トリガー (キーボード) のオプション	説明
`キーのID`	トリガーとして押されたキーのID値。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー (ボタンバー) の値

ボタンクリックトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次のとおりです：

トリガー (ボタンバー) のオプション	説明
`刺激名`	イベントをトリガーしたボタンオブジェクトの名前。
`刺激情報`	イベントをトリガーしたボタンオブジェクトの刺激情報。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー (入力時のエンター) の値

入力時にエンターが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次のとおりです：

トリガー (入力時のエンター) のオプション	説明
`キーのID`	トリガーとして押されたキーのID値。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー (スクロール) の値

スクロールトリガーが使用されている場合、特定のアクションで呼び出すことができるトリガー特定の値は次のとおりです：

トリガー (スクロール) のオプション	説明
`刺激名`	イベントをトリガーしたボタンオブジェクトの名前。
`刺激情報`	イベントをトリガーしたボタンオブジェクトの刺激情報。
`スクロール位置X`	イベントがトリガーされたときのマウスのX方向のスクロール位置。
`スクロール位置Y`	イベントがトリガーされたときのマウスのY方向のスクロール位置。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からスクロールトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー (ゲームパッド/ジョイスティック) の値

ゲームパッド/ジョイスティックトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次のとおりです：

ゲームパッドトリガーメニューオプション

トリガー (ゲームパッド/ジョイスティック) のオプション	説明
`ゲームパッドデバイスID`	接続されたゲームパッドのIDまたは名前。
`押されたキー（配列）`	押されたキー。
`押されたまたは保持されたキー（配列）`	押されたまたは保持されたキー。
`解放されたキー（配列）`	解放されたキー。
`軸（配列）`	軸の値。
`ゲームパッドタイムスタンプ（ユニクスタイム）`	ゲームパッドのタイムスタンプ（ユニクスタイム）。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻のユニクスタイム。
`トリガー時刻（フレーム開始から）`	フレームの開始に対するトリガーの発生時刻のユニクスタイム。

トリガー (目の追跡の視線) の値

目の追跡の視線トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次のとおりです：

視線トリガー値オプション

トリガー (目の追跡の視線) オプション	説明
`座標X`	視線のX座標の値。
`座標Y`	視線のY座標の値。
`座標[X,Y]配列`	視線座標のX,Yを配列形式で示します。
`刺激名`	視線トリガーを引き起こした刺激の名前。
`刺激情報`	視線トリガーを引き起こした刺激の背後にある刺激情報。
`カメラキャプチャ時刻T`	スナップショットが発生した正確な時刻です。Labvancedの目の追跡パイプラインでは、アルゴリズムおよびニューラルネットワークが視線計算を実行する前にカメラスナップショットが最初に行われます。したがって、`カメラキャプチャ時刻T`は初期スナップショットが行われたときのUNIXタイムスタンプです。我々のウェブカメラベースの目の追跡の技術については、ET技術ページを参照してください。
`視線信頼度C`	この値は0から1の範囲であり、画像スナップショットにオープンアイが存在する信頼度と確率を指します。これは基本的に「まばたき検出器」として機能します。詳細については、我々の発表された査読付き論文を参照してください。
`座標 + 時間[X,Y,T]配列`	視線のx/y座標とカメラキャプチャ時刻のタイムスタンプ（T）を含む配列。
`座標 + 時間 + 信頼度[X,Y,T,C]配列`	視線のx/y座標、カメラキャプチャ時刻のタイムスタンプ（T）、及び視線信頼度（C）を含む配列。
`トリガータイムスタンプ（ユニクスタイム）`	視線トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	視線トリガーが発生するまでの経過時間をフレーム開始から測定したミリ秒単位。

トリガー(目の追跡の注視) の値

目の追跡の注視トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー (目の追跡の注視) オプション	説明
`注視の重心X`	注視の中心点のX値。
`注視の重心Y`	注視の中心点のY値。
`注視の持続時間`	検出された注視の持続時間。
`注視の開始時刻`	検出された注視の開始時刻。
`注視の終了時刻`	検出された注視の終了時刻。
`注視の拡散`	検出された注視内の視線値の散逸度合い。
`刺激名`	イベントをトリガーしたボタンオブジェクトの名前。
`刺激情報`	イベントをトリガーしたボタンオブジェクトの刺激情報。
`[X, Y, Dur, Start, End, Disp]`	注視の重心のx,y値、注視の持続時間、開始時刻、終了時刻、及び拡散値の配列。
`トリガータイムスタンプ（ユニクスタイム）`	注視トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	注視トリガーが発生するまでの経過時間をフレーム開始から測定したミリ秒単位。

トリガー (頭部追跡) の値

頭部追跡トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー (頭部追跡) オプション	説明
`カメラキャプチャ時刻T`	フレームがキャプチャされた時刻（例：フレームキャプチャが行われたUnixタイムスタンプ）。これは画像/フレームが処理される前にキャプチャされた時間です。
`頭の向き`	左から右への頭の動き。これは文献でヨーと呼ばれています。
`頭を傾ける`	上から下への頭の動き。文献ではピッチと呼ばれています。
`頭の回転`	頭が左右に回転する動きをキャプチャします。
`頭の位置[X,Y,T]配列`	頭の位置に関連する数値値をキャプチャするこの配列には、頭の中央のx,y座標とタイムスタンプ変数（T）が含まれます。
`鼻の位置[X,Y,T]配列`	ノーズの位置に特に関連する数値値をキャプチャするこの配列には、鼻の位置のx,y座標と測定が行われた時刻のタイムスタンプ変数（T）が含まれます。
`鼻のベクトル[X,Y,Z,T]配列`	鼻の先端からベクトルを投影する、この測定は、参加者が画面に注目しているかどうかをテストするのに役立ちます（これは目の追跡が無効になっている研究で特に重要です）。したがって、鼻が画面外を指している場合（例：参加者が実験に注目していない）、Z値は1から減少し、0に近づきます。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーが発生した時刻におけるトリガー検出の時間。この値は、画像/フレームを処理する時刻に影響され、参加者のグラフィックスカードに大きく影響されます。理論的には、この値はTの値にできるだけ近くなるべきです。
`トリガー時刻（フレーム開始から）`	トリガーが発生した時刻（フレームの開始）に関しての時間値。

トリガー (タスク初期化時) の値

タスク初期化トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー (タスク初期化時) のオプション	説明
`トリガータイムスタンプ（ユニクスタイム）`	トリガーのUnixタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの時間をミリ秒単位で示します。

トリガー (フレーム初期化時) の値

フレーム初期化トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー (フレーム初期化時) のオプション	説明
`試行番号`	フレーム初期化トリガーが発生したときの試行番号。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーのUnixタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの時間をミリ秒単位で示します。

トリガー（フレーム開始時）の値

フレーム開始トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（フレーム開始時）オプション	説明
`トリガータイムスタンプ（ユニクスタイム）`	トリガーのUnixタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの時間をミリ秒単位で示します。

トリガー（フレーム終了時）の値

フレーム終了トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（フレーム終了時）オプション	説明
`総フレーム時間`	フレームに費やされた総時間（ミリ秒単位）。
`トリガータイムスタンプ（ユニクスタイム）`	トリガーのUnixタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からトリガーが発生するまでの時間をミリ秒単位で示します。

トリガー（変数値が変更された）の値

変数値が変更されたトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（変数値が変更された）オプション	説明
`変数の新しい値`	変数の新しい値を指します。
`トリガータイムスタンプ（ユニクスタイム）`	変数変更トリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始から変数値の変更が発生するまでの経過時間をミリ秒単位で示します。

トリガー（メディアオブジェクトトリガー）の値

メディアオブジェクトトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（メディアオブジェクトトリガー）オプション	説明
`トリガータイムスタンプ（ユニクスタイム）`	メディアオブジェクトトリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からメディアオブジェクトトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー（WebSocketトリガー）の値

WebSocketトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（WebSocketトリガー）オプション	説明
`メッセージ`	説明およびラベルを表示するメッセージで、異なるデータタイプをフィルタリングできるようにします。
`データ`	参加者の選択、タイムスタンプ、マウスx/y座標など、さまざまなデータタイプを保持できる値。
`トリガータイムスタンプ（ユニクスタイム）`	WebSocketトリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からWebSocketトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー（OpenAIトリガー）の値

OpenAIトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（OpenAIトリガー）オプション	説明
`Chat GPTの回答`	ChatGPTからの回答の値。
`トリガータイムスタンプ（ユニクスタイム）`	OpenAIトリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からOpenAIトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー（グローバル実験イベント）の値

一時停止 / 実験再開トリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー（グローバル実験イベント）オプション	説明
`総フレーム時間`	トリガー以前に割り当てられた総フレーム時間を指します。
`グローバルイベントの理由`	トリガーの理由を示す文字列値（例：参加者が研究を離れた）。
`トリガータイムスタンプ（ユニクスタイム）`	グローバルイベントトリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からグローバルイベントトリガーが発生するまでの経過時間をミリ秒単位で示します。

トリガー（ユーザーが実験から離れる）の値

参加者がマルチユーザー研究から離れたトリガーが使用される場合、特定のアクションで呼び出すことができるトリガー特定の値は次の通りです：

トリガー (ユーザーが実験から離れる) オプション	説明
`残りの参加者の数`	研究に残っている参加者の数。
`トリガータイムスタンプ（ユニクスタイム）`	ユーザーが実験を離れるトリガーが発生した時刻のUnixタイム形式のタイムスタンプ（ミリ秒単位）。
`トリガー時刻（フレーム開始から）`	フレーム開始からユーザーが実験を離れるトリガーが発生するまでの経過時間をミリ秒単位で示します。