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
    • Browse recording top-ups →
    • Browse AI token top-ups →
    • Overview
    • Study Building
    • Subject Recruitment
    • Dedicated Support
    Checkout
  • Contact
    • FR
      • 中國人
      • Deutsch
      • Français
      • Español
      • English
      • 日本語
    • Logout
    • 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 recording top-ups →

    Need more AI tokens for the AI assistant and study translations? Simply use one of these AI token top-up packages.

    Browse AI token top-ups →
    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
    • 日本語
    • Commencer
    • Guide
      • COMMENCER

        • Éditeur de tâche
        • Cadres
          • Cadre Canvas
          • Cadre de Page
          • Cadre de site Web
          • Superpositions & Dialogues | Labvanced
        • Chronologie des essais
        • Présentation des stimuli
        • Exactitude de la réponse
        • Objets
        • Événements
        • Variables
        • Assistant de tâche
        • Assistant IA
        • Système d'essai
        • Conception d'expérience
          • Création d'une étude
          • Importer des modèles dans Labvanced
          • Modèles de Cadre de Données
          • Conception d'expérience multi-utilisateur
          • Conception d'Expérience Longitudinale
      • SUJETS SÉLECTIONNÉS

        • Randomisation & Équilibre
        • Suivi oculaire
          • Présentation des Stimuli dans une Tâche de Suivi oculaire
          • Comment Choisir les Paramètres de Calibration du Suivi Oculaire
          • Configuration du suivi oculaire dans une tâche
          • Enregistrement et Exportation des Données de Regard
          • Utilisation des formes comme zones d'intérêt (AOI) pour le suivi oculaire
          • L'expérience de calibration des participants
        • Pont Web
          • Sélectionner les AOI de site Web | Ancrer, ajuster et vérifier le suivi des AOI
          • Suivi du comportement de la souris sur une AOI de site Web | Guide Web Bridge
        • Questionnaires
        • Application de bureau
        • Études d'exemple
        • Recrutement de participants
        • Accès API
          • API REST
          • API Webhook
          • API WebSocket
        • Autres sujets

          • Chronométrage précis des stimuli
          • Études multi-utilisateurs
          • Suivi de la tête dans Labvanced | Guide
      • ONGLETS PRINCIPAUX DE L'APPLICATION

        • Aperçu : Onglets principaux
        • Tableau de bord
        • Mes études
        • Études partagées
        • Mes fichiers
        • Bibliothèque d'expériences
        • Mon compte
        • Licence & Services
      • ONGLETS D'ÉTUDE

        • Aperçu : Onglets spécifiques à l'étude
        • Conception de l'étude
          • Tâches
          • Blocs
          • Sessions
          • Groupes
        • Éditeur de tâche
          • Contrôles de tâche
          • Le Système des Essais
          • Types de cadres
          • Objets
          • Tables de Propriétés des Objets
          • Variables
          • Tableau des Variables Système
          • Le Système d'Événements
          • Fonctions de l'Éditeur de Texte
          • Options de suivi oculaire dans l'éditeur de tâches
          • Suivi de tête dans une tâche
          • Études multi-utilisateurs
        • Paramètres
        • Variables
        • Médias
        • Textes & Traduire
        • Lancer & Participer
        • Gestion des sujets
        • Vue des données et exportation
    • Tutoriels vidéo
      • Aperçu vidéo
      • Commencer avec Labvanced
      • Création de tâches
      • Vidéos d'éléments
      • Événements et variables
      • Sujets avancés
    • Guides
      • Introduction
      • Tâche de Stroop
      • Tâche de décision lexicale
      • Tâche de signalisation du regard de Posner
      • Paragraphe de clignotement de cécité d'image
      • Étude de suivi oculaire
      • Étude de suivi oculaire des nourrissons
      • Étude de capture attentionnelle avec suivi de souris
      • Présentation visuelle en série rapide
      • Étude ChatGPT
      • Démonstration de suivi oculaire : SVGs comme AOIs
      • Démonstration multi-utilisateur : Afficher les curseurs des sujets
      • Manette / Contrôleur de joystick - Configuration de base
      • Étude d'application de bureau avec intégration EEG
      • Équilibrage des groupes entre sujets et configuration des variables
      • Construire une étude multi-utilisateur
      • Guide de suivi oculaire de cadre de site web
      • Suivi oculaire de webcam conditionnel
      • Construction d'étude de segmentation de texte
      • Construire une étude avec l'IA
    • FAQ
      • Fonctionnalités
      • Politique de support & Directives
      • Sécurité & Confidentialité des données
      • Licences
      • Précision de Labvanced
      • Utilisation programmatique & API
      • Utiliser Labvanced hors ligne
      • Dépannage
      • Questions sur la création d'études
    Déclencheur Websocket recevant un message d'un dispositif externe dans Labvanced

    Déclencheur Websocket

    Le Websocket Trigger s'active lorsque votre étude en cours reçoit un message via sa connexion WebSocket. Il permet à un script local, un appareil d'enregistrement ou un serveur externe de démarrer un événement dans votre étude au moment où quelque chose se produit en dehors du navigateur.

    Table des Matières

    • Aperçu
    • Comment ça Marche
    • Valeurs Spécifiques au Déclencheur
    • Conseils de Flux de Travail
    • Études & Scénarios Exemples

    Aperçu

    Le Websocket Trigger est listé sous la catégorie API/External Trigger dans le menu de sélection du déclencheur. Avec l'Action Envoyer au Websocket, il permet à une étude d'avoir une communication bidirectionnelle avec un logiciel fonctionnant en dehors de Labvanced.

    Cas d'Utilisation Commun

    Le Websocket Trigger est utilisé chaque fois qu'un signal provenant de l'extérieur de l'étude doit modifier ce qui se passe dans l'étude.

    • Réception de marqueurs LSL : un script Python local passe un marqueur d'un autre dispositif Lab Streaming Layer dans l'étude, afin que l'étude puisse l'enregistrer à côté de ses propres horodatages. Voir EEG & Intégrations Matérielles pour l'image complète.
    • Conceptions en boucle fermée et biofeedback : un script qui traite un signal physiologique envoie un message chaque fois qu'un seuil est franchi, et l'étude modifie le stimulus en réponse.
    • Traitement Externe : un serveur analyse les données envoyées par l'étude et renvoie un résultat, comme une classification ou un score, que l'étude affiche ou enregistre ensuite.

    Comment ça Marche

    Pour accéder au Websocket Trigger, ouvrez le Système d'Événements dans l'éditeur de tâches et créez un nouvel événement. Sous la catégorie API/External Trigger, sélectionnez Websocket Trigger.

    Avant que le déclencheur puisse être utilisé, activez la connexion dans les paramètres de l'étude :

    1. Ouvrez l'onglet Settings.
    2. Ouvrez le menu déroulant Special Features et trouvez la section Websocket Connection.
    3. Cochez l'option pour l'activer, puis entrez WebSocket Address et Port. Les valeurs par défaut sont ws://localhost et 8081, qui se connectent à un script fonctionnant sur le même ordinateur que l'étude.

    La boîte de dialogue contient les éléments suivants :

    OptionDescription
    Websocket AddressAffiche l'adresse de vos paramètres d'étude. Elle ne peut pas être modifiée ici.
    PortAffiche le port de vos paramètres d'étude. Il ne peut pas être modifié ici.
    trigger / messageL'étiquette du message qui déclenche cet événement. Le déclencheur s'active lorsque l'étiquette d'un message entrant correspond exactement à ce texte. Entrez any pour déclencher à chaque message entrant.

    Lorsque l'étude commence, Labvanced ouvre la connexion à l'adresse et au port que vous avez entrés. Si la connexion n'est pas activée dans les paramètres, aucune connexion n'est établie et le déclencheur ne s'active jamais.

    Le déclencheur écoute uniquement pendant que le cadre contenant l'événement est affiché. Un message qui arrive pendant qu'un autre cadre est affiché ne déclenche pas cet événement. Placez l'événement sur chaque cadre où l'étude doit réagir au message.

    Un événement avec any s'active pour chaque message. Si un autre événement sur le même cadre utilise une étiquette spécifique, les deux événements se déclenchent lorsqu'un message avec cette étiquette arrive.

    Ce que le Programme d'Envoi Fournit

    Le déclencheur ne s'active que si un programme externe à Labvanced lui envoie un message. Ce programme, généralement un court script sur le même ordinateur, exécute le serveur WebSocket auquel l'étude se connecte. Chaque message qu'il envoie a deux parties :

    • Une étiquette : le déclencheur la compare avec le champ trigger / message. Lorsqu'ils correspondent, l'événement se déclenche, et l'étiquette est disponible en tant que valeur Message.
    • Contenu : toute valeur que le script souhaite transmettre, telle qu'une valeur de marqueur ou une mesure. Elle est disponible en tant que valeur Data.

    Pour la personne écrivant le script, chaque message est un objet JSON avec les champs msg pour l'étiquette et value pour le contenu. Les exemples de scripts dans le dépôt API WebSocket de Labvanced sur GitHub envoient et reçoivent des marqueurs LSL de cette manière et constituent un bon point de départ. Pour la configuration de la connexion, consultez le guide API WebSocket.

    Valeurs Spécifiques au Déclencheur pour Déclencheur Websocket

    Après que le déclencheur s'est activé, les valeurs suivantes sont disponibles dans les actions de l'événement. Sélectionnez-les dans le Menu de Sélection de Valeurs sous Trigger (Websocket Trigger).

    ValeurDescription
    MessageL'étiquette du message reçu. Utilisez-la pour différencier les types de messages, surtout dans un événement qui utilise any.
    DataLe contenu du message reçu. Il peut contenir toute valeur JSON, telle qu'un nombre, une chaîne ou une liste, et peut être stocké dans une variable avec l'Action Définir / Enregistrer Variable.
    Trigger Timestamp (Unixtime)Le temps auquel le déclencheur s'est activé, en temps Unix avec des millisecondes.
    Trigger Time (From Frame Onset)Le temps en millisecondes depuis le début du cadre jusqu'au moment où le déclencheur s'est activé.

    Conseils de Flux de Travail

    • Démarrez votre script avant de commencer l'étude. La connexion est ouverte lorsque l'étude commence.
    • Testez la connexion avec l'étude fonctionnant sur le même ordinateur que le script avant de collecter des données. Le ws://localhost par défaut ne peut atteindre que les programmes sur cet ordinateur.
    • Gardez les étiquettes de message courtes et cohérentes entre le script et l'étude. La correspondance est exacte, donc Marker et marker sont des messages différents.
    • Enregistrez Trigger Time (From Frame Onset) avec Data lorsque le timing du message est important pour l'analyse.

    Études & Scénarios Exemples

    Réception d'un marqueur d'un autre dispositif. Dans l'étude de bibliothèque LSL Receive Marker, un marqueur produit par un dispositif externe atteint un script Python local, qui le transmet à l'étude via un Websocket Trigger. L'étude enregistre ensuite la valeur du marqueur. Utilisez l'option Inspect dans la bibliothèque pour voir la configuration de l'événement.

    Messagerie bidirectionnelle. L'étude de bibliothèque Exemple de Connexion Socket envoie un message hors de l'étude avec l'action Envoyer au Websocket et réagit aux réponses avec ce déclencheur.

    Lectures Complémentaires

    Action Envoyer au Websocket

    Action Envoyer au Websocket

    L'action associée pour envoyer un message ou une variable hors de l'étude.

    API WebSocket

    API WebSocket

    Comment connecter une étude à un script local ou à un serveur externe.

    Menu de Sélection de Valeurs

    Menu de Sélection de Valeurs

    Comment référencer les valeurs spécifiques au déclencheur dans vos actions.

    Aperçu des Événements

    Aperçu des Événements

    Une introduction complète au système logique de déclencheur et d'action dans Labvanced.