イベントシステム

説明

イベントシステムは、すべての研究にとって不可欠です。これは、記録される値を設定し、実験を進行させ、タスクを作成する方法です。ユーザーは、タスク内のすべての機能、ロジック、インタラクションを実行するためにイベントシステムを作成できます。イベントは、オブジェクトと変数の間の仲介者として機能することがよくあります。

完全なトリガーのリストについては
完全なアクションのリストについては
イベント下で値を設定するためのValue-Selectメニューに関する詳細情報については

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

Labvancedにおけるイベントの動作についての紹介ビデオを参照してください：

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

Labvancedでのイベントの追加

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

以下のビデオは、Labvancedで利用可能なトリガーとアクションの概要を示しています：

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

トリガー

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

トリガーカテゴリー	トリガーオプション	説明
`ユーザー入力トリガー`	マウストリガーキーボードトリガーボタンクリック入力時にEnter スクロールトリガーゲームパッド/ジョイスティックトリガー	ユーザー入力トリガーは、ユーザー/参加者がマウスを移動させたり、キーボードの要素をクリックしたり、スクロールしたりすることで手動でアクティブ化できるトリガーを指します。
`生理的信号トリガー`	視線追跡視線固定頭部追跡	生理的信号トリガーは、特定の生理的入力があるときに発生します。たとえば、特定の要素を見つめたり、頭の動きが変化したりする場合です。
`トライアルとフレームトリガー`	タスク初期化フレーム初期化フレーム開始フレーム終了	これらのトリガーは、実験トライアルおよびフレームに関連して発生します。たとえば、フレームが開始または終了する時です。
`変数値変更トリガー`	変数（値変更）	特定の変数値に変更があるときにイベントが発生するトリガーです。
`メディアオブジェクトトリガー`	メディアオブジェクトトリガー	このトリガーは、動画/音声ファイルの一時停止、録音の完了など、メディアオブジェクトに関係して発生します。
`APIトリガー`	WebSocketトリガー Open AIトリガー PostMessage受信	これは、APIからのデータが受信されたときに発生するトリガーです。
`グローバルトリガー`	実験の一時停止/再開参加者がマルチユーザー研究から離れた	グローバルトリガーは、実験に対する大きな変更、例えば一時停止された場合やマルチユーザー研究から参加者が離れた場合などを指します。

ユーザー入力トリガー

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

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

以下の表は、Labvancedで利用可能なすべてのユーザー入力トリガーの概要を提供します。それぞれは、後のセクションでより詳しく説明されます。

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

マウストリガー

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

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

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

Labvancedで使用されているマウストリガーオプションの例。

以下は、マウストリガーを使用する際のオプション全体の概要です：

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

注意: イベントシステムでマウストリガーを選択すると、さまざまなアクションでトリガー特有のマウス値を利用および参照するオプションが与えられます。値選択メニューを使用して。

キーボードトリガー

「キーボードトリガー」オプションは、イベントをトリガーするための別の一般的な方法です。基本的に、キーボードからの任意の入力をトリガーとして使用できます。これには、キーを押す、保持する、または放すことが含まれます。

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

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

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

以下は、キーボードトリガーを使用する際のキーとオプションの完全な概要です：

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

注意: イベントシステムでキーボードトリガーを選択すると、さまざまなアクションでトリガー特有のキーボード値を利用および参照するオプションが与えられます。値選択メニューを使用して。

ボタンクリックトリガー

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

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

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

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

ここでは、特集されている項目の詳細に目を向けましょう：

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

注意: イベントシステムでボタンクリックトリガーを選択すると、さまざまなアクションでトリガー特有のボタンクリック値を利用および参照するオプションが与えられます。値選択メニューを使用して。

入力時のEnterトリガー

トリガーが発生する条件: 特定の要素がアクティブな時にEnter/Returnキーが押される。

パラメータ:

ターゲットを追加: イベントに入力要素を追加します。
注意: イベントシステムで入力時のEnterトリガーを選択すると、さまざまなアクションでトリガー特有の入力時のEnter値を利用および参照するオプションが与えられます。値選択メニューを使用して。

スクロールトリガー

トリガーが発生する条件: 特定の要素上でスクロールバー、トラックパッドでのスクロール、またはマウスのスクロールホイールが使用されます。

パラメータ:

スクロールがY軸かX軸か（縦スクロールまたは横スクロール）を選択します。

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

注意: 長いテキストの場合、「オブジェクトプロパティ」パネルの「スタイル」セクションのOverflow-Xおよび/またはOverflow-Yオプションには、スクロールを選択する必要があります。

注意: イベントシステムでスクロールトリガーを選択すると、さまざまなアクションでトリガー特有のスクロール値を利用および参照するオプションが与えられます。値選択メニューを使用して。

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

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

詳しく学ぶ.

生理学的信号トリガー

これらのトリガーは、アイ・トラッキングおよび/またはヘッドトラッキングがタスクに対して有効になっている場合にのみ適用されます。

アイ・トラッキング視線トリガー

トリガーが発生する条件:

全体として、このトリガーはアイ・トラッキングが有効になっているときに適用されます。
特定の要素を見ているときにのみトリガー

パラメータ:

特定の要素でのみトリガーすることを選択した場合、それらの要素をターゲットとして追加します。
注意: イベントシステムでアイ・トラッキング視線トリガーを選択すると、さまざまなアクションでトリガー特有の視線値を利用および参照するオプションが与えられます。値選択メニューを使用して。

アイ・トラッキング固定トリガー

このトリガーはまだベータ版です。

注意: イベントシステムでキーボードトリガーを選択すると、さまざまなアクションでトリガー特有の固定値を利用および参照するオプションが与えられます。値選択メニューを使用して。

ヘッドトラッキングトリガー

トリガーが発生する条件:

頭の向きの変更または頭の動き。
注意: イベントシステムでヘッドトラッキングトリガーを選択すると、さまざまなアクションでトリガー特有のヘッドトラッキング値を利用および参照するオプションが与えられます。値選択メニューを使用して。

試行およびフレームトリガー

タスク初期化トリガー

トリガーが発生する条件:

タスクの最初の試行の最初のフレーム。すべてのインスタンスで表示されても、タスクごとに一度だけ実行されます。

このトリガーは、シャッフルおよび読み取りアクションと組み合わせると効果的です。これにより、タスクが開始される際に配列の項目やデータフレームをシャッフルし、被験者を刺激のセットに割り当て、多数のイベントを作成して刺激やデータを読み取る必要がなくなります。

パラメータ: なし

注意: イベントシステムでタスク初期化トリガーを選択すると、さまざまなアクションでトリガー特有のタスク初期化値を利用および参照するオプションが与えられます。値選択メニューを使用して。```

フレーム初期化トリガー

トリガー発動条件:

フレームの初期化、参加者に表示される前。

このトリガーは、シャッフル、読み込み、ランダム番号の描画アクションと組み合わせると良いでしょう。これらの組み合わせにより、フレームが表示される前にこれらのアクションを完了でき、フレームが開始する際に他のアクションが進行できる明確な経路が残ります。

注意: フレーム初期化トリガーを、変数を記録するイベントや、トライアル番号や条件番号などのシステム変数を含むイベントと一緒に使用しないでください。これは、フレーム初期化トリガーがトライアルの間に発生するため、表示されるトライアルや条件の完全に正確なカウントが存在しないからです。

パラメータ: なし

注意: イベントシステムでフレーム初期化トリガーを選択した後、トリガー固有のフレーム初期化値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

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

フレーム初期化の警告

変数の値をリセットしたくない場合は、変数プロパティウィンドウで「トライアル開始時にリセット」ボックスのチェックを外してください。

フレーム開始トリガー

トリガー発動条件:

フレームの開始

パラメータ: なし

注意: イベントシステムでフレーム開始トリガーを選択した後、トリガー固有のフレーム開始値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

フレーム終了トリガー

トリガー発動条件:

フレームの終了（フレームがもはや表示されない後）

パラメータ: なし

注意: イベントシステムでフレーム終了トリガーを選択した後、トリガー固有のフレーム終了値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

変数値変更トリガー

変数値変更

トリガー発動条件:

変数の値が初期値から変更される

パラメータ:

変数: 変更を「リッスン」したい1つ以上の変数を選択します。これらの変数の値が変更された場合、対応するアクションが即座にトリガーされます。
注意: イベントシステムで変数値変更トリガーを選択した後、トリガー固有の変数値変更値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

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

以前の「音声/ビデオトリガー」と「オブジェクト制御」トリガーと呼ばれていました。

トリガー発動条件:

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

パラメータ:

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

APIトリガー

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

ウェブソケットトリガー
OpenAIトリガー
PostMessage受信

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

ウェブソケットトリガー

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

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

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

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

受信/受け取る: ローカルホストのIPアドレスを自動検出します。手動で設定タブの特別な機能の下で変更できます。
トリガー/メッセージ: トリガーとして機能するメッセージを入力します。複数のメッセージをトリガーとして受け取るには「any」と入力します。

APIトリガー/アクションの使用方法の例については、ダイアログボックスの「検査」オプションをクリックして、デモhttps://www.labvanced.com/page/library/51053を確認してください。

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

注意: イベントシステムでウェブソケットトリガーを選択した後、トリガー固有のウェブソケット値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

OpenAIトリガー

「OpenAIトリガー」は、OpenAIからの情報に基づいてアクションを開始する際に使用できます。

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

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

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

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

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

LabvancedのOpenAIトリガーの例。

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

注意: イベントシステムでOpenAIトリガーを選択した後、トリガー固有のOpenAI値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

PostMessage受信トリガー

PostMessage受信トリガーは、実行中の実験がブラウザのpostMessage APIを介して外部ソースから受信したメッセージに対して発火します。これは、実験を親ページ、カスタムアプリケーション、または研究にデータを送信する埋め込み外部ウェブサイトに接続するのに役立ちます。

詳細を学ぶ.

注意: イベントシステムでPostMessage受信トリガーを選択した後、トリガー固有のPostMessage受信値を様々なアクションで利用し参照するオプションがあります。値選択メニューを利用してください。

グローバルトリガー

グローバルトリガーは、実験内で大きな変更が発生するたびに発生します。つまり、実験を一時停止することや、参加者がマルチユーザー研究から離れるといった「グローバル」な何かです！次のオプションがグローバルトリガーとしてリストされています:

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

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

実験の一時停止/再開

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

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

```以下のトリガーを選択すると、トリガーの性質をさらに指定できるビューが表示されます。実験が一時停止されるべきか、それとも続行/再開されるべきかを選択できます：

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

実験が一時停止中: 参加者が研究を一時停止します（フルスクリーンを終了）。
実験が再開された: 参加者が研究を再開します。このトリガーは、眼球追跡研究に適しています。参加者が仮想顎置きを離れた場合に、以前の試行またはフレームに戻すために使用できます。
注: イベントシステムで一時停止/再開実験トリガーを選択した後、さまざまなアクションでトリガー固有の値を利用して参照するオプションがあります。値選択メニューと共に使えます。

参加者がマルチユーザー研究から離れた

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

Labvancedにおけるマルチユーザー研究から離れた参加者のオプションをトリガーとして使用

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

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

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

アクション

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

以下の表は、Labvancedで利用可能なアクションの概要を示しています:

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

オブジェクトアクション

オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる操作を指します。いくつかのオブジェクトアクションオプションがあります：

オブジェクトプロパティの設定
メディアオブジェクトの制御
オブジェクトのコピー
各オブジェクトの処理

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

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

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

詳細を学ぶ

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

以前の「オーディオ/ビデオの制御」と「オブジェクトの制御」アクションが統合されました。

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

パラメーター：

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

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

効果：オブジェクトをコピーし、複数の個別のオブジェクトや重複するイベントの必要性を置き換えます。

パラメーター：

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

ForEach Object Action

効果: 同じ種類の複数のオブジェクトにアクションを適用します。

パラメータ:

フィルター: 対象とする要素の種類を選択します。
その他の名前フィルターを許可: 対象とするオブジェクトの名前を入力します。同一の名前を持つオブジェクトがフレームに複数ある場合に、これがうまく機能します。
アクションシーケンス: 選択した要素に何が起こるかを選択することができます（通常のアクションリストから）。"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 Action

「Set / Record Variable」アクションは、Labvancedのすべての実験で使用されることが保証されており、これにより値と行動指標が保存および記録されます。

イベントシステムにおけるセット/レコード変数アクションの位置

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

イベントシステムにおけるセット/レコード変数オプション

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

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

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

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

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

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

Copy to Clipboard Action

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

Draw Random Number Action

効果: 1つ以上のランダムな数を生成し、それを変数に保存します。

パラメータ:

タイプ: 連続値と離散値のどちらかを選択します
分布: ガウス分布と均一分布のどちらかを選択します
複数の描画（boolean true/false）: 1回または複数回描画するかを選択します。
描画回数: 描画の回数を選択します
最小: 均一分布の最小値を定義します
最大: 均一分布の最大値を定義します
平均: ガウス分布の平均値を定義します
標準偏差: ガウス分布の標準偏差を定義します
変数に保存: 値を保存する変数を選択します。

Get URL Parameter Action

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

パラメータ:

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

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

Read from/Write to Device Action

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

パラメータ:

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

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

このアクションを使用すると、同じ参加者が各セッションで同じデバイスを使用している限り、デバイス固有のデータをセッション間で引き継ぐことができます。
たとえば、このアクションを使用して、参加者1のセッションで提示された画像を記録し、次のセッションで異なる画像が提示されることを確実にします。
- 画像の配列を作成し、各セッションで提示するためにいくつかをランダムに選択します。
- デバイスに書き込む: セッション1で提示された画像のインデックス番号。
- デバイスから読み取る: セッション2で、セッション1の画像のインデックスを読み出し、2回目のセッションでそれらのインデックスが選択されないようにJavaScriptアクションを含めます。

Read from/Write to Shared Variable Action

効果: 研究のセッション間で共有される変数を読み込むまたは書き込みます。この変数は、すべての参加者と共有することも、各個人にプライベートにすることもできます。

パラメータ:

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

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

このアクションを使用すると、参加者固有のデータをセッション間で引き継ぎ、セッション間で参加者同士で共有することができます。
たとえば、このアクションを使用して、テストのスコアを記録し、その後、参加者がテストを完了した他の参加者の平均スコアと自分のスコアを比較できるようにします。
もう1つの例（デバイスアクションの読み取り/書き込みに似た）は、参加者が配列から好きな5枚の画像を選択し、作業を実行し、次のセッションで再度その5枚の画像を提示することです。違いは、このアクションが他の参加者に選ばれた画像を表示したり、他の参加者の利用可能なオプションからその画像を除外したりできることです。

#### 数学 & 統計アクション
効果: 入力変数（配列）の数学的操作を実行し、結果を出力変数に保存します。

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

#### 変数を即座に記録するアクション
効果: すべての変数値のスナップショットを作成し、これをLabvancedサーバーに送信します。

パラメータ: なし

#### 移動平均フィルターアクション
効果: いくつかの入力の移動平均（データの常に更新される平均）を計算し、結果を新しい変数に保存します。

パラメータ:
* フィルター形式: フィルタータイプを選択します
    * 単純移動平均: すべてのサンプルが同じ重みを持つ単純移動平均を計算します。
    * 線形加重移動平均: サンプルの重みを線形に減少させるように加重します。
    * 指数移動平均: サンプルの重みを指数的に減少させるように加重します。
* サンプル数: ステップごとに使用されるサンプルの数を決定します。
* 入力: 移動平均が計算される入力変数（配列）を選択します
* 出力: 結果が保存される出力変数を選択します。

#### 変数を分配するアクション
変数を分配するアクションは、[Labvancedにおけるマルチユーザー研究に不可欠です。](https://www.labvanced.com/content/technology/ja/multi-user-psychology-studies/) このアクションを使用すると、参加者間で変数値を共有でき、実質的に情報（刺激の位置や変更を含む）が参加者の画面に反映されることが可能です。

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_menu.webp" alt="Labvancedのアクションメニューにおける変数分配アクション。" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/distribute_variable_example.webp" alt="すべてのメニューオプションが設定された例として使用される変数分配。" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

分配変数とチャットボックス機能を組み合わせたデモをご覧ください: [チャットアドオン付きの画像説明課題。](https://www.labvanced.com/page/library/3008)

ダイアログメニュー項目の完全な説明は以下にあります: 

| メニュー項目 | メニューエリア |  変数分配アクションのオプションと説明 |
|:-----:|-----| ---------| 
| **`値を分配する`** | ![変数が送信される参加者を選択する](/content_imgs/learn/guide/task-editor/imgs/events/dist_participants.webp) | 値が送信される他の参加者を選択します。 <ul><li>**すべての参加者:** この値をすべての参加者に送信します</li><li>**選択された参加者:** 選択された参加者に値を送信します。 </li></ul> | 
| **`対象変数と値を選択`** | ![対象と値を指定する](/content_imgs/learn/guide/task-editor/imgs/events/dist_target.webp) | <ul><li> **対象変数:** 値が保存される対象変数を選択します。 </li><li>**値:** 他の参加者に送信される値を決定します。</li> </ul>|
| **`ブロック`** | ![変数分配のブロックオプション](/content_imgs/learn/guide/task-editor/imgs/events/block_dist_variable.webp) | 有効にすると、現在の値の分配が完了するまで対象変数を変更できません。 | 
| **`レート制限戦略`**| ![変数分配のレート制限戦略のオプション](/content_imgs/learn/guide/task-editor/imgs/events/dist_rate_limit.webp) | レート制限戦略は、実験がサーバーをオーバーフローしないように保護し、分配変数によって送信される要求（すなわち更新）のレートを制御するための予防策として機能します。以下の戦略オプションが利用可能です: <ul><li>**デバウンス:** このアクションが100 msの時間ウィンドウ内で複数回実行される場合、新しいサーバーメッセージは「デバウンス」されます（このアクションが実行されていない100 msの間に最も最近のメッセージのみが送信されます）。</li><li>**スロットル:** このアクションが100 msの時間ウィンドウ内で複数回実行される場合、新しいメッセージはスロットルされます（すなわち、最後のメッセージが送信された後の100 msが経過した場合、最も最近のメッセージのみが分配されます）。</li><li>**破棄:** このアクションが100 msの時間ウィンドウ内で複数回実行される場合、その100 msのウィンドウ内の新しいメッセージは破棄されます。</li><li>**キュー:** このアクションが100 msの時間ウィンドウ内で複数回実行される場合、新しい変数値はキューに追加されます（最大キューサイズは10メッセージまで）。</li></ul> |

### 配列アクション 

#### 配列から選択（読み取り）アクション
効果: 配列から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ループ）アクション

効果: 一連のアクションを繰り返し実行します。すぐにまたは定義された間隔で実行できます。ループの実行を停止させるための停止条件を指定できます。

パラメータ:

実行タイプ: 即時実行またはタイムド実行から選択します
- 完全なループを実行: これは停止条件が満たされるまでループを継続的に実行します。
- 毎に...ミリ秒実行: これは定義された間隔でループを実行します（例: ループが毎50ミリ秒実行される）。
ループの数を定義: 「毎に...ミリ秒実行」が選択された場合、ユーザーはループが実行される回数の数値の整数値を割り当てるオプションがあります。これにより停止条件を定義する必要がなくなります。
実行間隔: これにより実行間隔が決まります。
即時に開始（真/偽）: 有効にすると、ループがすぐに実行されます。無効の場合、ループは次の実行間隔で開始されます。
複数の開始を許可（真/偽）: 有効にすると、複数のループインスタンスが並行して開始できます。無効の場合、一度に1つのループインスタンスしか実行できません。
停止条件を有効にする（真/偽）: 有効にすると、ループの停止条件を指定できます。
停止条件: 停止条件を使用して、ループの実行を停止するロジカル式を指定します。If/Else-If文と同様に、ANDグループ、ORグループ、要件を組み合わせて論理比較を行うことができます。
アクションシーケンス: アクションシーケンスは、ループの各反復で実行されるすべてのアクションをリストします。「アクションを追加」アイコンを介して新しいアクションを追加できます。

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

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

パラメータ:

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

アクショングループ

アクションはアクショングループにも整理できます。アクショングループを使用すると、特定のアクションを視覚的に構造を簡単にするためにグループ化できますが、複数のアクションを一度にコピー、複製、または削除したい場合にも便利です。

詳細を学ぶ

APIアクション

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

PostMessageを送信
Websocketに送信
OpenAIに送信

これらのアクションが「利用可能」または使用可能になるためには、設定タブにAPIキーを入力する必要があります。

LabvancedのアクションメニューにおけるAPIアクション。

PostMessageを送信アクション

Send PostMessageアクションは、ブラウザのpostMessage APIを使用して、実行中のLabvanced実験から親ウェブページや埋め込まれたフレームなどの外部ターゲットにメッセージを送信します。

詳細を学ぶ

Websocketに送信アクション

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

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

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

上記の例と完全なイベント構造には、こちらでアクセスできます: https://www.labvanced.com/page/library/51053 で「検査」をクリックします。

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

APIアクセスについての詳細は、このページを訪れてください。

OpenAIに送信アクション

‘Send to OpenAI’アクションは、文字列入力値などの情報をOpenAIに送信することを可能にします。このオプションを利用可能にするためには、設定タブの特別な機能にAPIキーをリストする必要があります。

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

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

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

必要な情報がすべて提供されると、このイベントの機能的な例は以下のようになります：

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

```

この機能をどのように活用できるか、実際に見るために、このお問い合わせフォームを提出してデモをご希望の場合はお気軽にご連絡ください。

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

以下は、「OpenAIに送信」アクションに含まれるフィールドの詳細な説明です:

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

OpenAIは日々進化しているため、さらなる明確化についてはOpenAIのドキュメントをご確認ください。

コードアクション

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

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

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

JavaScript実行アクション

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

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

上記の「JavaScriptを実行」アクションを選択すると、JavaScriptコードを書くためのエリア（コードエディタ）が表示され、使用方法についての指示も表示されます:

Labvanced内のJavaScriptコードエディタ。

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

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

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

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

Labvanced内のCSSコードエディタ。

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

貼り付けアクション

このオプションを使うことで、以前に作成しコピーしたアクションを貼り付けることができます。これにより、同じ項目を何度も選択することなく、実験の設計をより迅速に行うことができます。たとえば、既存のものと似たイベントがある場合、それをコピーして貼り付けて修正することができ、最初から作る必要はありません。

値選択メニュー

特定のイベントで作業していると、ペンアイコンが表示されることに気付くでしょう。これは値選択メニューと呼ばれ、どのような値を記録または追跡するかを選択して指示することができます。これは実験設計とセットアップのために必ず使用する非常に強力かつ重要なオプションです。

このペンアイコン / 値選択メニューは、 Set / Record Variable アクション、Set Object Property アクション、Requirement (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'を作成するために算術操作を利用する方法を示しています。

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

新しい変数の値（'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]配列トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（タスク初期化時）`	トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（フレーム初期化時）`	試行番号トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（フレーム開始時）`	トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（フレーム終了時）`	合計フレーム時間トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（変数値が変更された）`	変数の新しい値トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（メディアオブジェクトトリガー）`	トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（ウェブソケットトリガー）`	メッセージデータトリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（OpenAIトリガー）`	チャットGPTの回答トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（ポストメッセージ受信）`	メッセージ内容トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（グローバル実験イベント）`	合計フレーム時間グローバルイベントの理由トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
`トリガー（ユーザーが実験を離れた）`	残りの参加者数トリガータイムスタンプ（ユニックスタイム）トリガー時間（フレーム開始から）
マウストリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

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

トリガー (マウス) オプション	説明
`Mouse X`	フレーム座標における現在のマウスX位置を返します。
`Mouse Y`	フレーム座標における現在のマウスY位置を返します。
`Mouse [X,Y] Array`	配列形式のマウス[X,Y]座標。
`Stimulus Name`	イベントをトリガーしたオブジェクトの名前（例: どの画像がクリックされたか）。
`Stimulus Info`	イベントをトリガーしたオブジェクトの刺激情報。
`Trigger Timestamp (Unixtime)`	タイムスタンプはトリガーが発生した時間をUnix Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

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

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

トリガー (キーボード) オプション	説明
`Id of Key`	トリガーとして押されたキーのID値。
`Trigger Timestamp (Unixtime)`	トリガーが発生した時間をUnix Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

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

ボタンクリックトリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

トリガー (ボタンバー) オプション	説明
`Stimulus Name`	イベントをトリガーしたボタンオブジェクトの名前。
`Stimulus Info`	イベントをトリガーしたボタンオブジェクトの刺激情報。
`Trigger Timestamp (Unixtime)`	トリガーが発生した時間をUnix Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

トリガー (入力時のEnter) 値

入力時のEnterトリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

トリガー (入力時のEnter) オプション	説明
`Id of Key`	トリガーとして押されたキーのID値。
`Trigger Timestamp (Unixtime)`	トリガーが発生した時間をUnix Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

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

スクロールトリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

トリガー (スクロール) オプション	説明
`Stimulus Name`	イベントをトリガーしたボタンオブジェクトの名前。
`Stimulus Info`	イベントをトリガーしたボタンオブジェクトの刺激情報。
`Scroll Position X`	イベントがトリガーされたときのマウスのXのスクロール位置。
`Scroll Position Y`	イベントがトリガーされたときのマウスのYのスクロール位置。
`Trigger Timestamp (Unixtime)`	トリガーが発生した時間をUnix Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

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

ゲームパッド/ジョイスティックトリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

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

トリガー (ゲームパッド/ジョイスティック) オプション	説明
`Gamepad Device Id`	接続されたゲームパッドのIDまたは名前。
`Pressed Keys (Array)`	押されたキー。
`Pressed OR Hold Keys (Array)`	押されたか保持されたキー。
`Released Keys (Array)`	解放されたキー。
`Axes (Array)`	軸の値。
`Gamepad Timestamp (Unixtime)`	ゲームパッドのタイムスタンプをUnixtimeで。
`Trigger Timestamp (Unixtime)`	トリガーが発生した時間のタイムスタンプをUnixtimeで。
`Trigger Time (From Frame Onset)`	フレームの開始からトリガーが発生するまでの関係するUnixtimeのタイムスタンプ。

トリガー (アイストラッキング注視) 値

アイストラッキング注視トリガーが使用されるとき、特定のアクションを操作する際に呼び出すことができる以下のトリガー特有の値があります:

注視トリガー値のオプション

トリガー (アイストラッキング注視) オプション	説明
`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 Time形式でミリ秒単位で示します。
`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 Time形式でミリ秒単位で示します。
`Trigger Time (From Frame Onset)`	トリガーが発生するまでの経過時間をフレーム開始からミリ秒単位で測定します。

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

トリガー (頭部追跡) オプション	説明
`カメラキャプチャ時間 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 トリガー) の値

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

トリガー (Websocket トリガー) オプション	説明
`メッセージ`	説明やラベル付けに使用できるメッセージで、異なる種類のデータを区別するためにフィルターをかけることができます。
`データ`	参加者の選択やタイムスタンプ、マウスのx/y座標など、異なるタイプのデータを保持できる値です。
`トリガータイムスタンプ (ユニックス時間)`	Websocketトリガーが発生した時のUnixタイムスタンプ（ミリ秒単位）。
`トリガー時間 (フレーム開始から)`	フレーム開始からWebSocketトリガーが発生した時の経過時間（ミリ秒単位）。

トリガー (OpenAI トリガー) の値

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

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

トリガー (PostMessage 受信) の値

PostMessage 受信トリガーが使用されると、特定のアクションで呼び出すことができるトリガー特有の値は以下の通りです：

トリガー (PostMessage 受信) オプション	説明
`メッセージコンテンツ`	外部ソースから送信された受信したpostMessageのデータペイロード。
`トリガータイムスタンプ (ユニックス時間)`	PostMessage受信トリガーが発生した時のUnixタイムスタンプ（ミリ秒単位）。
`トリガー時間 (フレーム開始から)`	フレーム開始からトリガーが発生した時の経過時間（ミリ秒単位）。

トリガー (全体実験イベント) の値

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

トリガー (全体実験イベント) オプション	説明
`総フレーム時間`	トリガーの前に割り当てられた総フレーム時間を指します。
`全体イベントの理由`	参加者が研究を離れたことなど、このトリガーの理由を述べる文字列値。
`トリガータイムスタンプ (ユニックス時間)`	グローバルイベントトリガーが発生した時のUnixタイムスタンプ（ミリ秒単位）。
`トリガー時間 (フレーム開始から)`	フレーム開始からグローバルイベントトリガーが発生した時の経過時間（ミリ秒単位）。

トリガー (ユーザーが実験を離れた) の値

参加者がマルチユーザースタディを離れたトリガーが使用されると、特定のアクションで呼び出すことができるトリガー特有の値は以下の通りです：

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