イベントシステム

説明

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

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

Labvancedにおけるイベントの仕組みの紹介に関するこのクイックビデオをご覧ください：

イベントの作成 - 概要

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

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

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

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

トリガー

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

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

ユーザー入力トリガー

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

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

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

マウストリガー

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

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

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

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

• 注意: イベントシステム内でマウストリガーを選択した後、トリガー固有のマウス値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

キーボードトリガー

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

以下の例では、指定された対象の数値（0、2、6）が押されたときのキーボードプレスがトリガーとして設定されています。

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

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

• 注意: イベントシステム内でキーボードトリガーを選択した後、トリガー固有のキーボード値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

ボタンクリックトリガー

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

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

ここでは、以下の項目について詳しく見てみましょう：

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

• 注意: イベントシステム内でボタンクリックトリガーを選択した後、トリガー固有のボタンクリック値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

入力時エンタートリガー

トリガー時: 特定の要素がアクティブになっているときに、キーボードのEnter/Returnキーが押されます。

パラメータ:

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

• 注意: イベントシステム内で入力時エンタートリガーを選択した後、トリガー固有の入力時エンター値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

スクロールトリガー

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

パラメータ:

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

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

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

• 注意: イベントシステム内でスクロールトリガーを選択した後、トリガー固有のスクロール値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

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

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

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

ゲームパッドを接続すると、どの特定のキーがトリガーとして使用されるかを指定できます。特定のキーを押すと、そのIDがシステムに表示されます。

以下の例では、2が◎キーを、3が▵キーを指します。 注意: キーIDの割り当てが異なる場合があるため、ゲームパッド間での違いに留意することが重要です。

キーを押すと、トリガーダイアログボックスの後半にライブデータも表示され、どのように値がリアルタイムで変化するかを見られます：

このトリガーを利用する研究の詳細なウォークスルーを確認してください。

以下のテーブルでは、これらのオプションについて詳細に説明します。

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

注意: イベントシステム内でゲームパッド/ジョイスティックトリガーを選択した後、様々なアクションでこのトリガー固有の値を利用および参照でき、値選択メニューを使用できます。

生理信号トリガー

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

視線追跡の視線トリガー

トリガー時:

• 視線追跡が有効になっている場合に適用されます。
• 特定の要素を見つめているときだけトリガーします。

パラメータ:

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

• 注意: イベントシステム内で視線追跡の視線トリガーを選択した後、トリガー固有の視線値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

視線追跡の凝視トリガー

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

• 注意: イベントシステム内でキーボードトリガーを選択した後、トリガー固有の凝視値を様々なアクションで利用および参照でき、値選択メニューを使用できます。

頭部追跡トリガー

トリガー時:

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

• 注意: イベントシステム内で頭部追跡トリガーを選択した後、様々なアクションでこのトリガー固有の値を利用および参照でき、値選択メニューを使用できます。

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

タスク初期化トリガー

トリガー時:

• タスクの最初の試行の最初のフレーム。すべてのフレームのインスタンスに対してイベントタブに表示されるにもかかわらず、タスクごとに一度だけ実行されます。

このトリガーは、シャッフルおよび読み取りアクションと組み合わせてうまく機能します。この組み合わせにより、タスクスタート時に配列エントリやデータフレームをシャッフルし、被験者を刺激のセットに割り当てることができ、複数のイベントを作成することなく刺激やデータを読み取ることが可能になります。

パラメータ: なし

• 注意: イベントシステム内でタスク初期化トリガーを選択した後、様々なアクションでこのトリガー固有のタスク初期化値を利用および参照でき、値選択メニューを使用できます。

フレーム初期化トリガー

トリガー時:

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

このトリガーは、シャッフル、読み取り、ランダム番号描画アクションと組み合わせてうまく機能します。この組み合わせにより、フレームが表示される前にこれらのアクションを完了することができ、フレームが始まると他のアクションを開始するための明確な道を残します。

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

パラメータ: なし

• 注意: イベントシステム内でフレーム初期化トリガーを選択した後、様々なアクションでこのトリガー固有のフレーム初期化値を利用および参照でき、値選択メニューを使用できます。

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

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

フレーム開始トリガー

トリガー時:

• フレームの開始

パラメータ: なし

• 注意: イベントシステム内でフレーム開始トリガーを選択した後、様々なアクションでこのトリガー固有のフレーム開始値を利用および参照でき、値選択メニューを使用できます。

フレーム終了トリガー

トリガー時:

• フレームの終了（フレームがもはや表示されなくなった後）

パラメータ: なし

• 注意: イベントシステム内でフレーム終了トリガーを選択した後、様々なアクションでこのトリガー固有のフレーム終了値を利用および参照でき、値選択メニューを使用できます。

変数値変更トリガー

変数値変更

トリガー時:

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

パラメータ:

• 変数: 変更を「監視」したい1つ以上の変数を選択します。これらの変数の値が変更されると、対応するアクションが直ちにトリガーされます。

• 注意: イベントシステム内で変数値変更トリガーを選択した後、様々なアクションでこのトリガー固有の変数値変更値を利用および参照でき、値選択メニューを使用できます。

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

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

以前は、「音声/動画制御トリガー」と「オブジェクト制御」トリガーとして知られていました。

トリガー時:

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

パラメータ:

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

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

  • 音声または動画オブジェクトオプション:
    • 再生開始: 要素の再生が始まった時にトリガーされる
    • 再生停止: 要素が一時停止した時にトリガーされる
    • 再生終了: 要素の再生が停止した時にトリガーされる
  • 動画、音声、または画面録画オブジェクトオプション:
    • 録音完了: 音声録音が停止した時にトリガーされる
    • アップロード完了: ファイルアップロードが完了した時にトリガーされる
  • ファイルアップロードオブジェクトオプション:
    • ファイル選択: ファイルが選択された時にトリガーされる
    • アップロード完了: ファイルアップロードが完了した時にトリガーされる
  • カメラスナップショットオブジェクトオプション:
    • スナップショット完了: カメラが成功裏にスナップショットを撮った時にトリガーされる
    • アップロード完了: スナップショットのアップロードが完了した時にトリガーされる

• 注意: イベントシステム内でメディアオブジェクトトリガーを選択した後、様々なアクションでこのトリガー固有のメディアオブジェクト値を利用および参照でき、値選択メニューを使用できます。

APIトリガー

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

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

ウェブソケットトリガー

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

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

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

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

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

• 注意: イベントシステム内でウェブソケットトリガーを選択した後、様々なアクションでこのトリガー固有のウェブソケット値を利用および参照でき、値選択メニューを使用できます。

OpenAIトリガー

「OpenAIトリガー」は、OpenAIからの情報をもとにアクションを開始するために使用されます。

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

注意: このウォークスルーでも、ステップバイステップで研究を構築し、研究にChatGPTを統合し、このトリガーを利用する方法が紹介されています。

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

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

• 注意: イベントシステム内でOpenAIトリガーを選択した後、様々なアクションでこのトリガー固有のOpenAI値を利用および参照でき、値選択メニューを使用できます。

グローバルトリガー

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

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

一時停止/再開実験

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

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

• 実験一時停止: 参加者が研究を一時停止（フルスクリーンを退出）した場合。

• 実験が続行された: 参加者が研究を再開した場合。このトリガーは、視線追跡研究にうまく機能します。参加者がバーチャルチンレストを離れた場合、以前の試行またはフレームに戻すために使用できます。

• 注意: イベントシステム内で一時停止/再開実験トリガーを選択した後、様々なアクションでこのトリガー固有の値を利用および参照でき、値選択メニューを使用できます。

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

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

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

• 注意: イベントシステム内で参加者がマルチユーザー研究を離れたトリガーを選択した後、様々なアクションでこのトリガー固有の値を利用および参照でき、値選択メニューを使用できます。

アクション

アクションは、イベントが実行されたときに発生するべきことを定義します。変数やオブジェクトのプロパティを変更したり、データを記録したり、配列に読み書きしたり、次の試行やタスクにジャンプしたりするために使用できます。通常、1つのイベントごとに複数のアクションがあります。「ControlActions」 باستخدام يمكن استخدام العوامل للتعامل مع العمليات المنطقية (if-else) ، الحلقات ، وظائف الاسترجاع ، بالإضافة إلى استدراج الأعمال في بعضها (مثل حلقة while داخل جملة if). وبالتالي ، يمكن اعتبار نظام الأحداث على أنه بيئة برمجة بيانية. في هذه الرؤية ، تعمل المشغلات كاستدعاءات للوظائف ، بينما تصف الإجراءات المنطقية الوظيفية. هذه النهج يضمن أنه يمكن تنفيذ أي منطق تجريبي تقريبًا دون الحاجة إلى استخدام بعض الهياكل البرمجية / النحوية.

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

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

オブジェクトアクション

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

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

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

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

以下の例では、アクションはターゲット画像の2つのプロパティを変更し、「visibility」を「1」に、「height」を「400」に設定します。この変更が画面に反映された時間を「Object_Prop_Change_Time」という数値変数に保存することで記録します。

以下は、「オブジェクトプロパティの設定」アクション作業時に遭遇するフィールドの全体的な概要です：

メニュー項目	メニューエリア	オブジェクトプロパティ設定トリガーオプション
ターゲット オブジェクト選択ドロップダウンリスト:		最初のドロップダウンリストには、選択するためのフレーム内のオブジェクトが表示されます。これは、アクションが実行される特定のオブジェクトを示しています。
ターゲット プロパティ選択ドロップダウンリスト:		2つ目のドロップダウンメニューには、どのオブジェクトプロパティを変更するかが示されています。利用可能なオプションとそのパラメータの詳細については、オブジェクトプロパティテーブルをご覧ください。
値選択メニュー		新しいオブジェクトプロパティの値として設定されるべき値（アクションの結果として）を定義します。利用するのは、**値選択メニュー**です。
‘+ プロパティを追加		このアイコンをクリックすることで、アクション内で複数のプロパティを追加および変更できます。
チェックボックス - この変更が画面に反映されたときの時間を記録する (フレーム開始からのミリ秒で測定)。		プロパティが変更されると、短い時間（約10ms）かかります。 このオプションを使用すると、変更されたプロパティが次のディスプレイ更新の際に本当に見える時間をより正確に記録できます。 注: このオプションを選択すると、捕捉された値を保存する場所（新しい変数を作成）を指定するように求めるダイアログボックスが表示されます。この変数は、「データ型」として数値である必要があります。

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

以前の「オーディオ/ビデオ制御」と「オブジェクト制御」アクションを統合。

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

パラメータ：

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

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

効果：オブジェクトをコピーし、いくつかの個別のオブジェクトと重複イベントの必要性を取り除きます。

パラメータ：

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

各オブジェクトに対する処理アクション

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

パラメータ：

• フィルター：ターゲットとする要素のタイプを選択します。
• 追加の名前フィルターを許可：ターゲットとするオブジェクトの名前を入力します。フレーム内に同一の名前を持つオブジェクトが複数ある場合に便利です。
• アクションシーケンス：選択された要素に何が発生するかを決定します。「CurrentObject」をターゲットとして選択し、上記の指定された基準を満たすすべての要素にアクションを適用します。

変数アクション

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

以下の表は、Labvancedで利用可能なすべての変数アクションオプションの紹介を提供します。各項目は、今後のセクションでより詳しく説明されます。

変数アクションオプション	説明
変数の設定/記録	変数の値を書き込むまたは設定します
クリップボードにコピー	変数の値をコンピュータの内部クリップボードにコピーします。
ランダム数を描く	1つまたは複数のランダム数を描き、変数に保存します
URLパラメータを取得	参加者のユニークなURLから値を保存します
デバイスから読み書き	ローカルデバイスのストレージから変数を読み書きします。このアクションは、データをLabvancedサーバーに送信するのではなく、参加者のデバイスにデータを保存します。
共有変数から読み書き	研究のセッションをまたいで共有される変数から読み取るか、または書き込みます。その変数はすべての参加者と共有するか、個々の参加者にプライベートにしておくことができます。
数学と統計	一部の入力変数（配列）の数学演算を実行し、結果を出力変数に保存します。
瞬時に変数を記録	すべての変数値のスナップショットを作成し、これをLabvancedサーバーに送信します。
移動平均フィルター	一部の入力の移動平均（データの絶えず更新される平均）を計算し、結果を新しい変数に保存します。
変数を分配	他の参加者に値を送信します。値は変数に保存されます。

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

「変数の設定/記録」アクションは、Labvancedのすべての実験で使用される必要があり、値と行動測定がどのように保存され記録されるかを示します。

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

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

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

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

注: 変数の設定/記録アクションは、コントロールアクションのコンテキストでも一般的に使用され、変数の値に基づいて「if / then」および「whileループ」を使用して条件を指定できます。

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

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

ランダム数を描くアクション

効果：1つまたは複数のランダム数を描き、変数に保存します。

パラメータ：

• タイプ：連続値と離散値の間で選択します
• 分布：ガウス分布と均一分布の間で選択します
• 複数描画（真/偽）：1回または複数回描くことを選択します。
• 描画数：描画の数を選択
• 最小：均一分布の最小値を定義します
• 最大：均一分布の最大値を定義します
• 平均：ガウス分布の平均値を定義します
• 標準偏差：ガウス分布の標準偏差を定義します
• 変数に保存：値が保存される変数を選択します。

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

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

パラメータ：

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

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

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

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

パラメータ：

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

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

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

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

パラメータ：

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

ユースケース：縦断的/多セッション研究 *このアクションを使用すると、参加者固有のデータをセッション間で引き継ぎ、セッションを跨いで参加者間で共有することができます。 *たとえば、このアクションを使用してテストのスコアを記録し、その後、参加者がテストを受けた他の参加者の平均スコアと比較できるようにします。 *別の例（デバイスから読み取る/書き込むアクションに似た）のは、参加者が配列から好きな5つの画像を選び、タスクを実行し、その後、後のセッションで再びその5つの画像を提示することです。このアクションを使用すると、他の参加者に選択された画像を表示したり、他の参加者の利用可能なオプションからそれらの画像を除外したりできます。

数学と統計アクション

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

パラメータ：

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

瞬時に変数を記録アクション

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

パラメータ：なし

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

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

パラメータ：

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

変数を分配アクション

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

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

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

こちらのデモでは、分配変数とチャットボックス機能が組み込まれています：画像説明タスク - チャットアドオン

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

メニュー項目	メニューエリア	分配変数アクションオプションと説明
値を分配する		どの他の参加者に値が送信されるかを選択します。 **すべての参加者：**この値をすべての参加者に送信します **選択した参加者：**選択された参加者に値を送信します。
ターゲット変数と値を選択		ターゲット変数： 値が保存されるターゲット変数を選択します。 値： 他の参加者に送信されるべき値を決定します。
ブロック		有効にすると、現在の値の分配が完了するまでターゲット変数は変更できなくなります。
レート制限戦略		レート制限戦略は、サーバーが過負荷になるのを防ぎ、分配変数を介して送信されるリクエストのレートを制御するための予防策です。以下の戦略オプションがあります： **デバウンス：**このアクションが100msの時間窓内に複数回実行される場合、新しいサーバーメッセージは「デバウンス」されます（このアクションの実行がない100msのインターバル後に最も最近のメッセージのみが送信されます）。 **スロットル：**このアクションが100msの時間窓内に複数回実行される場合、新しいメッセージはスロットルされます（つまり、最後のメッセージが送信されてから100ms経過した後、最も最近のメッセージだけが配布されます）。 **破棄：**このアクションが100msの時間窓内に複数回実行される場合、その100msの時間窓内の新しいメッセージは破棄されます。 **キュー：**このアクションが100msの時間窓内に複数回実行される場合、新しい変数値はキューに入れられます（最大キューサイズは10メッセージ）。

配列アクション

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

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

パラメータ：

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

配列エントリの追加/削除アクション

効果：配列に対してエントリの追加および/または削除を行います。

パラメータ：

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

配列エントリの変更（置き換え）アクション

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

パラメータ：

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

配列エントリのシャッフルアクション

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

パラメータ：なし

データフレーム操作

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

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

パラメータ：

• データフレーム変数：読み取るデータフレームの変数を選択します。
• 読み取りまたは書き込み：選択されたデータフレームから読み取るか、選択されたデータフレームに書き込みを選択します。
• 行または列による：データがどのように読み取られるかを選択します。
• インデックスタイプ：データフレームを読み取るために使用されるインデックス変数のタイプを選択します。固定、変数、または最後の行です。
• インデックス変数：データフレームを読み取るために使用される変数を選択します。
• 出力変数：読み取られた/書き込まれたデータが出力として保存される変数を選択します。配列変数である必要があります。

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

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

パラメータ：

• シャッフルするデータフレームを選択します。
• データフレームが行または列によってシャッフルされるかを選択します。

ジャンプアクション

ジャンプトゥアクション

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

パラメータ：

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

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

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

パラメータ：

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

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

効果：記録セッションが終了し、参加者のデータが完了としてマークされず、デフォルトの終了画面と報酬コードが表示されません。

このアクションを使用して参加者のデータを拒否する場合、ユーザーは参加者にその理由を説明する適切なメッセージを表示する必要があります。

パラメータ：なし

URLへのリダイレクトアクション

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

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

コントロールアクション

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

効果：if-thenステートメントを評価し、一連のアクションを従属的に実行します。それぞれのIf / Else-Ifステートメントは入れ子になったAND / OR比較で構成されており、すべての要件が満たされているかどうか（ステートメントが真であるかどうか）を評価します。ステートメントが真であれば、「Then」の下のアクションが実行されます。

パラメータ：

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

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

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

パラメータ：

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

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

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

パラメータ：

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

アクショングループ

アクションはアクショングループにも整理できます。アクショングループを使用すると、特定のアクションをグループ化して視覚的な構造を簡素化したり、複数のアクションを一度にコピー、複製、または削除したりすることができます。アクショングループを追加するには、カスタムアクションの下にオプションがあります：

APIアクション

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

• WebSocketに送信
• OpenAIに送信

これらのアクションを「利用可能」または使用可能にするには、研究設定内の「実験機能」列にAPIキーを入力する必要があります。APIキーが提供されたら、これらのアクションはもはやメニューからグレーアウトされなくなります。

WebSocketに送信アクション

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

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

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

OpenAIに送信アクション

「OpenAIに送信」アクションでは、文字列入力値などの情報をOpenAIに送信できます。このオプションを使用するには、必ず「研究設定」タブの「実験機能」列にAPIキーをリストする必要があります。

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

必要な情報がすべて提供された場合、このイベントがどのように機能するかの機能的な例を以下に示します：

この機能をどのように活用し、実際に見ることができるかについては、デモをリクエストしてこの連絡フォームを提出することをお勧めします。

注： この手順解説も参照してください。ChatGPTを研究に組み込んで、このアクションを利用する手順を紹介します。

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

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

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

コードアクション

場合によっては、あなたの実験にはカスタムコードの使用が必要です。これらのアクションを使うことで、まさにそれを行うことができます！『コードアクション』メニューの下には以下のオプションがあります：

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

JavaScript実行アクション

『JavaScriptを実行』アクションを使用すると、特定のイベントをプログラムし、実験内のLabvanced変数を読み取り/設定するためのカスタムJavaScriptを入力して、トリガーされたときにアクションとして実行されます。

上記の『JavaScriptを実行』アクションが選択されると、JavaScriptコードを書くべきエリア（コードエディター）が表示され、使い方に関する指示も表示されます：

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

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

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

『グローバルCSSを設定』アクションの使用例は、参加者が複数選択肢から特定の色を選択した時に研究の背景色を変更することです。

ペーストアクション

このオプションを使用すると、以前に作成してコピーしたアクションをペーストできます。これにより、実験をデザインする際に同じアイテムを再び選択する必要がなくなり、作業を迅速に行えます。たとえば、既存のイベントと似たイベントがある場合、単純にそれをコピーし、貼り付けて、修正することができます。

値選択メニュー

特定のイベントに取り組むとき、ペンアイコンが表示されます。これは値選択メニューと呼ばれ、記録または追跡する値の種類を選択し、指示することができます。これは、あなたの実験設計やセットアップに必ず使用する強力で重要なオプションです。

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

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

上の画像は、マウストリガーが使用されているときの値選択メニューの外観を示しています。ご覧のとおり、左側の最初のメニュー項目はトリガー固有のカテゴリから始まり、その後、他の5つのカテゴリ（現在の時間など）に進みます。

メニューオプション

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

現在の時間の値

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

以下のオプションがあります：

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

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

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

現在の時間：フレーム発生からの時間

この値は、フレーム発生から経過した時間を取得します。これは最も頻繁に反応時間と同等です。

定数値

必要な変数のタイプに基づいて定数値を割り当てます。これらは時には、算術などの他のオプションと組み合わせて使用されます。

以下のオプションがあります：

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

定数：文字列

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

定数：数値

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

定数：ブール値

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

定数：カテゴリカル

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

定数：日付

日付値を割り当てます。

定数：時間

時間値を割り当てます。

定数：色

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

変数の値

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

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

変数を選択

変数を選択してポイントします。

配列から値を選択

配列から値を選択します。

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

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

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

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

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

オブジェクトプロパティ

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

フレーム

目の追跡

デバイス

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

操作

操作を使用して、変数の特定の変更を実行します。例えば、変数値を結合したり、文字列をすべて小文字に変換したり、数学的な操作を実行したりします。

以下のオプションがあります：

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

算術

算術演算は、文字列を結合したり、オブジェクトプロパティを変更したりするなど、多くの目的に役立ちます。

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

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

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

• (+) 加算
• (-) 減算
• (/) 除算
• (*) 乗算
• (%) 除算の余り

以下の例では、算術操作を利用して、新しい文字列変数（緑のボタン）を作成しています。これを「intermediateVar」と呼びます。

新しい変数値（「intermediateVar」）は、いくつかの算術操作を特定のコンビネーションで組み合わせて定義されており、以前に作成された変数（「userChatName」と「chatInput」）と定数文字列値、すなわちセミコロン : と改行 <br> を組み合わせて使用します。このアクションにより、マルチユーザー研究で使用できるユーザーのチャットエフェクトが生成されます。

文字列操作

数学操作

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

トリガー固有の値

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

以下の例では、マウストリガーのトリガー固有の値を使用して、セット/レコード変数アクションを用いてx-およびy-値と[X,Y]配列を記録しています。

以下の表は、Labvancedで見つけることができるすべてのトリガー固有の値のタイプを示し、それぞれのオプションについての詳細な説明を示しています。

名前	値オプション - 概要
トリガー（マウス）	マウスX マウスY マウス[X,Y]配列 嵌入物名 嵌入物情報 トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から）
トリガー（キーボード）	キーのID トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から） li>
トリガー（ボタンバー）	嵌入物名 嵌入物情報 トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から）
トリガー（入力でのEnter）	キーの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トリガー）	Chat GPT応答 トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から）
トリガー（グローバル実験イベント）	総フレーム時間 グローバルイベントの理由 トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から）
トリガー（ユーザーが実験から離れた）	残りの参加者数 トリガータイムスタンプ（ユニックスタイム） トリガー時間 （フレーム発生から）

トリガー（マウス）値

マウストリガーを使用する場合、特定のアクションに取り組む際に、以下のトリガー固有の値を呼び出すことができます：

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

キーボードトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

ボタンクリックトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

入力でのEnterトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

スクロールトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

ゲームパッド/ジョイスティックトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（目の追跡凝視）値

目の追跡凝視トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（目の追跡固定）値

目の追跡固定トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（頭追跡）値

頭追跡トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（タスク初期化時）値

タスク初期化トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（フレーム初期化時）値

フレーム初期化トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

フレーム開始トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

フレーム終了トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（変数値変更時）値

変数値変更トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

メディアオブジェクトトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

トリガー（ウェブソケットトリガー）値

ウェブソケットトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

OpenAIトリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

停止/再開実験トリガーを使用する場合、以下のトリガー固有の値を特定のアクションで呼び出すことができます：

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

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