L’API iMotions Lab
iMotions Lab propose une API permettant d’étendre les fonctionnalités d’iMotions. Vous trouverez ci-dessous un aperçu des possibilités offertes par cette API. Pour une documentation détaillée, veuillez consulter le Centre d’aide.
L’utilisation de l’API nécessite des connaissances avancées en programmation ainsi qu’une expérience dans l’envoi et la réception d’événements vers une API
Transmission d’événements
Transmettez les événements d’iMotions Lab à une application tierce via un flux de données en temps réel.
Au cours d’un test de répondants, le logiciel recueille divers types de données provenant de différentes sources. Dans une configuration à double écran, ces données sont utilisées pour générer des visualisations. Elles sont également mises en cache en mémoire et enregistrées dans la base de données à la fin du test. Lors de l’analyse de l’étude, les données sont chargées depuis la base de données et utilisées pour effectuer l’analyse et générer divers visuels, par exemple la relecture du regard. Les données peuvent également être exportées vers un fichier texte afin de permettre à des applications tierces d’effectuer des analyses personnalisées.
L’interface de transfert d’événements étend ce modèle afin de permettre à des applications tierces de recevoir les données en temps réel, au fur et à mesure qu’elles sont captées par le système iMotions. Lorsqu’un événement est détecté par le logiciel (par exemple, un clic de souris ou un échantillon de l’oculomètre), l’application vérifie alors si le transfert d’événements est activé. Si c’est le cas, l’événement est sérialisé en une chaîne de caractères, et cette chaîne est transmise sous forme de message d’événement. Une application externe peut écouter ces messages d’événement. Elle traiterait alors l’événement dans le cadre de l’exécution d’une tâche spécifique à l’application. En général, cela serait utilisé dans un enregistrement d’écran, où l’application testée recevrait les événements externes et ajusterait son comportement en fonction de ceux-ci, par exemple
- On pouvait présenter au participant différentes images en fonction de l'endroit où il avait posé son regard sur l'image précédente.
- Si les données de l'oculomètre de la dernière seconde indiquent que le participant a détourné le regard ou fermé les yeux, un signal sonore de « réveil » pourrait être émis pour attirer son attention. Le logiciel Imotions peut envoyer des événements à une application externe via TCP ou UDP.
- Lorsqu'il utilise le protocole TCP, le logiciel fait office de serveur et attend les connexions sur un port spécifique. Une fois la connexion établie avec un client, iMotions transmettra tous les messages d'événement à ce client via cette connexion. L'application cliente n'a qu'à lire les messages d'événement provenant de cette connexion.
- Lorsqu'il utilise le protocole UDP, iMotions envoie chaque message d'événement sous forme de datagramme UDP vers une combinaison serveur/port configurée.
Réception d’événements
Intégrez des appareils ou des applications personnalisés à iMotions.
iMotions prend actuellement en charge plusieurs capteurs permettant de mesurer l’état d’un participant pendant un test, par exemple l’Emotiv EEG ou l’Affectiva QSensor. Cependant, il existe de nombreux autres capteurs qu’un client pourrait utiliser, et il n’est pas réaliste pour iMotions de prendre en charge chacun d’entre eux. Il est donc envisagé de créer une application tierce qui s’interface avec l’ensemble de dispositifs souhaité, puis transmette les données ainsi collectées au logiciel iMotions. Ces données seront traitées de la même manière que celles collectées par les capteurs pris en charge nativement : elles seront synchronisées avec toutes les autres données collectées, pourront être visualisées sous forme de graphique, seront stockées dans la base de données et enregistrées avec l’étude, et seront disponibles dans l’exportation de données textuelles pour une analyse plus approfondie, etc.
Ce document décrit la méthode permettant à une application tierce d’envoyer les données de capteurs enregistrées au logiciel iMotions.
REMARQUE :
Même si nous avons tendance à nous concentrer sur le cas des « capteurs externes non pris en charge », il convient de noter qu’il n’y a aucune restriction quant à la provenance des données provenant de l’application tierce. Celles-ci seront stockées dans le logiciel sous la forme d’un flux d’événements externes. Que ces données proviennent de capteurs externes ou que les valeurs aient été générées en interne par l’application tierce n’a aucune importance pour iMotions.
Télécommande
L’API de commande à distance permet à des programmes externes de contrôler le logiciel iMotions, c’est-à-dire d’effectuer certaines tâches sans passer par l’interface utilisateur. Les commandes suivantes sont disponibles.
| Commande | Action |
| Réduire | En cas d’inactivité, iMotions se réduit dans la barre des tâches. Le logiciel ne se réduit pas s’il est en train d’exécuter un test. |
| Optimiser | La fenêtre iMotions s’affichera à nouveau. |
| Arrêt | iMotions va se fermer. Si un test est en cours, la commande est rejetée. |
| Courir | iMotions utilisera les paramètres de la commande pour sélectionner l’étude et le participant à tester. Un test sera ensuite lancé. Si un test est déjà en cours, la commande sera rejetée. |
| Diapositive suivante | Permet de passer à la diapositive suivante dans le diaporama. Équivaut à la combinaison de touches Maj + Espace |
| Annuler le diaporama | Demande l’annulation du diaporama. Équivalent à Maj-F1. |
| Statut | La commande « Status » peut être envoyée à iMotions à tout moment. Elle génère une réponse indiquant si le logiciel est inactif ou s’il est en train d’exécuter un test. Si un test est en cours, la réponse contiendra des informations détaillées sur ce test. |
| Enregistrer | Si le programme reste inactif, iMotions enregistrera l’étude et le répondant sélectionnés dans un fichier. Le fichier ZIP ainsi créé sera enregistré dans un dossier personnalisable du système de fichiers. L’emplacement du fichier ZIP sera indiqué dans la réponse à la commande. |
| Charger | Charge le contenu d’un fichier d’exportation d’étude dans iMotions. Cette opération permet soit de créer une nouvelle étude, soit d’intégrer les données des participants testés contenues dans le fichier zip à une étude existante. |
| Supprimer | Supprimer une étude. |
| Exporter les données des capteurs | Exporte les données de l’étude vers un fichier texte brut pouvant être importé dans Excel, Matlab, etc. |
| Exporter des enregistrements vidéo | Exporte les enregistrements de l’écran ou de la caméra frontale vers un dossier. |
Cet ensemble restreint de commandes a pour objectif de permettre à un client disposant d’un vaste réseau de collecte de données d’intégrer le logiciel iMotions à son infrastructure existante de distribution d’études.
Guide et documentation de l’API
Veuillez consulter le Centre d’aide pour obtenir la liste complète des commandes disponibles ainsi que les guides d’utilisation de l’API.
-
Qu'est-ce que les émotions et pourquoi sont-elles importantes ?
-
Les 8 meilleures applications d'oculométrie dans le domaine de la recherche
-
Les 6 applications les plus courantes de la recherche sur l'EEG humain
-
Réussir votre sondage : 5 types de questions à connaître pour que votre sondage fasse un tabac
-
10 ouvrages incontournables sur l'oculométrie