跳到主要内容

Playback Control

This guide provides instructions on how to control the playback of BlendVision iframe player, enabling interaction between the player and your website.

Step 1: Define a Unique ID in the iframe Code

Include id=”IFRAME_ID” in your iframe code, replacing IFRAME_ID with a unique ID of your choice.

<iframe id="IFRAME_ID" src="https://showroom.one.blendvision.com/embed?token={token}" width="640" height="360" allow="autoplay; encrypted-media; clipboard-write" frameborder="0" allowfullscreen></iframe>

<script>
  window.addEventListener('message', event => {
    if (event.data.command === 'ping') {
      Array.from(document.querySelectorAll('iframe')).forEach(iframe =>
        iframe?.contentWindow?.postMessage({ command: 'pong' }, '*')
      );
    }
  });
</script>

Step 2: Control Playback Using Post Message

Utilize the following post message commands to control your iframe player.

Play

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'play', args: []}),
'*'
)

Pause

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'pause', args: []}),
'*'
)

Seek to a Target Time

Pass the target time in seconds to the args array.

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'seek', args: [12]}), // seek to 12sec.
'*'
)

Set Volume

Pass the volume level from 0 to 1 with two decimal places (e.g. 0.35 for 35% volume) to the args array.

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'set-volume', args: [1]}), // set to the maximum volume
'*'
)

Speed Up

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'speed-up', args: []}),
'*'
)

Slow Down

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'slow-down', args: []}),
'*'
)

Set Speed

Pass the following volume levels to the args array: 0.25, 0.5, 0.75, 1, 1.25, 1.5, 1.75, 2

const bvOnePage = docuement.querySelector('iframe#IFRAME_ID')

bvOnePage.contentWindow.postMessage(
JSON.stringify({event: 'command', func: 'set-speed', args: [0.25]}),
'*'
)