Feedback von Rätseln mit Hilfe der API erhalten und verarbeiten

Hintpad kann auf zwei verschiedene Arten Feedback erhalten.

Entweder über eine offene API (JSON) oder in Kombination mit einem Controllino. 
Dieser Artikel behandelt den Umgang mit der API, über die jede beliebige Anwendung mit Hintpad verbunden werden kann.

Beispiel-Code (Javascript):
XMLHttpRequest()

// Send html formatted strings to Hintpad

function sendRoomEvent (message) {

      var hintpadIP = "192.168.0.2";

      var data = JSON.stringify( {"data":{"content": message, "origin":"MyEscapeRoomDevice"}} );

      var xhr = new XMLHttpRequest();

      xhr.open("POST", 'http://'+hintpadip+':4010/api/external-logs', true);

      xhr.setRequestHeader('Content-Type', 'application/json');

      xhr.send(data);

}

fetch()

function sendRoomEvent(message) {

     const hintpadIP = "192.168.0.100";

     const url = `http://${hintpadIP}:4010/api/external-logs`;

     const payload = { data: {content: message, origin: "machine"} };

     fetch(url, { method: "POST", headers: {"Content-Type": "application/json"},

                           body: JSON.stringify(payload) })

     .then(response => {

             if (!response.ok) {

             log("Fehler beim Senden des Room Events:", response.statusText);

             }

     })

     .catch(error => {

         log("Fetch-Fehler beim Room Event:", error.message);

     });

     } else {

     log("-> Room event NOT sent: activate Hintpad in gameConfig.");

     }

}

Hintpad zeigt in der Spielleiter-Ansicht den message-String an. Dieser String kann mit jeder beliebigen Funktion verknüpft werden, um Aktionen zu automatisieren (Zeit, Hinweise, Magnete etc.)

Room Events einrichten

Im Admin-Bereich des Hintpads können unter Advanced/API die Room Events eingerichtet werden. 

- Name: Benennung des Events für die weitere Verarbeitung (siehe unten)
- Trigger: der (Teil-)String, der als content im JSON-Payload des Room Events mitgeschickt wird

Der Trigger kann dann in einer Action unter Advanced Settings eingetragen werden, um die Action auszulösen:

• Related Articles

• Einsatz von Controllinos, Sensoren und Aktoren

  Hintpad ermöglicht den Einsatz der Controllino-Plattform, um Sensoren (z.B. Buttons) auszulesen und Aktoren (z.B. Elektromagnete) anzusteuern. Es gibt verschiedene Ausführungen von Controllino-Geräten (Mini, Maxi, Mega), die alle mit Hintpad zusammen ...

• Export und Import von Hintpad-Einstellungen

  Mit der Export/Import-Funktion lassen sich alle Einstellungen, Actions und Medienfiles eines Hintpads auf ein anderes Gerät übertragen. Um ein komplettes Hintpad-Setup zu exportieren, wird zunächst der Admin-Bereich geöffnet. Die Exportfunktion ...

• Wie funktioniert der 'Battle Modus'?

  Im Battle-Modus können Gruppen gegeneinander antreten und um die beste Punktzahl spielen. Besonderheiten des Battle-Modus: - Gruppen spielen gegeneinander um die beste Punktzahl - Gruppen können Fortschritt und Punktzahl der gegnerischen Gruppen ...

• Erstellen von Ereignis-Ketten: 'Enabled by action' und 'Disables action'

  Actions können unterschiedliche Abhängigkeiten zueinander haben, sich gegenseitig auslösen oder ein Auslösen verhindern. So lassen sich unterschiedliche Spielabläufe realisieren, z.B. das automatische Abspielen eines Videos nach einer erfolgreichen ...

• Wo finde ich die Fotos der Spiele?

  Die Fotos, die mit Hilfe des Markertyps "Take a picture" erstellt werden, sind in der Fotogallerie des iPads gespeichert und werden gleichzeitig als Anhang zu der jeweiligen Spielgruppe ins Dashboard übertragen. Ihr könnt die Bilder somit ganz ...