npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@videomatik/player

v0.1.0

Published

``` ⚠ This lib is currently in alpha version and still in development, we are accepting feedback from the developers. ⚠ ```

Downloads

2

Readme

Videomatik Player SDK (Alpha!)

⚠ This lib is currently in alpha version and still in development, we are accepting feedback from the developers. ⚠

This module provides easy access to Videomatik's Player to get a preview of your video template with your customizations via the customJSON data.

Check the Support section for help.

Installation

npm i --save @videomatik/player@latest

Usage

Simple usage example rendering the player inside a div element.

import VideomatikPlayer from '@videomatik/player';

const player = new VideomatikPlayer('#videomatik-player', {
  apiKey: 'WDSi8lOCua5KKzPvzx2DI86medihfQj0U8T--qSm',
  templateId: 'conheca-a-italia', 
  compositionId: 'default', 
  height: 1280,
  width: 720,
});

<div id="videomatik-player"></div>

Authentication

First, you should get your Videomatik API Key on the Dashboard page, then you can start using this project by instantiating the main class.

const player = new VideomatikPlayer('<css selector or HTMLElement instance>', {
  apiKey: '< your api key >',
  templateId: '< your template id >', 
  compositionId: '< the selected composition id >', 
});

Options

WIP: More player options available in the future. See a preview of future options below:

const player = new VideomatikPlayer('#player', {
  apiKey: 'apiKey',
  templateId: 'templateId', 
  compositionId: 'compositionId',
  customJSON: {...}, // Optional, initial customJSON when load
  options: {
    autoplay: true, // default
    loaderColor: '#fffff',
    disabledLoader: false, // default
    pauseOnClick: true, // default
    progressUpdateInterval: 100, // default in milliseconds
  },
  events: {
    'onLoad' () => {},
    ...
  }
});

Templates and CustomJSON

If you are not familiar with the Template and CustomJSON entities for Videomatik, please check our API SDK documentation for more information. The same concept of customJSON applies to the Videomatik Player.

Update Player Methods

setTemplate(templateId: String, [compositionId: String, customJSON: Object])

  • templateId: Id of the Template to set
  • compositionId (Optional): Id of the template composition to set. Default is 'default'
  • customJSON (Optional): Initial customJSON to be passed on the first player render.

Updates the current template on the player, it will load the new template if not loaded yet.

Example:

player.setTemplate(templateId, compositionId, customJSON)

getCompositions()

Returns the compositions available for the current video Template. Returns Array[Object].

Example:

player.getCompositions()

// Response Example:
[ 
  {
    compositionId: 'default', 
    displayName: 'Vertical', 
    width: 1080, 
    height: 1920
  },
  {
    compositionId: 'feed', 
    displayName: 'Quadrado', 
    width: 1080, 
    height: 1080
  }
]

setComposition(compositionId: String)

  • compositionId: Id of the Composition to set.

Change the composition of your template. It will load the new composition video if not loaded yet.

Example:

player.setComposition('feed')

setCustomJSON(customJSON: Object)

  • customJSON`: Valid customJSON object with customized parameters for the video.

Updates the custom JSON of the video.

Example:

player.setCustomJSON({
  "version": "1",
  "soundtrack": {...},
  "images": [...],
  "texts": [...],
  "shapes": [...],
  "colors": [...],
})

Player Methods

setSize({ height: Number, width: Number })

Updates the size of the video player. Only one dimension is required. The player will fit the dimension specified and keep the video aspect ratio.

Example:

player.setSize({ height: 1280, width: 720 })

getCurrentTime()

This method will return the current time of the video (in seconds).

getDuration()

This method will return the total duration of the video (in seconds).

play()

Play the video.

pause()

Pause the video.

seekTo(time: Number)

  • time in seconds

Sets the current time of the player. The time must be between 0 and the video duration.
Example:

player.seekTo(12.5) // Will seek to 12.5 seconds of the video

getPlayerState()

Returns the player state, which can be: 'playing', 'paused' or 'loading'.

destroy()

Destroy the player and remove all event listeners.

Advanced Methods

getIframe()

This method will return the iframe HTML element.

Error Handling

Player API Errors

There are three known errors you can receive from our API.

| Error type | Occurs | |-----------------------|-----------------------------------------------------------------------------------------------------------------------------| | Invalid API Key | When the player is being created. Check your Dashboard's page to get the correct API key. | | Template not found | When the player is being created or when you are setting a new template. Check your Dashboard's page to get the ID of the desired template. | | Composition not found | When the player is being created or when you are setting a new template or composition. Find valid compositions on getCompositions() method. |

Render errors

Invalid custom JSON

When an invalid custom JSON is passed to the setCustomJson() method or when creating the player, the Player will return the following error:

{
  message: 'Invalid CustomJSON, verify CustomJSON fields.',
}

Support

Please read the API documentation available on Videomatik's website or contact the developers through our Discord server (invite link available at our website).