Please correct the errors below.
Log in Go to Soundslice Soundslice

The Soundslice player JavaScript API

The Soundslice player’s JavaScript API lets you control our player from within your own web page. For example, you can use this to:

  • Provide your own UI for play/pause
  • Roll your own analytics on which moments are being practiced the most
  • Modify sheet music on the fly, given your users’ preferences

For performance reasons, our player’s API isn’t active by default. To activate it, add the URL parameter api=1 to your iframe, like this:

<iframe src="https://www.soundslice.com/slices/TEST/embed/?api=1" ...>

You’ll also probably want to add an id attribute to the <iframe>, so that your own JavaScript can reference it. For example:

<iframe id="ssembed" ...>

You can then get a reference to the <iframe> like so:

var ssiframe = document.getElementById('ssembed').contentWindow;

We use the standard postMessage API. In each case, JavaScript code from your own page (the parent page) calls postMessage() on the iframe’s contentWindow attribute, passing a serialized JSON object with a method key. In some cases, there’s an additional arg key.

Note that the postMessage() calls require you to pass the proper target origin parameter, which is "https://www.soundslice.com", to avoid cross-site scripting attacks.