labvanced logoLabVanced
Contact
    • Remote Physiological Measurements
    • Eye Tracking
    • Head & Face-Tracking
    • Emotion Detection
    • Heart Rate Detection (rPPG)
    • Generative AI
    • Audio Transcription
    • EEG & Hardware Integrations
    • Decision Making
    • Reaction Times
    • Keyboard Inputs
    • Mouse Tracking
    • Mobile / Touch
    • Questionnaires
    • Gamepad / Joystick Integration
    • Audio Recordings
    • Audio Transcription
    • Video Recordings
    • Screen Recordings
    • Photos / Snapshots
    • Video Conferencing
    • Canvas Drawings
    • Build with AI
    • Build with Spreadsheets
    • Using the Experiment Editor
    • Coding
    • Creating Questionnaires
    • Balancing & Randomization
    • UX & Website Testing
    • Single Session Studies
    • Factorial Designs
    • Longitudinal & Multi-session Studies
    • Individual & Case Studies
    • Real-time Multi-user Studies
    • Interviews & Video Calls
    • Surveys & Questionnaires
    • Experience Sampling & Diaries
    • Classroom & Group Testing
    • Interventions & Clinical Trials
    • In the Browser
    • Mobile App
    • Desktop App
    • WebBridge Chrome Extension
    • Stroop Test
    • Flanker Task
    • N-back Task
    • Implicit Association Test
    • Trail Making Test
    • Digit Span
    • Corsi Block Tapping
    • Tower of London
    • Balloon Analog Risk Task
    • Preferential Looking
    • Browse more →
    • DASS-21
    • GAD-7
    • Rosenberg Self-Esteem Scale
    • PHQ-9
    • Ten-Item Personality Inventory
    • Big Five Personality Test
    • Adult ADHD Self-Report Scale
    • Browse more →
    • Building a Multi-user Study
    • Webcam Eye Tracking with AOIs
    • Website Frame Eye Tracking
    • Conditional Eye Tracking Opt-in
    • ChatGPT Study
    • Desktop App Study with EEG
    • Between-subjects Group Balancing
    • Building a Reading Study
    • Stroop Task
    • Lexical Decision Task
    • Browse more →
    Public Experiment Library
    • Arts Research
    • Clinical Psychology & Neuropsychology Medicine
    • Cognitive Psychology
    • Developmental Psychology
    • Behavioral Economics & Decision Science
    • Educational Research & Psychology
    • HCI & Human Factors
    • Linguistics & Language Sciences
    • Consumer & Marketing Research
    • Social & Personality Psychology
    • Sport & Movement Science
    • UX & Website Testing
    • Executive Functions
    • Language & Reading
    • Decision-Making & Reasoning
    • Attention
    • Overview
    • HCI & Human Factors
    • UX & Website Testing
    • Consumer & Marketing Research
    • White-Label App
    • PageGazer
    • Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela Markova
    • Eye Tracking for Influencer MarketingDr. Alexander Edeling
    • Eye Tracking Infant Word ComprehensionDr. Giulia Calignano
    • Sentence Reading and Grammar JudgmentsDr. Jonathan Mirault
    • Regulating Emotions with MusicDr. Katrin Starcke
    • Game-Based Grammar Learning in ChildrenDr. Mireia Marimon
    • Gaze Cueing and AutismMax Soares Miehstein
    • Personality and Hearing in NoiseDr. Malte Wöstmann
    • All interviews →
    • Lab Notes
    • How to Cite Labvanced
    • Labvanced Platform Paper (2017)
    • Webcam Eye Tracking Validation (2024)
    • Webcam Eye Tracking Studies
    • Cognitive Psychology Studies
    • Developmental Psychology Studies
    • Linguistics Studies
    • See all publications →
    • Getting Started
    • Guide
    • Video Tutorials
    • Walkthroughs
    • Live Chat
    • Webinars & Onboarding Calls
    • AI Assistant
    • FAQ
    • Importing Templates Guide
    • Test Templates
    • Live Eye Tracking Metrics
    • Mouse Tracking Demo
    • ChatGPT Demo
    • Audio Recording Object Demo
    • Adding Image Stimuli Demo
    • Score & Feedback Demo
    • Browse all technical demos →
    • Timing Precision
    • Stimuli Presentation
    • Headphone Checks
    • Bot Checks
    • Participant Management
    • Comparisons
    • Research Blog
    • Prolific Integration
    • CloudResearch Integration
    • Sona Systems Integration
    • BeSample Integration
    • Panelabs Integration
    • Clickworker Integration
    • Labvanced Webhook API
    • Labvanced REST API
    • About Us
    • Newsletter Archive
    • Terms & Conditions
    • Data Security & Data Privacy
    • Technical & Organisational Measures
    • Accessibility
    • W-8BEN-E Form
    • Data Processing Agreement Template
    LinkedInYouTubeDiscord
    • Individual
    • Lab
    • Department / Consortium
    • Teaching
    • Campus
    • Commercial
    Top-Ups
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • JA
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Appgo to app icon
    • Loginlogin icon
    Platform
    Labvanced makes it easy to implement the most advanced study design and reliably collect your data.
    Biosignals & AI
    Remote Physiological MeasurementsEye TrackingHead & Face-TrackingEmotion DetectionHeart Rate Detection (rPPG)Generative AIAudio TranscriptionEEG & Hardware Integrations
    Behavioral Recordings
    Decision MakingReaction TimesKeyboard InputsMouse TrackingMobile / TouchQuestionnairesGamepad / Joystick Integration
    Media Recordings
    Audio RecordingsAudio TranscriptionVideo RecordingsScreen RecordingsPhotos / SnapshotsVideo ConferencingCanvas Drawings
    Implementation Techniques
    Build with AIBuild with SpreadsheetsUsing the Experiment EditorCodingCreating QuestionnairesBalancing & RandomizationUX & Website Testing
    Study Formats

    Your study can take whatever format your research needs. Here are a few popular examples.

    Single Session StudiesFactorial DesignsLongitudinal & Multi-session StudiesIndividual & Case StudiesReal-time Multi-user StudiesInterviews & Video CallsSurveys & QuestionnairesExperience Sampling & DiariesClassroom & Group TestingInterventions & Clinical Trials
    Where Studies Run

    Run your study online in the browser, on mobile or tablet with the mobile app, or in-lab with the desktop app.

    In the BrowserMobile AppDesktop AppWebBridge Chrome Extension
    Tests
    Explore cognitive tests, questionnaires, walkthroughs, and our public experiment library: a starting point for your next study.
    Popular Cognitive Tests
    Stroop TestFlanker TaskN-back TaskImplicit Association TestTrail Making TestDigit SpanCorsi Block TappingTower of LondonBalloon Analog Risk TaskPreferential Looking
    Browse more →
    Questionnaires & Scales
    DASS-21GAD-7Rosenberg Self-Esteem ScalePHQ-9Ten-Item Personality InventoryBig Five Personality TestAdult ADHD Self-Report Scale
    Browse more →
    Public Experiment Library

    Take a look at what other researchers in the community are doing through our extensive, open catalog of shared studies.

    Open the public library →
    Walkthroughs

    Step-by-step builds of complete studies, from a blank project to a running experiment, that you can follow along or adapt.

    Building a Multi-user StudyWebcam Eye Tracking with AOIsWebsite Frame Eye TrackingConditional Eye Tracking Opt-inChatGPT StudyDesktop App Study with EEGBetween-subjects Group BalancingBuilding a Reading StudyStroop TaskLexical Decision Task
    Browse more →
    Research
    One platform for students, academics, and industry researchers studying human behavior.
    Harvard UniversityStanford UniversityCambridge UniversityUCLNYUMax Planck InstituteUCLATU Munich

    Trusted by researchers at 1,500+ universities worldwide

    Academic Research
    Arts ResearchClinical Psychology & Neuropsychology MedicineCognitive PsychologyDevelopmental PsychologyBehavioral Economics & Decision ScienceEducational Research & PsychologyHCI & Human FactorsLinguistics & Language SciencesConsumer & Marketing ResearchSocial & Personality PsychologySport & Movement ScienceUX & Website Testing
    Research Areas
    Executive FunctionsLanguage & ReadingDecision-Making & ReasoningAttention
    Industry / Commercial
    OverviewHCI & Human FactorsUX & Website TestingConsumer & Marketing ResearchWhite-Label AppPageGazer
    Researcher Interviews

    Conversations with researchers about the studies they ran with Labvanced, what worked, and what they learned.

    Webcam vs. Lab Eye Tracking in InfantsAnna Banki & Gabriela MarkovaEye Tracking for Influencer MarketingDr. Alexander EdelingEye Tracking Infant Word ComprehensionDr. Giulia CalignanoSentence Reading and Grammar JudgmentsDr. Jonathan MiraultRegulating Emotions with MusicDr. Katrin StarckeGame-Based Grammar Learning in ChildrenDr. Mireia MarimonGaze Cueing and AutismMax Soares MiehsteinPersonality and Hearing in NoiseDr. Malte Wöstmann
    All interviews →
    Our Research
    Lab NotesHow to Cite Labvanced
    Peer Reviewed Studies

    A selection of peer-reviewed work built on Labvanced: our own platform and validation papers, and studies by the research community grouped by area. Hundreds more are listed on the full publications page.

    Labvanced Platform Paper (2017)Webcam Eye Tracking Validation (2024)Webcam Eye Tracking StudiesCognitive Psychology StudiesDevelopmental Psychology StudiesLinguistics Studies
    See all publications →
    Resources
    Valuable resources to help you learn the platform, stay updated, and more.
    Documentation
    Getting StartedGuideVideo TutorialsWalkthroughs
    Support
    Live ChatWebinars & Onboarding CallsAI AssistantFAQ
    Templates & Demos

    These are a few popular examples. Browse our guide and a selection of technical demos to get started with implementation.

    Importing Templates GuideTest TemplatesLive Eye Tracking MetricsMouse Tracking DemoChatGPT DemoAudio Recording Object DemoAdding Image Stimuli DemoScore & Feedback Demo
    Browse all technical demos →
    Methodology
    Timing PrecisionStimuli PresentationHeadphone ChecksBot ChecksParticipant ManagementComparisonsResearch Blog
    Integrations & APIs
    Prolific IntegrationCloudResearch IntegrationSona Systems IntegrationBeSample IntegrationPanelabs IntegrationClickworker IntegrationLabvanced Webhook APILabvanced REST API
    Company & Legal
    About UsNewsletter ArchiveTerms & ConditionsData Security & Data PrivacyTechnical & Organisational MeasuresAccessibilityW-8BEN-E FormData Processing Agreement Template
    LinkedInYouTubeDiscord
    Pricing
    Our licenses and additional services at a glance.
    Licenses
    IndividualLabDepartment / ConsortiumTeachingCampusCommercial
    Top-Ups

    Need more recordings for your lab or your own research? Simply use one of these recording top-up packages.

    Browse top-up packages →
    Additional Services

    Hire Labvanced’s expert team to quickly bring your project to the level of rigor it needs.

    OverviewStudy BuildingSubject RecruitmentDedicated Support
    Checkout

    Ready to purchase a license or top-up? Head straight to checkout.

    Go to checkout →
    • 中國人
    • Deutsch
    • Français
    • Español
    • English
    • 日本語
    • はじめに
    • ガイド
      • はじめに

        • タスクエディタ
        • フレーム
          • キャンバスフレーム
          • ページフレーム
          • ウェブサイトフレーム
        • トライアルタイムライン
        • 刺激提示
        • 応答の正確性
        • オブジェクト
        • イベント
        • 変数
        • タスクウィザード
        • AIアシスタント
        • トライアルシステム
        • 実験デザイン
          • 研究の作成
          • Labvancedでのテンプレートのインポート
          • データフレームパターン
          • マルチユーザー実験デザイン
          • 縦断実験デザイン
      • 特集トピック

        • ランダム化とバランス
        • アイ・トラッキング
          • 注視追跡タスクにおける刺激の提示
          • 眼球追跡キャリブレーション設定の選択方法
          • タスクにおける視線追跡の設定
          • 注視データの記録とエクスポート
          • 形状を興味領域 (AOI) として使用する方法
          • 参加者キャリブレーション体験
        • ウェブブリッジ
          • ウェブサイト AOI の選択 | アンカー、調整、および AOI トラッキングの検証
          • ウェブサイト AOI におけるマウスの動作の追跡 | ウェブブリッジガイド
        • 質問票
        • デスクトップアプリ
        • サンプルスタディ
        • 参加者募集
        • APIアクセス
          • REST API
          • Webhook API
          • WebSocket API
        • その他のトピック

          • 正確な刺激タイミング
          • マルチユーザー研究
          • Labvancedにおける頭追跡 | ガイド
      • メインアプリタブ

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

        • 概要: 研究特定タブ
        • 研究デザイン
          • タスク
          • ブロック
          • セッション
          • グループ
        • タスクエディタ
          • タスクコントロール
          • 試行システム
          • フレームタイプ
          • オブジェクト
          • オブジェクトプロパティテーブル
          • 変数
          • システム変数テーブル
          • イベントシステム
          • テキストエディタの機能
          • タスクエディタにおける視線追跡オプション
          • タスクにおけるヘッドトラッキング
          • マルチユーザー研究
        • 設定
        • 変数
        • メディア
        • テキストと翻訳
        • 開始と参加
        • 被験者管理
        • データビューとエクスポート
    • ビデオチュートリアル
      • ビデオ概要
      • Labvancedの始め方
      • タスクの作成
      • 要素ビデオ
      • イベントと変数
      • 高度なトピック
    • ウォークスルー
      • イントロダクション
      • スループタスク
      • 語彙的判断タスク
      • ポズナー凝視キューイングタスク
      • 変化盲点フリッカパラダイム
      • 眼球追跡サンプル研究
      • 乳児眼球追跡研究
      • マウストラッキングを用いた注意捕捉研究
      • 迅速系列視覚提示
      • ChatGPT研究
      • 眼球追跡デモ:AOIとしてのSVG
      • マルチユーザーデモ:被験者のカーソルを表示
      • ゲームパッド/ジョイスティックコントローラ - 基本設定
      • EEG統合を用いたデスクトップアプリ研究
      • 被験者間グループバランシングと変数設定
      • マルチユーザー研究の構築
      • ウェブサイトフレーム眼球追跡ウォークスルー
      • 条件付きウェブカメラ眼球追跡
      • テキストセグメンテーション研究の構築
      • AIを使用した研究の構築
    • FAQ
      • 機能
      • サポートポリシーとガイドライン
      • セキュリティとデータプライバシー
      • ライセンス
      • Labvancedの精度
      • プログラムによる利用とAPI
      • Labvancedをオフラインで使用する
      • トラブルシューティング
      • 研究作成の質問

    Webhook API

    使用法: ​Labvancedの外部データストレージWebhook APIの主なユースケースは、記録されたデータをLabvancedのサーバー上にホストするのではなく、参加者データを“リアルタイム”で外部のリモートサーバーに転送することです。

    注意: ​多くのAPIユースケースとは異なり、ここで説明されているのはLabvanced API / エンドポイントを呼び出す方法ではなく(そのような機能は現在存在しません)、私たちのプラットフォームが、参加者データを私たちのバックエンド/データベースではなくあなたのバックエンド/データベースに直接送信するために、あなたが実装したエンドポイントを自動的に呼び出せるようにバックエンドを構成/実装する方法です。

    利用可能性: ​この機能はLabvancedのラボライセンス所有者のみが利用できます。

    1. Webhook APIの設定

    Webhook APIを使用するには、最初にそれぞれのLabvanced研究の“実験機能”セクションの“研究設定”で“外部データストレージ”オプションを有効にする必要があります。

    1.1 パラメータ:

    • IPアドレス: 外部サーバーが稼働している/公に利用可能な静的IPアドレスを入力してください。
    • ポート: データを送信するために使用するポート
    • URLパス: ポートの後に追加すべきURLパスです。これは特に、異なる実験からのデータを異なるURLパスに送信するために、プロジェクト/受信データの“名前空間”を作成するのに便利です。URLパスはオプションですが、使用することを強く推奨します。

    2. Webhook APIからデータを受信するためのサーバー/スクリプトの作成

    ステップ1の設定に基づいて、指定されたIPアドレス、ポート、およびURLパスで利用可能なサーバーを実装する必要があります。このようなサーバーの簡略化されたバージョン/例は、私たちのGithubのページにあります。

    2.1 データ形式: “/file_upload”ルートを除いて、すべてのルートでデータはJSON形式で送信されます。“/file_upload”ルート(記録されたビデオや音声などのバイナリファイルをアップロードするために使用される)は“multipart/form-data”としてエンコードされているため、受信データを正しくJSONまたはmultipart/form-data / バイナリデータとして解析することを確認してください。

    2.2 CORS設定: バックエンドを実装する際には、Cross Origin Resource Sharing (CORS)を実装/許可する必要があります。特に、次のヘッダーを設定する必要があります:“Access-Control-Allow-Origin” (​https://www.labvanced.com/​を含む)、 “Access-Control-Allow-Methods”(POSTとOPTIONSを含む)、 “Access-Control-Allow-Headers”(Content-Typeを含む)

    2.3 リクエストの種類: ​すべてのリクエストの種類はPOSTリクエストであり、データを送信するために使用されます。この時点では、“/file_upload”ルートにのみ戻り値が必要です。他のすべてのルートは特別な戻り値を必要としません。

    2.4 リクエスト/ルートの種類: ​参加者が研究に参加するたびに、合計で8種類の異なるPOSTリクエストが(外部/あなたの)サーバーに送信されます。“/file_upload”ルートは、あなたの研究に記録されたバイナリデータ(例:音声またはビデオ)をアップロードするアクションが含まれている場合にのみ使用されます。各タイプのPOSTリクエストには異なるルート(URLパス)があり、ステップ1で指定されたURLパスに追加されます。また、各リクエストの型には異なる構造/ペイロードがあり、データを解析および保存する際に考慮する必要があります。詳細はセクション3を参照してください。

    3. Webhook APIエンドポイントの定義/ルート:

    以下に、参加者が実験に参加する際に使用される/呼び出される各ルート/エンドポイントの詳細な説明を示します。理想的には、これらすべてのエンドポイント(3.1を除く)を実装し、すべてのデータが適切に解析され、データベースに保存されることを確認することをお勧めします。

    どのエンドポイントが使用され、どのサーバーがいつ呼び出されますか?

    • エンドポイント3.1 “/startExpPlayer”は、実験の定義/JSONファイルと関連する刺激を私たちのサーバーからロードするためにLabvancedサーバーにのみ送信されます。
    • エンドポイント3.2、3.3、3.4、3.7、3.8は、グループバランスと一般的な実験フローに必要なLabvancedサーバーと外部/あなたのサーバーの両方に送信されます。
    • エンドポイント3.5および3.6は、外部/あなたのサーバーにのみ送信されます。すべての試行/参加者データはルート3.6を介して送信されるため、これは実装するために最も重要なエンドポイントです。
    • エンドポイント3.9は、外部/あなたのサーバーにのみ送信され、バイナリ(音声またはビデオ)データをアップロードするアクションが実行されるたびに呼び出されます。

    3.1 実験の読み込み

    • ルート: /startExpPlayer
    • タイプ: POST
    • 呼び出されるとき: 参加者がlabvanced.comの特定の実験URLを訪れるとき Labvancedサーバーの主要機能: 実験の読み込みを開始します。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    isTestrunデータが記録されるかどうかブールいいえ
    subject_codeURLパラメータ経由の対象者の識別子文字列いいえ
    token長期的な研究の参加者のためのユニークな識別子トークン識別子いいえ
    askSubjData初期調査を表示するかどうか、対象者を異なるグループに分けるために使用されますブールはい

    注意: これは外部サーバーで実装する必要はありません。これはLabvancedサーバーからクライアントコンピュータへの実験の読み込みを初期化するだけです。


    3.2 グループとセッションの選択

    • ルート: /startFirstPlayerSession
    • タイプ: POST
    • 呼び出されるとき: ルート3.1 “ /startExpPlayer”がLabvancedサーバーから正常に返されたとき。
    • Labvancedサーバーの主要機能: 被験者にグループ番号とセッション番号を割り当てるために使用されます(サーバー側のバランス)。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    subject_codeURLパラメータ経由の対象者の識別子文字列いいえ
    token長期的な研究の参加者のためのユニークな識別子トークン識別子いいえ
    survey_data事前研究アンケートのJSON、以下にフィールドを説明します。JSONいいえ
    survey_data.selectedGender参加者の選択された性別文字列いいえ
    survey_data.selectedAge参加者の選択された年齢整数いいえ
    survey_data.selectedCountry参加者の選択された国/場所文字列いいえ
    survey_data.selectedLanguage参加者の選択された(第一)言語文字列いいえ
    isTestrunデータが記録されるか否かブールはい
    runOnlyGroupNrデータ記録なしで特定のグループ番号をテスト実行するためにのみ使用整数 / 偽いいえ
    runOnlySessionNrデータ記録なしで特定のセッション番号をテスト実行するためにのみ使用整数 / 偽いいえ
    groupNrこの対象者のグループ番号整数はい
    sessionNr長期的な研究のセッション番号整数はい
    group_nameこの対象者のグループ名文字列はい
    session_nameこの対象者のセッション名文字列はい
    experiment_name実験名(出版名ではない)文字列はい

    3.3 実験の開始

    • ルート: /setPlayerSessionStartedTime
    • タイプ: POST
    • 呼び出されるとき: 参加者が“実験を開始”を押したとき
    • Labvancedサーバーの機能: 実験の開始時間、セッション名、およびグループ名を保存し、実験を開始します。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    start_time実験の開始時間UNIXタイムスタンプはい
    sessionNr長期的な研究のセッション番号整数はい
    groupNrこの対象者のグループ番号整数はい
    token長期的な研究の参加者のためのユニークな識別子トークン識別子いいえ

    3.4 メタデータ情報の追加

    • ルート: /addMetaInfo
    • タイプ: POST
    • 呼び出されるとき: 参加者が“実験を開始”を押したとき
    • Labvancedサーバーの機能: サーバーにメタ情報を保存します。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    var_dataメタ情報を保持するJSONJSONはい
    var_data.browserSpec対象者が使用しているブラウザ文字列いいえ
    var_data.versionSpec対象者が使用しているブラウザのバージョン文字列いいえ
    var_data.systemSpec対象者が使用しているデバイスタイプ / OS文字列いいえ
    var_data.agentSpec完全なユーザーエージェント文字列文字列いいえ
    var_data.fullscreen研究が常に全画面であるかどうかを示すブールいいえ
    var_data.timeDelayMeanJavaScriptコールバック精度の平均オフセット(ミリ秒単位)浮動小数点いいえ
    var_data.timeDelayStdJavaScriptコールバック精度の標準偏差(ミリ秒単位)浮動小数点いいえ
    var_data.crowdsourcingCode対象者のためのクラウドソーシング/完了コード文字列いいえ
    var_data.crowdsourcinSubjId対象者のためのクラウドソーシング/ワーカーID文字列いいえ
    var_data.subjCounterGlobal研究内の対象者のためのグローバルな対象者カウンター整数いいえ
    var_data.subjCounterPer Group研究内のグループごとの対象者カウンター整数の配列いいえ
    var_data.roleId対象者のためのマルチユーザ研究のユニークなロールID整数いいえ
    var_data.multiUserGroupIdマルチユーザ研究のためのグローバルユニークなマルチユーザグループIDUuidいいえ
    var_data.displayedLanguageマルチランゲージ研究のための選択された表示言語文字列いいえ
    var_data.pixelDensityPerMMスクリーンのピクセル密度浮動小数点いいえ
    var_data.screenHeightスクリーンの高さ(ピクセル単位)整数いいえ
    var_data.screenWidthスクリーンの幅(ピクセル単位)整数いいえ
    var_data.windowHeightウィンドウ/ビューポートの高さ(ピクセル単位)整数いいえ
    var_data.windowWidthウィンドウ/ビューポートの幅(ピクセル単位)整数いいえ

    3.5 タスクに関する情報の記録

    • ルート: /recordStartTask
    • タイプ: POST
    • 呼び出されるとき: 実験のフローで新しいタスクが開始されるとき
    • Labvancedサーバーの機能: 外部APIリクエストが有効な場合は呼び出されません
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    blockNr現在のブロック番号(カウントアップ)整数はい
    blockId現在のブロックのユニークIDUuidはい
    blockNameブロックの名前文字列はい
    taskNr現在のタスク番号(カウントアップ)整数はい
    taskIdエディタで定義された現在のタスクのID(対象者間で同じ)Uuidはい
    recTaskId現在の録音タスクのためのサーバー生成ID(対象者間で異なる)整数はい
    taskName現在のタスクの名前文字列はい
    start_timeタスクの開始時間UNIXタイムスタンプはい

    3.6 試行データの記録

    • ルート: /recordTrial
    • タイプ: POST
    • 呼び出されるとき: 試行が終了したとき OR カスタム記録アクションが実行されたとき
    • Labvancedサーバーの機能: 外部APIリクエストが有効な場合は呼び出されません。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    recTaskId現在の録音タスクのためのサーバー生成ID(対象者間で異なる)整数はい
    taskIdエディタで定義された現在のタスクのID(対象者間で同じ)Uuidはい
    trailNr試行番号整数はい
    recDataメインデータ / 各試行ごとの全ユーザー作成変数はここに保存されますJSONはい

    注意: 各試行ごとに記録される正確なデータは、特定の実験とタスクに依存します。各研究の概要は、特定の実験の“変数”タブで入手可能です(スクリーンショットを参照)。また、外部APIの変数名はJSON構造内のキーとして使用されるため、変数名がユニークであることを確認してください。そうしないと、データが上書きされてしまいます。Labvancedシステムは通常、ユーザーがユニークな変数名を使用することを強制します。

    Overview of the Variables tab in Labvanced

    3.7 実験の成功での終了

    • ルート: /finishExpSession
    • タイプ: POST
    • 呼び出されるとき: 実験が正常に終了したとき
    • Labvancedサーバーの機能: 研究を終了し、データセットに完了フラグを付けます(バランスに重要)。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    end_time実験が終了した時間UNIXタイムスタンプはい
    var_data“/​addMetaInfo​”ルートのvarデータと同じ(更新情報)JSONはい
    nextStartTime次の開始時間(長期的な研究のみ)UNIXタイムスタンプいいえ
    nextEndTime次の終了時間(長期的な研究のみ)UNIXタイムスタンプいいえ
    reminderTime次の開始時間までの時間(長期的な研究のみ)時間文字列いいえ
    selectedEmail参加 reminderを送信するためのメール(長期的な研究のみ)メールアドレスいいえ
    emailReminder提出するreminderのタイミング(長期的な研究のみ)文字列いいえ

    3.8 失敗での実験の終了

    • ルート: /errExpSession
    • タイプ: POST
    • 呼び出されるとき: 実験がエラーで中止されたとき
    • Labvancedサーバーの機能: 研究を中止し、データセットに不完全フラグを付けます
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expId研究のユニーク識別子整数はい
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    err_msgエラーメッセージ文字列はい

    3.9 バイナリ(音声またはビデオ)データのアップロード

    • ルート: /file_upload
    • タイプ: POST
    • 呼び出されるとき: 音声またはビデオ録音オブジェクトに関連付けられたイベントシステム内でアップロードアクションが実行されるとき。 Labvancedサーバーの機能: 外部APIリクエストが有効な場合は呼び出されません。
    • 注意: サーバーはこのルートの戻り値を送信する必要があります(下記で説明)。これが行われない場合、“onUploadComplete”トリガーが実行されず、実験が正しく伝播できません。また、このルートのデータは“multipart/form-data”としてエンコードされており、バイナリデータと非バイナリデータの両方を含んでいます。
    • ペイロード: 次のフィールドを持つJSON:
    フィールド名説明データ型必須
    expSessionNrこの参加者の録音セッションのユニーク識別子(昇順でカウント)文字列はい
    newFileNameファイルを保存するための推奨ファイル名。このファイル名には関連する変数名と、現在のブロック、タスク、および試行番号が含まれます。文字列はい
    myFile実際のファイル / バイナリデータバイナリはい

    必要な応答:

    フィールド名説明データ型必須
    file_guid録音ファイルのためのグローバルユニーク識別子(guid)。これはサーバー側で生成され、ファイルに関連付けられて保存される必要があり、後でどのファイルがどの録音オブジェクトから来たのか理解しやすくなります。Uuidはい
    file_nameサーバーがファイルを保存するために使用した結果のファイル名。これは(クライアントがリクエストで提案したファイル名と同じである必要はありません)。これも関連変数に保存されます。文字列はい
    Prev
    REST API
    Next
    WebSocket API