イベントシステム

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

イベントシステムは、トリガーとアクションで構成されています。ここでは、「このことが起こったら」(トリガー)、「これを行う」(アクション)というルールを設定します。例えば、参加者が特定の画像をクリックした場合(トリガー)、異なるランダムな画像を表示することになります(アクション)。
Labvancedでイベントがどのように機能するかの紹介については、このクイックビデオを参照してください:
イベントの作成 - 概要
イベントは、右上の「イベント」タブの下のタスクエディタで管理されます。新しいイベントは、あるフレームで発生するべきイベントのための+ Frame Eventをクリックするか、すべてのフレームにイベントを適用する+ Trial Eventをクリックすることで作成できます。すべての既存のイベントは、右側パネルにリストビューで表示されます。イベントはフレームレベルで定義されており、各フレームごとに別々または特定のものとして、またはトライアル全体の各フレームで複製または同じであることができます。

いずれにせよ、イベントは指定されたフレームのためにトライアルグループ内のすべてのトライアルに対して常に定義されています。ただし、カスタムロジックにより、ユーザーは特定のトライアル、条件、または他の状況でのみイベントを実行することができます。
トリガーの選択
新しいイベントを作成する際、トリガーの選択がタイルグリッドとして開きます。トリガーの種類はユーザー入力、生理的信号、トライアルおよびフレーム、変数、メディアオブジェクト、API、グローバルによってカテゴリー分けされています。上部の検索ボックスでトリガーの種類を名前でフィルタリングできます。任意のタイルをクリックして、それをイベントのトリガーとして設定します。
トリガーが選択されると、イベントは現在のトリガー名とアイコンを持つコンパクトなバーを表示します。別のトリガーに切り替えるには、Change triggerボタン(鉛筆アイコン)をクリックしてタイルグリッドを再表示します。
以下のビデオは、Labvancedで利用可能なトリガーとアクションの概要を提供します:
イベントの実行順序は調整可能です。デフォルトでは、同じトリガーを持つイベントがリストの上方にあり、最初に実行されます。イベントはコピーまたは削除することもできます。既存のイベントを選択すると、詳細が右下(イベントプロパティ)パネルに表示されます。より良い概要のために、既存のイベントも再表示できます(名前フィールド横のアイコン)。
トリガー
トリガーは、イベントが実行されるタイミングを定義します。これは、特定のオブジェクトへのマウスクリック、特定のキーボード入力、変数の変更、ビデオファイルの開始、または他の多くの事柄になる可能性があります。すべてのトリガーとその設定/パラメータは、以下のリストで説明されています:
| トリガーカテゴリ | トリガーオプション | 説明 |
|---|---|---|
User Input Triggers | ユーザー入力トリガーは、ユーザー/参加者がマウスを動かしたり、キーボード要素をクリックしたり、スクロールしたりなどの行動で手動でアクティベートできるトリガーを指します。 | |
Physiological Signal Triggers | 生理的信号トリガーは、特定の要素を注視したり、頭部の動きが変化したりする場合に発生します。 | |
Trial and Frame Triggers | これらのトリガーは、実験トライアルおよびフレームに関連して発生します。例えば、フレームの開始や終了時などです。 | |
Variable Value Changed Trigger | 変数(値が変わった) | 特定の変数値の変更があるときにイベントが発生するトリガーです。 |
Media Object Trigger | メディアオブジェクトトリガー | このトリガーは、ビデオや音声ファイルの一時停止、録音の完了など、メディアオブジェクトに関連して発生します。 |
API Triggers | これらは、APIからのデータを受信するときに発生するトリガーです。 | |
Global Triggers | グローバルトリガーは、実験の主要な変更を指します。例えば、実験が一時停止されたり、マルチユーザースタディの参加者が離れたりすることです。 |
ユーザー入力トリガー
ユーザー入力トリガーは、ユーザー/参加者が手動でアクティベートできるトリガーを指します。

以下の表は、Labvancedで利用可能なすべてのユーザー入力トリガーの概要を提供します。それぞれは今後のセクションで詳細に説明されます。
| ユーザー入力トリガーオプション | 概要 |
|---|---|
Mouse Trigger | 任意のマウスの動きはイベントを開始するためのトリガーとして使用できます。スクロール、クリック、ホバーなどが含まれます。また、トリガーと特定の要素またはターゲットを関連付けることもできます。例えば、特定の画像がクリックされた場合のみマウスクリックがトリガーとして使用されます。 |
Keyboard Trigger | 任意のキーボードの押下がイベントを開始するためのトリガーとして使用できます。特定のキーボードの文字や数字をトリガーとして指定できます。 |
Button-Clicks | Labvancedで作成されたボタンオブジェクトは、イベントを開始するためのトリガーとして使用できます。 |
Enter on Input | このトリガーは、参加者が実験中に「Enter」を押したときによく使用されます。これは、テキストボックスエリアに書かれた回答を提出する手段として機能します。 |
Scroll Trigger | このトリガーは、参加者がスクロールしたときに発生します。x軸またはy軸のスクロール方向を指定でき、どの要素上でスクロールが発生したかをイベントトリガーとして使用できます。 |
Gamepad/ Joystick Trigger | このトリガーを使うことで、データ記録のための入力デバイスとしてゲームパッドやジョイスティックコントローラーを実験設計に利用できます。 |
マウストリガー
「マウストリガー」オプションは、マウスの任意の操作に基づいてイベントを開始するため、非常に人気のあるイベントトリガーです。例えば、マウスを上下に動かしたり、クリックしたり、特定のオブジェクトの上にホバーしたり、特定のオブジェクトから離れたり、あらゆる動作が含まれます!

以下の例は、‘Image_1’という‘Target’オブジェクトに対して‘左’マウスクリックを行った際に発生する‘Mouse Trigger’を示しています:

以下は、マウストリガーを使用する際のオプションの全体像です:
| メニューアイテム | メニューエリア | マウストリガーオプションと仕様 |
|---|---|---|
Action ドロップダウンリスト: | ![]() | ドロップダウンリストから利用可能な以下のマウストリガーオプションがあります:
|
Button ドロップダウンリスト: | ![]() |
|
Targets オプション: | 上記の例では、‘Image_1’がイベントをトリガーするボタンのクリック対象です。 ‘+Add Target’ オプションをクリックすることで、複数のターゲットを追加できます。 |
|
- 注意: イベントシステムでマウストリガーを選択した後、さまざまなアクションでトリガー特定のマウス値を利用および参照するオプションがあります。値選択メニューを使用できます。
キーボードトリガー
‘Keyboard trigger’オプションは、イベントをトリガーするもう一つの人気の方法です。本質的に、キーボードからの任意の入力をトリガーとして使用できます。これには、キーを押す、保持する、または解放することが含まれます。

以下の例では、指定されたターゲット数値(0、2、または6)が押されたときにトリガーがキーボードの押下に設定されています:

以下は、キーボードトリガーを使用する際のキーとオプションの全体像です:
| メニューアイテム | メニューエリア | キーボードトリガーオプション |
|---|---|---|
Action ドロップダウンリスト: | ![]() |
|
Keys どのキーがイベントをトリガーするか | ![]() | どのキーがトリガーとして使用されるかは、ここで**+Add:**をクリックして選択するオプションによって指定されます。
+Add: ボタンを再度クリックすることで、複数のキーボードトリガーを追加できます。 |
| 追加オプション | ![]() | テンキーのボタンを有効にするオプションにより、テンキーをトリガーとして使用できます。 イベントの伝播を許可するオプションは、同じキーボードトリガーを持つ複数のイベントがある場合、すべてがそれなしに発火/トリガーされます。最初のものだけが発火し、最初のイベントが完了した後にイベント実行が停止します。 |
- 注意: イベントシステムでキーボードトリガーを選択した後、さまざまなアクションでトリガー特定のキーボード値を利用および参照するオプションがあります。値選択メニューを使用できます。
ボタンクリックトリガー
エディタにボタンまたはナビゲーションオブジェクトが配置されている場合、ボタンをクリックすることでトリガーとしてアクションを実行するイベントの一部として利用できます。

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

ここでは、特集されている項目を詳しく見ていきましょう:
| メニューアイテム | メニューエリア | ボタンクリックトリガーオプション |
|---|---|---|
ターゲット: +Set Target | ![]() | |
Button: オプション | ![]() | フレーム上の特定のボタンを指定 |
- 注意: イベントシステムでボタンクリックトリガーを選択した後、さまざまなアクションでトリガー特定のボタンクリック値を利用および参照するオプションがあります。値選択メニューを使用できます。
入力時のエンターキーのトリガー
トリガー:特定の要素がアクティブな間にキーボードでエンター/リターンキーが押されます。
パラメータ:
ターゲットの追加:イベントに入力要素を追加します。
注意: イベントシステムで入力時のエンターキーのトリガーを選択した後、さまざまなアクションでトリガー特定の入力時のエンター値を利用および参照するオプションがあります。値選択メニューを使用できます。
スクロールトリガー
トリガー:特定の要素に対してスクロールバー、トラックパッドのスクロール、またはマウスのスクロールホイールが使用されます。
パラメータ:
- スクロールがY軸かX軸(縦方向または横方向)かを選択します。
ターゲット:スクロールトリガーが適用されるターゲット要素を設定します。
注意:長いテキストの場合、'オブジェクトプロパティ'パネルの‘スタイル’セクションのOverflow-Xおよび/またはOverflow-Yオプションにはscrollを選択する必要があります。
- 注意: イベントシステムでスクロールトリガーを選択した後、さまざまなアクションでトリガー特定のスクロール値を利用および参照するオプションがあります。値選択メニューを使用できます。
ゲームパッド/ジョイスティックトリガー
Gamepad/ Joystick Triggerでは、実験デザインでゲームパッドやジョイスティックコントローラーを入力デバイスとして利用してデータを記録することができます。 注意: このオプションはSettingsタブの下で有効にすることを忘れないでください。
生理的信号トリガー
これらのトリガーは、タスクのためにアイ・トラッキングおよび/またはヘッドトラッキングが有効になっている場合にのみ適用されます。
アイ・トラッキング・ゲイズ・トリガー
トリガー:
- 全般的に、このトリガーはアイ・トラッキングが有効になっているときに適用されます。
- 特定の要素を見ているときだけトリガーされます。
パラメータ:
特定の要素でのみトリガーすることを選択した場合は、ターゲットとしてその要素を追加します。
注意: イベントシステムでアイ・トラッキング・ゲイズ・トリガーを選択した後、さまざまなアクションでトリガー特定のゲイズ値を利用および参照するオプションがあります。値選択メニューを使用できます。
詳細を学ぶ: アイ・トラッキングを有効にし、ゲイズデータを記録し、実践的な例を見るための専用のアイ・トラッキング・ゲイズ・トリガーページを参照してください。
アイ・トラッキング注視トリガー
このトリガーは現在BETA版です。
- 注意: イベントシステムでキーボードトリガーを選択した後、トリガー特有の注視値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
詳細: 注視検出を有効にし、注視データを記録し、実用的な例については、専用のアイ・トラッキング注視トリガーページを参照してください。
ヘッドトラッキングトリガー
トリガー発動条件:
頭の向きや頭の動きの変化。
注意: イベントシステムでヘッドトラッキングトリガーを選択した後、トリガー特有のヘッドトラッキング値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
試験とフレームトリガー
タスク初期化トリガー
トリガー発動条件:
- タスクの最初の試行の最初のフレーム。一度のタスクにつき一度だけ実行され、すべてのインスタンスでイベントタブに表示されます。
このトリガーは、シャッフルおよび読み取りアクションと組み合わせて相性が良いです。これらの組み合わせにより、タスクが開始されるときに配列エントリやデータフレームをシャッフルし、刺激のセットに被験者を割り当てることができ、刺激やデータを読み取るために複数のイベントを作成する必要がなくなります。
パラメータ: なし
- 注意: イベントシステムでタスク初期化トリガーを選択した後、トリガー特有のタスク初期化値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
フレーム初期化トリガー
トリガー発動条件:
- フレームの初期化、参加者に表示される前。
このトリガーはシャッフル、読み取り、およびランダム数を描画するアクションと組み合わせて相性が良いです。これらの組み合わせにより、フレームが表示される前にこれらのアクションが完了し、フレームの開始に伴って他のアクションが始まる明確な道筋が残されます。
注意: 変数を記録するイベントや試行番号や条件番号などのシステム変数を含むイベントでフレーム初期化トリガーを使用しないでください。これは、フレーム初期化トリガーが試行の間に発生し、そのため、表示される試行や条件の完全なカウントが行われないためです。
パラメータ: なし
- 注意: イベントシステムでフレーム初期化トリガーを選択した後、トリガー特有のフレーム初期化値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
タスクおよびフレーム初期化トリガーについての注意: タスクおよびフレーム初期化トリガーはタスクまたはフレームが始まる前に発生するため、この時点で作成された変数は、タスク/フレームが実際に開始されるとリセットされます。このイベントを使用すると警告が表示されます:

変数の値をリセットしたくない場合は、変数プロパティウィンドウで「試行開始時にリセット」のチェックを外してください。
フレーム開始トリガー
トリガー発動条件:
- フレームの開始
パラメータ: なし
- 注意: イベントシステムでフレーム開始トリガーを選択した後、トリガー特有のフレーム開始値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
フレーム終了トリガー
トリガー発動条件:
- フレームの終了(フレームがもはや表示されない後)
パラメータ: なし
- 注意: イベントシステムでフレーム終了トリガーを選択した後、トリガー特有のフレーム終了値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
変数値変更トリガー
変数値変更
トリガー発動条件:
- 変数の値が初期値から変更される
パラメータ:
変数: 変更を「聴く」変数を1つ以上選択します。これらの変数の値の変更は、即座に対応するアクションをトリガーします。
注意: イベントシステムで変数値変更トリガーを選択した後、トリガー特有の変数値変更値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
メディアオブジェクトトリガー
メディアオブジェクトトリガー
以前は別個の「オーディオ/ビデオトリガー」と「オブジェクト制御」トリガーとして知られていました。
トリガー発動条件:
- ビデオまたはオーディオファイルの開始、一時停止、または停止
- 録音オブジェクトのファイルアップロード完了、ファイル選択、録音完了
- カメラスナップショットオブジェクトのスナップショット完了またはアップロード完了
パラメータ:
対象: フレーム上に存在するオブジェクト要素を選択
実行条件: トリガーのサブタイプを選択
- オーディオまたはビデオオブジェクトオプション:
- 再生開始: 要素が再生を開始したときにトリガー
- 再生停止: 要素が一時停止したときにトリガー
- 再生終了: 要素が再生を停止したときにトリガー
- ビデオ、オーディオ、またはスクリーン録画オブジェクトオプション:
- 録音完了: オーディオ録音が停止したときにトリガー
- アップロード完了: ファイルアップロードが完了したときにトリガー
- ファイルアップロードオブジェクトオプション:
- ファイル選択: ファイルが選択されたときにトリガー
- アップロード完了: ファイルアップロードが完了したときにトリガー
- カメラスナップショットオブジェクトオプション:
- スナップショット完了: カメラがスナップショットを正常に撮ったときにトリガー
- アップロード完了: スナップショットのアップロードが完了したときにトリガー
- オーディオまたはビデオオブジェクトオプション:
注意: イベントシステムでメディアオブジェクトトリガーを選択した後、トリガー特有のメディアオブジェクト値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
APIトリガー
外部サーバーからLabvancedにデータを送信または通信する必要がある場合は、「APIトリガー」と「APIアクション」を使用できます。以下をトリガーとして使用できます。
- Websocketトリガー
- OpenAIトリガー
- PostMessage受信

Websocketトリガー
Websocket Triggerは、実行中の研究がWebSocket接続を介してメッセージを受信したときに発火します。たとえば、他のデバイスからマーカーを渡すローカルスクリプトからのものです。
- 注意: イベントシステムでWebSocketトリガーを選択した後、トリガー特有のWebSocket値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
OpenAIトリガー
「OpenAIトリガー」は、OpenAIからの受信情報に基づいてアクションを開始するために使用できます。

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

注意: ここでは、ChatGPTを統合した研究を段階的に構築するこのウォークスルーも参照してください。
以下の例では、割り当てられたデータフレームは「df」と呼ばれ、「OpenAIトリガー」の結果がこのデータフレームに追加されます。このデータフレームには2つの列が必要です。最初の列は「役割」を示し、2番目の列は「チャットメッセージ」です。アクションからの値は、ここにリンクされたデータフレームに自動的に追加されます。

「OpenAIに送信」アクションを使用している場合は、ここで示したのと同じデータフレームをそこで使用する必要があります。
- 注意: イベントシステムでOpenAIトリガーを選択した後、トリガー特有のOpenAI値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
PostMessage受信トリガー
PostMessage Receivedトリガーは、実行中の実験がブラウザのpostMessage APIを介して外部ソースからの受信メッセージを受け取ると発火します。これは、実験を親ページ、カスタムアプリケーション、または研究にデータを送信する埋め込まれた外部ウェブサイトに接続するために便利です。
- 注意: イベントシステムでPostMessage受信トリガーを選択した後、トリガー特有のPostMessage受信値をさまざまなアクションで利用および参照するオプションがあります、値選択メニュー。
グローバルトリガー
グローバルトリガーは、実験内で大きな変化が発生したとき、つまり実験の一時停止や参加者がマルチユーザースタディを離れるなどの「グローバル」な何かが起こるときに発生します。以下のオプションがグローバルトリガーとしてリストされています:
- 実験の一時停止 / 再開
- 参加者がマルチユーザースタディを離れた

実験の一時停止/再開
「実験の一時停止 / 再開」トリガーは、実験が一時停止または再開されることに基づいてイベントを実行することを可能にするオプションです。

このトリガーを選択すると、トリガーの性質をさらに特定できるビューが表示されます。これは、実験が一時停止されるときまたは続行/再開されるときに実行されるべきかどうかを指定します。


実験が一時停止しました: 参加者がスタディを一時停止(全画面から退出)します。
実験が再開されました: 参加者がスタディを再開します。このトリガーは、視線追跡研究でうまく機能します。参加者がバーチャルチンレストから離れた場合、以前の試行またはフレームに戻すために使用できます。
注: イベントシステムで一時停止/再開実験トリガーを選択した後、トリガー固有の値をさまざまなアクションで利用し、値選択メニューを参照するオプションがあります。
参加者がマルチユーザースタディを離れた
参加者がマルチユーザースタディを離れた場合、それもイベントのトリガーとして使用できます。参加者がマルチユーザースタディを離れると、他の参加者がスタディを続けられなくなるため、全体的な実験に影響します。

このトリガーを選択することで、参加者がマルチユーザースタディを離れた場合にどのようなアクションが発生するかを指定できます。

アクション
アクションは、イベントが実行されたときに何が起こるべきかを定義します。これらは、変数やオブジェクトのプロパティを変更したり、データを記録したり、配列へのデータの読み書きを行ったり、次の試行やタスクにジャンプするために使用できます。通常、イベントごとにいくつかのアクションがあります。「ControlActions」を使用することで、論理演算(If-Else文)、ループ、コールバック関数、さらにはアクションをお互いにネストすることができます(例:if文の中のwhileループ)。したがって、イベントシステムはグラフィカルなプログラミング環境として見ることができます。このビューでは、トリガーが関数の呼び出しとして機能し、アクションが機能的なロジックを表します。このアプローチにより、特定のプログラム的/構文的構造を使用することなく、ほぼすべての実験的ロジックを実装できることが保証されます。
以下の表は、Labvancedで利用可能なアクションの概要を示しています:
| アクションカテゴリ | アクションオプション | 説明 |
|---|---|---|
Object Actions | オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる操作を指します。 | |
Variable Actions | 変数値を読み取ったり記録したりするアクション。 | |
Array Actions | 配列操作には、配列とそのエントリを選択、追加、削除、変更、シャッフルすることが含まれます。 | |
Data Frame Operations | これらのアクションは、実験内で.csvファイル(データフレーム)を扱う場合に関連します。 | |
Jump Actions | 特定のセクションにジャンプすることにより、実験をナビゲートしたり、参加者セクションを受け入れたり拒否したりすることができます。 | |
Control Actions | 制御アクションは、if/thenロジックのような特定のイベントシーケンスを実行するために使用されます。特定のアクションが行われるまでの遅延を設定することも含まれます。 | |
API Actions | APIにデータを送信するためのAPI固有のアクションを指します。 | |
Code Actions | コードアクションを使用すると、JavaScriptまたはCSSで作業できます。 | |
Paste Action | ペーストアクション | 以前にコピーしたアクションをペーストすることができます。 |
オブジェクトアクション
オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる操作を指します。いくつかのオブジェクトアクションオプションがあります:
- オブジェクトプロパティの設定
- メディアオブジェクトの制御
- オブジェクトのコピー
- 各オブジェクトに対して

オブジェクトプロパティの設定アクション
「オブジェクトプロパティの設定」アクションを使用すると、対象のオブジェクト、変更するプロパティ、そして新しい値を指定することで、オブジェクトの外観を自由に変更できます。
メディアオブジェクトの制御アクション
以前は別々の「オーディオ/ビデオの制御」と「オブジェクトの制御」アクションでした。
効果:動画/音声要素の再生を変更したり、アップロード/録音要素の状態を変更したりします。
パラメータ:
- ターゲット: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アクションを使用すると、値を変数に書き込むことができ、ターゲット変数を選択または作成し、値選択メニューを通じて値を定義します。これは、行動測定を記録し、Labvancedでの変数ベースのロジックを駆動するための中核メカニズムです。
クリップボードにコピーアクション
効果: 変数値をコンピュータの内部クリップボードにコピーします。
ランダム番号を引くアクション
効果: 1つまたは複数のランダムな数字を引き、それを変数に保存します。
パラメータ:
- 種類: 連続値と離散値の間から選択
- 分布: ガウス分布と一様分布の間から選択
- 複数の引き出し(真/偽): 1回または複数回引くことを選択します。
- 引き出しの数: 引き出しの数を選択
- 最小: 一様分布の最小値を定義
- 最大: 一様分布の最大値を定義
- 平均: ガウス分布の平均値を定義
- 標準偏差: ガウス分布の標準偏差を定義
- 変数に保存: 値が保存される変数を選択。
URLパラメータ取得アクション
効果: 参加者のユニークなURLから値を保存します。
パラメータ:
- パラメータ名: 望ましいパラメータの名前を入力
- 変数に保存: パラメータ値を保存する変数を選択
このアクションは、参加者のためにユニークなURLを構築したり、データ分析に必要な情報を抽出したりするために他のアクションと組み合わせて使用できます。 URL_Search_Paramsと比べたこのアクションの専用の手順については、URLパラメータ取得アクションを参照してください。
デバイスから読み込み/書き込みアクション
効果: ローカルデバイスのストレージに変数を読み書きします。このアクションは、データをLabvancedサーバーに送信するのではなく、参加者のデバイスにデータを保存します。
パラメータ:
- ローカルデバイスから読むか、書き込むかを選択します。
- 読み書きする変数を選択します。
ユースケース: 縦断的/マルチセッション研究
- このアクションを使用すると、デバイス固有のデータをセッション間で引き継ぐことができ、すべてのセッションで同じ参加者が同じデバイスを使用している場合に利用できます。
- 例えば、セッション1で各参加者に提示された画像を記録し、セッション2で異なる画像を提示するように、このアクションを使用することができます。
- 画像の配列を作成し、各セッションで提示するためにいくつかをランダムに選択します。
- デバイスに書き込む: セッション1で提示された画像のインデックス番号。
- デバイスから読み取る: セッション2で、セッション1の画像のインデックスを読み出し、これらのインデックスがセッション2で選択されないようにするJavaScriptアクションを含めます。
共有変数から読み込み/書き込みアクション
効果: 研究のセッション間で共有される変数を読み書きします。変数はすべての参加者と共有されるか、各個人にプライベートです。
パラメータ:
- シンクする変数を選択します。スカラーまたは配列でなければなりません。
- 高度なオプション
- ストレージキー: 同期された変数にアクセスするためのキーとして機能する変数の名前を選択します。
- 読み取りまたは書き込み方法:
- 共有変数を読み取り、修正してから書き込む: 変数を読み取り、変更を加え、その変数を研究に送信します。
- サーバーから共有値のみを読み取る: 研究内で共有されている変数を呼び出しますが、変更は行いません。
- サーバーにのみ変数を書き込む: 共有変数を変更しますが、参加者には表示しません。
- 異なる参加者間で値を共有する(セッション間ではなく): 参加者がセッションを超えて互いの同期された変数値を確認できるようにします。このオプションはデフォルトで選択されていますが、チェックボックスをクリックすることで選択を解除できます。
- アクションシーケンス:
- 利用可能なすべてのアクションのリストから、共有/同期された変数に何が起こるかを選択します。
ユースケース: 縦断的/マルチセッション研究
- このアクションを使用すると、参加者固有のデータをセッション間で引き継ぐことができ、セッションを越えて参加者同士で共有することができます。
- 例えば、テストのスコアを記録し、その後参加者が他の参加者の平均スコアと比較できるようにこのアクションを使用できます。
- もう一つの例(デバイスから読み取り/書き込みアクションに似ている)は、参加者が配列から好きな5つの画像を選び、タスクを実行し、その後別のセッションで再度その5つの画像を提示することです。違いは、このアクションを使用して、他の参加者が選んだ画像を表示したり、他の参加者の選択肢からその画像を除外したりできる点です。
数学と統計アクション
効果: 入力変数(配列)の数学的操作を実行し、結果を出力変数に保存します。
パラメータ:
- 種類: 配列操作、線形代数、統計テストの中から選択
- 操作: 数学操作を選択(例: 合計、最小、標準偏差など)
- 入力配列: 操作を実行する入力変数(配列)を選択
- パラメータ: 一部の操作には追加のパラメータがあります。
- 出力: 結果を保存する出力変数を選択。
変数を即座に記録するアクション
効果: すべての変数値のスナップショットを作成し、Labvancedサーバーに送信します。
パラメータ: なし
移動平均フィルターアクション
効果: 入力の移動平均(データの常に更新される平均)を計算し、結果を新しい変数に保存します。
パラメータ:
- フィルター形状: フィルタータイプを選択
- 単純移動平均: すべてのサンプルが同じ重みを持つ単純移動平均を計算します。
- 線形加重移動平均: サンプルに重みを付け、サンプルの重みが線形に減少します。
- 指数移動平均: サンプルに重みを付け、サンプルの重みが指数的に減少します。
- サンプル数: ステップあたりに使用されるサンプルの数を決定します。
- 入力: 移動平均が計算される入力変数(配列)を選択
- 出力: 結果が保存される出力変数を選択。
変数配布アクション
変数配布アクションは、Labvanced におけるマルチユーザー研究に不可欠です。このアクションを使用すると、変数の値が参加者間で共有され、情報(刺激の位置や変更を含む)が参加者の画面に反映されるようになります。このアクションに関する詳細な手順は、変数配布アクション をご覧ください。

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

こちらのデモでは、変数配布とチャットボックス機能が組み込まれています: イメージ記述タスクにチャットアドオン。
ダイアログのメニュー項目に関する完全な説明は以下の通りです:
| メニュー項目 | メニューエリア | 変数配布アクションのオプションと説明 |
|---|---|---|
Distribute value to | ![]() | どの他の参加者に値を送信するかを選択します。
|
Choose target variable and value | ![]() |
|
Block | ![]() | 有効にすると、現在の値の配布が完了するまでターゲット変数は変更できません。 |
Rate Limit Strategy | ![]() | レート制限戦略は、サーバーのオーバーフローから実験を保護し、サーバーに送信されるリクエストのレート(すなわち、変数配布を介した更新)を制御するための予防策として機能します。以下の戦略オプションが利用可能です:
|
配列アクション
配列から選択(読み取り)アクション
効果: 配列から1つの変数を読み取り、この値をスカラー変数に保存します。
パラメータ:
- 配列変数: 値を読み取るための入力配列。
- インデックスタイプ: どの種類のインデックスが使用されるかを決定します。
- 固定: 読み取り操作のために固定インデックスを使用します。この場合、情報が読み取られる位置を入力します(1ベース)。
- 変数: 読み取り操作のためのインデックスとして数値変数を使用します。この場合、読み出しの位置を決定するためにスカラー数値変数を選択します。
- 配列の末尾: 配列の末尾から読み取ります。
- 出力変数: 読み取られた値が保存されるスカラー変数を選択します。
配列のエントリを追加/削除アクション
効果: 配列からエントリを追加および/または削除します。
パラメータ:
- 配列変数: 追加または削除操作を実行する配列変数。
- インデックスタイプ: どの種類のインデックスが使用されるかを決定します。
- 固定: 挿入/削除操作のために固定インデックスを使用します。この場合、エントリが挿入/削除される配列位置を入力します(1ベース)。
- 変数: 挿入/削除操作のために数値変数をインデックスとして使用します。この場合、エントリが挿入/削除される場所を決定するためにスカラー数値変数を選択します。
- 配列の末尾: 配列の末尾に挿入/削除します。
- 削除するエントリの数: 定義されたインデックス位置から開始して、配列エントリを削除します(新しいエントリを挿入する前に)。0は、値が削除されないことを示します。
- 挿入する変数: 定義されたインデックス位置で配列変数に追加される1つ以上のスカラー変数を選択します。
配列エントリの変更(置換)アクション
効果: 配列内の1つの値を置き換え/変更します。
パラメータ:
- 配列変数: 変更する1つの値を持つ配列変数
- インデックスタイプ: どの種類のインデックスが使用されるかを決定します。
- 固定: 置換操作のために固定インデックスを使用します。この場合、変更されるべき配列位置を入力します(1ベース)。
- 変数: 置換操作のために数値変数をインデックスとして使用します。この場合、置換操作の位置を決定するためにスカラー数値変数を選択します。
- 配列の末尾: 配列の最後のエントリを置き換えます。
- 入力変数: 新しい値を保持する(スカラー)変数を選択します。
配列エントリのシャッフルアクション
効果: 配列内のエントリ/順序を再シャッフルします。
パラメータ: なし
データフレーム操作
データフレームから読み取り/書き込みアクション
効果: データフレームから値を読み出したり、値をデータフレームに書き込んだりし、新しい配列変数に保存します。
パラメータ:
- データフレーム変数: 読み取るデータフレームの変数を選択します。
- 読み取りまたは書き込み: 選択したデータフレームから読み取るか、選択したデータフレームに書き込むかを選択します。
- 行または列による: データの読み取り方法を選択します。
- インデックスタイプ: データフレームを読み取るために使用されるインデックス変数のタイプを選択します。固定、変数、または最終行のいずれかです。
- インデックス変数: データフレームを読み取るために使用される変数を選択します。
- 出力変数: 読み取った/書き込まれたデータが出力として保存される変数を選択します。配列変数である必要があります。
データフレームエントリのシャッフルアクション
効果: データフレーム内のエントリの順序をシャッフルします。
パラメータ:
- シャッフルするデータフレームを選択します。
- データフレームを行または列でシャッフルするかを選択します。
ジャンプアクション
ジャンプアクション
効果: 参加者を実験内の異なるステップに「ジャンプ」させます。このアクションは、実験内の試行やタスクの順序を変更することができ、各参加者のための個別の実験ロジックを作成するために使用できます。
パラメータ:
- ジャンプ先: 実験のどこにジャンプするかを決定します。
- 次のフレーム: 次のフレームにジャンプします。試行内に他のフレームが定義されていない場合、次の試行の最初のフレームにジャンプします。
- 次の試行: 次の試行にジャンプします。試行内に他の試行が定義されていない場合、次のタスクの最初の試行にジャンプします。
- 次のタスク: 次のタスクにジャンプします。タスク内に他のタスクが定義されていない場合、次のブロックの最初のタスクにジャンプします。
- 次のブロック: 次のブロックにジャンプします。ブロック内に他のブロックが定義されていない場合、セッションが終了します。
- 前のフレーム: 前のフレームにジャンプします。前のフレームがない場合、このアクションは実行されません。
- 特定のフレーム: 特定のフレームにジャンプします。ユーザーが直接ジャンプするフレームを選択します。
- 特定の試行: 特定の試行にジャンプします。ユーザーが直接ジャンプする試行番号を選択します。
- 特定のタスク: 現在のブロック内の指定されたタスクの最初のインスタンスにジャンプします。ユーザーが直接ジャンプするタスクを選択します。
- 特定のブロック: 指定されたブロックの最初のインスタンスにジャンプします。ユーザーが直接ジャンプするブロックを選択します。
- このフレーム内でスクロール: 現在のフレーム内をスクロールし、フレームを離れることはありません。
Display ModeがZoom / Adaptiveでないタスクのキャンバスフレームでのみ提供されます。また、オーバーフロー設定がMake frames scrollableです(両方ともタスク設定で)。ターゲットはPosition(フレーム単位でのX/Y、表示領域の左上隅になります)またはフレーム上のObject(左上隅が表示領域の左上隅になるまでスクロールします)です。スムーズスクロールはオフにすることもできます。典型的な使用法: 長い1ページのフレームにおけるナビゲーションバー。
- 必要な回答を確認する前: 有効にすると、実験はすべての必要な回答が既に回答されているかどうかを確認します。そうでない場合、ジャンプアクションは実行されません。
セッションの受け入れ/終了アクション
効果: 参加者のデータを受け入れ、録音セッションを終了し、クラウドソーシングコードを表示します。
パラメータ:
- セッション終了前に試行データを記録: 有効にすると、最新の試行データが保存されます(サーバーに送信)し、研究を終了する前に保存されます。
- デフォルトの終了ページを表示: 有効にすると、デフォルトのLabvanced終了画面が表示されます。これがクラウドソーシングセッションである場合(クラウドソーシングリンクが使用された場合)、補償コードが参加者に示されます。無効にすると、実験は現在のフレームを表示した後に終了し、補償コード付きのデフォルトの終了画面は表示されません。
セッションの拒否/終了アクション
効果: 録音セッションを終了し、参加者のデータを完了としてマークせず、補償コード付きのデフォルトの終了画面を表示しません。
このアクションを使用して参加者のデータを拒否する場合、ユーザーは参加者に報酬が得られない理由を説明する適切なメッセージを表示するべきです。
パラメータ: なし
URLにリダイレクトアクション
効果: 参加者を特定のURLにリダイレクトします。
注意: このアクションが機能するためには、URLの先頭に https:// を含める必要があります。
コントロールアクション
要件アクション(If... Then... Else If)アクション
効果: If-Thenステートメントを評価し、連鎖的にアクションを実行します。各If / Else-Ifステートメントは、すべての要件が満たされているかどうか(ステートメントが真であるかどうか)を評価するための入れ子のAND / OR比較で構成されています。ステートメントが真の場合、「Then」の下のアクションが実行されます。このアクションに関する専用のウォークスルーについては、要件アクションを参照してください。
パラメータ:
- 要件の追加: ステートメントに新しい要件を追加します。論理比較を行うために、両側に「value-select」メニューが表示されます。ステートメントの中央で、両側をどのように比較するか(例: 等しい、より小さい、不等しいなど)を選択できます。
- ORグループの追加: ORグループ内のすべての要件のうち、1つだけが真であれば、全体のグループが真となります。サブアクションが複数の場合に実行されるべきであればORグループを追加します。
- ANDグループの追加: ANDグループ内のすべての要件が真でなければ、全体のグループは真とはなりません。サブアクションが複数の要件が満たされた場合にのみ実行されるべきであればANDグループを追加します。
- アクションシーケンス: 各If / Else-Ifステートメントには、"Then"の下に定義されたアクションのリストがあります。新しいアクションは「アクションの追加」アイコンを使って追加できます。アクションシーケンスは、関連付けられたIf / Else-Ifステートメントの要件が満たされた場合にのみ実行されます。
- Else-Ifケースの追加: 要件アクションは、いくつかの別々のIf / Else-If --> Thenステートメントで構成されることができます。ただし、1つのステートメントのみが実行されます。1つのIf / Else-Ifステートメントが肯定的に評価される場合(真を返す場合)、Thenブロックのアクションが実行され、要件アクションの残りはスキップされます。
- Elseケースの追加(真/偽): 有効にすると、要件アクションにデフォルト/フォールバックオプションが追加されます。If / Else-Ifステートメントのいずれも実行されない場合(真を返さない場合)、elseケースで定義されたアクションが実行されます。
繰り返しアクション(Whileループ)アクション
効果: 一連のアクションを繰り返し実行します、ただし、即座にまたは定義された間隔内で実行されます。ループの実行が停止される停止条件を指定できます。
パラメータ:
- 実行タイプ: 即座の実行かタイミング実行を選択します。
- 完全なループを実行: 停止条件が満たされるまで、このループは継続して実行されます。
- 毎...ミリ秒実行: 定義された間隔(例: 50ミリ秒ごとにループが実行されます)でループを実行します。
- ループ数の定義: 「毎...ミリ秒実行」が選択されている場合、ループを何回実行するかの数値整数値を指定できます。これにより、停止条件を定義する必要がなくなります。
- 実行間隔: これは実行間隔を決定します。
- すぐに開始(真/偽): 有効にすると、これはすぐにループを実行します。無効にすると、次の実行間隔でループが開始されます。
- 複数の開始を許可(真/偽): 有効にすると、複数のループインスタンスを並行して開始できます。無効にすると、一度に1つのループインスタンスのみが実行できます。
- 停止条件を有効にする(真/偽): 有効にすると、ループの停止条件を指定できます。
- 停止条件: 停止条件を使用して、ループの実行を停止する論理式を指定できます。If / Else-Ifステートメントと同様に、論理比較のためにANDグループ、ORグループ、および要件を組み合わせることができます。
- アクションシーケンス: アクションシーケンスは、ループの各反復で実行されるすべてのアクションをリストします。「アクションの追加」アイコンを使用して新しいアクションを追加できます。
遅延アクション(タイムコールバック)アクション
効果: 一定の時間遅延の後に一連のアクションを実行します。
パラメータ:
- 遅延タイプ: 固定遅延または可変遅延のいずれかを選択します。
- 固定遅延: アクションは固定遅延の後に実行されます。
- 可変遅延: アクションは(数値)変数で指定された遅延の後に実行されます。
- 遅延: 遅延の長さ(ミリ秒)です(ms)。
- アクションシーケンス: アクションシーケンスは、指定された時間遅延の後に実行されるすべてのアクションをリストします。「アクションの追加」アイコンを使用して新しいアクションを追加できます。
アクショングループ
アクションはアクショングループに整理することもできます。アクショングループを使用すると、視覚的な構造を簡単にするために特定のアクションをグループ化できますが、同時に複数のアクションを一度にコピー、複製、または削除したい場合にも便利です。
コントロールフレームアクション
Control Frame アクションは、オーバーレイまたはダイアログフレームを表示、非表示、または切り替えます。設定と利用可能なコマンドについては、オーバーレイとダイアログを参照してください。
API アクション
外部サーバーからLabvancedにデータを送信または通信する必要がある場合は、「API アクション」と「API トリガー」を使用できます。このカテゴリには次のアクションが用意されています:
- PostMessageを送信
- Websocketに送信
- OpenAIに送信
これらのアクションを「利用可能」または使用可能にするには、SettingsタブにAPIキーを入力する必要があります。

PostMessageを送信アクション
Send PostMessage アクションは、ブラウザのpostMessage APIを使用して、実行中のLabvanced実験から親ウェブページや埋め込みフレームなどの外部ターゲットにメッセージを送ります。
Websocketに送信アクション
Send To Websocket アクションは、研究からローカルスクリプトまたは外部サーバーにWebSocket接続を介してメッセージ、変数値、または記録ファイルを送信します。
OpenAIに送信アクション
「OpenAIに送信」アクションでは、文字列入力値などの情報をOpenAIに送信できます。このオプションを使用するには、SettingsタブのSpecial FeaturesにAPIキーを記載する必要があります。

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

必要な情報がすべて提供された場合、このイベントがどのように見えるかの実用的な例を次に示します:

この機能をどのように活用し、実際に見るかについてのより深い理解が必要な場合は、このお問い合わせフォームを提出してデモをリクエストしてください。
注: また、このウォークスルーも参照してください。ここでは、ChatGPTを研究に統合し、このアクションを利用してステップバイステップで研究を構築します。
ここでは、「Send to OpenAI」アクションに含まれるフィールドの詳細な説明を示します:
| メニュー項目 | メニューエリア | 「Send to OpenAI」アクションオプション |
|---|---|---|
Model Type | ![]() | |
Chat History Dataframe | ![]() | 2列のデータフレーム変数へのリンク。最初の列は「役割」、2番目の列は「チャットメッセージ」を示します。アクションからの値は、ここにリンクされているデータフレームに自動的に追加されます。 データフレームはデータフレームアクションで操作することもできます。詳細については、OpenAIのドキュメントを確認してください。 |
Insert Message ‘+’ | ![]() | これをクリックすると、変数ダイアログボックスが表示されます。「変数」値がOpenAIに送信されていることと、関連するメッセージの「役割」を示す必要があります:
|
OpenAIは日々進化しているため、詳細についてはOpenAIのドキュメントを確認してください。
コードアクション
場合によっては、実験でカスタムコードを使用する必要があります。これらのアクションを使用すると、それが可能になります!「コードアクション」メニューの下で利用可能なオプションは次のとおりです:
- JavaScriptを実行
- グローバルCSSを設定

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

上記の「JavaScriptを実行」アクションが選択されると、JavaScriptコードを書き込むエリア(コードエディタ)とその使用方法に関する指示が表示されます:

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

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

「グローバルCSSを設定」アクションの使用例としては、参加者がマルチチョイスの質問から特定の色を選択したときに、研究の背景色を変更することが挙げられます。
ペーストアクション
このオプションは、以前に作成してコピーしたアクションを貼り付けることを可能にします。実験を設計する際に、同じ項目を繰り返し選択する必要がなくなり、作業が速くなります。たとえば、すでに存在するイベントと類似するイベントがある場合、それをコピーして貼り付け、修正することができます。最初から構築する代わりに。
値選択メニュー
特定のイベントを扱う際に、ペンアイコンが表示されることに気付くでしょう。これは値選択メニューと呼ばれ、記録または追跡する値の種類を選択して指示することができます。これは、実験デザインとセットアップに使用される非常に強力で重要なオプションです。
このペンアイコン / 値選択メニューは、Set / Record Variableアクション、Set Object Propertyアクション、Requirement (If... Then)アクションなど、イベントシステムの特定のアクションでさまざまな場所に表示されます。以下に示します。

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

上の画像は、マウストリガーが使用されている場合の値選択メニューの外観を示しています。最初のメニュー項目はトリガー固有のカテゴリから始まり、他の5つのカテゴリ(現在の時間など)に移行します。
メニューオプション
以下の表は、カテゴリとオプションについてさらに説明します:
| カテゴリ | オプション | 説明 |
|---|---|---|
Trigger-specific | トリガータイプに依存します。 | イベントに選択したトリガーに基づいて、値選択メニューの最上部に特定のオプションのリストが表示されます。オプションと説明の完全なリストを確認するには、トリガー固有の値のセクションを参照してください。 |
Current Time | 時間の値を測定し、呼び出す。 | |
Constant Value |
| 必要な変数のタイプに応じて定数値を割り当てます。これらは時々、カウンターを作成するために他のオプションArithmeticと組み合わせて使用されることがあります。 |
Variable |
| 変数を指定または参照したり、配列またはデータフレームから値を選択したりします。 |
Frame / Task / Object |
| オブジェクトプロパティ、フレーム、眼球追跡(有効にされている場合)、デバイス(画面のリフレッシュレート)に関連付けられた値を取得することができます。 |
Operations |
| 変数の値を結合したり、文字列をすべて小文字に変換したり、数学的操作を実行したりするなど、指定された変更を変数に適用するための操作を使用します。 |
現在の時間の値
「現在の時間」オプションを使用すると、時間に関する値を記録したり言及したりできます。
次のオプションが利用可能です:
現在の時間:UNIX タイムスタンプ
この値は、ミリ秒単位のUNIX形式のタイムスタンプをキャプチャします。
現在の時間:フレームの開始からの時間
この値は、フレームの開始から経過した時間をキャプチャします。一般的には、これは反応時間に相当します。
定数の値
必要な変数のタイプに応じて定数値を割り当てます。これらは時々、カウンターを作成するために他のオプションArithmeticと組み合わせて使用されます。
次のオプションが利用可能です:
定数:文字列
文字列/テキスト値を割り当てます。
定数:数値
数値/番号値を割り当てます。
定数:ブール値
真または偽の値を割り当てます。
定数:カテゴリ値
レベル値(主に因子用)を割り当てます。
定数:日付
日付値を割り当てます。
定数:時間
時間値を割り当てます。
定数:色
色(16進数文字列)値を割り当てます。
変数の値
変数を指定または参照したり、配列やデータフレームから値を選択したりします。次のオプションが利用可能です:
変数を選択
変数を選択してポイントを指定できます。
配列から値を選択
配列から値を選択できます。
データフレームから値を選択
作成したデータフレームから値を選択できます。
フレーム / タスク / オブジェクトの値
オブジェクトプロパティ、フレーム、アイエイトラッキング(有効な場合)、デバイス(画面リフレッシュレート)に関連付けられた値を取得できます。
オブジェクトプロパティ
オブジェクトプロパティを読み出します。
フレーム
| フレーム値オプション | 説明 |
|---|---|
Last cached Mouse X Position | 参加者のマウスの最後のX座標値。 |
Last cached Mouse Y Position | 参加者のマウスの最後のY座標値。 |
Last cached Mouse [X,Y] Array | 配列形式での参加者のマウスの最後の[X,Y]座標値。 |
Frame Name | フレームの名前。 |
アイエイトラッキング
| アイエイトラッキング値オプション | 説明 |
|---|---|
Last cached Coordinate X | 参加者の視線の最後のX座標値。 |
Last cached Coordinate Y | 参加者の視線の最後のY座標値。 |
Last cached Coordinate [X,Y] Array | 配列形式での参加者の視線の最後の[X,Y]座標値。 |
Last cached Coordinate + Time [X,Y,T] Array | 配列形式での参加者の視線の最後の[X,Y]座標値に加え、カメラキャプチャT値。 |
デバイス
- リフレッシュレート: 参加者のデバイスのリフレッシュレート値。
操作
操作を使用して、変数への指定された変更を実行します。これには、変数の値を結合したり、文字列をすべて小文字に変換したり、数学的操作を実行したりすることが含まれます。
以下のオプションが利用可能です:
算術
算術操作は、文字列を結合したり、オブジェクトプロパティを変更したりするなど、多目的に役立ちます。

基本的に、算術操作は複数の値に対して操作を実行できます。
このオプションを選択すると、追加のペンアイコン(例:値選択メニュー)が表示され、加算などの操作のリストも表示されます。

値は、以下の5つの異なる操作を使用して操作できます:
- (+) 加算
- (-) 減算
- (/) 除算
- (*) 乗算
- (%) 割り算
以下の例は、算術操作を活用して「intermediateVar」という名前の新しい文字列変数を作成する方法を示しています。

新しい変数値(「intermediateVar」)は、算術操作をいくつか組み合わせて、以前に作成した変数(「userChatName」と「chatInput」)と、定数文字列値(例:セミコロン:と空白<br>)によって定義されます。この操作は、マルチユーザースタディで使用できるユーザーのチャットの効果を生み出します。
文字列操作
| 文字列操作オプション | 説明 |
|---|---|
To Lowercase | 文字列変数内のすべての文字を小文字に変換します。 → 例: (AAABBB) は (aaabbb) に変換されます。 |
To Uppercase | 文字列変数内のすべての文字を大文字に変換します。 → 例: (aaabbb) は (AAABBB) に変換されます。 |
To Link | 変数内の文字列を別のウィンドウで開くURLに変換します。 |
Remove Whitespaces | 文字列変数内の文字間のスペースを削除します。 → 例: (aaa bbbb cccc) は (aaabbbbccc) に変換されます。 |
Trim Whitespaces | 文字列変数の先頭のスペースを削除します。 → 例: ( aaabbbcccc) は (aaabbbcccc) に変換されます。 |
Replace Substring Regexp | 文字列値変数内の特定の文字を置き換えます。 → 例: (aaabbbccc) は bbb を xxx に置き換え、その値は (aaaxxxccc) に変換されます。 |
数学操作
スカラー値に対して数学操作を実行します。
| 数学操作オプション | 説明 |
|---|---|
abs | 値の絶対数を返します。 |
sqrt | 値の平方根を返します。 |
round | 0から3桁までの四捨五入値を返します。 |
floor | 下方向に切り捨てた値を返します。 |
ceil | 上方向に切り上げた値を返します。 |
cos | コサイン値を返します。 |
sin | サイン値を返します。 |
tan | タンジェント値を返します。 |
トリガー特定の値
トリガー特定の値は、特定のイベント内で定義されたトリガーに関連付けられた値を指します。例として、イベントがマウストリガーを使用している場合、アクションが指定された特定の領域内(例:Set / Record Variable アクションまたは Set Object Property アクションを使用中)の場合、マウストリガー特定の値をvalue select menuで参照できます。
以下の例では、マウストリガーに関連する値を使用して、x値とy値、そして[X,Y]配列をSet / Record Variableアクションを使用して記録しています。

以下は、Labvancedで見られるすべてのトリガー特定の値の種類の表であり、その後に各オプションの詳細説明があります。
| 名称 | 値オプション - 概要 |
|---|---|
Trigger (Mouse) |
|
Trigger (Keyboard) |
|
Trigger (Button Bar) |
|
Trigger (Enter On Input) |
|
Trigger (Scroll) |
|
Trigger (Gamepad/ Joystick) |
|
Trigger (Eyetracking Gaze) |
|
Trigger (Eyetracking Fixation) |
|
Trigger (Head Tracking) |
|
Trigger (On Task Initialization) |
|
Trigger (On Frame Init) |
|
Trigger (on Frame Start) |
|
Trigger (On Frame End) |
|
Trigger (Variable Value Changed) |
|
Trigger (Media Object Trigger) |
|
Trigger (Websocket Trigger) |
|
Trigger (OpenAI Trigger) |
|
Trigger (PostMessage Received) |
|
Trigger (Global Experiment Event) |
|
Trigger (User Leaves Experiment) |
|
トリガー(マウス)の値
マウストリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:

| トリガー(マウス)オプション | 説明 |
|---|---|
Mouse X | フレーム座標での現在のマウスX位置を返します。 |
Mouse Y | フレーム座標での現在のマウスY位置を返します。 |
Mouse [X,Y] Array | マウスの[X,Y]座標を配列形式で示します。 |
Stimulus Name | イベントをトリガーしたオブジェクトの名前(例:どの画像がクリックされたか)。 |
Stimulus Info | イベントをトリガーしたオブジェクトの刺激情報。 |
Trigger Timestamp (Unixtime) | トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始からトリガーが発生するまでの経過時間(ミリ秒)。 |
トリガー(キーボード)の値
キーボードトリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:
| トリガー(キーボード)オプション | 説明 |
|---|---|
Id of Key | トリガーとして押されたキーのID値。 |
Trigger Timestamp (Unixtime) | トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始からトリガーが発生するまでの経過時間(ミリ秒)。 |
トリガー(ボタンバー)の値
ボタンクリックトリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:
| トリガー(ボタンバー)オプション | 説明 |
|---|---|
Stimulus Name | イベントをトリガーしたボタンオブジェクトの名前。 |
Stimulus Info | イベントをトリガーしたボタンオブジェクトの刺激情報。 |
Trigger Timestamp (Unixtime) | トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始からトリガーが発生するまでの経過時間(ミリ秒)。 |
トリガー(入力のEnter)の値
入力のEnterトリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:
| トリガー(入力のEnter)オプション | 説明 |
|---|---|
Id of Key | トリガーとして押されたキーのID値。 |
Trigger Timestamp (Unixtime) | トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始からトリガーが発生するまでの経過時間(ミリ秒)。 |
トリガー(スクロール)の値
スクロールトリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:
| トリガー(スクロール)オプション | 説明 |
|---|---|
Stimulus Name | イベントをトリガーしたボタンオブジェクトの名前。 |
Stimulus Info | イベントをトリガーしたボタンオブジェクトの刺激情報。 |
Scroll Position X | イベントがトリガーされたときのマウスのXスクロール位置。 |
Scroll Position Y | イベントがトリガーされたときのマウスのYスクロール位置。 |
Trigger Timestamp (Unixtime) | スクロールトリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始からスクロールトリガーが発生するまでの経過時間(ミリ秒)。 |
トリガー(ゲームパッド/ジョイスティック)の値
Gamepad/Joystick triggerが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:

| トリガー(ゲームパッド/ジョイスティック)オプション | 説明 |
|---|---|
Gamepad Device Id | 接続されているゲームパッドのIDまたは名前。 |
Pressed Keys (Array) | 押されたキー。 |
Pressed OR Hold Keys (Array) | 押されたまたは保持されたキー。 |
Released Keys (Array) | 放されたキー。 |
Axes (Array) | 軸の値。 |
Gamepad Timestamp (Unixtime) | ゲームパッドのタイムスタンプ(Unix時間)。 |
Trigger Timestamp (Unixtime) | トリガーが発生した時刻のタイムスタンプ(Unix時間)。 |
Trigger Time (From Frame Onset) | トリガーが発生した時刻のUnix時間におけるフレームの開始からのタイムスタンプ。 |
トリガー(アイ・トラッキング・注視)の値
アイ・トラッキング・注視トリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:

| トリガー (アイ・トラッキング・注視) オプション | 説明 |
|---|---|
Coordinate X | 注視のX座標の値。 |
Coordinate Y | 注視のY座標の値。 |
Coordinate [X,Y] Array | 注視のX,Y座標を配列形式で示します。 |
Stimulus Name | 注視トリガーを開始した刺激の名前。 |
Stimulus Info | 注視トリガーを開始した刺激の背後にある刺激情報。 |
Camera Capture Time T | スナップショットが発生した正確な時刻。Labvancedのアイ・トラッキングパイプラインでは、アルゴリズムとニューラルネットワークが注視計算を行う前にカメラスナップショットが最初に発生します。したがって、Camera Capture Time Tは初回スナップショットが発生した時刻のUNIXタイムスタンプです。ウェブカメラベースのアイ・トラッキングに関する技術の詳細については、ET技術ページをご参照ください。 |
Gaze Confidence C | この値は0から1の範囲であり、画像スナップショットにオープンアイがある可能性と確信度を示し、本質的に「瞬き検出器」として機能します。詳細については、公開された査読論文をご参照ください。 |
Coord. + Time [X,Y,T] Array | 注視のx/y座標とカメラキャプチャ日時のタイムスタンプ(T)が含まれる配列。 |
Coord. + Time + Confidence [X,Y, T,C] Array | 注視のx/y座標、カメラキャプチャ日時のタイムスタンプ(T)、および注視の確信度(C)が含まれる配列。 |
Trigger Timestamp (Unixtime) | 注視トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始から注視トリガーが発生するまでの経過時間(ミリ秒)。 |
詳細を学ぶ: アイ・トラッキングを有効にし、注視データを記録し、実用的な例を説明する専用のアイ・トラッキング・注視トリガーページをご覧ください。
トリガー(アイ・トラッキング・固定)の値
アイ・トラッキング・固定トリガーが使用されると、特定のアクションを操作する際に呼び出すことができる次のトリガー固有の値があります:
| トリガー (アイ・トラッキング・固定)オプション | 説明 |
|---|---|
Fixation Centroid X | 注視の中心点をX値として示します。 |
Fixation Centroid Y | 注視の中心点をY値として示します。 |
Fixation Duration | 検出された注視の持続時間。 |
Fixation Start Time | 検出された注視の開始時刻。 |
Fixation End Time | 検出された注視の終了時刻。 |
Fixation Dispersion | 検出された注視の中での注視値の分散の度合いを示します。 |
Stimulus Name | イベントをトリガーしたボタンオブジェクトの名前。 |
Stimulus Info | イベントをトリガーしたボタンオブジェクトの刺激情報。 |
[X, Y, Dur, Start, End, Disp] | 次の内容が含まれる配列:注視の重心のxおよびy値、注視の持続時間、開始時刻、終了時刻、分散値。 |
Trigger Timestamp (Unixtime) | 固定トリガーが発生した時刻のUnix時間形式でのタイムスタンプ(ミリ秒付き)。 |
Trigger Time (From Frame Onset) | フレーム開始から固定トリガーが発生するまでの経過時間(ミリ秒)。 |
詳細を学ぶ: 専用の Eyetracking Fixation Trigger ページを参照して、Fixation Detection を有効にし、フィクスデータを記録し、実用的な例を確認してください。
トリガー (頭部追跡) 値
Head Tracking trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (頭部 追跡) オプション | 説明 |
|---|---|
Camera Capture Time T | カメラがフレームをキャプチャしたとき、つまりフレームキャプチャが発生したときのユニックスタイムスタンプです。これは、処理が行われる前に画像 / フレームがキャプチャされた時間です。 |
Facemesh Dataframe | 顔メッシュモデルによって検出された468の顔のランドマークキーポイントを含むデータフレームです。各行は、正規化フレーム空間のx、y、およびz座標を持つ1つのキーポイントを表します。この値を使用して、リップ、目、または顎のランドマークなど、フレームごとの詳細な顔の幾何学にアクセスします。 |
Head Turn | 左から右への頭の回転、これは文献ではヨーと呼ばれます。 |
Head Tilt | 上から下への頭の傾き、文献ではヘッドピッチとして知られています。 |
Head Roll | 頭が左右にローリングする動きをキャプチャします。 |
Head Position [X,Y, T] Array | この配列は、頭の位置に関連する数値をキャプチャします。これには、頭の中心のxおよびy座標と、タイムスタンプ変数 (T) が含まれます。 |
Nose Position [X,Y, T] Array | この配列は、特に鼻の位置に関連する数値をキャプチャします。これには、鼻が位置しているxおよびy座標と、測定が発生したときのタイムスタンプ変数 (T) が含まれます。 |
Nose Vector [X,Y, Z, T] Array | この測定は、鼻の先端からベクトルを投影することによって機能し、参加者が画面に注意を向けているかどうかをテストするのに役立ちます(これは、目の追跡が無効にされている研究にとって特に重要です)。したがって、鼻が画面外を指す場合(つまり、参加者が実験に注意を向けていない場合)、Z値は1から減少し、0に近づきます。 |
Trigger Timestamp (Unixtime) | 実験中にトリガー自体が発生したポイントで、頭部追跡が検出され、システム内でトリガーが発生したときの時間です。基本的に、これは画像 / フレームが処理される時間であり、この値は参加者のグラフィックスカードによって大きく影響を受けます。理論的には、これは値Tにできるだけ近いはずです。 |
Trigger Time from Frame Onset | トリガーが発生した時点とフレームの開始時点との関連で、トリガーが発生したときの時間値です。 |
トリガー (タスク初期化時) 値
Task Init Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (タスク初期化時) オプション | 説明 |
|---|---|
Trigger Timestamp (Unixtime) | ミリ秒単位のトリガーのユニックスタイムスタンプ。 |
Trigger Time (From Frame Onset) | フレームの開始からトリガーが発生したときのミリ秒単位の時間。 |
トリガー (フレーム初期化時) 値
Frame Init Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (フレーム初期化時) オプション | 説明 |
|---|---|
TrialNr | フレーム初期化トリガーが発生したときの試行番号。 |
Trigger Timestamp (Unixtime) | ミリ秒単位のトリガーのユニックスタイムスタンプ。 |
Trigger Time (From Frame Onset) | フレームの開始からトリガーが発生したときのミリ秒単位の時間。 |
トリガー (フレーム開始時) 値
Frame Start Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (フレーム開始時) オプション | 説明 |
|---|---|
Trigger Timestamp (Unixtime) | ミリ秒単位のトリガーのユニックスタイムスタンプ。 |
Trigger Time (From Frame Onset) | フレームの開始からトリガーが発生したときのミリ秒単位の時間。 |
トリガー (フレーム終了時) 値
Frame End Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (フレーム終了時) オプション | 説明 |
|---|---|
Total Frame Time | フレームに費やされた合計時間(ミリ秒単位)。 |
Trigger Timestamp (Unixtime) | ミリ秒単位のトリガーのユニックスタイムスタンプ。 |
Trigger Time (From Frame Onset) | フレームの開始からトリガーが発生したときのミリ秒単位の時間。 |
トリガー (変数値変更) 値
Variable Value Changed Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (変数値変更) オプション | 説明 |
|---|---|
New Value in Variable | 変数の新しい値を指します。 |
Trigger Timestamp (Unixtime) | Unix Timeフォーマットで変数変更トリガーが発生したときのタイムスタンプ(ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始から変数の値が変更されたときまでの経過時間(ミリ秒単位)。 |
トリガー (メディアオブジェクトトリガー) 値
Media Object Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (メディアオブジェクトトリガー) オプション | 説明 |
|---|---|
Trigger Timestamp (Unixtime) | メディアオブジェクトトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からメディアオブジェクトトリガーが発生したときまでの経過時間(ミリ秒単位)。 |
トリガー (Websocket Trigger) 値
WebsSocket Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (Websocket Trigger) オプション | 説明 |
|---|---|
Message | データの異なるタイプをフィルタリングできるようにするメッセージ。 |
Data | 参加者の選択、タイムスタンプ、マウスのx/y座標など、さまざまなデータタイプを保持できる値。 |
Trigger Timestamp (Unixtime) | Websocketトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からWebSocketトリガーが発生したときまでの経過時間(ミリ秒単位)。 |
トリガー (OpenAI Trigger) 値
OpenAI Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (OpenAI Trigger) オプション | 説明 |
|---|---|
Chat GPT Answer | ChatGPTからの回答の値。 |
Trigger Timestamp (Unixtime) | OpenAIトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からOpenAIトリガーが発生したときまでの経過時間(ミリ秒単位)。 |
トリガー (PostMessage 受信) 値
PostMessage Received trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (PostMessage 受信) オプション | 説明 |
|---|---|
Message Content | 外部ソースから送信された受信postMessageのデータペイロード。 |
Trigger Timestamp (Unixtime) | PostMessage Receivedトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からトリガーが発生したときまでの経過時間(ミリ秒単位)。 |
トリガー (グローバル実験イベント) 値
Pause / Resume Experiment Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (グローバル実験イベント) オプション | 説明 |
|---|---|
Total Frame Time | トリガーの前に割り当てられた合計フレーム時間を指します。 |
Reason for Global Event | トリガーの理由を示す文字列値、例えば参加者が研究を離れるなど。 |
Trigger Timestamp (Unixtime) | グローバルイベントトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からグローバルイベントトリガーが発生したときまでの経過時間(ミリ秒単位)。 |
トリガー (ユーザーが実験を離れる) 値
Participant Left Multiuser Study Trigger が使用されるとき、次のトリガー特有の値が特定のアクションで呼び出されることがあります:
| トリガー (ユーザー が実験を離れる) オプション | 説明 |
|---|---|
Remaining Number of Participants | 研究に残っている参加者の数。 |
Trigger Timestamp (Unixtime) | ユーザーが実験を離れるトリガーが発生したときのタイムスタンプ(Unix Timeフォーマット、ミリ秒単位)。 |
Trigger Time (From Frame Onset) | フレームの開始からユーザーが実験を離れるトリガーが発生したときまでの経過時間(ミリ秒単位)。 |













