Get started
Installation
Browser
Add the handy-channel-sdk lib to your website.
Latest:
<script src="https://unpkg.com/@poengalex/handy-channel-sdk"></script>Specific version:
<script src="https://unpkg.com/@poengalex/handy-channel-sdk@1.0.2"></script>Latest of major
<script src="https://unpkg.com/@poengalex/handy-channel-sdk@1"></script>Access the the handy channel sdk by HandyChannel.XXXXX where XXXX is function or variable listed in this document.
Other
npm i @poengalex/handy-channel-sdk
Please note that documentation is written with browser use in mind. Please remove HandyChannel. from any functions or varibles in this SDK to use it with import.
Another note: you should try and catch Promise when using await. For readability try and catch is not added to the examples in this documentation.
Examples
Create a controller
This example will create a channel and set the mode to up and down motion (HAMP - default), start motion and finally set the speed to 50%.
Share channelId and subscriberKey to the users that wants to join the channel.
let controller = new HandyChannel.Controller();
let channel = await controller.createChannel();
//Share channelId and subscriberKey to the subscribers:
console.log("channel.channelId:", channel.channelId);
console.log("channel.subscriberKey:", channel.subscriberKey);
await controller.start();
await controller.setSpeed(50);Create a user
This example will make a Handy join a channel with id: channelId and key: subscriberKey
let user = new HandyChannel.User("YOUR_CONNECTION_KEY");
await user.joinChannel("channelId","subscriberKey")How to use
API docs
The full detailed channel docs can be found here: https://staging.handyfeeling.com/api/channel/v0/docs/.
Controller
You must initiate the Controller before you can use all the functions. this can be done with createChannel if you want a new channel or reuseExistingChannel if you want to reuse a channel you already have created.
Controller class
Controller constructor.
apiUrlConfig - Optional API config (channel API url and Handy API v2 url) - default is set to Production config - optional open API config
constructor(apiUrlConfig: ApiUrlConfig = CHANNEL_CONFIG_PRODUCTION, channelConfig: Partial<OpenAPIConfig> = {},apiConfig: Partial<OpenAPIConfig> = {}) {Example production:
let controller = new HandyChannel.Controller()Example staging:
let controller = new HandyChannel.Controller(HandyChannel.CHANNEL_CONFIG_STAGING);createChannel
Creates a new channel
createChannel(name: string = "", description: string = ""): Promise<Channel>Example production:
let controller = new HandyChannel.Controller();
let channel = await controller.createChannel();
//Share channelId and subscriberKey to the subscribers:
console.log("channel.channelId:", channel.channelId);
console.log("channel.subscriberKey:", channel.subscriberKey);reuseExistingChannel
Reuses a exsisting channel. Use this function to initialize a channel that you already have created.
reuseExistingChannel(channelId: ChannelId,channelKey: string): Promise<Channel>Example production:
let controller = new HandyChannel.Controller();
let channel = await reuseExistingChannel("CHANNEL_ID", "CHANNEL_KEY");getChannelInfo
Gets the latest channel info / Including any meta data that is change when setting commands
getChannelInfo(): Promise<Channel>Example production:
let controller = new HandyChannel.Controller();
let channelInfo = await getChannelInfo();updateChannelInfo
Updates the channel information
updateChannelInfo(update: ChannelUpdate): Promise<Channel>Example production:
let controller = new HandyChannel.Controller();
await controller.updateChannelInfo({name: "A_NEW_CHANNEL_NAME", description: "A_NEW_CHANNEL_DESCRIPTION"});updateChannelInfo
Close a channel
closeChannel(): Promise<Channel>Example production:
let controller = new HandyChannel.Controller();
await controller.closeChannel();getSubscribers
Get a list of all the subscribers that are subscribing to the channel
getSubscribers(): Promise<Subscriber[]>Example production:
let controller = new HandyChannel.Controller();
let subscribers = await controller.getSubscribers();setMode
Set mode on all the subscribers
- Default is HAMP mode. HAMP mode is a a mode where the Handy moves up and down continuslly with a set speed.
NB! Currently only HAMP mode is supported in the Channel API NB! When creating a new channel the Mode is set to HAMP
setMode(mode:Mode = Mode.HAMP) : Promise<ModeUpdateResponse | ErrorResponse>Example production - set mode to HAMP mode:
let controller = new HandyChannel.Controller();
await controller.setMode();start
Start the subscribing machines
NB! The channel must be in mode HAMP to use this function
start(start) : Promise<HAMPStartResponse | ErrorResponse>Example production - start:
let controller = new HandyChannel.Controller();
await controller.start();stop
Stop the subscribing machines
NB! The channel must be in mode HAMP to use this function
stop(start) : Promise<HAMPStopResponse | ErrorResponse>Example production - start and stop after 5000ms:
let controller = new HandyChannel.Controller();
await controller.start();
setTimeout(async ()=>{
await controller.stop();
},5000)setSpeed
Set the speed of the subscribing machines
NB! The channel must be in mode HAMP to use this function. start must be called to for this to have an effect. When calling start() the speed is reset to 0%.
setSpeed(velocity:number) : Promise<HAMPVelocityPercentResponse | ErrorResponse>Example production - set speed to 50%:
let controller = new HandyChannel.Controller();
await controller.start();
await controller.setSpeed(50);setSpeed
Set the speed of the subscribing machines
NB! The channel must be in mode HAMP to use this function. start must be called to for this to have an effect. When calling start() the speed is reset to 0%.
setStrokeZone(settings: SlideSettings) : Promise<SlideUpdateResponse | ErrorResponse>Example 1: set min stroke to 10%:
let controller = new HandyChannel.Controller();
await controller.start();
await controller.setStrokeZone({min:10});Example 2: set max stroke to 90%:
let controller = new HandyChannel.Controller();
await controller.start();
await controller.setStrokeZone({max:90});Example 3: set min stroke to 20% and max stroke to 75%:
let controller = new HandyChannel.Controller();
await controller.start();
await controller.setStrokeZone({min:20,max:75});Admin
This class is only for Handy admins and approved moderators.
Admin class
Admin constructor. adminAuth - Admin auth token ApiUrlConfig - Optional API config (channel API url and Handy API v2 url) - default is set to Production config - optional open API config
constructor(adminAuth: string,apiUrlConfig: ApiUrlConfig = CHANNEL_CONFIG_PRODUCTION,config: Partial<OpenAPIConfig> = {}) {Example production:
let admin = new HandyChannel.Admin("MY_SECRET_ADMIN_KEY");Example staging:
let admin = new HandyChannel.Admin("MY_SECRET_ADMIN_KEY",HandyChannel.CHANNEL_CONFIG_STAGING);listChannels
List all active channels
listChannels(): Promise<Channel>Example - List all active channel on production servers:
let admin = new HandyChannel.Admin("MY_SECRET_ADMIN_KEY");
let channels = await admin.listChannels