Home » Development »
Exhibits API
The Exhibits API was developed specifically for monitoring and controlling digital exhibits in exhibitions and museums.
Standard media controls can turn an exhibit’s PC on or off, but many museum operators want more control options, such as monitoring the software on the PC.
The exhibit does not work anymore!
NeuroomNet can determine whether the PC or the software has stopped responding. In that case, you can use NeuroomNet Monitoring to restart the software. This is faster than restarting the entire PC.
It is also helpful to know where the error originated in order to resolve it permanently.
How does it work?
The exhibit application connects to the NeuroomNet server via a network using the provided interface. Exhibits are uniquely identified via VendorIDs.
There are standard actions that NeuroomNet has implemented for this, for example:
- User login/logout
- Restart Exhibits Software
- Restart software
The developers of the exhibits can implement the functionality of these actions in their software. NeuroomNet only sends the trigger for this.
In addition, individual events and actions can be registered. These then become visible and executable in the NeuroomNet monitoring and NeuroomNet script blocks.
Notice.
Technical details
The server listens for connection requests on a predefined port. Applications must connect to the server as soon as they are ready.
The transmitted data packets consist of JSON strings.
It is recommended to store the server’s IP address—or rather, its name, which can be resolved via DNS—and the port in an application-specific configuration file so that any necessary adjustments can be made easily.
PING — Are you still there?
After connecting/logging in an exhibit to the server, the server will query the status of the application/exhibit at regular intervals to be able to visualize error states in the media control and thus allow the exhibition staff to correct the error. If the application hangs and does not respond or the WebSocket connection is disconnected, the exhibit is reported as “OFFLINE”. On the other hand, the application may only return an “Ok” if all components are working properly. However, exhibit software can also report individual errors such as “No more paper” or “Connected camera not working”.
Visitor identification via RFID or QR code
The system is designed to manage visitor login information. This is described here as an example of registration using an RFID wristband.
The visitor checks in at an exhibit by holding their RFID wristband up to the exhibit’s RFID reader. The RFID reader transmits the wristband’s ID to the system, which then communicates this via API to the assigned application from the exhibit manufacturer. The application will then initiate the visitor’s interaction with the exhibit (game, information, etc.). Once this interaction is complete (whether normally upon completion of all actions, through an explicit, manual termination, or due to a timeout), corresponding information is sent to the system.
If, in the course of visitor interaction, it is necessary to confirm a transaction via RFID wristband, this information is transmitted to the application in the same way. The application must decide based on its status whether it is a confirmation, a new registration, or a change of visitor.
Implement visitor identification yourself
What is the advantage of using the NeuroomNet Exhibits API?
Finally, each application could also implement its own communication with an RFID or QR code reader.
- It is often the case that several companies write the exhibit software for an exhibition. So that would mean that each company would have to build the application once itself — so the same work would have to be done multiple times.
- There is no central authority to decide whether the ID is valid at all.
- Central statistics can be created through the use of exhibits.
- In the event of a device replacement (RFID defective) and changed hardware or firmware, all applications would have to be adapted.
- The same technology can be used in the building for other applications such as access control or to control visitor tours.
For more examples and explanations take a look at our documentation.