Skip to content

hologfx/holographics-client-sdk

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Welcome to Holographics

Holographics is the fastest and easiest way to add live graphics to your videos. Easily overlay lower-thirds, broadcast messages, ticker tapes and your own custom widgets on any live video feed. Or output Key & Fill signals using a supported application.

https://hologfx.io/

For examples and usage, please refer to the Documentation.

This is the Holographics SDK

This simple library can be used to connect to Holographics and execute functions against its API, either through REST methods or via Websockets. Websockets offer the additional advantage of receiving events from the server as well.

Information on how to use this API can be found in our API docs: https://holographics.restlet.io

You can find all available routes and methods in EXAMPLES.md.

Prerequisites

Note that this SDK works only with Holographics versions 1.2.0 and up.

Node, Yarn or NPM installed

Installation

yarn
or
npm install

Useage example

const sdk = require('holographics-client-sdk')

// Choose to go with the REST or Socket API.
// Best option is Socket if you have the choice.

//let Holographics   = new sdk.REST('http://localhost:3000')
let Holographics = new sdk.Socket('http://localhost:3000')

// From here the API's are identical
// The general pattern is API.service.method().

Holographics.state.get().then((response) => {
  console.log(response)
})

// You can access the socket as well:
Holographics.socket.on('stateChanged', (state) => {
  console.log(state)
})

// Get the list of events you can receive this way in EXAMPLES.md

// You need to pass in an ID for some requests:
Holographics.widgets.get({
  id: 'widgetidgoeshere'
}).then((widget) => {
  // do something with widget
})

// And in some cases you need both an ID and data:
Holographics.entries.patch({
  id: 'entryidgoeshere',
  data: {
    visibility: false
  }
})

Meta

Floris Porro – @florisporro

About

This simple library can be used to connect to Holographics and execute functions against its API.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published