Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@enplug/sdk-player

Package Overview
Dependencies
Maintainers
29
Versions
97
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@enplug/sdk-player

Enplug Player SDK

  • 0.11.8
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
41
increased by485.71%
Maintainers
29
Weekly downloads
 
Created
Source

Player SDK

The Player SDK is a JavaScript library which provides communication between the app hosted within the Player's iframe with the hosting Player. It allows to fetch the value of the asset which is to be displayed, manage the app's lifecycle, fetch device's settings and others.

:::note Development tips The app using Player SDK has to be run inside of the Player's iframe to function properly as the SDK serves as a transport channel of the messages only. All commands are actually executed by the hosting Player. This means that running your app outside of the Player will not work. To run your app inside of the Player, you need to add it to the system. See Creating an App. After you create a new asset in the Dashboard part of the app and assign it to some Display Group, the app should start appearing in the Player. :::

Installing the Player SDK

Include the Player SDK script in your app, by adding the following code to the <head> section of your app's HTML file:

<script type="text/javascript" src="https://apps.enplug.com/sdk/v1/player.js"></script>

This will create a global enplug/window.enplug object providing various SDK methods for communicating with the hosting Player.

Type support

If you use TypeScript and would like to have the typings checked in your IDE you can load the following NPM package:

npm install @enplug/sdk-player --save-dev

Then, add "@enplug/sdk-player" to the types array in your TypeScript config file. Make sure that typeRoots array has the "node_modules" entry, so that the whole path is available to the compiler.

Usage

After the Player SDK script gets loaded into your app, it will instantly create a global enplug/window.enplug object which gives you the access to the methods provided by the Player.

See more: enplug

Useful APIs

Account API

Use enplug.appStatus to manage app's lifecycle.

  • {@link start|enplug.appStatus.start()} - app is ready
  • {@link error|enplug.appStatus.error()} - app has errored and cannot be displayed
  • {@link hide|enplug.appStatus.hide()} - app should be hidden
  • {@link setCanInterrupt|enplug.appStatus.setCanInterrupt()} - informs whether the app can be hidden

See more: enplug.appStatus

Assets API

Use enplug.assets to fetch the value of the assets that is to be displayed or the selected theme.

  • {@link getNext|enplug.assets.getNext()} - fetch the value of the asset that is to be displayed
  • {@link getTheme|enplug.assets.getTheme()} - get the currently selected theme

See more: enplug.assets

Settings API

Use enplug.settings to fetch the settings of the device and the player.

  • {@link all|enplug.settings.all} - returns all device settings

Others

See more: enplug

Keywords

FAQs

Package last updated on 05 Apr 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc