イベントシステム

説明

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

• トリガーの完全なリストについては
• アクションの完全なリストについては
• イベントに基づいて値を設定するための値選択メニューに関する詳細

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

Labvancedのイベントの働きについての紹介は、こちらの短い動画をご覧ください:

イベントの作成 - 概要

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

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

トリガーの選択

新しいイベントを作成すると、トリガー選択がタイルグリッドとして開きます。トリガーの種類はカテゴリ（ユーザー入力、生理信号、試行とフレーム、変数、メディアオブジェクト、API、グローバル）によって整理されています。上部の検索ボックスでトリガーの種類を名前でフィルタリングできます。任意のタイルをクリックして、それをイベントのトリガーとして設定します。

トリガーが選択されると、イベントには現在のトリガー名とアイコンを含むコンパクトバーが表示されます。別のトリガーに切り替えるには、Change triggerボタン（鉛筆アイコン）をクリックしてタイルグリッドを再度開きます。

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

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

トリガー

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

トリガーカテゴリー	トリガーオプション	説明
User Input Triggers	マウストリガー キーボードトリガー ボタンクリック 入力時にEnter スクロールトリガー ゲームパッド/ジョイスティックトリガー	ユーザー入力トリガーは、ユーザー/参加者がマウスを動かしたり、キーボード要素をクリックしたり、スクロールしたりするなど、手動でアクションを起こせるトリガーを指します。
Physiological Signal Triggers	視線追尾の凝視 視線追尾の注視 頭部追跡	生理的信号トリガーは、特定の要素を見つめたり、頭部の動きの変化があったときに発生します。
Trial and Frame Triggers	タスク初期化 フレーム初期化 フレーム開始 フレーム終了	これらのトリガーは、実験の試行やフレームに関連するもので、フレームが開始または終了するときに発生します。
Variable Value Changed Trigger	変数（値の変更）	特定の変数の値が変わると、イベントが発生するトリガーです。
Media Object Trigger	メディアオブジェクトトリガー	これは、動画/音声ファイルの一時停止、録音の完了など、メディアオブジェクトに関連するトリガーが発生します。
API Triggers	Websocketトリガー Open AIトリガー PostMessage受信	これらはAPIからのデータが到着したときに発生するトリガーです。
Global Triggers	実験の一時停止/再開 参加者がマルチユーザー研究から退出	グローバルトリガーは、実験に対する大きな変更を指します。たとえば、実験が一時停止されたり、マルチユーザー研究の参加者が退出したりすることです。

ユーザー入力トリガー

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

以下の表は、Labvancedにおけるすべてのユーザー入力トリガーの概要を提供します。それぞれは次のセクションでさらに詳しく説明されています。

ユーザー入力トリガーオプション	概要
Mouse Trigger	マウスの動きはイベントを開始するトリガーとして使用できます。たとえば、スクロール、クリック、ホバーなどです。特定の要素やターゲットをトリガーに関連付けることもできます。たとえば、特定の画像がクリックされた場合にのみ、マウスクリックがトリガーとして使用されます。
Keyboard Trigger	すべてのキーボードの押下は、イベントを開始するトリガーとして使用できます。特定のキーボードの文字や数字をトリガーとして指定できます。
Button-Clicks	Labvancedで作成されたボタンオブジェクトは、イベントを開始するトリガーとして使用できます。
Enter on Input	このトリガーは、参加者が実験中に「Enter」を押すときに一般的に使用され、記入したレスポンスやテキストフィールドへの入力を送信する手段として機能します。
Scroll Trigger	このトリガーは、参加者がスクロールするときに発生します。x方向またはy方向のスクロールを指定したり、スクロールが発生する要素をイベントトリガーとして使用することもできます。
Gamepad/ Joystick Trigger	このトリガーを使用すると、データを記録するための入力デバイスとして実験設計にゲームパッドやジョイスティックコントローラーを使用できます。

マウストリガー

「マウストリガー」オプションは非常に人気のあるイベントトリガーであり、マウスのいかなる相互作用（上下に動かす、クリックする、特定のオブジェクトにホバーする、特定のオブジェクトを離れるなど）に基づいてイベントを開始します。

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

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

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

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

キーボードトリガー

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

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

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

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

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

ボタンクリックトリガー

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

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

ここに示すアイテムを詳しく見てみましょう：

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

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

入力時のEnterトリガー

トリガーされるイベント: 特定の要素がアクティブな状態でEnter/Returnキーがキーボードで押されたとき。

パラメータ:

• ターゲットを追加: イベントに入力要素を追加。

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

スクロールトリガー

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

パラメータ:

• スクロールがY軸またはX軸のどちらであるかを選択します（垂直スクロールまたは水平方向のスクロール）。

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

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

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

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

Gamepad/ Joystick Triggerは、ゲームパッドやジョイスティックコントローラーを実験デザインでデータを記録する入力デバイスとして使用することを可能にします。 注: このオプションをSettingsタブで有効にするのを忘れないでください。

詳細を学ぶ.

生理的信号トリガー

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

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

トリガーされるイベント:

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

パラメータ:

• 特定の要素でのみトリガーすることを選択した場合、これらの要素をターゲットとして追加します。

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

アイートラッキング注視点トリガー

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

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

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

トリガーされるイベント:

• 頭の向きや動きの変化。

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

トライアルおよびフレームトリガー

タスク初期トリガー

トリガー発生:

• タスクの最初のトライアルの最初のフレーム。タスクごとに一度だけ実行され、すべてのインスタンスのイベントタブに表示されます。

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

パラメータ: なし

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

フレーム初期トリガー

トリガー発生:

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

このトリガーは、シャッフル、読み取り、およびランダム数描画アクションと組み合わせると良いでしょう。これらの組み合わせでは、フレームが表示される前にこれらのアクションを完了させ、フレームが開始されると同時に他のアクションを開始するための明確な経路を提供します。

注: フレーム初期トリガーを試行回数または条件番号のような変数を記録するイベントで使用しないでください。フレーム初期トリガーはトライアルの間に発生するため、表示されるトライアルまたは条件の正確な数が取得できません。

パラメータ: なし

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

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

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

フレーム開始トリガー

トリガー発生:

• フレームの開始

パラメータ: なし

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

フレーム終了トリガー

トリガー発生:

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

パラメータ: なし

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

変数値変更トリガー

変数値変更

トリガー発生:

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

パラメータ:

• 変数: 変更を「リッスン」したい1つまたは複数の変数を選択します。これらの変数の値に変更があると、対応するアクションが即座にトリガーされます。

• 注: イベントシステムで変数値変更トリガーを選択した後、トリガー特有の変数値変更値をさまざまなアクションで利用および参照するオプションがあります。値選択メニューで。

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

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

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

トリガー発生:

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

パラメータ:

• ターゲット: フレーム上に存在するオブジェクト要素を選択します

• 実行する: トリガーのサブタイプを選択します

  • オーディオまたはビデオオブジェクトオプション:
    • 再生開始: 要素が再生を開始したときにトリガーされます
    • 再生停止: 要素が一時停止したときにトリガーされます
    • 再生終了: 要素が再生を停止したときにトリガーされます
  • ビデオ、オーディオ、または画面録画オブジェクトオプション:
    • 録音完了: オーディオ録音が停止したときにトリガーされます
    • アップロード完了: ファイルのアップロードが完了したときにトリガーされます
  • ファイルアップロードオブジェクトオプション:
    • ファイル選択: ファイルが選択されたときにトリガーされます
    • アップロード完了: ファイルのアップロードが完了したときにトリガーされます
  • カメラスナップショットオブジェクトオプション:
    • スナップショット完了: カメラがスナップショットを正常に撮影したときにトリガーされます
    • アップロード完了: スナップショットのアップロードが完了したときにトリガーされます

• 注: イベントシステムでメディアオブジェクトトリガーを選択した後、トリガー特有のメディアオブジェクト値をさまざまなアクションで利用および参照するオプションがあります。値選択メニューで。

APIトリガー

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

• Websocketトリガー
• OpenAIトリガー
• PostMessage受信

Websocketトリガー

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

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

• 受け入れる/受信する: ローカルホストのIPアドレスを自動検出します。Settingsタブ内のSpecial Featuresで手動で変更できます。
• トリガー/メッセージ: トリガーとして機能するメッセージを入力します。複数のメッセージをトリガーとして受け入れるには、'any'と入力します。

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

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

• 注: イベントシステムで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	変数を設定 / 記録 クリップボードにコピー ランダム番号を生成 URLパラメータを取得 デバイスから読み書き 共有変数から読み書き 数学 & 統計 変数を即座に記録 移動平均フィルター 変数を分配	変数の値を読み取ったり記録したりする操作です。
Array Actions	配列から選択（読み取り） 配列エントリの追加 / 削除 配列エントリの変更（置換） 配列エントリをシャッフル	配列操作は、配列とそのエントリを選択、追加、削除、変更、シャッフルすることを含みます。
Data Frame Operations	データフレームからの読み書き データフレームエントリをシャッフル	これらのアクションは、実験で.csvファイル（データフレーム）を使用している場合に関連します。
Jump Actions	ジャンプする セッションを受け入れる / 終了する セッションを拒否 / 終了する URLにリダイレクト	実験内の特定のセクションにジャンプしたり、参加者のセクションを受け入れたり拒否したりできます。
Control Actions	条件アクション（If…Then） 繰り返しアクション（Whileループ） 遅延アクション（時間コールバック） アクショングループ	コントロールアクションは、if/thenロジックやループ（再生された音や点滅する画像のように）、アクションが発生するまでの遅延を設定するために使用されます。
API Actions	PostMessageを送信 Websocketに送信 OpenAIに送信	APIにデータを送信するためのAPI固有のアクションを指します。
Code Actions	JavaScriptを実行 グローバルCSSを設定	コードアクションでは、JavaScriptやCSSを扱うことができます。
Paste Action	ペーストアクション	前にコピーしたアクションをペーストすることができます。

オブジェクトアクション

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

• オブジェクトプロパティを設定
• メディアオブジェクトを制御
• オブジェクトをコピー
• オブジェクトごとに

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

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

詳細を学ぶ。

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

以前の「オーディオ/ビデオを制御」と「オブジェクトを制御」という独立したアクション。

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

パラメータ：

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

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

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

パラメータ:

• ソース: コピーするフレーム上のオブジェクトを選択します。
• コピーの数: ソースオブジェクトのコピー数を入力します。
• 新しい要素名を設定: コピーの名前を決定するためにいくつかのパラメータから選択します。
• 増分接尾辞を持つ名前を割り当て: コピーを区別するために新しい要素名の末尾に数値タグを追加します。
• アクションシーケンス:（通常のアクションリストから）コピーに対して何が起こるかを選択できます。ターゲットとして「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	他の参加者に値を送信します。その値は変数に保存されます。

変数設定/記録アクション

「変数設定/記録」アクションは、Labvancedのすべての実験で使用されることが義務付けられています。これは、値や行動測定が保存および記録される方法です。

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

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

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

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

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

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

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

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

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

パラメータ:

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

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

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

パラメータ:

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

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

デバイスから読み書きアクション

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

パラメータ:

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

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

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

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

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

パラメータ:

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

利用例: 縦断的/マルチセッション研究

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

数学 & 統計アクション

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

パラメータ:

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

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

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

パラメータ: なし

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

効果: 一部の入力の移動平均（データの常に更新される平均）を計算し、その結果を新しい変数に保存します。

パラメータ:

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

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

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

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

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

こちらのデモで、分配変数とチャットボックス機能を組み込んだものをご覧ください: チャットアドオンを使用した画像説明タスク。

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

メニュー項目	メニューエリア	変数分配アクションのオプションと説明
Distribute value to		どの他の参加者に値を送信するかを選択します。 すべての参加者: この値をすべての参加者に送信します 選択した参加者: 選択した参加者に値を送信します。
Choose target variable and value		ターゲット変数: 値が保存されるターゲット変数を選択します。 値: 他の参加者に送信する値を決定します。
Block		有効にすると、現在の値の分配が完了するまでターゲット変数を変更できなくなります。
Rate Limit Strategy		レート制限戦略は、実験がサーバーからオーバーフローするのを防ぐための方法であり、リクエスト（つまり、分配変数を介しての更新）の送信速度を制御するための予防的な戦略として機能します。利用可能な戦略オプションは次のとおりです: デバウンス: このアクションが100msのウィンドウ内で1回以上実行されると、新しいサーバーメッセージは「デバウンス」されます（このアクションが実行されない100msの間隔の後、最も最近のメッセージのみが送信されます）。 スロットル: このアクションが100msのウィンドウ内で1回以上実行されると、新しいメッセージはスロットルされます（つまり、最後のメッセージが送信されてから100msが経過した場合、最も最近のメッセージのみが分配されます）。 破棄: このアクションが100msのウィンドウ内で1回以上実行されると、その100msのウィンドウ内の新しいメッセージが破棄されます。 キュー: このアクションが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」の下のアクションが実行されます。

パラメータ:

• 要件の追加: ステートメントに新しい要件を追加します。「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 Loop）アクション

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

パラメータ:

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

遅延アクション（タイムコールバック）アクション

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

パラメータ:

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

アクショングループ

アクションはアクショングループに整理することもできます。アクショングループにより、特定のアクションをグループ化して視覚構造を簡素化したり、一度に複数のアクションをコピー、複製、または削除したりできます。

詳しくはこちらを学んでください。

APIアクション

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

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

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

PostMessageを送信アクション

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

詳しくはこちらを学んでください。

Websocketに送信アクション

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

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

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

OpenAIに送信アクション

「OpenAIに送信」アクションは、文字列入力値などの情報をOpenAIに送信することを可能にします。このオプションを使用可能にするには、SettingsタブのSpecial FeaturesにAPIキーをリストする必要があります。

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

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

この機能をどのように活用できるか、実際に見るためのデモを受けるには、ぜひこの連絡フォームを提出してください。

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

「Send to OpenAI」アクションに含まれるフィールドの詳しい説明は以下の通りです:

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

OpenAIは日々進化していますので、はっきりした情報についてはOpenAIのドキュメントを確認してください。

コードアクション

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

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

JavaScriptを実行アクション

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

上記の「JavaScriptを実行」アクションを選択すると、JavaScriptコードを書くべき領域（コードエディター）が表示され、使用方法に関する指示が示されます:

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

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

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

「グローバルCSSを設定」アクションの一例としては、参加者が特定の色を複数選択の質問から選択したときに、研究の背景色を変更することがあります。

ペーストアクション

このオプションを使用すると、以前に作成してコピーしたアクションをペーストできます。これにより、実験をデザインする際、同じアイテムを何度も選択する必要がなくなり、作業が迅速化します。たとえば、既存のイベントに似たイベントがある場合、それをコピーしてペーストし、最初から構築する代わりに修正できます。

値選択メニュー

特定のイベントに取り組む際、ペンアイコンが表示されます。これは、値選択メニューと呼ばれ、どのような値を記録または追跡するかを選択して指示することを可能にします。これは、実験デザインおよびセットアップに使用する必須の非常に強力なオプションです。

このペンアイコン/値選択メニューは、Set / Record Variableアクション、Set Object Propertyアクション、Requirement (If... Then)アクションなど、一部のアクションイベントシステムのさまざまな場所に表示されます。

ペンアイコンをクリックすると、読み取られるか書き込まれる値を指定するドロップダウンメニューが表示されます。ドロップダウンメニューは、常にトリガーに特有の値オプションから始まり、その後に他の5つのカテゴリー（Current Time, Constant Value, Variable, Frame / Task / Option, Operations）が続きます。これらはそれぞれ独自のオプションを持っています。 それらについては以下でさらに説明します。

上の画像は、マウストリガーが使用されているときの値選択メニューの見た目を示しています。左側の最初のメニュー項目はトリガー特有のカテゴリから始まり、その後他の5つのカテゴリ（Current Timeなど）に移行します。

メニューオプション

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

現在の時間の値

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

以下のオプションが利用可能です:

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

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

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

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

この値は、フレーム開始から経過した時間を記録します。最もよく使われるのは、反応時間に相当します。

定数値

必要な変数の種類に基づいて定数値を割り当てます。これらは、カウンターを作成するために、他のオプションと組み合わせて使用されることがありますArithmetic。

以下のオプションが利用可能です：

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

定数：文字列

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

定数：数値

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

定数：ブール値

trueまたはfalseの値を割り当てます。

定数：カテゴリカル

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

定数：日付

日付値を割り当てます。

定数：時間

時間値を割り当てます。

定数：色

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

変数値

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

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

変数を選択

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

配列から値を選択

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

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

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

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

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

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

オブジェクトプロパティ

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

フレーム

視線追跡

デバイス

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

操作

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

以下のオプションが利用可能です：

• 算術
• 文字列操作
• 数学演算

算術

算術操作は、文字列の結合やオブジェクトプロパティの修正など、さまざまな目的で役立ちます。

本質的に、算術演算は複数の値に対して操作を実行することを可能にします。

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

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

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

以下の例では、算術操作を利用して新しい文字列変数（緑のボタン）である'intermediateVar'を作成する方法を示しています。

新しい変数値（'intermediateVar'）は、いくつかの算術演算を、以前に作成された変数（すなわち、'userChatName'および'chatInput'）と定数文字列値（すなわち、セミコロン:および空白<br>）の組み合わせを使用することによって定義されます。この操作は、複数のユーザーによる研究で使用可能なユーザーチャットの効果を生み出します。

文字列操作

数学演算

スカラー値に対して数学演算を行います。

トリガー固有の値

トリガー固有の値は、特定のイベントに定義されたトリガーに関連付けられた値を指します。たとえば、イベントがマウストリガーを使用している場合、アクションが指定されている特定の領域（Set / Record VariableアクションやSet Object Propertyアクションなど）において、マウストリガー固有の値をvalue select menuで参照できます。

以下の例では、マウストリガーのトリガー固有の値を使用してx値およびy値、およびSet / Record Variableアクションを使用して[X,Y]配列を記録します。

以下は、Labvancedで見つかるすべてのトリガー固有の値のタイプの表であり、続いて各オプションの詳細な説明があります。

名称	値オプション - 概要
Trigger (Mouse)	マウスX マウスY マウス [X,Y] 配列 刺激名 刺激情報 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Keyboard)	キーのID トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Button Bar)	刺激名 刺激情報 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Enter On Input)	キーのID トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Scroll)	刺激名 刺激情報 スクロール位置X スクロール位置Y トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Gamepad/ Joystick)	ゲームパッドデバイスID 押されたキー（配列） 押されたまたは保持されたキー（配列） 解放されたキー（配列） 軸（配列） ゲームパッドタイムスタンプ (Unix時間) トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Eyetracking Gaze)	座標X 座標Y 座標[X,Y]配列 刺激名 刺激情報 カメラキャプチャ時間T 視線信頼度C 座標 + 時間 [X,Y, T] 配列 座標 + 時間 + 信頼度 [X,Y, T,C] 配列 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Eyetracking Fixation)	凝視中心X 凝視中心Y 凝視の持続時間 凝視開始時間 凝視終了時間 凝視散逸 刺激名 刺激情報 [X,Y, Dur, Start, End, Disp] トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Head Tracking)	カメラキャプチャ時間T フェイスメッシュデータフレーム 頭の回転 頭の傾き 頭のロール 頭の位置 [X,Y, T] 配列 鼻の位置 [X,Y, T] 配列 鼻のベクトル [X,Y, Z, T] 配列 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (On Task Initialization)	トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (On Frame Init)	試行番号 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (on Frame Start)	トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (On Frame End)	合計フレーム時間 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Variable Value Changed)	変数の新しい値 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Media Object Trigger)	トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Websocket Trigger)	メッセージ データ トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (OpenAI Trigger)	チャットGPTの回答 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (PostMessage Received)	メッセージコンテンツ トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (Global Experiment Event)	合計フレーム時間 グローバルイベントの理由 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)
Trigger (User Leaves Experiment)	参加者の残り数 トリガータイムスタンプ (Unix時間) トリガー時間 (フレーム開始から)

トリガー（マウス）値

マウストリガーが使用される場合、特定のアクションを操作するときに呼び出すことができるトリガー特有の値は以下の通りです:

トリガー（キーボード）値

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

トリガー（ボタンバー）値

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

トリガー（入力でのEnter）値

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

トリガー（スクロール）値

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

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

Gamepad/Joystick triggerが使用される場合、特定のアクションを操作するときに呼び出すことができるトリガー特有の値は以下の通りです:

トリガー（視線追跡）値

視線追跡トリガーが使用される場合、特定のアクションを操作するときに呼び出すことができるトリガー特有の値は以下の通りです:

トリガー（視線追跡固定）値

視線追跡固定トリガーが使用される場合、特定のアクションを操作するときに呼び出すことができるトリガー特有の値は以下の通りです:

トリガー (頭部追跡) 値

頭部追跡トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

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

タスク初期化トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

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

フレーム初期化トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (フレーム開始時) 値

フレーム開始トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (フレーム終了時) 値

フレーム終了トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (変数値変更時) 値

変数値変更トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

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

メディアオブジェクトトリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (WebSocketトリガー) 値

WebSocketトリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

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

OpenAIトリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (PostMessage受信) 値

PostMessage受信トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

トリガー (グローバル実験イベント) 値

一時停止/実験再開トリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：

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

参加者がマルチユーザースタディを離れたトリガーが使用されるとき、特定のアクションを操作する際に呼び出せる次のトリガー特有の値があります：