JavaScript SDK for Improv Wi-Fi over BLE
Installation
You can use the JavaScript SDK by adding the following HTML to your website:
<script type="module" src="https://www.improv-wifi.com/sdk-js/launch-button.js"></script>
If you are using a bundler and JavaScript package manager, you can install the SDK via NPM:
npm install --save improv-wifi-sdk
And then import it in your code:
import 'improv-wifi-sdk';
Usage
Add the following to your website to show a button to start the provisioning process:
<improv-wifi-launch-button></improv-wifi-launch-button>
A warning message will be rendered if the browser does not support WebBluetooth.
Attributes
The following attributes are automatically added to <improv-wifi-launch-button>
and can be used for styling:
Attribute | Description |
---|---|
supported |
Added if this browser is supported |
unsupported |
Added if this browser is not supported |
Slots
It is possible to customize the button and the message. You do this by putting your elements inside the <improv-wifi-launch-button>
element and adding the appropriate slot
attribute. Use activate
to replace the activation button and unsupported
to replace the unsupported message:
<improv-wifi-launch-button>
<button slot='activate'>Start provisioning!</button>
<span slot='unsupported'>Your browser does not support provisioning.</span>
</improv-wifi-launch-button>
Events
When the state of provisioning changes, a state-changed
event is fired.
A state-changed
event contains the following information:
Field | Description |
---|---|
state | The current state (CONNECTING , AUTHORIZATION_REQUIRED , AUTHORIZED , PROVISIONING , PROVISIONED , ERROR , UNKNOWN ) |
Browser Support
This SDK requires a browser with support for WebBluetooth. Currently this is supported by Google Chrome, Microsoft Edge and other browsers based on the Blink engine.
No iOS devices are supported.