Die iMotions Lab-API
iMotions Lab bietet eine API zur Erweiterung der Funktionen von iMotions. Im Folgenden erfahren Sie, welche Möglichkeiten Ihnen die API bietet. Eine ausführliche Dokumentation finden Sie im Hilfe-Center.
Die Nutzung der API erfordert fortgeschrittene Programmierkenntnisse sowie Erfahrung mit dem Senden und Empfangen von Ereignissen an eine API
Weiterleitung von Ereignissen
Leiten Sie Ereignisse aus iMotions Lab über einen Echtzeit-Datenfeed an eine Drittanbieteranwendung weiter.
Während eines Testdurchlaufs erfasst die Software verschiedene Arten von Daten aus unterschiedlichen Quellen. In einer Dual-Screen-Konfiguration werden diese Daten zur Darstellung von Visualisierungen verwendet. Sie werden außerdem im Arbeitsspeicher zwischengespeichert und am Ende des Tests in der Datenbank protokolliert. Während der Studienanalyse werden die Daten aus der Datenbank geladen und zur Durchführung der Analyse sowie zur Darstellung verschiedener Visualisierungen, z. B. der Blickverfolgung, verwendet. Die Daten können auch in eine Textdatei exportiert werden, sodass Drittanbieteranwendungen zur Durchführung benutzerdefinierter Analysen genutzt werden können.
Die Schnittstelle zur Ereignisweiterleitung erweitert dieses Modell, sodass Anwendungen von Drittanbietern die Daten in Echtzeit empfangen können, sobald sie vom iMotions-System empfangen werden. Wenn die Software ein Ereignis empfängt, z. B. einen Mausklick oder eine Eyetracker-Messung, prüft die Anwendung nun, ob die Ereignisweiterleitung aktiviert ist. Ist dies der Fall, wird das Ereignis in eine Textzeichenfolge serialisiert und diese Zeichenfolge als Ereignismeldung weitergeleitet. Eine externe Anwendung kann auf diese Ereignismeldungen warten. Sie würde das Ereignis dann im Rahmen der Ausführung einer anwendungsspezifischen Aufgabe verarbeiten. Typischerweise würde dies bei einer Bildschirmaufzeichnung zum Einsatz kommen, bei der die zu testende Anwendung die externen Ereignisse empfängt und ihr Verhalten entsprechend anpasst, z. B.
- Dem Befragten konnten je nachdem, wohin er auf dem vorherigen Bild geschaut hatte, unterschiedliche Bilder gezeigt werden.
- Wenn die Daten des Eye-Trackers in der letzten Sekunde darauf hindeuten, dass der Befragte wegschaut oder die Augen geschlossen hat, könnte ein akustisches „Wecksignal“ abgespielt werden, um die Aufmerksamkeit des Befragten zu wecken. Die Imotions-Software kann Ereignisse entweder über TCP oder UDP an eine externe Anwendung senden.
- Bei Verwendung von TCP fungiert die Software als Server und wartet auf Verbindungen an einem bestimmten Port. Sobald eine Verbindung zu einem Client hergestellt wurde, leitet iMotions alle Ereignismeldungen über diese Verbindung an den Client weiter. Die Client-Anwendung muss lediglich die Ereignismeldungen aus der Verbindung auslesen.
- Bei Verwendung von UDP sendet iMotions jede Ereignismeldung als UDP-Datagramm an eine konfigurierte Server-Port-Kombination.
Empfang von Ereignissen
Integrieren Sie eigene Geräte oder Anwendungen in iMotions.
iMotions unterstützt derzeit eine Reihe von Sensoren zur Messung des Zustands eines Probanden während eines Tests, z. B. Emotiv EEG und Affectiva QSensor. Es gibt jedoch noch viele weitere Sensorgeräte, die ein Kunde verwenden könnte, und es ist für iMotions nicht praktikabel, jedes einzelne dieser Geräte zu unterstützen. Stattdessen ist vorgesehen, dass eine Drittanbieter-Anwendung entwickelt wird, die eine Schnittstelle zu den gewünschten Geräten herstellt und die so gesammelten Daten an die iMotions-Software weiterleitet. Diese Daten werden genauso behandelt wie Daten, die von den Sensoren mit integrierter Unterstützung erfasst werden, d. h. sie werden mit allen anderen erfassten Daten synchronisiert, können in einem Diagramm visualisiert werden, werden in der Datenbank gespeichert und zusammen mit der Studie abgelegt und stehen im Textdatenexport für weitere Analysen zur Verfügung usw.
In diesem Dokument wird beschrieben, wie eine Drittanbieter-Anwendung erfasste Sensorwerte an die iMotions-Software senden kann.
HINWEIS:
Auch wenn wir uns in der Regel auf das Szenario „nicht unterstützter externer Sensor“ konzentrieren, ist zu beachten, dass es keine Einschränkung hinsichtlich der Herkunft der Daten gibt, die von der Drittanbieteranwendung stammen. Sie werden in der Software als Strom externer Ereignisse gespeichert. Ob sie von externen Sensorgeräten stammen oder ob die Werte intern von der Drittanbieteranwendung generiert wurden, spielt für iMotions keine Rolle.
Fernbedienung
Die Fernsteuerungs-API ermöglicht es externen Programmen, die iMotions-Software zu steuern, d. h. bestimmte Aufgaben auszuführen, ohne mit der Benutzeroberfläche zu interagieren. Die folgenden Befehle stehen zur Verfügung.
| Befehl | Aktion |
| Minimieren | Wenn das Programm im Leerlauf ist, wird iMotions in die Taskleiste minimiert. Die Software wird nicht minimiert, wenn gerade ein Test ausgeführt wird. |
| Maximieren | Das iMotions-Fenster wird wiederhergestellt. |
| Herunterfahren | iMotions wird geschlossen. Wenn gerade ein Test läuft, wird der Befehl abgelehnt. |
| Laufen | iMotions verwendet die Befehlsparameter, um die zu testende Studie und den zu testenden Befragten auszuwählen. Anschließend wird ein Test durchgeführt. Läuft bereits ein Test, wird der Befehl abgelehnt. |
| Nächste Folie | Fordert die Diashow auf, zur nächsten Folie zu wechseln. Entspricht der Tastenkombination Umschalt-Leertaste |
| Diashow abbrechen | Beendet die Diashow. Entspricht der Tastenkombination Umschalt-F1. |
| Status | Der Befehl „Status“ kann jederzeit an iMotions gesendet werden. Daraufhin wird eine Antwort gesendet, aus der hervorgeht, ob die Software im Leerlauf ist oder gerade einen Test durchführt. Wenn ein Test läuft, enthält die Antwort Einzelheiten zum aktuellen Test. |
| Speichern | Wenn das Programm im Leerlauf ist, speichert iMotions die ausgewählte Studie/den ausgewählten Befragten in einer Datei. Die resultierende ZIP-Datei wird in einem konfigurierbaren Ordner im Dateisystem gespeichert. Der Speicherort der ZIP-Datei wird in der Befehlsantwort angegeben. |
| Laden | Lädt den Inhalt eines Studienexports in iMotions. Dabei wird entweder eine neue Studie erstellt oder die Daten der befragten Teilnehmer aus der ZIP-Datei werden in eine bestehende Studie integriert. |
| Löschen | Eine Studie löschen. |
| Sensordaten exportieren | Exportiert die Studiendaten in eine reine Textdatei, die in Excel, Matlab usw. geladen werden kann. |
| Videoaufnahmen exportieren | Speichert die Aufzeichnungen des Bildschirms oder der Frontkamera in einem Ordner. |
Diese begrenzte Auswahl an Befehlen soll es Kunden mit einem umfangreichen Datenerfassungsnetzwerk ermöglichen, die iMotions-Software in ihre bestehende Infrastruktur zur Studienverteilung zu integrieren.
API-Handbuch und Dokumentation
Eine vollständige Liste der verfügbaren Befehle sowie Anleitungen zur Verwendung der API finden Sie im Hilfe-Center.
-
Eine Einführung in die Farbwahrnehmung
-
Preise für VR-Headsets – Ein Überblick über mehr als 20 Modelle
-
Eine Einführung in das sympathische und parasympathische Nervensystem
-
EEG (Elektroenzephalografie): Der vollständige Taschenführer
-
Wissenschaft in den Medien: Wie Biosensoren im Film eingesetzt werden