labvanced logoLabVanced
  • Research
    • Publications
    • Researcher Interviews
    • Use Cases
      • Developmental Psychology
      • Linguistics
      • Clinical & Digital Health
      • Educational Psychology
      • Cognitive & Neuro
      • Social & Personality
      • Arts Research
      • Sports & Movement
      • Marketing & Consumer Behavior
      • Economics
      • HCI / UX
      • Commercial / Industry Use
    • Labvanced Blog
    • Services
  • Technology
    • Feature Overview
    • Code-Free Study Building
    • Eye Tracking
    • Mouse Tracking
    • Generative AI Integration
    • Multi User Studies
    • More ...
      • Reaction Time/Precise Timing
      • Text Transcription
      • Heart Rate Detection (rPPG)
      • Emotion Detection
      • Questionnaires/Surveys
      • Experimental Control
      • Data Privacy & Security
      • Desktop App
      • Mobile App
  • Learn
    • Guide
    • Videos
    • Walkthroughs
    • FAQ
    • Release Notes
    • Documents
    • Classroom
  • Experiments
    • Cognitive Tests
    • Sample Studies
    • Public Experiment Library
  • Pricing
    • Licenses
    • Top-Up Recordings
    • Subject Recruitment
    • Study Building
    • Dedicated Support
    • Checkout
  • About
    • About Us
    • Contact
    • Downloads
    • Careers
    • Impressum
    • Disclaimer
    • Privacy & Security
    • Terms & Conditions
    • Third-Party Licenses
  • Appgo to app icon
  • Logingo to app icon
Learn
ガイド
ビデオ
ウォークスルー
よくある質問
ニュースレターアーカイブ
ドキュメント
教室
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
ガイド
ビデオ
ウォークスルー
よくある質問
ニュースレターアーカイブ
ドキュメント
教室
  • 中國人
  • Deutsch
  • Français
  • Español
  • English
  • 日本語
  • ガイド
    • はじめに

      • タスクエディタ
      • 刺激の提示
      • 反応の正確性
      • オブジェクト
      • イベント
      • 変数
      • タスクウィザード
      • トライアルシステム
      • 研究デザイン
        • タスク
        • ブロック
        • セッション
        • グループ
    • 特集トピック

      • 実験デザイン
        • スタディの作成
        • データフレームのパターン
      • ランダム化とバランス
      • 視線追跡
      • アンケート
      • デスクトップアプリ
      • サンプル研究
      • 参加者の募集
      • APIアクセス
        • REST API
        • Webhook API
        • WebSocket API
      • その他のトピック

        • 正確な刺激のタイミング
        • マルチユーザー研究
        • Labvancedにおけるヘッドトラッキング | ガイド
    • メインアプリタブ

      • 概要: メインタブ
      • ダッシュボード
      • 私の研究
      • 共有研究
      • 私のファイル
      • 実験ライブラリ
      • マイアカウント
      • ライセンスとサービス
    • 研究タブ

      • 概要: 研究特有のタブ
      • 研究デザイン
        • タスク
        • ブロック
        • セッション
        • グループ
      • タスクエディタ
        • タスクコントロール
        • 試行システム
        • キャンバスとページフレーム
        • オブジェクト
        • オブジェクトプロパティテーブル
        • 変数
        • システム変数テーブル
        • イベントシステム
        • テキストエディタの機能
        • タスクにおけるアイ・トラッキング
        • タスクにおける頭追跡
        • マルチユーザー研究
      • 設定
      • 変数
      • メディア
      • テキストと翻訳
      • 開始と参加
      • 被験者管理
      • データビュウとエクスポート
        • Dataview と変数 & タスクの選択 (古いバージョン)
        • 録音へのアクセス (古いバージョン)
  • ビデオ
    • ビデオ概要
    • Labvancedの使い方
    • タスクの作成
    • 要素ビデオ
    • イベントと変数
    • 高度なトピック
  • 手引き
    • イントロダクション
    • ストループ課題
    • 語彙判断課題
    • ポズナーの視線キュー課題
    • 変化盲点フリッカーパラダイム
    • 眼球追跡サンプル研究
    • 乳児の眼球追跡研究
    • マウストラッキングによる注意喚起研究
    • 迅速な系列視覚提示
    • ChatGPT研究
    • 眼球追跡デモ:SVGをAOIとして使用
    • マルチユーザーデモ:被験者のカーソルを表示
    • ゲームパッド / ジョイスティックコントローラー - 基本セットアップ
    • EEG統合付きデスクトップアプリ研究
    • 被験者間グループのバランス調整と変数設定
  • FAQ
    • 機能
    • サポートポリシーとガイドライン
    • セキュリティとデータプライバシー
    • ライセンス
    • Labvancedの精度
    • プログラム的利用とAPI
    • Labvancedをオフラインで使用する
    • トラブルシューティング
    • 研究作成に関する質問
  • ニュースレターアーカイブ
  • 文書
  • 教室

値選択メニュー

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

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

Labvanced における値選択の位置。

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

Labvanced の値選択メニュー

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

メニューオプション

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

カテゴリオプション説明
Trigger-specific過去にイベントのために選択したトリガーの種類に依存します。イベントのために選択したトリガーに基づいて、値選択メニューの上部に選択肢が表示されます。オプションの完全なリストと説明については、トリガー固有の値のセクションを参照してください。
Current Time
  • UNIX タイムスタンプ
  • フレーム開始からの時間
時間値の測定と呼び出し。
Constant Value
  • 文字列
  • 数値
  • ブール値
  • カテゴリカル
  • 日付
  • 時間
  • 色
文字列や数値など、必要に応じた変数のタイプに基づいて定数値を割り当てます。これらは時々、カウンターを作成するために Arithmetic のような他のオプションと組み合わせて使用されます。
Variable
  • 変数を選択
  • 配列から値を選択
  • データフレームから値を選択
変数を指定または参照したり、配列やデータフレームから値を選択したりします。
Frame / Task / Object
  • オブジェクトプロパティ
  • フレーム
  • 目の追跡
  • デバイス
オブジェクトプロパティ、フレーム、目の追跡(有効にされている場合)、およびデバイス(画面のリフレッシュレート)に関連付けられた値を取得できます。
Operations
  • 算術
  • 文字列操作
  • 数学操作
変数の値を結合したり、文字列をすべて小文字に変換したり、数学的操作を実行したりするなど、変数に対して特定の変更を行うために操作を使用します。

現在の時間値

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

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

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

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

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

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

この値は、フレームの開始から経過した時間をキャプチャします。ほとんどの場合、これは反応時間に相当します。

定数値

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

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

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

定数: 文字列

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

定数: 数値

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

定数: ブール値

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

定数: カテゴリカル

レベル値を割り当てます(主にファクター用)。

定数: 日付

日付値を割り当てます。

定数: 時間

時間値を割り当てます。

定数: 色

色(16進数字符串)の値を割り当てます。

変数値

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

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

変数を選択

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

配列から値を選択

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

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

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

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

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

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

オブジェクトプロパティ

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

フレーム

フレーム値オプション説明
Last cached Mouse X Position参加者のマウスの最後の X 座標値。
Last cached Mouse Y Position参加者のマウスの最後の Y 座標値。
Last cached Mouse [X,Y] Array参加者のマウスの最後の [X,Y] 座標値を配列形式で。
Frame Nameフレームの名前。

目の追跡

目の追跡値オプション説明
Last cached Coordinate X参加者の視線の最後の X 座標値。
Last cached Coordinate Y参加者の視線の最後の Y 座標値。
Last cached Coordinate [X,Y] Array参加者の視線の最後の [X,Y] 座標値を配列形式で。
Last cached Coordinate + Time [X,Y,T] Array参加者の視線の最後の [X,Y] 座標値、およびカメラキャプチャ T 値を含む配列形式。

デバイス

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

操作

操作を使用して変数に対して特定の変更を行います。これには、変数の値を結合したり、文字列をすべて小文字に変換したり、数学的操作を実行したりすることが含まれます。

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

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

算術

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

Labvanced の算術メニュー。

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

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

Labvanced における算術オプションの場所。

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

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

以下の例は、算術演算を利用して新しい文字列変数(緑のボタン内)「intermediateVar」を作成する方法を示しています。

算術演算を使用して新しい文字列変数を作成する例。

新しい変数の値(「intermediateVar」)は、いくつかの算術演算を使い、以前に作成した変数(例:「userChatName」および「chatInput」)の組み合わせと、定数文字列値、 つまりセミコロン:と間隔<br>を利用して定義されます。このアクションは、複数のユーザー研究で使用できるユーザーチャットの効果を作り出します。

文字列操作

文字列操作オプション説明
To Lowercase文字列変数内のすべての文字を小文字に変換します。

→ 例: (AAABBB) は (aaabbb) に変換されます。
To Uppercase文字列変数内のすべての文字を大文字に変換します。

→ 例: (aaabbb) は (AAABBB) に変換されます。
To Link変数内の文字列を他のウィンドウで開くURLに変換します。
Remove Whitespaces文字列変数内の文字の間のスペースを削除します。

→ 例: (aaa bbbb cccc) は (aaabbbbccc) に変換されます。
Trim Whitespaces文字列変数の先頭にあるスペースを削除します。

→ 例: ( aaabbbcccc) は (aaabbbcccc) に変換されます。
Replace Substring Regexp文字列値変数内の特定の文字を置き換えます。

→ 例: (aaabbbccc) は bbb を xxx に置き換え、値を (aaaxxxccc) に変換します。

数学演算

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

数学演算オプション説明
abs値の絶対数を返します。
sqrt値の平方根を返します。
round0から3桁の小数点以下の値を返します。
floor切り捨てた値を返します。
ceil切り上げた値を返します。
cosコサイン値を返します。
sinサイン値を返します。
tanタンジェント値を返します。

トリガー特有の値

トリガー特有の値は、特定のイベント内に定義されているトリガーに関連付けられた値を指します。例えば、イベントがマウストリガーを使用している場合、そのアクションが指定されている特定の領域(例: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 (Emotion Detection)
  • 最大感情
  • 最大感情スコア
  • 情動スコア
  • 唾液スコア
  • カメラキャプチャタイムT
  • [最大感情, スコア, T] 配列
  • [情動, 唾液, T] 配列
  • [すべての感情, T] 配列
  • [すべての感情, 情動, 唾液, 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 (Global Experiment Event)
  • 合計フレーム時間
  • グローバルイベントの理由
  • トリガータイムスタンプ(ユニックス時間)
  • トリガー時間(フレーム開始から)
Trigger (User Leaves Experiment)
  • 残りの参加者数
  • トリガータイムスタンプ(ユニックス時間)
  • トリガー時間(フレーム開始から)

トリガー(マウス)値

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

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

トリガー(マウス)オプション説明
Mouse Xフレーム座標での現在のマウスX位置を返します。
Mouse Yフレーム座標での現在のマウスY位置を返します。
Mouse [X,Y] Array配列形式でのマウス[X,Y]座標です。
Stimulus Nameイベントをトリガーしたオブジェクトの名前(クリックされた画像など)です。
Stimulus Infoイベントをトリガーしたオブジェクトの刺激情報です。
Trigger Timestamp (Unixtime)トリガーが発生した時のタイムスタンプ(Unix Time形式)で、ミリ秒を含みます。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生するまでの経過時間をミリ秒で測定した値です。
#### トリガー(キーボード)値
[キーボードトリガー](#keyboard-triggers)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

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

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

[ボタンクリックトリガー](#button-click-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

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

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

[入力時Enterトリガー](#enter-on-input-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

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


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

[スクロールトリガー](#scroll-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

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

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

[`Gamepad/Joystick trigger`](#gamepad-joystick-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

<p style="text-align:center;">
<img width="80%" style="padding: 10px; border:1px solid #39AECB" height="auto" loading="lazy" src="/content_imgs/learn/guide/task-editor/imgs/events/gamepad_trigger_specific.webp" alt="ゲームパッドトリガーメニューオプション">
</p>

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

#### トリガー(アイ・トラッキング・ガゼ)値

[アイ・トラッキング・ガゼトリガー](#eyetracking-gaze-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

<p style="text-align:center;">
<img src="/content_imgs/learn/guide/task-editor/imgs/events/ET_gaze_trigger_specific_values.webp" alt="ガゼトリガー値オプション" width="80%" style="border:1px solid #39AECB" height="auto" loading="lazy">
</p> 

| トリガー&nbsp;(アイ・トラッキング・ガゼ)&nbsp;オプション  | 説明  |
| :---: | --- |
| **`Coordinate X`** | ガゼのX座標の値。 |
| **`Coordinate Y`** | ガゼのY座標の値。 |
| **`Coordinate [X,Y] Array`** | ガゼの座標X,Yを配列形式で表したもの。 |
| **`Stimulus Name`** | ガゼトリガーを開始した刺激の名前。 |
| **`Stimulus Info`** | ガゼトリガーを開始した刺激の背後にある刺激情報。  |
| **`Camera Capture Time T`** | スナップショットが発生した正確な時刻。Labvancedのアイ・トラッキングパイプラインでは、カメラスナップショットが最初に発生し、その後アルゴリズムとニューラルネットワークがガゼの計算を行います。このため、`Camera Capture Time T`は初期スナップショットが発生したときのUNIXタイムスタンプです。ウェブカメラベースのアイ・トラッキングの背後にある技術に関する詳細は、弊社の[ET技術ページ](/content/technology/ja/labvanced-eye-tracking/)を参照してください。   |
| **`Gaze Confidence C`** | この値は0から1の範囲で、画像スナップショットにオープンアイが存在する可能性に対する信頼度を示しており、本質的には「瞬き検出器」として機能します。詳細については、[発表された査読論文](https://link.springer.com/article/10.3758/s13428-023-02237-8)を参照してください。  |
| **`Coord. + Time [X,Y,T] Array`** | ガゼのx/y座標とカメラキャプチャ時間(T)のタイムスタンプを含む配列。  |
| **`Coord. + Time + Confidence [X,Y, T,C] Array`** | ガゼのx/y座標とカメラキャプチャ時間(T)のタイムスタンプ、ガゼの信頼度(C)を含む配列。 |
| **`Trigger Timestamp (Unixtime)`** | ガゼトリガーが発生した時刻をミリ秒単位のUnix Time形式で表したタイムスタンプ。 |
| **`Trigger Time (From Frame Onset)`** | フレームの開始からガゼトリガーが発生するまでの経過時間をミリ秒単位で表したもの。 |

#### トリガー(アイ・トラッキング・フィキュレーション)値

[アイ・トラッキング・フィキュレーショントリガー](#eyetracking-fixation-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

| トリガー&nbsp;(アイ・トラッキング・フィキュレーション) オプション | 説明 |
| :---: | ---|
| **`Fixation Centroid X`** | フィキュレーションの中心点のX値。 |
| **`Fixation Centroid Y`** | フィキュレーションの中心点のY値。 |
| **`Fixation Duration`** | 検出されたフィキュレーションの期間。 |
| **`Fixation Start Time`** | 検出されたフィキュレーションの開始時刻。 |
| **`Fixation End Time`** | 検出されたフィキュレーションの終了時刻。 |
| **`Fixation Dispersion`** | 検出されたフィキュレーション内でのガゼ値の分散具合を示します。 |
| **`Stimulus Name`** | イベントをトリガーしたボタンオブジェクトの名前。 |
| **`Stimulus Info`** | イベントをトリガーしたボタンオブジェクトの刺激情報。 |
| **`[X, Y, Dur, Start, End, Disp]`** | 次の項目の配列:フィキュレーションの重心のxおよびy値、フィキュレーションの期間、開始時刻、終了時刻、および分散値。 |
| **`Trigger Timestamp (Unixtime)`** | フィキュレーショントリガーが発生した時刻をミリ秒単位のUnix Time形式で表したタイムスタンプ。 |
| **`Trigger Time (From Frame Onset)`** | フレームの開始からフィキュレーショントリガーが発生するまでの経過時間をミリ秒単位で表したもの。 |

#### トリガー(ヘッドトラッキング)値

[ヘッドトラッキングトリガー](#headtracking-trigger)が使用されるとき、特定のアクションで作業するときに呼び出すことができる以下のトリガー固有の値があります:

| トリガー&nbsp;(ヘッド&nbsp;トラッキング) オプション | 説明 |
| :---: | ---|
| **`Camera Capture Time T`** | カメラがフレームをキャプチャした時刻、つまりフレームキャプチャが行われたときのUnixタイムスタンプ。これは、画像/フレームがキャプチャされた後、処理が行われる前の時間です。 |
| **`Head Turn`** | 左から右への頭の回転、文献ではこれをヨーと呼びます。 |
| **`Head Tilt`** | 上から下への頭の傾き、文献ではピッチと呼ばれます。 |
| **`Head Roll`** | 頭が側面から側面に回転する動きをキャプチャします。 |
| **`Head Position [X,Y, T] Array`** | この配列は頭の位置に関連する数値をキャプチャしており、頭の中心のxおよびy座標とタイムスタンプ変数(T)が含まれています。 |
| **`Nose Position [X,Y, T] Array`** | この配列は特に鼻の位置に関連する数値をキャプチャしており、鼻がある場所のxおよびy座標と、測定が行われたときのタイムスタンプ変数(T)が含まれています。 |
| **`Nose Vector [X,Y, Z, T] Array`** | この測定は鼻の先端からベクトルを投影することで機能し、参加者が画面に注目しているかどうかをテストするのに役立ちます(これは特にアイ・トラッキングが有効になっていない研究にとって重要です)。したがって、鼻が画面外を指すと(つまり、参加者が実験に注目していない場合)、Z値は1から減少し0に接近します。 |
| **`Trigger Timestamp (Unixtime)`** | 実験中のトリガーが発生する時間点で、ヘッドトラッキングが検出された時刻を示し、システム内でトリガーが発生した時刻を考慮に入れています。本質的に、これは画像/フレーム処理が行われる時間であり、この値は参加者のグラフィックスカードによって大きく影響を受けます。理論的には、これもTの値にできるだけ近いべきです。 |
| **`Trigger Time from Frame Onset`** | トリガーが発生したときのフレームの開始に関連する時間値です。 |

トリガー (感情検出) 値

感情検出トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (感情検出) オプション説明
Max Emotion検出された最大の感情。利用可能なパラメーターを含む文字列値: angry, contempt, disgust, fear, happy, neutral, sad, surprise。
Max Emotion Score検出された Max Emotion のスコア。
Valence Score順応検出の数値スコア。
Arousal Score検出された覚醒の数値スコア。
Camera Capture Time T画像スナップショットが発生した際の調整されたタイムスタンプ値。注意: これは Trigger Timestamp よりも感情検出が発生した時のより正確なタイムスタンプであり、アルゴリズムがトリガーが開始された後に画像をキャプチャして処理するのに数ミリ秒を要します。
[Max Emotion, Score, T] Array最大感情 (文字列ラベル)、スコア (数値)、カメラキャプチャ T (ユニックス時間)の配列。
[Valence, Arousal, T] Array順応 (数値)、覚醒 (数値)、カメラキャプチャ T (ユニックス時間)の配列。
[All Emotions, T] Arrayすべての8つの感情のスコアとカメラキャプチャ T を記録します。注意: 8つの感情のスコアは互いに相対的で、合計は1になります。
[All Emotions, Valence, Arousal, T] Arrayすべての8つの感情、順応、覚醒、カメラキャプチャ T のスコアを記録します。注意: 8つの感情のスコアは互いに相対的で、合計は1になります。
Trigger Timestamp (Unixtime)ユニックス時間におけるトリガーのタイムスタンプ。より正確なタイミング値については Camera Capture Time T を参照してください。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生した時間 (ミリ秒単位)。

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

タスク初期化トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (タスク初期化時) オプション説明
Trigger Timestamp (Unixtime)トリガーのユニックスタイムスタンプ (ミリ秒)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生した時間 (ミリ秒)。

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

フレーム初期化トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (フレーム初期化時) オプション説明
TrialNrフレーム初期化トリガーが発生した際の試行番号。
Trigger Timestamp (Unixtime)トリガーのユニックスタイムスタンプ (ミリ秒)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生した際の時間 (ミリ秒)。

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

フレーム開始トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (フレーム開始時) オプション説明
Trigger Timestamp (Unixtime)トリガーのユニックスタイムスタンプ (ミリ秒)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生した際の時間 (ミリ秒)。

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

フレーム終了トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (フレーム終了時) オプション説明
Total Frame Timeフレームに費やされた合計時間 (ミリ秒単位)。
Trigger Timestamp (Unixtime)トリガーのユニックスタイムスタンプ (ミリ秒)。
Trigger Time (From Frame Onset)フレームの開始からトリガーが発生した際の時間 (ミリ秒)。

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

変数値変更トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (変数値変更時) オプション説明
New Value in Variable変数の新しい値を参照します。
Trigger Timestamp (Unixtime)変数変更トリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始から変数値変更が発生するまでの経過時間 (ミリ秒単位)。

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

メディアオブジェクトトリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (メディアオブジェクトトリガー) オプション説明
Trigger Timestamp (Unixtime)メディアオブジェクトトリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始からメディアオブジェクトトリガーが発生するまでの経過時間 (ミリ秒単位)。

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

WebSocket トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (Websocket トリガー) オプション説明
Message受信側が異なるデータタイプ間でフィルタリングできるように説明およびラベル付けに使用できるメッセージ。
Data参加者の選択、タイムスタンプ、マウスの x/y 座標など、さまざまなデータ型を保持できる値。
Trigger Timestamp (Unixtime)Websocket トリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始からWebSocketトリガーが発生するまでの経過時間 (ミリ秒単位)。

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

OpenAI トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (OpenAI トリガー) オプション説明
Chat GPT AnswerChatGPT からの回答の値。
Trigger Timestamp (Unixtime)OpenAI トリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始からOpenAIトリガーが発生するまでの経過時間 (ミリ秒単位)。

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

一時停止 / 実験再開トリガー が使用されている場合、特定のアクションに関して呼び出すことができる以下のトリガー固有の値があります。

トリガー (グローバル実験イベント) オプション説明
Total Frame Timeトリガーの前に与えられた合計フレーム時間を参照します。
Reason for Global Event参加者が研究を離れたなど、トリガーの理由を述べる文字列値。
Trigger Timestamp (Unixtime)グローバルイベントトリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始からグローバルイベントトリガーが発生するまでの経過時間 (ミリ秒単位)。

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

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

トリガー (ユーザー が 実験を 離れる) オプション説明
Remaining Number of Participants 研究に残っている参加者の数。
Trigger Timestamp (Unixtime)ユーザーが実験を離れるトリガーが発生した際のタイムスタンプ (ミリ秒単位のユニックス時間形式)。
Trigger Time (From Frame Onset)フレームの開始からユーザーが実験を離れるトリガーが発生するまでの経過時間 (ミリ秒単位)。