{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"833fbfe4-a4c8-46c1-bdf6-8340a08fb289"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"29a9a009-ce3c-4055-89c8-6bb60e7c0ff4"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"SDK Configuration Options","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is a list of the configuration options that the SDK constructor takes as parameters.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"constructor (token: string, exhibitId: number, manifest: Object, options = {})","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"token","type":"text"}]},{"type":"paragraph","content":[{"text":"The exhibit token generated through the Exhibit/Auth tab in the Gumband UI. This is required to authenticate the SDK with Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"exhibitId","type":"text"}]},{"type":"paragraph","content":[{"text":"The ID of the exhibit in Gumband. This can be found under the Exhibit/Auth tab in the Gumband UI. This is required to authenticate the SDK with Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"manifest","type":"text"}]},{"type":"paragraph","content":[{"text":"The exhibit manifest. See the ","type":"text"},{"text":"Exhibit Manifest Configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://deeplocal.atlassian.net/wiki/spaces/GS/pages/179306526"}}]},{"text":" docs for how to structure the manifest object.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"options","type":"text"}]},{"type":"paragraph","content":[{"text":"All of the remaining optional parameters that enables certain features of the Gumband SDK.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"contentLocation: string","type":"text"}]},{"type":"paragraph","content":[{"text":"Including this option tells the SDK to download a copy of each file in the Exhibit/Files tab of the Gumband UI and save them in this location. The SDK will automatically sync these files each time it starts and connects to Gumband, but the files can also be synced manually with the ","type":"text"},{"text":"gb.content.sync()","type":"text","marks":[{"type":"code"}]},{"text":" function.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"endpoint: string","type":"text"}]},{"type":"paragraph","content":[{"text":"Set to “app” by default. May be set to “custom” if ","type":"text"},{"text":"app.gumband.com","type":"text","marks":[{"type":"code"}]},{"text":" is not the instance of Gumband to which you’re connecting your exhibit. If set to “custom”, the sdk can connect the “customServerIP” option or ","type":"text"},{"text":"0.0.0.0","type":"text","marks":[{"type":"code"}]},{"text":" if “customServerIP“ is left undefined.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"customServerIP: string","type":"text"}]},{"type":"paragraph","content":[{"text":"If the “endpoint” configuration option is set to “custom”, this option can be set in order to tell the SDK the IP address of the Gumband server to which it is connecting. Set to ","type":"text"},{"text":"0.0.0.0","type":"text","marks":[{"type":"code"}]},{"text":" by default.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"version: string","type":"text"}]},{"type":"paragraph","content":[{"text":"The version of the Gumband Cloud to which the exhibit should connect. Set to “v1” by default.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"noInternetConnection: boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Tells the SDK that the exhibit is expected to be disconnected from the internet, and should not attempt to authenticate with Gumband.","type":"text"}]},{"type":"paragraph","content":[{"text":"allowOnlyCloudHardwareIds: boolean","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Tells the SDK only to allow messages from hardware associated with the same exhibit as the SDK.","type":"text"}]},{"type":"paragraph","content":[{"text":"allowedHardwareIds: number[]","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"A whitelist of hardware IDs. The SDK is only permitted to process messages from hardware on this whitelist. By default, messages from all hardware IDs are permitted.","type":"text"}]},{"type":"paragraph","content":[{"text":"useLocalMQTTBroker: boolean","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Whether a local MQTT broker should be started when the SDK is initialized. This MQTT broker is used to communicate with Gumband Hardware.","type":"text"}]},{"type":"paragraph","content":[{"text":"MQTTBrokerIP: string","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"An IP for the user provided MQTT broker. The SDK will attempt to open an MQTT client connection to this IP and the port from the MQTTBrokerPort option.","type":"text"}]},{"type":"paragraph","content":[{"text":"MQTTBrokerPort: number","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":" This option is the port that the local MQTT broker is exposed on, or the port that the SDK should attempt to connect to if running a third part MQTT broker.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"skipOrganizationFileSync: boolean","type":"text"}]},{"type":"paragraph","content":[{"text":"Set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" by default. Tells the SDK not to download all organization files along with the exhibit files when the “contentLocation” option is provided. Exhibit files are only accessible by the exhibit under the Exhibit/Files tab in the Gumband UI, but organization files are available to all exhibits under the organization and can be seen under each exhibits' Files tab. Organization files are prefixed by “[ORG]” and are managed by the Strapi CMS.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"SDK Base Function Library","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"isReady( )","type":"text"}]},{"type":"paragraph","content":[{"text":"Returns true if Gumband is connected to the Gumband Cloud and is ready to process requests. Useful when the Gumband SDK is initialized in multiple places since the constructor returns a singleton and it is possible to \"miss\" the READY event if an event listener is not configured yet.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"setManifest(manifestLocation: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Use a local manifest to update the exhibit items on the gumband cloud. This function updates the SDK cache of the manifest as well.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"manifestLocation","type":"text"}]},{"type":"paragraph","content":[{"text":"The directory path to the manifest.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.setManifest('./path/to/manifest.json');","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getOperatingMode( ): Promise","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The Operating Mode feature is deprecated and disabled by default. You can continue to use it, but we plan to replace it with a more functional feature in the future. When the feature is disabled, this method will always resolve ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":". To enable the OperatingMode feature, call the ","type":"text"},{"text":"setOperatingMode","type":"text","marks":[{"type":"code"}]},{"text":" method once while the SDK is connected to the Gumband platform.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Get the current operating mode for the exhibit from Gumband.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"let operatingMode = await gumbandSDK.getOperatingMode();\n\nconsole.log(`Operating Mode: ${operatingMode}`);\n// Operating Mode: true","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"setOperatingMode(opMode: boolean): Promise","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The Operating Mode feature is deprecated and disabled by default. You can continue to use it, but we plan to replace it with a more functional feature in the future. To enable the OperatingMode feature, call the ","type":"text"},{"text":"setOperatingMode","type":"text","marks":[{"type":"code"}]},{"text":" method once while the SDK is connected to the Gumband platform.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Set the operating mode for the exhibit in Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"opMode","type":"text"}]},{"type":"paragraph","content":[{"text":"The target operating mode.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.setOperatingMode(true);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getStatus(statusName: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the value of a status from Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"statusName","type":"text"}]},{"type":"paragraph","content":[{"text":"The “id” field of the status in the manifest.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"let statusValue = await gumbandSDK.getStatus('cpu-usage');\n\nconsole.log(`CPU Usage: ${statusValue}`);\n// CPU Usage: 50%","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"setStatus(statusName: string, value: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the value of a status in Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"statusName","type":"text"}]},{"type":"paragraph","content":[{"text":"The “id” field of the status in the manifest.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"value","type":"text"}]},{"type":"paragraph","content":[{"text":"The target value to which the status should be set.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.setStatus('cpu-usage', \"50%\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getSetting(manifestId: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the value of a setting from Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"manifestId","type":"text"}]},{"type":"paragraph","content":[{"text":"The “id” field of the setting in the manifest.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"let motorRPM = await gumbandSDK.getSetting('motor-rpm');\n\nconsole.log(`Motor RPM: ${motorRPM}`);\n// Motor RPM: 30","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"setSetting(settingName: string, value: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Set the value of a setting in Gumband.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"settingName","type":"text"}]},{"type":"paragraph","content":[{"text":"The “id” field of the setting in the manifest.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"value","type":"text"}]},{"type":"paragraph","content":[{"text":"The target value to which the setting should be set.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.setSetting('motor-rpm', '30');","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getAllSettings( ): Promise>","type":"text"}]},{"type":"paragraph","content":[{"text":"Get all settings as a map, where the key is the “id” field of each setting in the manifest.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.getAllSettings());\n\n//{\n// 'motor-rpm': {\n// id: 14,\n// manifestId: 'motor-rpm',\n// exhibitId: 1,\n// type: 'IntegerInput',\n// display: 'Motor RPM',\n// enabledOpMode: null,\n// value: 30,\n// default: 0,\n// order: 0,\n// touchless: null,\n// listId: null,\n// groupId: null,\n// read: true,\n// write: true\n// }\n//}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getAllSettingLists( ): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get all setting lists in the manifest as an array.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.getAllSettingLists());\n\n//[\n// {\n// id: 1,\n// exhibitId: 1,\n// manifestId: 'my-list',\n// listDisplay: 'List Label',\n// listParent: null,\n// schema: [ [Object], [Object] ],\n// listItemCount: 1,\n// order: [ 'item 1' ],\n// orderSelf: null,\n// groupId: null,\n// settinglistitems: [ [Object] ],\n// type: 'SettingsList'\n// }\n//]","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getOnlineHardware( ): Hardware[ ]","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the list of Gumband Hardware that are currently connected to the SDK.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(gumbandSDK.getOnlineHardware());\n\n//[\n// {\n// hardwareId: 83,\n// name: 'Gumband SDK Tutorial',\n// peripherals: { Button: [Object], LED: [Object] }\n// }\n//]","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Exhibit","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"exhibit.getManifest( ): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the full manifest of this exhibit from Gumband.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.exhibit.getManifest());\n\n//{\n// manifest: {\n// id: 249,\n// siteId: 34,\n// name: 'Gumband SDK Tutorial',\n// mqttPath: '',\n// online: true,\n// manifestLocked: false,\n// opMode: 'On',\n// settingLists: [],\n// settingGroups: [ [Object], [Object] ],\n// settings: [ [Object] ],\n// statuses: [ [Object], [Object], [Object] ],\n// controls: [ [Object], [Object] ],\n// strapiContent: []\n// }\n//}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"exhibit.getStrapiContentSetting(id: number): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get an exhibit setting with type ","type":"text"},{"text":"StrapiContent","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"The database ID of the StrapiContent.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Hardware","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.setProperty(id: string, topic: string, value: any, options: any): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Set a hardware property to a value.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"topic","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"property/path","type":"text","marks":[{"type":"code"}]},{"text":", which is the name and path to the property that is having its value set.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"value","type":"text"}]},{"type":"paragraph","content":[{"text":"The new value to which the property will be set.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"[options.source]","type":"text"}]},{"type":"paragraph","content":[{"text":"The source of the property. Can be either “system”, which come on the Gumband Hardware by default, or “app”, which are created in the user firmware. This value will be set to “app” by default.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"//gmbnd_bool property type\nawait gumbandSDK.hardware.setProperty(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\", \"My Property\", 1);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getProperty(id: string, topic: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get the value of the given property.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"topic","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"property/path","type":"text","marks":[{"type":"code"}]},{"text":", which is the name and path to the property that is having its value set.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"[options.source]","type":"text"}]},{"type":"paragraph","content":[{"text":"The source of the property. Can be either “system”, which come on the Gumband Hardware by default, or “app”, which are created in the user firmware. This value will be set to “app” by default.","type":"text"}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"//gmbnd_bool property type\nconsole.log(await gumbandSDK.hardware.getProperty(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\", \"My Property\"));\n\n// 1","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getRegisteredProperties(id: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get all registered properties for a hardware. Will not include values for those properties","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"[options.source]","type":"text"}]},{"type":"paragraph","content":[{"text":"The source of the property. Can be either “system”, which come on the Gumband Hardware by default, or “app”, which are created in the user firmware. This value will be set to “app” by default.","type":"text"}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"//gmbnd_bool property type\nconsole.log(await gumbandSDK.hardware.getRegisteredProperties(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\"));\n\n// [{\n// path: 'Types/My Bool',\n// desc: '',\n// index: 1,\n// type: 'gmbnd_primitive',\n// format: '!?',\n// length: 1,\n// settable: true,\n// gettable: true,\n// ui_hidden: false\n// }]","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.reboot(id: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Triggers a reboot of the hardware matching the given ID.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.hardware.reboot(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.identify(id: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Triggers the hardware matching the given ID to identify itself by flashing its LED.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.hardware.identify(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getExhibitHardware( ): Promise>","type":"text"}]},{"type":"paragraph","content":[{"text":"Get all hardware associated with this exhibit in the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.hardware.getExhibitHardware());\n\n//[\n// {\n// id: '782ff2c2-11ef-489f-aa79-d0c229cd4799',\n// exhibitApi: 'v1',\n// exhibitId: 407,\n// name: 'My Hardware',\n// type: 'custom-hardware',\n// connected: false,\n// connectedChangedAt: null,\n// category: 'hardware'\n// }\n//]","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.sendMqttMessage(topic: string, rawPayload): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Sends an MQTT message directly to the hardware with the given topic and rawPayload.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"topic","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"{hardwareId}/{prop}","type":"text","marks":[{"type":"code"}]},{"text":", where ","type":"text"},{"text":"hardwareId","type":"text","marks":[{"type":"code"}]},{"text":" is the ID of the hardware found under the Hardware/Auth tab in the Gumband UI, and ","type":"text"},{"text":"prop","type":"text","marks":[{"type":"code"}]},{"text":" is the name of the property that is having its value set.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"rawPayload","type":"text"}]},{"type":"paragraph","content":[{"text":"The raw value to be sent directly by the hardware.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getAllRegisteredHardware(): Promise>","type":"text"}]},{"type":"paragraph","content":[{"text":"Gets a map of all registered hardware keyed by the hardware id.","type":"text"}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.hardware.getAllRegisteredHardware());\n\n//[\n// {\n// id: \"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\",\n// system: {\n// info: {\n// ...systemInfo\n// },\n// properties: {\n// ...systemProperties\n// }\n// },\n// app: {\n// info: {\n// ...appInfo\n// },\n// properties: {\n// ...appProperties\n// }\n// }\n// }\n//]","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getRegisteredHardware(id: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Gets a hardware that is registered.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"id","type":"text"}]},{"type":"paragraph","content":[{"text":"A string of the form ","type":"text"},{"text":"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7","type":"text","marks":[{"type":"code"}]},{"text":". This is the hardware ID.","type":"text"}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.hardware.getRegisteredHardware(\"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\"));\n\n// {\n// id: \"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\",\n// system: {\n// info: {\n// ...systemInfo\n// },\n// properties: {\n// ...systemProperties\n// }\n// },\n// app: {\n// info: {\n// ...appInfo\n// },\n// properties: {\n// ...appProperties\n// }\n// }\n// }","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"hardware.getIdFromName(name: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Gets a hardware id from the given name.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"name","type":"text"}]},{"type":"paragraph","content":[{"text":"The name of the hardware that the user gave it in the Gumband UI.","type":"text"}]},{"type":"paragraph"},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"console.log(await gumbandSDK.hardware.getRegisteredHardware(\"My Hardware\"));\n\n// \"ed028e04-41d9-4e77-a5d2-ab4e7346e3a7\"","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Content","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"content.getRemoteFileList( ): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a list of all remote file names. These file names will match the files list under the Exhibit/Files tab in the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"let remoteFiles = await gumbandSDK.content.getRemoteFileList();\n\nconsole.log(remoteFiles);\n//{\n// response: 'OK',\n// files: [\n// {\n// file: 'gumband-cassette.png',\n// name: 'gumband-cassette.png',\n// hash: 'SlTZJxaq+s5YH4R1KX6wHA==',\n// lastUpdated: '2023-08-14T19:22:08.547Z',\n// size: '81204'\n// }\n// ],\n// errors: []\n//}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"content.getLocalFileList( ): File[ ]","type":"text"}]},{"type":"paragraph","content":[{"text":"Get a list of all locally saved file names for the exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"let localFiles = gumbandSDK.content.getLocalFileList();\n\nconsole.log(localFiles);\n//{\n// files: [\n// {\n// file: 'gumband-cassette.png',\n// name: 'gumband-cassette.png',\n// hash: 'SlTZJxaq+s5YH4R1KX6wHA==',\n// lastUpdated: '2023-08-14T19:22:08.547Z',\n// size: '81204'\n// }\n// ]\n//}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"content.sync( ): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Sync locally saved files with the list of remote files. This is called whenever the SDK makes a connection to Gumband if local files is enabled.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.content.sync();","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"content.uploadFile(fileStream: ReadStream): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Uploads a file to the list of remote files for the exhibit.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"fileStream","type":"text"}]},{"type":"paragraph","content":[{"text":"A stream of data from a function such as ","type":"text"},{"text":"fs.createReadStream(\"path/to/file\")","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"const fileStream = fs.createReadStream(\"path/to/file\");\nawait gumbandSDK.content.uploadFile(fileStream);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"content.downloadFile(","type":"text"},{"text":"file: string)","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":": Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Downloads the given file name from the remote list of files for the exhibit in Gumband, and saves it in the contentLocation directory for the locally saved exhibit files. Existing files with the same name will be overwritten.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"file","type":"text"}]},{"type":"paragraph","content":[{"text":"The name of the file.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.content.downloadFile(\"gumband-cassette.png\");","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Event","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"event.create(eventName: string, data: any): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a reporting event of the given event name, and includes the data object given as an object on the event.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"eventName","type":"text"}]},{"type":"paragraph","content":[{"text":"The name of the reporting event.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"data","type":"text"}]},{"type":"paragraph","content":[{"text":"Any data object to be associated with the event.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.event.create(\"Red Button Pressed\", { holdTime: 2.52 });","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Logger","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"logger.info","type":"text","marks":[{"type":"link","attrs":{"href":"http://logger.info"}}]},{"text":"(message: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs a message to Gumband as an “info” level log. Logs can be viewed under the Exhibit/Logs tab in the Gumband UI.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"message","type":"text"}]},{"type":"paragraph","content":[{"text":"The message for the log.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.logger.info(\"This is an info log message\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"logger.debug(message: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs a message to Gumband as an “debug” level log. Logs can be viewed under the Exhibit/Logs tab in the Gumband UI.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"message","type":"text"}]},{"type":"paragraph","content":[{"text":"The message for the log.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.logger.debug(\"This is a debug log message\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"logger.warn(message: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs a message to Gumband as an “warn” level log. Logs can be viewed under the Exhibit/Logs tab in the Gumband UI.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"message","type":"text"}]},{"type":"paragraph","content":[{"text":"The message for the log.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.logger.warn(\"This is a warning log message\");","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"logger.error(message: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs a message to Gumband as an “error” level log. Logs can be viewed under the Exhibit/Logs tab in the Gumband UI.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"message","type":"text"}]},{"type":"paragraph","content":[{"text":"The message for the log.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.logger.error(\"This is an error log message\");","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Metrics","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.broadcastEventConfigs(manifest: object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Sends metrics configurations from the manifest to the gumband cloud","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.broadcastEventConfigs(manifest);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.create(eventName: string, data: object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Creates a metrics event for a given exhibit","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.create('Use_Pressed_Button_1', { buttonType: 'accept', score: 72, isGameOver: false});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.endInteraction(data?: object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Ends an active interaction for a given exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.endInteraction()","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.startInteraction(data?: object)","type":"text"}]},{"type":"paragraph","content":[{"text":"Starts an active interaction for a given exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.startInteraction()","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.createConcurrent(eventName: string, data: object, interactionId?: string): string","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is identical to the create method except that it attaches an interactionId to each event, so Gumband can tell the difference between events for different, concurrent interactions. It will return the generated interactionId so it can be attached to future events for this interaction.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.createConcurrent('Use_Pressed_Button_1', { buttonType: 'accept', score: 72, isGameOver: false}, interactionId);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.startConcurrentInteraction(data: object, interactionId?: string): string","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is identical to the startInteraction method except that it generates and attaches an interactionId to each event, so Gumband can tell the difference between events for different, concurrent interactions. It will return the generated interactionId so it can be attached to future events for this interaction.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.startConcurrentInteraction({}, interactionId);","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"metrics.endConcurrentInteraction(data: object, interactionId: string): string","type":"text"}]},{"type":"paragraph","content":[{"text":"This method is identical to the endInteraction method except that it attaches an interactionId to each event, so Gumband can tell the difference between events for different, concurrent interactions.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","content":[{"text":"gumbandSDK.metrics.startConcurrentInteraction({}, interactionId);","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Notification","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"notifications.email(message: string): Promise","type":"text"}]},{"type":"paragraph","content":[{"text":"Sends a custom email notification through Gumband. Custom email notifications can be subscribed to on an individual user basis under the Exhibit/Notifications tab of the Gumband UI.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"message","type":"text"}]},{"type":"paragraph","content":[{"text":"The message for the custom email notification.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"await gumbandSDK.notification.email(\"Your exhibit requires maintenance\");","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Websocket Events","type":"text"}]},{"type":"paragraph","content":[{"text":"This is a list of the possible websocket events that may be emitted by the SDK; for example:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"const { Sockets } = require(\"@deeplocal/gumband-node-sdk\");\n\ngumbandSDK.on(Sockets.CONTROL_RECEIVED, (payload) => {\n //code reached when the SDK emits a Sockets.CONTROL_RECEIVED event\n});","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.READY","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted after the SDK successfully authenticates with Gumband, comes online, and is ready to make requests to Gumband.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.READY, (manifest) => {\n console.log(manifest);\n \n // {\n // id: 1,\n // siteId: 1,\n // name: 'E',\n // mqttPath: null,\n // online: true,\n // manifestLocked: false,\n // opMode: 'Off',\n // settingLists: [...],\n // settingGroups: [...],\n // settings: [...],\n // statuses: [...],\n // controls: [...],\n // strapiContent: [...]\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.EXHIBIT_ONLINE","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when the SDK successfully authenticates with Gumband and comes online.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.EXHIBIT_ONLINE, () => {\n //no payload for the the Sockets.EXHIBIT_ONLINE event.\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.EXHIBIT_OFFLINE","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when the SDK losses its websocket connection with Gumband.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.EXHIBIT_OFFLINE, () => {\n //no payload for the the Sockets.EXHIBIT_OFFLINE event.\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.CONTROL_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a control is triggered, usually through the Exhibit/Controls tab in the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.CONTROL_RECEIVED, async (payload) => {\n console.log(payload);\n\n // {\n // id: 'control_manifest_id',\n // touchless: undefined,\n // sessionId: undefined,\n // sessionUser: undefined\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.SETTING_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a setting is changed, usually through the Exhibit/Settings tab in the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.SETTING_RECEIVED, (payload) => {\n console.log(payload);\n \n // {\n // id: 'setting_manifest_id',\n // value: 'new value',\n // touchless: undefined,\n // sessionId: undefined,\n // sessionUser: undefined\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.SETTING_LIST_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a new setting list item is added or deleted, when the setting list items have their order changed, or when a setting within a setting list item is changed. The payload is the new setting list with all of its items.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.SETTING_LIST_RECEIVED, (payload) => {\n console.log(payload);\n \n // { \n // id: 'setting_list_manifest_id', \n // value: [\n // ...settingListItems\n // ]\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.SETTING_LIST_ITEM_DELETED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a setting list item is deleted. The payload is the setting list item that was deleted.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.SETTING_LIST_ITEM_DELETED, (payload) => {\n console.log(payload);\n \n // {\n // \"id\": \"list_manifest_id\",\n // \"value\": [\n // {\n // \"id\": \"deleted_list_item_name\",\n // \"value\": [ ...listItemValues ]\n // }\n // ]\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.OP_MODE_RECEIVED","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The Operating Mode feature is deprecated and disabled by default. You can continue to use it, but we plan to replace it with a more functional feature in the future. While the feature is disabled, this event will not be emit to your software. To enable the OperatingMode feature, call the ","type":"text"},{"text":"setOperatingMode","type":"text","marks":[{"type":"code"}]},{"text":" method once while the SDK is connected to the Gumband platform.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Emitted when the Operation Mode is changed, usually through the Exhibit dashboard in the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.OP_MODE_RECEIVED, (payload) => {\n console.log(payload);\n \n // {\n // value: true\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_CONNECTED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a Gumband Hardware connects to the exhibit SDK.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_CONNECTED, (payload) => {\n console.log(payload);\n \n // {\n // id: \"hardware-id\"\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_DISCONNECTED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a Gumband Hardware disconnects from the exhibit SDK.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_DISCONNECTED, (payload) => {\n console.log(payload);\n \n // {\n // id: \"hardware-id,\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_SYSTEM_REGISTERED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted after a Gumband Hardware connects to and registers its system info/properties with the exhibit SDK. ","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_SYSTEM_REGISTERED, (payload) => {\n console.log(payload);\n \n // {\n // id: \"hardware-id\",\n // system: {\n // info: {\n // ...systemInfo\n // },\n // properties: {\n // ...systemProperties\n // }\n // },\n // app: {\n // info: {\n // ...appInfo\n // },\n // properties: {\n // ...appProperties\n // }\n // }\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_APP_REGISTERED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a Gumband Hardware connects to and registers its app info/properties with the exhibit SDK. ","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_APP_REGISTERED, (payload) => {\n console.log(payload);\n \n // {\n // id: \"hardware-id\",\n // system: {\n // info: {\n // ...systemInfo\n // },\n // properties: {\n // ...systemProperties\n // }\n // },\n // app: {\n // info: {\n // ...appInfo\n // },\n // properties: {\n // ...appProperties\n // }\n // }\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_FULLY_REGISTERED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a Gumband Hardware connects to and registers its app and system info/properties with the exhibit SDK. ","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_FULLY_REGISTERED, (payload) => {\n console.log(payload);\n \n // {\n // id: \"hardware-id\",\n // system: {\n // info: {\n // ...systemInfo\n // },\n // properties: {\n // ...systemProperties\n // }\n // },\n // app: {\n // info: {\n // ...appInfo\n // },\n // properties: {\n // ...appProperties\n // }\n // }\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_SYSTEM_PROPERTY_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a system property is changed in a Gumband Hardware that is connected to the exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_SYSTEM_PROPERTY_RECEIVED, async (payload) => {\n console.log(payload);\n \n // {\n // id: 'hardware-id',\n // info: {\n // system: { info: [Object], properties: [Array] },\n // app: { info: [Object], properties: [Array] }\n // },\n // value: [ \"myValue\" ],\n // property: 'My Property',\n // source: 'app'\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_APP_PROPERTY_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when an app property is changed in a Gumband Hardware that is connected to the exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_APP_PROPERTY_RECEIVED, async (payload) => {\n console.log(payload);\n \n // {\n // id: 'hardware-id',\n // info: {\n // system: { info: [Object], properties: [Array] },\n // app: { info: [Object], properties: [Array] }\n // },\n // value: [ \"myValue\" ],\n // property: 'My Property',\n // source: 'app'\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.HARDWARE_PROPERTY_RECEIVED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when either a system or app property is changed in a Gumband Hardware that is connected to the exhibit.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.HARDWARE_PROPERTY_RECEIVED, async (payload) => {\n console.log(payload);\n \n // {\n // id: 'hardware-id',\n // info: {\n // system: { info: [Object], properties: [Array] },\n // app: { info: [Object], properties: [Array] }\n // },\n // value: [ \"myValue\" ],\n // property: 'My Property',\n // source: 'app'\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.FILE_UPLOADED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a new file has been uploaded to Gumband, usually through the Exhibit/Files tab of the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.FILE_UPLOADED, (payload) => {\n console.log(payload);\n \n // {\n // file: 'uploadedFileName.png',\n // size: 7891,\n // exhibitId: '1',\n // lastUpdated: '2023-08-28T16:14:54.418Z'\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.FILE_DELETED","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when a file is deleted from Gumband, usually through the Exhibit/Files tab of the Gumband UI.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.FILE_DELETED, (payload) => {\n console.log(payload);\n \n // { \n // file: 'deletedFileName.png'\n // }\n});","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sockets.ERROR","type":"text"}]},{"type":"paragraph","content":[{"text":"Emitted when any error is logged to the local logger via Gumband.","type":"text"}]},{"type":"expand","attrs":{"title":"Example"},"content":[{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"gumbandSDK.on(Sockets.ERROR, (payload) => {\n console.log(payload);\n \n // This is an error message\n // Note: you can forward these errors to the Gumband UI by calling:\n // gumbandSDK.logger.error(payload);\n});","type":"text"}]}]},{"type":"paragraph"}],"version":1}

Browser not supported