設定
このドキュメントは、Labvancedの研究レベルの設定と機能の包括的な概要を提供します。コア研究情報、参加者コントロール、デバイスとソフトウェアの要件、参加者管理、生理学的測定、および任意の高度な機能の設定方法を説明し、研究者が実験を効果的に設定、カスタマイズ、管理できるよう支援します。
メイン
設定
研究ID
研究のためのユニークな識別子。'マイ研究'ページにも表示されます。サポートに問い合わせる際は、常にこのIDを提供してください。
内部研究名
内部研究名は、研究を整理するために'マイ研究'ページで見ることができる名前です。
公共研究名
公共研究名は、研究がロードされる間に参加者に表示される名前です。
ローディング画像
ローディング画像は、研究がロードされる間に参加者に表示されるオプションの画像です。
背景色
背景色は、画面の占有されていない部分の色です。目の追跡研究の場合、研究の背景色が目の追跡タスクの背景色と一致することを確認することが重要です。
タイムゾーン (UTC)
これは、研究のタイムゾーンを決定します。UTCからのオフセットとして定義されます。
メイン言語
この設定は、参加者に表示される研究のメイン言語を示します。複数の言語が有効になっている場合は、開始時に言語選択オプションが表示されるか、URLパラメータを通じて表示される言語を事前に定義できます。
静的 / システムテキスト言語
この設定は、参加者に対して表示されるシステムメッセージ / 静的文字列の言語を示します。これらの文字列はテキスト&翻訳タブでカスタマイズできます。
複数の言語
研究が複数の言語に定義されているかどうかを示します。
目の追跡研究
研究が目の追跡をアクティブにしているかどうかを示します。
縦断的デザイン
研究が縦断的(参加者ごとの複数セッション)として定義されているかどうかを示します。
マルチユーザー研究
研究がマルチユーザー / リアルタイムマルチプレイヤー実験として定義されているかどうかを示します。
デバイスの優先設定
この設定を変更することで、他の研究設定がそれに応じて調整されます。例えば、「モバイル最適化」を選択すると、新規作成されたフレームのデフォルトサイズがモバイルサイズ(縦向き)になります。
オフライン互換性
研究がLabvancedデスクトップおよび電話アプリで提供されるオフラインモードと互換性があるかどうかを示します。オフライン互換性のある研究は、インターネット接続なしでダウンロードして実行できます。
オフラインモードのロック
研究をオフライン互換モードにロックすると、オフラインモードでサポートされている機能のみが使用されることが保証されます。インターネット接続なしで実行されることを意図した研究には推奨されます。
JavaScriptコードの実行
JavaScriptコードの実行をネイティブ形式またはサンドボックス環境内で許可することで、セキュリティを向上させることができます。詳細を学ぶ。
デフォルト
デフォルトフォントサイズ (Px)
作成する新しいテキスト要素に適用される好みのフォントサイズをピクセル単位で設定します。
デフォルトボタン色
作成する新しいボタン要素に適用される好みのボタン色を設定します。
デフォルトボタンホバー色
作成する新しいボタン要素に適用される好みのボタンホバー色を設定します。
デフォルトフレームサイズ
この設定は、研究のフレームのデフォルト寸法(横向きまたは縦向き)を制御します。カスタムを選択した場合、レンダリングと表示の処理を制御するために表示モードを変更することもできます。詳細については、ドキュメントを参照してください。
共有編集アクセス
ユーザーを研究に招待
他のユーザーにこの研究の編集アクセスを付与するには、彼らのメールアドレスまたはユーザー名を入力します。彼らは通知を受け、編集アクセスのリクエストを受け入れる必要があります。信頼できるユーザーにのみ編集アクセスを許可するべきです。研究の管理者のみが、新しいユーザーを編集に招待できます。
編集権限を持つユーザーのリスト
このセクションでは、あなたの研究に編集アクセスを許可されているユーザーのリストが表示されます。"アクセスを取り消す"ボタンをクリックすることで、任意のユーザーのアクセスを取り消すことができます。アクセスを持つユーザーは、研究の管理者にだけ表示されます。
実験ライブラリを開く
実験ライブラリの研究
Labvanced公衆実験ライブラリは、誰でも利用できる無料でオープンサイエンス/オープンマテリアルのリソースです。Labvancedチームと他の研究者が研究コミュニティと共有することを選んだ研究のコレクションが含まれています。
実験ライブラリの研究リンク
Labvanced公衆実験ライブラリにおけるあなたの研究のURL。レビュアー、同僚、およびコミュニティの他の人々と研究を共有するためにこのリンクを使用できます。
研究のインポートルール
この設定は、他のユーザーがLabvanced公衆実験ライブラリから研究デザインをインポートできるかどうかを制御します。あなたの作業を共有すること(公開前または公開後)は、透明性を高め、他の人があなたの作業を基に構築できるようにします。
誰でもあなたの記録データと研究セットアップを検査できるようにする(閲覧アクセスのみ)
この設定は、誰でもあなたの記録データと研究セットアップを見ることができるようにし、変更を加えることはできません。これは、オープンサイエンスと透明性のために最も便利です。
実験ライブラリ用設定:
研究が公開されているか(必須)
研究が公開されており、参加者の募集に利用可能かどうかを示すフラグ。
研究の持続時間(必須)
参加者が研究全体を完了するのにかかる時間の見積もり。この情報はLabvanced実験ライブラリにのみ表示されます。
あなたの所属機関(必須)
あなたが正式に関連付けられている学術機関や研究機関を指します。例えば、大学、研究センター、または企業など。この情報はLabvanced実験ライブラリにのみ表示されます。
研究キーワード(必須)
これらは、研究者が研究を見つけやすくし、Labvanced実験ライブラリ内でカテゴリに分けやすくするために研究に関連付けられる記述的な単語やフレーズです。好きなカスタムキーワードを追加できます。
説明(オプション)
このテキストフィールドでは、研究について紹介し、詳細を提供できます。この説明はLabvanced実験ライブラリと実験のロード中に表示されます。
関連する出版物(オプション)
これは、研究者が公衆実験ライブラリで研究を共有する際に、学術引用を研究に追加できるようにします。
コントロール
実験のスタートアップ
すべての実験ファイルを事前ロード
これは、研究が始まる前に参加者のブラウザに必要なすべてのメディアファイル(画像、音声、動画など)をロードするプロセスです。刺激がスムーズでタイムリーに提示されることを保証するためにベストプラクティスです。大量のメディアファイルがある研究の場合は、このオプションを無効にすることをお勧めします。
ファイルロードエラー時の対応
この設定は、リソースファイル(画像や音声ファイルなど)が研究開始前にロードできなかった場合に何が起こるかを決定します。"実験中止"を選択した場合、実験は終了し、参加者は参加できなくなります。
Labvanced同意書の表示
このオプションを有効にすると、実験開始前にLabvanced同意書を表示できます。
カスタム同意書の表示
このオプションを有効にすると、実験開始前にカスタム同意書を表示できます。このカスタム同意書は、テキスト&翻訳タブを通じて変更できます。"開始"セクションに移動し、"customConsent"フィールドを編集します。
初期調査を表示
初期調査は、実験開始前に(オプションで)表示される特別に定義された調査です。これが有効になっている場合、初期調査のデータは、参加者のバランスを取るために使用されます(例えば、性別、年齢などに基づいて参加者をグループに割り当てるため)。事前調査の回答に基づいてよりカスタマイズされたグループ割り当てが必要な場合、最初に参加者を1つのグループにのみ割り当て、その後"グループ変更アクション"を使用してそのグループを変更する必要があります。詳細については、ドキュメントをご覧ください。
ウェブカメラアクセスの要求
このフラグは、実験開始時に参加者のウェブカメラへのアクセスを要求するかどうかを示します。参加者は、自身のウェブカメラを共有することに同意する必要があります。
マイクへのアクセスを要求
このフラグは、実験開始時に参加者のマイクへのアクセスを要求するかどうかを示します。参加者は、自身のマイクを共有することに同意する必要があります。
画面アクセスの要求
このフラグは、実験開始時に参加者の画面を録画することを要求するかどうかを示します。参加者は、自身の画面を共有することに同意する必要があります。
実験言語選択の表示
このフラグは、研究が複数の言語で利用可能であり、参加者が実験開始時に希望する言語を選択するよう促されるかどうかを示します。
画面
フルスクリーンで研究を開始
このオプションは、研究がフルスクリーンモードで開始され、参加者に全画面スペースを利用した没入型の体験を提供します。
フルスクリーンを終了した際に一時停止
このオプションは、参加者がフルスクリーンモードを終了した場合に研究が一時停止されるようにし、参加者が集中し、重要なコンテンツや指示を見逃さないようにします。
ブラウザタブを終了した際に一時停止
このオプションは、参加者がブラウザタブから離れた場合に研究が一時停止されるようにし、参加者が研究に集中し続け、参加者が存在しない間に研究を完了しようとすることを回避します。
必要なリフレッシュレートを設定 (Hz)
これは、研究を実行するために参加者のデバイスに必要な最小モニターリフレッシュレートを指定するための設定です。この機能は、視覚刺激の正確なタイミングが重要な実験にとって重要です(例えば、刺激が100ms未満で表示される場合)。
許可される画面の向き
この設定では、研究中に参加者が使用できる画面の向きを指定できます。これは、タブレットやスマートフォンなどのモバイルデバイスで実行されることを意図した研究に特に重要です。
ダークモードテーマの防止
有効にすると、参加者が研究参加中にデバイスでダークモードテーマを使用するのを防ぎます。これは、特にモバイルデバイスで表示の問題を防ぐのに特に有用です。
画面サイズ:
画面サイズの測定(カードキャリブレーション)
有効にすると、参加者は標準化されたカード(85.60 x 53.98 mm)を使用して画面サイズをキャリブレーションするよう求められます。このキャリブレーションは、視覚刺激が正しいサイズで(mmまたは視覚度で)表示されることを保証するために使用されます。これは、精密な視覚測定を必要とする実験にとって重要です。
デフォルトの画面距離 (cm)
これは、画面に提示される刺激の視覚角度を推定するために使用される設定です。これは、参加者の目とモニターの間の距離をセンチメートル単位で示します。
最小画面サイズの設定
この設定では、研究の最適な表示と機能性を確保するために、デバイスに対する最小画面サイズの要件を定義できます。 ピクセル単位 ピクセルでの最小画面サイズ。 ミリメートル単位 ミリメートルでの最小画面サイズ(画面サイズの測定が必要です) 視覚度単位 視覚度での最小画面サイズ(画面サイズの測定と画面距離の推定が必要です)
ソフトウェアとデバイス
許可されるソフトウェア:
Labvanced電話アプリ
Labvancedモバイルアプリは、データ収集をネイティブな電話アプリケーション内で可能にするAndroidデバイス用のアプリケーション(iOSサポートは計画中)です。オフラインでデータを収集するモードも含まれています。詳細を学ぶ。
Labvancedデスクトップアプリ
Labvancedデスクトップアプリは、研究者のローカルコンピュータにLabvancedプラットフォームの機能を持ち込むためのダウンロード可能なアプリケーション(Windows、Mac、Linux用)で、オンラインおよびオフラインデータ収集を可能にします。また、EEGやその他の生理データ収集を可能にするためにLab Streaming Layer(LSL)と統合されています。詳細を学ぶ。
ブラウザ
ウェブブラウザ経由での参加を許可することで、オンライン / リモート参加を有効にします。各ブラウザを有効または無効にできます。
Google Chrome
参加者がGoogle Chromeを使用できるようにします。
Mozilla Firefox
参加者がMozilla Firefoxを使用できるようにします。
Microsoft Edge
参加者がMicrosoft Edgeを使用できるようにします。
Opera
参加者がOperaを使用できるようにします。
Safari
参加者がSafariを使用できるようにします。
その他
参加者がその他のブラウザを使用できるようにします。
許可される参加デバイス:
Androidモバイル
参加者がAndroidの携帯電話を使用できるようにします。
Androidタブレット
参加者がAndroidのタブレットを使用できるようにします。
iPhone
参加者がiPhoneを使用できるようにします。
iPad
参加者がiPadを使用できるようにします。
Windows PC
参加者がWindows PCを使用できるようにします。
Mac
参加者がMacを使用できるようにします。
Linux PC
参加者がLinux PCを使用できるようにします。
その他のデバイス
参加者がその他のデバイスを使用できるようにします。
ヘッドフォンチェック
参加者がヘッドフォンを着用しているかどうかをテストするために、これを含めることができますまたはこのブロックをあなたの研究に追加できます。
参加者
再参加
縦断的デザイン
縦断的デザインは、参加者が同じ研究に異なる時間に繰り返し参加できることを意味します。このためには、少なくとも1つのグループが複数のセッションを含む必要があります。
参加者の再参加を防止
これは、参加者が同じ研究に何度も参加できるかどうかを制御します。参加者が研究を再度実施するのを防ぐために、LabvancedはURLにユニークな参加者識別子が必要です。「subject_code」、「token」、または「Prolific_PID」パラメータのいずれかを使用できます。詳細を読む。
完了時に防止
このオプションは、参加者が研究を完了した後に同じ研究に再参加するのを防ぎます。
未完了時に防止
このオプションは、参加者が研究を開始したが以前に研究を完了しなかった場合、同じ研究に再参加するのを防ぎます。参加者があなたの研究の刺激/コンテンツを以前に見たことがないことが重要な場合、このオプションを有効にする必要があります。なお、技術的な理由や研究デザインのエラーにより、参加者が研究を完了できない場合、クラウドソーシングプラットフォームで苦情が発生する可能性があります。そのため、研究を完了できなかった参加者にも公正に補償する必要があります。
参加者バランシング
マルチグループデザイン
マルチグループデザインでは、研究内で参加者を異なるグループ(例:対照群と実験群)に割り当てることができます。詳細を学ぶ。
タイムアウトに基づく参加者の廃棄
これを有効にすると、参加者が実験を完了するのに時間がかかりすぎた場合、その参加者がタイムアウトしたとフラグ付けされます。これは、完了したデータセット/参加者をグループ間でバランスを取るために重要です。タイムアウトした参加者のデータもデータエクスポートで利用可能です。
タイムアウト(分)
参加者がタイムアウトと見なされるまでの時間を指定します。これは、平均参加時間の30-50%上昇したべきです(つまり、この参加者が研究を完了しないということを比較的確信している必要があります)。
タイムアウトしたおよび手動で廃棄された参加者の番号を置き換える
これを有効にすると、タイムアウトした参加者と手動で廃棄された参加者の番号が新しい参加者に割り当てられます。このオプションを有効にすると、"Subject_Nr"または"Subject_Nr_Per_Group"変数、またはタスク内の参加者間因子を使用している場合、参加者のバランスをさらに改善します。詳細を学ぶ。
生理学
一般設定
生理学ツールボックスのバージョン
研究で使用されるLabvanced生理学ツールボックスのバージョンを示します。(以前は目の追跡バージョンと呼ばれていました)。
複数のカメラを選択することを許可
参加者が好みのカメラデバイスを選択できるようにします。
目の追跡
この機能により、研究者は実験内でウェブカメラベースの目の追跡を有効にすることができます。Labvancedのウェブカメラベースの目の追跡技術は、精度と使いやすさの面で先導しており、複数の研究と出版物で検証されています。詳細を学ぶ。
頭の追跡
この機能は、参加者のウェブカメラを使用して頭と顔の動きを追跡することを可能にし、研究者が頭の動きを監視および分析し、研究中に詳細なフェイスメッシュデータを取得できるようにします。詳細を学ぶ。
心拍数検出
この機能は、リモート光容積脈波(rPPG)を使用してウェブカメラ映像から心拍数を検出できるようにし、研究者が物理センサーなしで参加者の心拍数を監視できます。この実装は、Wang et al.によって提案された時間-空間状態空間の二重性原理に基づいています。詳細情報: ホワイトペーパーを読む。
研究開始時にRPPGを初期化
RPPGは、時間経過での加重平均を計算することにより機能し、初期化には10秒以上かかる場合があります。この設定をアクティブにすると、メインタスクが開始される前にRPPG測定が準備されていることを保証するのに役立ちます(最初のタスクでRPPGを有効にした場合を除く)。詳細を学ぶ
心拍数信頼度を待つ
これを有効にすると、研究は心拍数検出が指定された信頼度レベルに達するまで待機します。実験中に心拍数の信頼度が指定された閾値を下回った場合、研究は一時停止されます。これは、心拍数データが信頼できることを確認するのに役立ちます。
特別機能
音声録音
音声録音を有効にして、研究中に参加者の口頭応答や周囲の音をキャプチャします。詳細を学ぶ。
複数のマイクを選択できるようにする
音声録音のために、参加者が好みのマイクデバイスを選択できるようにするためにこのボックスをチェックします。
音声転写(AIベース)
この機能は、研究中に収集された音声録音の自動転写をAIアルゴリズム(Whisper AI)を使用して有効にします。詳細を学ぶ。
転写モデル
転写に使用されるモデルを選択します。小型モデルは高速ですが精度が低く、大型モデルは精度が高いですが遅くなります。大型モデルは参加者のデバイスにダウンロードされる必要があるため、実験のスタートアップ時間が長くなることに注意してください。選択肢:
- スピード最適化(小型モデル)
- 精度最適化(大型モデル)
エンドツーエンド暗号化
この機能は、参加者によってアップロードされたすべてのバイナリファイル(例:動画、音声)が送信される前にデバイス上で暗号化されることを保証し、データセキュリティとプライバシーを向上させます。
ゲームパッド統合
この機能により、研究中にゲームパッドやジョイスティックを入力デバイスとして使用できるようになります。詳細を学ぶ。
ジェネレーティブAI統合
この機能により、大規模言語モデル(つまり、chatGPT)や他の生成的AIモデルを研究に利用して、高度なAI機能を実現できます。詳細を学ぶ。
Lab Streaming Layer (LSL)
この機能により、リアルタイムデータストリーミングのためにLab Streaming Layer (LSL)プロトコルと統合できます。デスクトップアプリでのみサポートされています。詳細を学ぶ。
マルチユーザー研究
マルチユーザー研究は、複数の参加者間でリアルタイムの相互作用を可能にするオンライン実験の一種です。詳細を学ぶ。
画面録画
この機能により、研究中に参加者の画面上の活動をキャプチャするために画面録画が可能になります。詳細を学ぶ。
ビデオ会議
この機能により、"Stream.IO"統合を使用して研究内でビデオ会議機能を有効にします。詳細を学ぶ。
APIキーを選択
ビデオ会議を有効にするために使用するAPIキーを指定します:
- Labvanced APIキーを使用
- StreamIOから自分のAPIキーを使用(この設定方法については上記のリンクを参照)
ビデオ録画
この機能により、参加者の顔や視覚的周囲をキャプチャするためにウェブカメラ/ビデオ録画が可能になります。詳細を学ぶ。
複数のカメラを選択することを許可
参加者がビデオ録画のために好みのカメラデバイスを選択できるようにします。
ビデオ解像度を選択
ビデオ録画の希望する解像度を選択します。高解像度はファイルサイズが大きくなります。また、目の追跡を有効にしている場合は、高解像度を選択すると目の追跡アルゴリズムのパフォーマンスに悪影響を与えることに注意してください。利用可能な解像度:
- 960 x 720ピクセル
- 1280 x 720ピクセル
- 1920 x 1080ピクセル(フルHD)
ビデオビットレートを選択
ビデオ録画の希望するビットレートを選択します。高ビットレートは品質が向上しますが、ファイルサイズが大きくなります。利用可能な選択肢:
- デフォルト
- 高
- 非常に高
可能な場合はMp4を使用
ブラウザがそれをサポートしている場合、ビデオはmp4形式で録画されます。そうでない場合、webm形式で録画されます。
Webhook API
このオプションを有効にすると、録音された研究データを選択した外部サーバにWebhook APIを介して送信します。APIドキュメントを見る。
Websocket接続
同じコンピュータに接続されている外部サーバまたは他の録音デバイスへの接続を有効にします。詳細を学ぶ。