Working with video URL parameters

Working with video URL parameters

You can customize interactive videos with parameters you pass to Cinema8 video urls.

Check out this video to see a running example of how you can configure a video with url parameters.   https://cinema8.com/video/ADQrr9X6?sub=en&t=s10&autoplay=1

This video will start from 10. second and with the English subtitle enabled.You can customize your interactive videos by this way using url parameters.These Parameters can be changed with Javascript api using Cinema8 JS Api.

You can also use URL parameters to customize embeded videos inside iframes.

  1. <iframe style="position: absolute; top: 0px; right: 0px; bottom: 0px; left: 0px; width: 100%; height: 100%; border: 0;" src=" https://cinema8.com/video/5J7ArMDN?sub=en&t=s10&autoplay=1"gesture="media" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen allow="autoplay; fullscreen; microphone; camera"></iframe>

Available URL parameters are ;

Parameter

Description

Default Value

Notes

 autoplay

If set to "1" video will play automaticly in supported environments.
0
Available values : 0 - False , 1- True
 sub

Enables opening the video with selected subtitle , if null or empty no subtitle will be applied to video.You can change this value programmatically from javascript code.
null
Available values : Language codes enabled from creative studio "Subtitle" section. 
  token

You can pass authenticated users token to this parameter.By this way Cinema8 analytics will collect user generated date for and assign to this user.If parameters is empty the user generated data will be collected anonymously.To learn more about generating tokens for specific users check this article.
null

Available values : Tokens generated from Cinema8 Authentication Server.
  externalVideoUrl

Enables viewing an external video within Cinema8 Video Player.
null
Available values : any valid Video Url format.
controls
Show hide video controls
 1
 Available values : 1-0.
muted
Mute video by default
 0
 Available values : 1-0.
loop
Restart video onend
 0
 Available values : 1-0.
  externalUser

Enables tracking an unregistered user with specified user fields.available userfields wil be stored for this audience and you will be available to track the user with specified userfields in reporting and analytics section.No user entity will be created in your account , this parameter is only for unsecure audience tagging. 
null

Available values : A json formatted text to specify user fields.

externalUser: {
        name: "John",
        surname: "Doe",
        email: " john.doe@gmail.com ",
        reference: "111-222-333"
 }
  t

Enables starting your videos from a predefined t. second.
null

Available values : any valid numeric between videos time line in seconds. 
  resumeLastPosition 

Cinema8 video player stores information about  viewed frames within the video.If your audiences are comming from an authorized place and if you want to keep your audiences within the video from where they left off , you can set this parameter to true.
0
Available values : 0 - False , 1- True 

 


    • Related Articles

    • Getting started with C8 API

      Cinema8 APIs to build extensive digital experiences within your videos. Cinema8 has an extensive API to support your business and your customers’ needs while developing interactive video-based solutions. Whether you are developing a web application, ...

    • Studio Development - Using Variables

      Cinema8 creative studio allows you to develop video interactions without writing code with drag-and-drop tools, You can still create variables in the video, fill these variables from integrations or widgets you have developed, and build algorithms ...

    • Server Side WebHooks

      A webhook (also called a web callback or HTTP push API) is a way for an app to provide other applications with real-time information. A webhook delivers data to other applications as it happens, meaning you get data immediately. Cinema8 Webhooks are ...

    • Javascript WebHooks - Custom CallBacks

      You can add javascript web hooks in to your interactive videos with Cinema8.By this technic you can inject custom javascript codes in to your videos and empower your interactive videos with your business process. You can use "Execute Custom Callback" ...

    • Widget API

      Widgets are key expansion points of any cinema8 interactive video. While You can use any widget from the widget library you can also develop your own customized widgets with the C8 Widget Development environment. This article  walks you through the  ...