イベントシステム

説明

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

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

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

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’ オプションをクリックすることで、複数のターゲットを追加できます。	ターゲットを指定する際に利用できるオプションは次のとおりです: フレーム背景でトリガー: オブジェクトや要素をクリックせずにマウストリガーをアクティブにできます。 任意の要素: フレーム内の任意の要素をクリックすることでマウストリガーをアクティブにできます。 ターゲットの追加: トリガーをアクティブにするためにクリックする必要がある特定の要素を選択します。

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

キーボードトリガー

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

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

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

メニュー項目	メニュー領域	キーボードトリガーオプション
Action ドロップダウンリスト:		利用可能なキーボードアクションオプションは次のとおりです: プレスキー: キー押下によってトリガーされます（キーが押されている状態） キーを押すまたは保持: キーが押されているか保持されている場合にトリガーされます リリースキー: キーが放出されたときにトリガーされます 注意: キーが再度トリガーとして「発火」するためには、キーを放出する必要があります。
Keys どのキーがイベントをトリガーするか		トリガーとして使用されるキーは、ここでオプションを選択することで指定されます。+Add: をクリックします 矢印: 四つの矢印キー 数字: 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タブの下で有効にすることを忘れないでください。

詳細を学ぶ.

生理学的信号トリガー

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

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

トリガー:

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

パラメータ:

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

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

詳細を学ぶ: アイートラッキングを有効にし、視線データを記録し、実用的な例を確認するには、専用のアイートラッキング視線トリガーページを参照してください。

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

このトリガーはまだBETA段階です。

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

詳細を学ぶ: アイオントラッキング検知を有効にし、凝視データを記録し、実用的な例を確認するには、専用のアイートラッキング凝視トリガーページを参照してください。

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

トリガー:

• 頭の向きや頭の動きの変化によってトリガーされます。

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

トライアルとフレームトリガー

タスク初期化トリガー

トリガー発動時:

• タスクの最初のトライアルの最初のフレーム。タスクごとに一度だけ実行され、フレームのすべてのインスタンスのイベントタブに表示されるにもかかわらず、実行回数は1回です。

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

パラメータ: なし

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

フレーム初期化トリガー

トリガー発動時:

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

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

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

パラメータ: なし

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

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

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

フレーム開始トリガー

トリガー発動時:

• フレームの開始

パラメータ: なし

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

フレーム終了トリガー

トリガー発動時:

• フレームの終了（フレームが見えなくなった後）

パラメータ: なし

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

変数値変更トリガー

変数値変更

トリガー発動時:

• 変数の値が開始値から変更された時

パラメータ:

• 変数: 変更を「リスン」したい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受信値を使用するオプションがあります⬅️バリューセレクトメニュー

### グローバルトリガー

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

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_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/pause_trigger.webp" alt="トリガーとしての実験の一時停止オプション。" 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/global_dialog.webp" alt="このグローバルトリガーのダイアログメニュー" width="50%">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/global_options.webp" alt="グローバルトリガーメニューでの利用可能なオプション" width="50%">
</p>

* **実験が一時停止された場合：** 参加者がスタディを一時停止（全画面を終了する）します。
* **実験が続行された場合：** 参加者がスタディを再開します。このトリガーは、視線追跡スタディに適しています。参加者がバーチャルチンレストを離れた場合、前の試行やフレームに戻るのに使用できます。

* **注意：** イベントシステムで一時停止/再開トリガーを選択した後、[トリガー特定の値](#trigger-global-experiment-event-values) を様々なアクションで利用・参照するオプションがあります。[値選択メニュー](#the-value-select-menu) を使用して。 

#### 参加者がマルチユーザースタディを離れた
参加者がマルチユーザースタディを離れると、それもイベントのトリガーとして使用できます。参加者がマルチユーザースタディを離れると、これは他の参加者がスタディを続行できなくするため、グローバルレベルで実験に影響を与えます。 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/left_mus.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/left_mus_dialog.webp" alt="参加者がマルチユーザースタディを離れたトリガーダイアログボックス。" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

* **注意：** イベントシステムで参加者がマルチユーザースタディを離れたトリガーを選択した後、[トリガー特定の値](#trigger-user-leaves-experiment-values) を様々なアクションで利用・参照するオプションがあります。[値選択メニュー](#the-value-select-menu) で。 


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

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

| アクションカテゴリ <img width=200/> | アクションオプション <img width=500/>| 説明 <img width=400/> | 
| :----: | -- | ----- | 
| [`Object Actions`](#object-actions)| <ul><li> [オブジェクトプロパティの設定](#set-object-property-action) </li> <li> [メディアオブジェクトの制御](#control-media-object-action) </li> <li> [オブジェクトのコピー](#copy-object-action) </li> <li> [各オブジェクトに対して](#foreach-object-action) </li> </ul> | オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる任意の操作を指します。 |
| [`Variable Actions`](#variable-actions) | <ul><li> [変数の設定 / 記録](#set-record-variable-action) </li> <li> [クリップボードにコピー](#copy-to-clipboard-action) </li> <li>[ランダム番号を生成](#draw-random-number-action) </li> <li> [URLパラメータを取得](#get-url-parameter-action) </li> <li> [デバイスから読み取り / 書き込み](#read-from-write-to-device-action) </li> <li> [共有変数から読み取り / 書き込み](#read-from-write-to-shared-variable-action) </li> <li> [数学 & 統計](#math-statistics-action) </li> <li>[変数を瞬時に記録](#record-variables-instantly-action) </li> <li>[移動平均フィルター](#moving-average-filter-action) </li> <li> [変数を分配](#distribute-variable-action) </li> </ul> |  変数の値を読み取ったり、記録するアクション。 |
| [`Array Actions`](#array-actions) | <ul><li> [配列から選択（読み取り）](#select-read-from-array-action) </li> <li> [配列エントリの追加 / 削除](#add-remove-array-entries-action) </li> <li> [配列エントリの変更（置換）](#change-replace-array-entry-action) </li> <li> [配列エントリのシャッフル](#shuffle-array-entries-action)  </li> </ul> | 配列操作は、配列やそのエントリを選択、追加、削除、変更、シャッフルすることを含みます。 | 
| [`Data Frame Operations`](#data-frame-operations) | <ul><li> [データフレームの読み取り / 書き込み](#read-from-write-to-data-frame-action) </li> <li> [データフレームエントリのシャッフル](#shuffle-data-frame-entries-action)  </li> </ul> | これらのアクションは、実験で.csvファイル（データフレーム）を扱う場合に関連します。 |
| [`Jump Actions`](#jump-actions) | <ul><li> [ジャンプする](#jump-to-action) </li> <li> [セッションを受け入れる / 終了する](#accept-end-session-action) </li> <li> [拒否する / セッションを終了する](#reject-end-session-action) </li> <li>[URLにリダイレクトする](#redirect-to-url-action)</li></ul> | 特定のセクションにジャンプすることで、実験をナビゲートしたり、参加者のセクションを受け入れたり拒否したりします。 | 
| [`Control Actions`](#control-actions) | <ul><li>  [要件アクション（If…Then）](#requirement-actions-if-then-else-if-action) </li><li> [繰り返しアクション（Whileループ）](#repeated-actions-while-loop-action) </li><li> [遅延アクション（タイムコールバック）](#delayed-actions-time-callback-action) </li><li> [アクショングループ](#action-group) </li></ul> | 制御アクションは、if/thenロジック、ループ（繰り返し音を再生したり、画像を点滅させたりすること）などの特定のイベントシーケンスを実行するために使用されます。 | 
| [`API Actions`](#api-actions) | <ul><li> [PostMessageを送信](#send-postmessage-action) </li><li> [Websocketに送信](#send-to-websocket-action) </li><li> [OpenAIに送信](#send-to-openai-action) </li></ul> | APIにデータを送信するためのAPI特有のアクションを指します。 |
| [`Code Actions`](#code-actions) | <ul><li> [JavaScriptを実行](#run-javascript-action) </li> <li> [グローバルCSSを設定](#set-global-css-action) </li></ul> |  コードアクションは、JavaScriptやCSSを扱うことを許可します。 
| [`Paste Action`](#paste-action) | ペーストアクション  | 以前にコピーしたアクションをペーストできます。 |

### オブジェクトアクション 
オブジェクトアクションは、タスク内に存在するオブジェクトに対して行われる任意の操作を指します。いくつかのオブジェクトアクションオプションがあります：
* オブジェクトプロパティを設定
* メディアオブジェクトを制御
* オブジェクトのコピー
* 各オブジェクトに対して 

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/object_actions_menu.webp" alt="Labvancedのオブジェクトアクションオプション。" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

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

[詳細を学ぶ。](/content/learn/ja/guide/events/set-object-property-action.html) 


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

以前は「音声/ビデオを制御」と「オブジェクトを制御」という別々のアクションでした。

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

パラメータ：
* ターゲット：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アクションは、Control Actionsの文脈でも一般的に使用され、変数の値に基づいて「if / then」や「whileループ」を使用して条件を指定できます。

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

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

ランダム数生成アクション

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

パラメータ:

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

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

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

パラメータ:

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

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

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

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

パラメータ:

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

ユースケース: 縦断的/複数セッション研究

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

共有変数への読み書きアクション

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

パラメータ:

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

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

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

数学 & 統計アクション

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

パラメータ:

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

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

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

パラメータ: なし

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

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

パラメータ:

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

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

変数を配布するアクションは、Labvancedのマルチユーザー研究 にとって不可欠です。このアクションにより、変数の値が参加者間で共有され、基本的には情報（刺激の位置や変更を含む）が参加者の画面に反映されることができます。このアクションの専用ウォークスルーについては、変数を配布するアクション を参照してください。

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

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

配布変数とチャットボックス機能を組み込んだデモはこちらをご覧ください: チャットアドオン付き画像説明タスク。

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

メニュー項目	メニューエリア	変数を配布するアクションのオプションと説明
Distribute value to		この値が送信される他の参加者を選択します。 すべての参加者: この値をすべての参加者に送信 選択された参加者: 選択された参加者に値を送信。
Choose target variable and value		ターゲット変数: 値が保存されるターゲット変数を選択。 値: 他の参加者に送信されるべき値を決定します。
Block		有効にすると、ターゲット変数は現在の値の配布が完了するまで変更できなくなります。
Rate Limit Strategy		レート制限戦略は、サーバーのオーバーフローから実験を保護する方法であり、サーバーに送信されるリクエストの速度（すなわち、変数を配布することによる更新）の制御のための予防策として機能します。以下の戦略オプションが利用可能です: デバウンス: このアクションが100 msの時間ウィンドウ内に複数回実行される場合、新しいサーバーメッセージは「デバウンス」されます（このアクションが実行されない100 msの間隔の後、最も最近のメッセージのみが送信されます）。 スロットル: このアクションが100 msの時間ウィンドウ内に複数回実行される場合、新しいメッセージは制限されます（すなわち、最後のメッセージが送信されてから100 msが経過した後、最も最近のメッセージのみが配布されます）。 破棄: このアクションが100 msの時間ウィンドウ内に複数回実行される場合、その100 msの時間ウィンドウ内の新しいメッセージは破棄されます。 キュー: このアクションが100 msの時間ウィンドウ内に複数回実行される場合、新しい変数値はキューに追加されます（最大キューサイズは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文のすべてのアクションをリストします。新しいアクションは、"アクションを追加"アイコンを介して追加できます。アクションシーケンスは、関連するIf / Else-if文の要件が満たされた場合にのみ実行されます。
• Else-Ifケースを追加: 要件アクションは、いくつかの別々のIf / Else-If --> Then文で構成されることがあります。ただし、1つの文のみが実行されます。1つのIf / Else-If文がポジティブに評価される（真を返す）場合、Thenブロック内のアクションが実行され、残りの要件アクションはスキップされます。
• Elseケースを追加（真 / 偽）: 有効にすると、要件アクションにデフォルト/フォールバックオプションが追加されます。If / Else-If文が実行されない場合（真を返さない場合）、elseケースで定義されたアクションが実行されます。

繰り返しアクション (While Loop) アクション

効果: 一連のアクションを繰り返し実行します。即座に実行するか、定義された間隔内で実行します。停止条件を指定することができるため、ループ実行を停止できます。

パラメータ:

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

遅延アクション (Time Callback) アクション

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

パラメータ:

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

アクショングループ

アクションはアクショングループに整理することもできます。アクショングループは、特定のアクションをまとめて視覚的な構造を簡単にするだけでなく、複数のアクションを一度にコピー、複製、または削除したい場合にも役立ちます。

詳細を学ぶ

APIアクション

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

• PostMessageの送信
• Websocketに送信
• OpenAIに送信

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

PostMessageの送信アクション

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

詳細を学ぶ

Websocketに送信アクション

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

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

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

OpenAIに送信アクション

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

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

必要な情報がすべて提供された場合、このイベントの機能的な例は次のとおりです：

この機能を利用し、実際にどのように動作するかをより良く理解するために、デモを要求するためにこの連絡フォームを送信してください。

注意： ChatGPTを統合した研究を段階的に構築し、このアクションを活用する方法については、このウォークスルーも参照してください。

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

メニュー項目	メニュー領域	'Send to OpenAI'アクションオプション
Model Type		使用されるAIモデルを指定します。
Chat History Dataframe		2列のデータフレーム変数へのリンク。最初の列は「役割」を示し、2番目の列は「チャットメッセージ」を示します。アクションからの値は、自動的にここにリンクされたデータフレームに追加されます。 データフレームは、データフレームアクションで操作することもできます。詳細については、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つのカテゴリ（現在の時間、定数値、変数、フレーム/タスク/オプション、および操作）を続けます。これらはすべて独自のオプションを持っています。 これらについては、以下でさらに説明します。

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

メニューオプション

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

現在の時間の値

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

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

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

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

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

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

この値は、フレーム開始から経過した時間をキャプチャします。最も一般的には、これは反応時間に相当します。

定数値

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

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

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

定数：文字列

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

定数：数値

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

定数：ブール値

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

定数：カテゴリカル

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

定数：日付

日付値を割り当てます。

定数：時間

時間値を割り当てます。

定数：色

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

変数値

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

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

変数を選択

変数を選択してポイントすることを可能にします。

配列から値を選択

配列から値を選択することを可能にします。

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

作成したデータフレームから値を選択することを可能にします。

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

オブジェクトプロパティ、フレーム、アイートラッキング（有効な場合）、およびデバイス（画面リフレッシュレート）に関連付けられた値を取得することを可能にします。

• オブジェクトプロパティ
• フレーム
• アイートラッキング
• デバイス

オブジェクトプロパティ

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

フレーム

アイートラッキング

デバイス

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

操作

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

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

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

算術

算術演算は、文字列を組み合わせたりオブジェクトプロパティを変更したりするなど、さまざまな目的に役立ちます。

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

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

これら5つの異なる操作を使用して値を操作できます：

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

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

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

文字列操作

数学操作

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

トリガー固有の値

トリガー固有の値は、特定のイベント内で定義されたトリガーに関連する値を指します。たとえば、イベントがマウストリガーを使用している場合、アクションが指定されている特定の領域（例えば、Set / Record VariableアクションやSet Object Propertyアクションを使用している場合）、値選択メニュー内でマウストリガー固有の値を参照できます。

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

以下は、Labvancedで見つけることができるすべてのトリガー固有の値の種類の表であり、それぞれのオプションの詳細な説明が続きます。

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

トリガー（マウス）値

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

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

キーボードトリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

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

ボタンクリックトリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

トリガー（入力時エンター）値

入力時エンタートリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

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

スクロールトリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

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

Gamepad/Joystick triggerが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

トリガー（視線追跡）値

視線追跡トリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

詳細について学ぶ: 視線追跡を有効にし、視線データを記録し、実用的な例を見るには、専用の視線追跡トリガーページを参照してください。

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

視線追跡固定トリガーが使用される場合、特定のアクションを操作しているときに呼び出すことができる次のトリガー固有の値があります：

詳しくは: 専用の 視線追跡の固定トリガー ページを参照して、固定検出を有効にし、固定データを記録し、実用的な例を確認してください。

トリガー (頭の位置追跡) 値

頭の位置追跡トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

タスク初期化トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

フレーム初期化トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

フレーム開始トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

フレーム終了トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

変数値変更トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

メディアオブジェクトトリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

WebSocketトリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

OpenAIトリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

トリガー (PostMessage受信) 値

PostMessage受信トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

一時停止 / 再開実験トリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。

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

参加者がマルチユーザー研究を離れたトリガー が使用されると、特定のアクションを扱うときに呼び出せる以下のトリガー固有の値があります。