イベントシステム

説明

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

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

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

Labvancedでのイベントの機能についてのイントロダクションは、以下の短いビデオを参照してください:

イベントの作成 - 概要

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

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

トリガーの選択

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

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

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

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

トリガー

トリガーは、イベントが実行される時点を定義します。特定のオブジェクトに対するマウスクリック、特定のキーボード入力、変数の変更、ビデオファイルの開始、その他多くの事柄が考えられます。以下のリストでは、すべてのトリガーとその設定/パラメータについて説明しています。

トリガーカテゴリ	トリガーオプション	説明
User Input Triggers	マウストリガー キーボードトリガー ボタンクリック 入力でエンター スクロールトリガー ゲームパッド/ジョイスティックトリガー	ユーザー入力トリガーは、ユーザー/参加者がマウスを動かしたり、キーボード要素をクリックしたり、スクロールしたりするなどして手動でアクティブにできるトリガーを指します。
Physiological Signal Triggers	視線追跡 視線固定 頭部追跡	生理信号トリガーは、特定の要素を見つめたり、頭の動きが変わったりするなど、特定の生理的入力があると発生します。
Trial and Frame Triggers	タスク初期化 フレーム初期化 フレーム開始 フレーム終了	これらのトリガーは、例えばフレームが開始または終了するなど、実験の試行やフレームに関連して発生します。
Variable Value Changed Trigger	変数（値が変更されました）	特定の変数の値が変更されるとイベント用のトリガーが発生します。
Media Object Trigger	メディアオブジェクトトリガー	このトリガーは、ビデオ/オーディオファイルの一時停止、録音の完了など、メディアオブジェクトに関連して発生します。
API Triggers	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:**をクリックしてオプションを選択することによって指定します。 矢印： 4つの矢印キー 数字： 0から9までの数字 文字： 英語アルファベットのすべての文字 特別： 特殊キー（Enter、Space、Control、Tab、Shift） Fキー： F1からF10まで 任意のキー： これらのキーのいずれも有効です +Add: ボタンを再度クリックすることで、複数のキーボードトリガーを追加できます。
追加オプション		テンキーを有効にするオプションでは、テンキーをトリガーとして使用できます。 イベント伝播を許可するオプションでは、複数のイベントが同じキーボードトリガーを持つ場合、すべてが発火/トリガーされます。ただし、最初の1つのみ発火し、イベントの実行は最初のイベントが完了した後に停止します。

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

ボタンクリックトリガー

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

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

ここでは、特徴的な項目の詳細を説明します：

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

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

入力時のエンター トリガー

トリガー条件：特定の要素がアクティブなときにキーボードのエンター/リターンキーが押される。

パラメータ：

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

• 注意： イベントシステムで入力時のエンター トリガーを選択した後、さまざまなアクションにおいてトリガー固有の入力時のエンター値を利用し参照するオプションがあります。これには値選択メニューが含まれます。

スクロール トリガー

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

パラメータ：

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

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

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

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

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

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

もっと学ぶ.

生理的信号トリガー

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

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

トリガー条件：

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

パラメータ：

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

• 注意： イベントシステムでアイ・トラッキング注視トリガーを選択した後、さまざまなアクションにおいてトリガー固有の注視値を利用し参照するオプションがあります。これには値選択メニューが含まれます。

もっと学ぶ： アイ・トラッキングを有効にし、注視データを記録し、実用的な例を知るための専用のアイ・トラッキング注視トリガーページをご覧ください。

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

このトリガーはまだBETA段階にあります。

• 注意： イベントシステムでキーボードトリガーを選択した後、さまざまなアクションにおいてトリガー固有の固定値を利用し参照するオプションがあります。これには値選択メニューが含まれます。

もっと学ぶ： 固定検出を有効にし、固定データを記録し、実用的な例を知るための専用のアイ・トラッキング固定トリガーページをご覧ください。

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

トリガー条件：

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

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

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

タスク初期化トリガー

トリガーが発生するのは:

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

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

パラメータ: なし

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

フレーム初期化トリガー

トリガーが発生するのは:

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

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

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

パラメータ: なし

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

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

変数のプロパティウィンドウで「トライアル開始時にリセット」をオフにすることを忘れないでください。

フレーム開始トリガー

トリガーが発生するのは:

• フレームの開始

パラメータ: なし

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

フレーム終了トリガー

トリガーが発生するのは:

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

パラメータ: なし

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

変数値変更トリガー

変数値変更

トリガーが発生するのは:

• 変数の値がその開始値から変更されるとき

パラメータ:

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

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

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

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

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

トリガーが発生するのは:

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

パラメータ:

• 対象: フレーム上に存在するオブジェクト要素を選択

• 実行オン: トリガーのサブタイプを選択

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

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

APIトリガー

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

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

Websocketトリガー

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

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

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

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

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

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

OpenAIトリガー

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

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

注意: また、このウォークスルーも参照してください。この中で、ChatGPTを研究に統合し、このトリガーを利用してステップバイステップで研究を構築します。

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

‘Send to OpenAI’アクションも使用している場合は、ここで示したのと同じデータフレームを利用する必要があります。

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

PostMessage受信トリガー

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

詳細を学ぶ

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

グローバルトリガー

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

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

実験の一時停止/再開

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

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

• 実験一時停止： 参加者が研究を一時停止（全画面を終了）します。

• 実験再開： 参加者が研究を再開します。このトリガーは視線追跡研究にうまく機能します。参加者が仮想顎固定具を離れた場合、以前の試行やフレームに戻すのに使用できます。

• 注意： イベントシステムでPause/Resume Experimentトリガーを選択した後、trigger-specific valuesを使用し、さまざまなアクションで値選択メニューを参照するオプションがあります。

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

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

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

• 注意： イベントシステムでParticipant Left Multiuser Studyトリガーを選択した後、trigger-specific valuesを使用し、さまざまなアクションで値選択メニューを参照するオプションがあります。

アクション

アクションは、イベントが実行されたときに何が起こるべきかを定義するものです。変数やオブジェクトプロパティを変更したり、データを記録したり、配列にデータを読み書きしたり、次の試行やタスクにジャンプしたりするために使用できます。イベントごとに複数のアクションが存在することがよくあります。「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つのメディアオブジェクトを選択
• 効果：サブアクションを選択
  • オーディオまたはビデオオブジェクトオプション：
    • 再生を開始：ビデオ / オーディオファイルの再生を開始します
    • 再生を停止：ビデオ / オーディオファイルの再生を停止します
    • 再生を一時停止：ビデオ / オーディオファイルの再生を一時停止します
    • JumpToTime：オーディオ/ビデオファイル内のミリ秒で指定された時間にジャンプすることを可能にします
    • ミュート：オブジェクトの音をオフにします
    • 音を戻す：オブジェクトの音を戻します
  • オーディオ、ビデオ、または画面録画オブジェクトオプション：
    • 録音を開始：新しい（オーディオ）録音を開始します
    • 録音を停止：録音を停止します（オーディオ録音）
    • アップロードを開始：ファイルのアップロードを開始します
    • 録音をクリア：録音データを削除します（オーディオ録音）
    • 再生を開始：録音されたファイルの再生を開始します
    • 再生を停止：録音されたファイルの再生を停止します
    • 録音を一時停止：オブジェクトの録音を一時停止します
    • 録音を再開：オブジェクトの録音を再開します
  • ファイルアップロードオブジェクトオプション：
    • アップロードを開始：選択したファイルのアップロードプロセスを開始します
    • ファイルをクリア：選択されたファイルを削除します
    • ファイルを選択：参加者が希望のファイルを選択できるようにします
  • カメラスナップショットオブジェクトオプション：
    • カメラを起動：参加者のカメラを起動します
    • カメラを停止：参加者のカメラをオフにします
    • アップロードを開始：スナップショットを実験にアップロードし始めます
    • スナップショットを撮影：参加者のカメラを使用して写真を撮影します

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

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

パラメータ:

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

各オブジェクトアクション

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

パラメータ:

• フィルター: ターゲットとする要素のタイプを選択します。
• 追加の名前フィルターを許可: ターゲットとなるオブジェクトの名前を入力します。同じ名前のオブジェクトがフレームに複数ある場合に有効です。
• アクションシーケンス: 選択した要素に何が起こるかを通常のアクションリストから選択できます。ターゲットとして「CurrentObject」を選択すると、上記の指定された基準に一致するすべての要素にこのアクションを適用します。

変数アクション

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

以下の表は、Labvancedで利用可能なすべての変数アクションオプションについての概要を提供します。それぞれについては、次のセクションでより詳しく説明します。

変数アクションオプション	説明
Set / Record Variable	変数値を記述または設定します
Copy to Clipboard	変数値をコンピュータの内部クリップボードにコピーします。
Draw Random Number	1つまたは複数の乱数を生成し、それを変数に保存します
Get URL Parameter	参加者のユニークなURLから値を保存します
Read from / Write to Device	ローカルデバイスのストレージに対して変数を読み書きします。このアクションは、データをLabvancedサーバーに送信するのではなく、参加者のデバイスにデータを保存します。
Read from / Write to Shared Variable	研究のセッション間で共有される変数に読み書きします。変数はすべての参加者と共有することも、各個人にプライベートにすることもできます。
Math & Statistics	入力変数（配列）の数学的演算を実行し、その結果を出力変数に保存します。
Record Variables Instantly	すべての変数値のスナップショットを作成し、これをLabvancedサーバーに送ります。
Moving Average Filter	一部の入力の移動平均（データの常に更新される平均）を計算し、その結果を新しい変数に保存します。
Distribute Variable	他の参加者に値を送ります。その値は変数に保存されます。

セット / レコード変数アクション

「セット / レコード変数」アクションは、Labvancedのすべての実験で使用されるべきものであり、これは値や行動測定が保存および記録される方法です。

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

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

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

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

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

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

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

乱数を生成するアクション

効果: 1つまたは複数の乱数を生成し、それを変数に保存します

パラメータ:

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

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

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

パラメータ:

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

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

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

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

パラメータ:

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

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

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

共有変数に読み書きするアクション

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

パラメータ:

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

使用例：縦断的/複数セッション研究

• このアクションを使用すると、参加者特有のデータをセッション間で引き継ぎ、セッション間で参加者間で共有することができます。
• 例えば、このアクションを使用してテストのスコアを記録し、その後参加者がテストを完了した他の参加者の平均スコアと自分のスコアを比較できるようにすることができます。
• 別の例（デバイスへの読み書きアクションに似ています）は、参加者が配列から気に入った5つの画像を選ぶタスクを実行し、その後別のセッションで再度その5つの画像を提示することです。このアクションの違いは、他の参加者に選ばれた画像を見せたり、他の参加者の選択肢からその画像を除外したりできる点です。

数学および統計アクション

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

パラメータ：

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

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

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

パラメータ：なし

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

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

パラメータ：

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

変数を分配アクション

変数分配アクションは、Labvancedでの複数ユーザー研究に不可欠です。 このアクションを使用すると、変数の値を参加者間で共有でき、刺激の位置や変更内容を参加者の画面に反映させることができます。

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

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

変数分配とチャットボックス機能を組み込んだデモはこちらでご覧ください：画像説明タスクとチャット追加機能。

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

メニュー項目	メニューエリア	変数分配アクションオプションと説明
Distribute value to		値が送信される他の参加者を選択します。 すべての参加者: この値をすべての参加者に送信します 選択した参加者: 選択した参加者に値を送信します。
Choose target variable and value		対象変数: 値が保存される対象変数を選択します。 値: 他の参加者に送信する値を決定します。
Block		有効にすると、現在の値の分配が完了するまで対象変数は変更できません。
Rate Limit Strategy		レート制限戦略は、実験がサーバーを上回るのを防ぐための方法であり、リクエスト（すなわち、変数分配を介した更新）がサーバーに送信される速度を制御するための予防策として機能します。以下の戦略オプションが利用可能です： ディバウンス: このアクションが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つのIf / Else-Ifステートメントが肯定的に評価される（真を返す）場合、Thenブロック内のアクションが実行され、残りの要件アクションはスキップされます。
• Elseケースを追加（真/偽）: 有効にすると、要件アクションにデフォルト/フォールバックオプションが追加されます。If / Else-Ifステートメントが実行されなかった場合（真を返さなかった場合）、elseケースで定義されたアクションが実行されます。

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

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

パラメータ:

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

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

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

パラメータ:

• 遅延タイプ: 固定遅延または可変遅延のいずれかを選択
  • 固定遅延: アクションは固定遅延の後に実行されます。
  • 可変遅延: アクションは（数値）変数で指定された遅延の後に実行されます。
• 遅延: ミリ秒（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に送信される「変数」値と、関連するメッセージの「役割」を示す必要があります： システム: ChatGPTシステムを指します。 ユーザー: 参加者 **アシスタント:**システム内で作成された特定のサブロールを指します。

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

コードアクション

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

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

JavaScriptを実行するアクション

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

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

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

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

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

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

貼り付けアクション

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

値選択メニュー

特定のイベントで作業していると、ペンアイコンが表示されることに気付くでしょう。これが値選択メニューと呼ばれるもので、記録されるべき値や追跡されるべき値の種類を選択して指示することを可能にします。これは、あなたの実験デザインと設定で使用することになる非常に強力で重要なオプションです。

このペンアイコン/値選択メニューは、セット/記録変数アクション、オブジェクトプロパティを設定するアクション、要件（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 値、および Set / Record Variable アクションを使用して [X,Y] 配列を記録します。

以下は、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)	残りの参加者数 トリガータイムスタンプ（ユニックス時間） トリガー時間（フレームオンセットから）

トリガー (マウス) の値

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

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

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

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

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

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

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

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

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

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

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

トリガー (アイ・トラッキングの視線) の値

アイ・トラッキング視線トリガー が使用される場合、特定のアクションを実行する際に呼び出すことができる次のトリガー固有の値があります:

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

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

アイ・トラッキング注視トリガー が使用される場合、特定のアクションを実行する際に呼び出すことができる次のトリガー固有の値があります:

詳細を学ぶ: 固定検出を有効にし、固定データを記録し、実用的な例については、専用の Eyetracking Fixation Trigger ページを参照してください。

トリガー (頭の追跡) 値

Head Tracking trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Task Init Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Frame Init Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Frame Start Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Frame End Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

トリガー (変数値が変更された) 値

Variable Value Changed Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Media Object Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

トリガー (Websocket トリガー) 値

WebsSocket Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

OpenAI Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

トリガー (PostMessage 受信) 値

PostMessage Received trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Pause / Resume Experiment Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。

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

Participant Left Multiuser Study Trigger が使用されると、特定のアクションを実行するときに呼び出すことができるトリガー固有の値は次のとおりです。