添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接

Idomoo's Video Player consists of many configuration options, below you can see the full list of available configurations.

Below options need to be defined inside the var player_options script .


Video Link

Video link created by Idomoo can contain the full video url or just the video's ID. Configure the player by your needs.

By default, video player plays a full video link.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

src

url

string

None

Video Embed.

A Link to a specific all viewers to watch.

If it exists, it overwrites the video link in the URL.

src:

'xyz.idomoo.com/videos/s

amples/VideoForPlayer.mp4'

build_url

URL Prefix (Consult professional services or support in case of doubt)

string

None

Video generating environment.

To be use when the video link contain only video id

video's generating environment US:

build_url: " https://c.idomoo.com/ "

______

video's generating environment EU:

build_url: " https://e.idomoo.com/ "

______

video's generating environment BT:

build_url: " https://b.pv.bt.com/ "

extension

mp4 / m3u8

string

mp4

To be use when the video link contain only video id

extension: "m3u8"

Sizing and Aspect ratio

The size and aspect ratio of the player needs to match the video's dimensions.

By default size is HD , ratio is 16:9 (Horizontal HD videos).

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

size

sd

hd

fhd

wide

string

hd

The size of the video player needs to match the video's dimensions

size: "hd"

ratio

number : number

string

16:9

The video player’s aspect ratio should match the video's aspect ratio

ratio: "1:1"

width

Integer  in pixels

number

1280

Width dimension of the

Player

width: 1080

fluid_mode

true / false

Boolean

false

Auto calculates the correct aspect ratio

Fluid_mode: true

Autoplay

Video will be muted in case the browser blocks videos to autoplay.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

autoplay

true / false

Boolean

true

Determine  whether the video should play automatically on load or when the viewer presses “Play”

autoplay: false

Mute

For some browsers, videos can not autoplay if the sound is not muted. This parameter will assure that video will start muted and if autoplay determined, autoplayed.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

mute

true / false

Boolean

false

Determine  whether the video should start muted or not

mute: true


Share

Share options to be shown under the player's share button

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

share_button

true / false , object

Boolean, object

{

download: true,

copy: true,

mail: true,     whatsapp: true,       facebook: false,

twitter: false

}

Controls share options displayed inside the player share menu. If set to “false”, the player share button is hidden

share_button: {

download: true,

download_filename: My cool video,

copy:false,

mail: true,

whatsapp: true,

facebook: true,

twitter: true

}

or

share_button: false

share_button.download

true / false

Boolean

true

Show “download” share option

download: false

download_filename


Any text ; Parameters from url ;

Saved words:

<date_time> shown in format  dd MMM YYYY, HHMM).

<date> shown in format (YYYY-MM-DD)

string

my_video

Downloaded file name

download_filename: A cool video_<title>_<date>

Will be translated from the URL https://mypage?url=https://v.idomoo.com…91v43b2r.m3u8&title=%F0%9F%98%8F With the date of January 21st, 2024

Will be translated to:

A cool video_?_2024-01-21.mp4

share_button.copy

true / false

Boolean

true

Show “copy” share option

copy: false

share_button.mail

true / false

Boolean

true

Show “mail” share option

mail: false

share_button.whatsapp

true / false

Boolean

true

Show “whatsapp” share option

whatsapp: false

share_button.facebook

true / false

Boolean

false

Show “facebook” share option

facebook: true

share_button.twitter

true / false

Boolean

false

Show “twitter” share option

twitter: true

Interaction

Enable player actions

If your video contains an ' Interactive Player Action ', you'll need to make sure that it is also enabled here on the player.

The full screen option will not be available on iOS systems (iPhone, iPad).  Native player is the one that opens at full screen state and it doesn't support use of any of the interactivity features. If you want your video viewers to have full screen take into consideration that interactivity will not work in this state  and it’s not recommended.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

interactive

true / false

Boolean

false

Video contains an ' Interactive Player Action ', must enable “interactive” on the player.

interactive: true

ios_full_screen

true / false

Boolean

false

We think it is a bad UX, but if you like viewers to have a full screen on iOS, take into consideration that interactivity will not work in this state.

ios_full_screen:true


Mark "Visited" placeholder

Player to mark clicked interactive choices of the viewer while the viewer is in the same session.

Demo can be seen here and at the example below how the ‘Kids club’ text is marked after being clicked.


Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

visited_placheholder

true / false

Binary

false

Player to mark clicked interactive choices of the viewer.

visited_placheholder:true

In-Player Menu

Choose when the In-Player Menu will appear, if the video contains one.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

show_customise

“on_click”, “on_start”, “on_end”

string

“on_click”

Choose when the In-Player Menu will appear: On user click , when video starts playing or

when the video finishes playing.

show_customise: on_start

Analytics

Data Collection

The player is a data collection tool, define all buttons you want to measure under the cta_analytics property.

See how viewers interact with page’s buttons on Idomoo's analytics dashboard.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

cta_analytics

Array

[button class, Analytics event name]

string

None

Holds data that is sent to Idomoo’s analytics engine from page elements

(usually call to action buttons)

cta_analytics: [

["idm-cta-btn1", "Click Me"],

["idm-cta-btn2", "Join Now"]

]

Analytics environment

This parameter indicates where the data collected is sent to. Only BT projects need to add this parameter.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

analytics_ env

us/bt

string

us

Mandatory for BT projects only

analytics_env: "bt”


Display

Appearance of the thumbnails and messages shown on the player

Opening image

Choose which image that will show before the video begins playing.

“image_url” is the strongest option, stating this will overwrite other keys.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

opening_i mage

Array

{

image_suffix :'',

image_extension:'',

image_url:'

' }

string

None

Possible keys’ members of this object defined below

opening_image: {

image_suffix: '_start'

}

image_url

url (public)

string

None

Image to display

image_url:' https://goo.gl/ LxgrFt '

image_suf

fix

String

string

None

state which suffix to use (_end is what is usually being configured by idomoo’s professional services. Other suffix can be stated on the API call

image_suffix: '_start'

image_extension

jpg,gif

string

jpg

state extension

image_extension:jpg


Closing image

Choose which image that will show when the video finishes playing.

“image_url” is the strongest option, stating this will overwrite other keys.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

closing_image

Array

{

image_suffix :'',

image_ext ension:'',

image_url:'

' }

string

None

Possible keys’ members of this object defined below

opening_image: {

image_suffix: '_start'

}

image_url

url (public)

string

None

Image to display

closing_image: {

image_url:' https://goo.gl/LxgrFt '

}

image_suffix

String

string

None

S uffix can be stated on the API call

image_suffix: '_end'

image_extenson

jpg,gif

string

jpg

state extension

image_extension:jpg


Loading gif

Choose if animated gif shown while the video loads

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

remove_gif

Boolean

True , false

false

Animated gif will not show

remove_gif:true


Error message

Replace Idomoo's default error message with your own

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

set_error_message_image

url (public)

string

Idomoo’s default message

Image to display

set_error_message_image: ' https://image.shutterstoc k .com/z/stock-photo-colorf ul-flower-on-dark-tropical-f oliage-nature-background721703848.jpg'

Accessibility

Closed Captioning

*Captions are available for full service users only *


Add a closed captions button on the player and choose its default and other languages.

If no language is set to default, the video will start playing without captions.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

close_captions

array

{

"srclang": "en",

"Label": "English",

"src": " https://s3.amazonaws.co m/idoplayer-us.idomoo.com/player2.0/vtt/sample.vtt",

"default": "true"

},

{

"srclang": "es",

"label": "Espanol"

}

string

None

Array that holds all information about the available and default captions languages.

See below each field.

close_captions:

[

{

"srclang": "en",

"label": "English",

"src": " https://s3.amazonaws.co m/idoplayer-us.idomoo.com/player2.0/vtt/sample.vtt",

"default": "true"

},

{

"srclang": "es",

"label": "Espanol",

"src":

" https://s3.amazonaws.co m/idoplayer-us.idomoo.co m/player2.0/vtt/sample.vtt "

}

]

srclang

Language code in 2 characters

string

None

Language code in 2 characters

srclang: "es"

label

text

string

None

Language label (as shown on the player)

label: "Espanol"

src

URL

string

None

Define outsource CC. If not defined, the video URL extension replaced with .vtt and used as captions source

src:

" https://s3.amazonaws.co m/idoplayer-us.idomoo.co m/player2.0/vtt/sample.vtt "

default

true / false

Binary

None

Start video with marked default language

default: true

Alternativer text

Replace Idomoo's default video div label for screen readers.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

"descriptive_title"


alphanumeric characters, spaces, underscores, and dashes.


string

Video player

the visible text or alternative text used to label the video player. This label is announced after activating the Play button.

"descriptive_title"=video with personalized information


Control Bar

Customize player control bar appearance

Control bar position

Control bar position can be at the bottom of the video frame area (Default) or Below the video frame area.

Here is an example of the control bar below the video frame area.


Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

toolbar_position


low

string

-

Position player’s control bar below the video

toolbar_position: "low"


Remove progress bar

Remove progress bar from control bar. This is useful when you do not want users to be able to navigate forward and backward in the video.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

disabled_control_bar


True , false

Boolean

false

Prevent user to control the playback using the progress bar control

disabled_control_bar: true


Mobile compact version

Display a control bar which is optimized for the user experience on a narrow device such as a mobile device


Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

minimal_version

True , false

Boolean

false

Define Player to show minimal control bar when loaded on mobile

minimal_version: true


Fade out control bar

Control bar to fade out after 3 seconds in pause mode . When the user will hover on the player it becomes visible again.

This mimics the player’s behavior in play mode.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

fade_control_bar_on _pause

True , false

Boolean

false

Progress bar to fade out after 3 sec. in pause mode.

This will act exactly as the player acts in "play" state.

fade_control_bar_on_pause: true


Fixed control bar

Control bar to stay always on screen.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

fade_control_bar

True , false

Boolean

true

If true, Progress bar to stay always on screen

fade_control_bar: true


Pause / Play on the whole video frame area

Control the player’s play / pause behavior by clicking on the whole video frame area.

Parameter  name

Possible values

Data/

Unit Type

Default

Description

Example

click_to_pause

“disable”, “enable”

string

disable

Control the player’s play / pause behavior by clicking on the whole video frame area.

click_to_pause: enable


Did you find it helpful? No

Send feedback