Definitions

Type Definitions

AdBreak

AdBreak definition
Properties:
Name Type Description
start number The start time of the range, in milliseconds.
end number The end time of the range, in milliseconds.

Ads

Ads Ad configuration
Properties:
Name Type Attributes Default Description
adsMode string <optional>
 'none' Determines the ad library: ‘ima’, ‘dai’, 'mediatailor' or 'none'. Note that ‘dai’ needs a daiConfig object to work, while ‘ima’ require a adTagUri string and 'mediatailor' needs a mediatailorConfig object to work.
enableVpaid boolean <optional>
 true If it is set to true the player can execute VPAID ads, otherwise, the player will play other media that is available in the ad. In case no other media files are included in the ad an error will be fired.
adTagUri string <optional>
 Advertisement URL that is going to be played. VAST, VPAID, VMAP are supported.
pageUrl string <optional>
 Adds a parameter to the ad request to keep track of the domain that sent the request. For targeting purposes. Parameter for ima.
allowMutedAutoplay boolean <optional>
 false Indicates whether ads can start automatically without sound. By default, this property is set to false and the player will wait for the user activation -user interacts with the page- to start playing the ads. Config.mutedAtStart must be set to false and Config.autoplay to true in order to play ads with sound after the user activation.
daiConfig object <optional>
 Used to initialize the DAI stream.
Properties
Name Type Attributes Description
assetKey string <optional>
 This is used to determine which stream should be played. Required for live streams.
contentSrcId string <optional>
 Unique identifier for the publisher content, from a CMS. Required for on-demand streams.
videoId string <optional>
 Identifier for the video content source. Required for on-demand streams.
apiKey string <optional>
 The stream request API key. It's configured through the DFP Admin UI and provided to the publisher to unlock their content. It verifies the applications that are attempting to access the content.
mediatailorConfig object <optional>
 Used to initialize the Media Tailor stream.
Properties
Name Type Attributes Description
baseUrl string <optional>
 Base URL for Video and Ads.
manifestUrl string <optional>
 Video URL to be attached to the baseURL.
adsParams object <optional>
 Contains “Params: string” this is the Ad URL to be attached to the baseURL.

AudioTrack

AudioTrack definition
Properties:
Name Type Attributes Description
id string The id of the track.
language string The audio language.
name string <nullable>
 The audio name.
label string <nullable>
 The audio label.
role string <nullable>
 The audio role.
channelsCount number <nullable>
 The audio channels.

Chapter

Chapter definition
Properties:
Name Type Description
id string The id of the chapter.
title string The title of the chapter.
startTime number The time that describes the beginning of the range of the chapter.
endTime number The time that describes the end of the range of chapter.

ChromecastReceiverConfig

ChromecastReceiverConfig
Properties:
Name Type Attributes Default Description
div Element The div container of the player. Optional only for ads.adsMode equal to ‘dai’ or 'mediatailor'.
backupManifests Array.<string> <optional>
 [] It’s possible to set one or multiple backup manifests so the player can switch to them in case the original fails. Please note that this feature is currently only available for live DASH streams and the backup manifests MUST have the same properties as the original one (codecs, container format, timestamps, etc.).
drm Array.<object> <optional>
 [] Contains an array of DRM information.
Properties
Name Type Attributes Default Description
type string DRM type of the video. Values: 'com.widevine.alpha', 'com.microsoft.playready', 'com.apple.fps.1_0', 'org.w3.clearkey'.
licenseServer string <optional>
 License server of the video. Optional only for ClearKey.
clearKeys object <optional>
 ClearKeys of the video. Only used on ClearKey. If licenseServer is present, this property is ignored.
provider string <optional>
 Provider of the video (only for FairPlay). Values: 'ezdrm', 'conax', 'verimatrix', 'expressplay'
certificateUri string <optional>
 CertificateUri of the video (only for FairPlay). Config.drm.certificateUri will have priority over Config.drm.certificate if both of them are provided.
certificate string <optional>
 Certificate of the video (only for FairPlay).
headers Array.<object> <optional>
 [] Headers of the video.
Properties
Name Type Description
name string Name of the HTTP header.
value string Value of the HTTP header.
autoplay boolean <optional>
 true Determines whether the playback must start automatically or not.
mutedAtStart boolean <optional>
 false Determines wheter the playback must start muted or not.
poster string <optional>
 Video poster URL.
showPosterWhenPaused boolean <optional>
 false Show the poster when the stream is paused.
title string <optional>
 The stream's name.
subtitle string <optional>
 Secondary or explanatory title of the stream.
externalSubtitles Array.<object> <optional>
 [] Used to provide subtitle files as external subtitles.
Properties
Name Type Description
src string Subtitles file URL.
language string Subtitle language identifier.
useAudioElement boolean <optional>
 false Determines if the media element to use is AUDIO instead of VIDEO.
lcevc boolean <optional>
 false Determines if the playback is MPEG-5 Part 2 (LCEVC).
preferredAudioLanguage string <optional>
 Determines which is the default audio language.
preferredSubtitleLanguage string <optional>
 Determines which is the default subtitle language.
preferredAudioChannelLayout string <optional>
 'stereo' Determines which is the default audio channel layout. Values: 'mono', 'stereo', 'surround'.
preferNativeSubtitleRendering boolean <optional>
 false Determines if the subtitles are rendered by the HTML Video Element or the subtitles ares rendered in a custom DIV.
mediaOptions Array.<string> <optional>
 [] HTML media options. Eg: 'disablePictureInPicture',
playerConfig object <optional>
 Playback configuration.
Properties
Name Type Attributes Default Description
abrRestrictToElementSize boolean <optional>
 false If true, restrict the quality to media element size
lowLatency boolean <optional>
 false If the stream is low latency and if true, low latency streaming mode is enabled.
cmcd object <optional>
 CMCD configuration and settings. (Common Media Client Data)
Properties
Name Type Attributes Default Description
enabled boolean <optional>
 false If true, enable CMCD data to be sent with media requests.
useHeaders boolean <optional>
 false If true, send CMCD data using the header transmission mode instead of query args.
sessionId string <optional>
 A GUID identifying the current playback session. A playback session typically ties together segments belonging to a single media asset. Maximum length is 64 characters. It is RECOMMENDED to conform to the UUID specification. By default the sessionId is automatically generated on each init() call.
contentId string <optional>
 A unique string identifying the current content. Maximum length is 64 characters. This value is consistent across multiple different sessions and devices and is defined and updated at the discretion of the service provider.
progressTimeEvents boolean <optional>
 false If true, fire progress time events
requireHdcp boolean <optional>
 false If true, requires a HDCP to reproduce DRM content. May be ignored if not supported by the device.
disableAudio boolean <optional>
 false If true, the audio tracks are ignored. Defaults to false.
disableVideo boolean <optional>
 false If true, the video tracks are ignored. Defaults to false.
disableText boolean <optional>
 false If true, the text tracks are ignored. Defaults to false.
disableThumbnails boolean <optional>
 false If true, the thumbnails tracks are ignored. Defaults to false.
useHLSCompatibilityMode boolean <optional>
 false If true, it is used a player mode that provides a better compatibility with stream that have A/V sync problems. Defaults to false.
playlistTypeEvent boolean <optional>
 false If true, the HLS playlist is identified as an EVENT playlist. Event playlists are typically used when you want to allow the user to seek to any point in the event.
requestLoader RequestLoader <optional>
 Custom request loader to manipulate request before sent to the server.
responseLoader ResponseLoader <optional>
 Custom response loader to manipulate responses from the server.
bufferConfig object <optional>
 Buffer settings
Properties
Name Type Attributes Description
bufferingGoal number <optional>
 The number of seconds of content that the player will attempt to buffer ahead of the playhead. This value must be greater than or equal to the rebuffering goal.
bufferBehind number <optional>
 The maximum number of seconds of content that the player will keep in buffer behind the playhead when it appends a new media segment. The player will evict content to meet this limit.
rebufferingGoal number <optional>
 The minimum number of seconds of content that the player must buffer before it can begin playback or can continue playback after it has entered into a buffering state
preferredVideoCodecs Array.<string> <optional>
 [] This property can be used to give priority to a specific video codec.
preferredAudioCodecs Array.<string> <optional>
 [] This property can be used to give priority to a specific audio codec.
bitrateConfig object <optional>
 Determines whether the video will start playing at the bitrate you set by default.
Properties
Name Type Attributes Description
disableABR number <optional>
 Disables the ABR to prevent the player from changing tracks regardless of bandwidth.
maxBitrate number <optional>
 The player should ignore any bitrate profiles in the manifest above this value, and never play them.
minBitrate number <optional>
 The player should ignore any bitrate profiles in the manifest under this value, and never play them.
startingBitrate number <optional>
 The bitrate the player will try to start playing.
withCredentials object <optional>
 Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates.
Properties
Name Type Attributes Default Description
license boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in license requests
manifest boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in manifest requests
segment boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in segment requests
liveSync object <optional>
 Properties for live synchronization. Note: only works for live Streams.
Properties
Name Type Attributes Default Description
enabled boolean <optional>
 false Indicates if live synchronization is enabled or disabled.
synchronizationDistance boolean <optional>
 2 Indicates the live synchronization distance in seconds. The live point is the seek range end.
syncAlways boolean <optional>
 true Indicates if live synchronization is always enabled or only for the initial load. If true, if the user play/pause, the player always go to live synchronization point.
maxAbrResolution object <optional>
 Determines the max resolutions picked by the ABR.
Properties
Name Type Attributes Default Description
width object <optional>
 Infinity Max width picked by the ABR.
height object <optional>
 Infinity Max height picked by the ABR.
retryParameters object <optional>
 Retry parameters for DRM, manifest and segments requests requests.
Properties
Name Type Attributes Default Description
drmConnectionTimeout number <optional>
 10000 The DRM request connection timeout, in milliseconds. Zero means "unlimited". Defaults to 10000 milliseconds.
manifestConnectionTimeout number <optional>
 10000 The manifest request connection timeout, in milliseconds. Zero means "unlimited". Defaults to 10000 milliseconds.
segmentsConnectionTimeout number <optional>
 5000 The segments requests connection timeout, in milliseconds. Zero means "unlimited". Defaults to 5000 milliseconds.

Config

Config
Properties:
Name Type Attributes Default Description
licenseKey string HISPlayer license key to validate the playback.
div Element The div container of the player.
src string URL of the stream to be played. Optional only for ads.adsMode equal to ‘dai’ or 'mediatailor'.
backupManifests Array.<string> <optional>
 [] It’s possible to set one or multiple backup manifests so the player can switch to them in case the original fails. Please note that this feature is currently only available for live DASH streams and the backup manifests MUST have the same properties as the original one (codecs, container format, timestamps, etc.).
debug boolean <optional>
 false Activates the player's logs.
drm Array.<object> <optional>
 [] Contains an array of DRM information.
Properties
Name Type Attributes Default Description
type string DRM type of the video. Values: 'com.widevine.alpha', 'com.microsoft.playready', 'com.apple.fps.1_0', 'org.w3.clearkey'.
licenseServer string <optional>
 License server of the video. Optional only for ClearKey.
clearKeys object <optional>
 ClearKeys of the video. Only used on ClearKey. If licenseServer is present, this property is ignored.
provider string <optional>
 Provider of the video (only for FairPlay). Values: 'ezdrm', 'conax', 'verimatrix', 'expressplay'
certificateUri string <optional>
 CertificateUri of the video (only for FairPlay). Config.drm.certificateUri will have priority over Config.drm.certificate if both of them are provided.
certificate string <optional>
 Certificate of the video (only for FairPlay).
headers Array.<object> <optional>
 [] Headers of the video.
Properties
Name Type Description
name string Name of the HTTP header.
value string Value of the HTTP header.
autoplay boolean <optional>
 true Determines whether the playback must start automatically or not.
mutedAtStart boolean <optional>
 false Determines wheter the playback must start muted or not. Ignored in SmartTVs and video game consoles.
resumePosition number <optional>
 Determines the position in seconds where the video will start playing.
poster string <optional>
 Video poster URL.
showPosterWhenPaused boolean <optional>
 false Show the poster when the stream is paused.
logo object <optional>
 Image to show on top of the video
Properties
Name Type Description
imageUrl string URL of the image to show on top of the video
redirectUrl string URL to open when clicking on the logo
left number Position of the image in the X axis. The values must be within the range [0, 100].
top number Position of the image in the Y axis. The values must be within the range [0, 100].
size number Size of the logo image. The value must be positive and its accepted values are within the range [0, 100]. Defines the width in % of the parent element (player's div).
showAfter number Determines how much time in seconds must pass since the start of the playback until the logo is shown. The values must be positive and 0 indicates that the logo will be shown when the playback starts.
hideAfter number Determines how much time in seconds must pass since the logo is shown until it is hidden again. If the value is negative the logo is not hidden ever.
title string <optional>
 The stream's name.
subtitle string <optional>
 Secondary or explanatory title of the stream.
externalSubtitles Array.<object> <optional>
 [] Used to provide subtitle files as external subtitles.
Properties
Name Type Description
src string Subtitles file URL.
language string Subtitle language identifier.
staticThumbnailsVTT string <optional>
 Used to provide the player an external thumbnails VTT file.
useAudioElement boolean <optional>
 false Determines if the media element to use is AUDIO instead of VIDEO.
lcevc boolean <optional>
 false Determines if the playback is MPEG-5 Part 2 (LCEVC).
ps5SecureVideoMode boolean <optional>
 false Enables the Enhanced Security Video Mode. This uses a more secure video render pipeline which is required when content is encrypted with PlayReady SL-3000 and/or HDR content.
externalChapters Array.<object> <optional>
 [] Used to provide the player an external chapters.
Properties
Name Type Attributes Description
src string <optional>
 Chapter file URL.
markers Array.<object> <optional>
 Chapter markers.
Properties
Name Type Attributes Description
time number <optional>
 Chapter time.
title string <optional>
 Chapter title.
language string Chapter language identifier.
vrMode string <optional>
 'none' Determines the VR mode: 'cubemap' and 'equirectangular' for 360º videos, '180' or 'none'.
vrHeadset boolean <optional>
 false Determines whether the VR mode must start the mode for VR headsets or not.
enableVrDeviceMotion boolean <optional>
 true Enables/disables the device motion for VR & 360 video.
preferredAudioLanguage string <optional>
 Determines which is the default audio language.
preferredSubtitleLanguage string <optional>
 Determines which is the default subtitle language.
preferredAudioChannelLayout string <optional>
 'stereo' Determines which is the default audio channel layout. Values: 'mono', 'stereo', 'surround'.
preferNativeSubtitleRendering boolean <optional>
 false Determines if the subtitles are rendered by the HTML Video Element or the subtitles ares rendered in a custom DIV.
mediaOptions Array.<string> <optional>
 [] HTML media options. Eg: 'disablePictureInPicture',
watermarkVerimatrix object <optional>
 Contains information needed to initialize Verimatrix watermarking. In order to use this feature it is needed to load the "watermark.min.js" on your page before loading "hisplayer.js". This watermarking library must be provided by Verimatrix. You can contact them at https://www.verimatrix.com/contact/
Properties
Name Type Attributes Description
strength number <optional>
 Watermark strength. Valid values: • 255: Visible watermark for debugging. • 1 - 100: Production watermark strength (1 = weakest, 100 = strongest/possibly visible). Default: 80.
transactionId number <optional>
 Size: 36 bits. Valid values: 0 - 687194767365.
logoImage string <optional>
 Optional. Sets a visible image to draw in addition to the imperceptible watermark. Default: None.
logoPosition Array.<number> <optional>
 Sets coordinates for the logo image. The array's elements represent the following [x, y, width, height]. Valid values for "x" and "y": 0 to 100. The "width" and "height" elements values' are represented as pixels. Default: Upper left corner of the video.
ads Ads <optional>
 Ad configuration.
playlist object <optional>
 Set of streams to be played in order of addition.
Properties
Name Type Attributes Description
title string <optional>
 Title of the playlist to be shown in the UI.
description string <optional>
 Description of the playlist to be shown in the UI.
displayType string <optional>
 The options are 'vertical' or 'horizontal'. By default, the playlist menu will be displayed horizontally on TVs and video consoles. On the other hand, by default on PC, macOS and mobile the playlist menu will be displayed vertically.
pauseVideoOnClickIcon boolean <optional>
 Determines if the current video will be paused when clicking on the playlist icon on the UI. Default to true.
playNextAutomatically boolean <optional>
 Determines if the next stream in the playlist will be played automatically when the current stream ends. Default to true.
elements Array.<PlaylistElement> Stream elements to be added to the playlist menu. They will be played automatically.
playerConfig object <optional>
 Playback configuration.
Properties
Name Type Attributes Default Description
abrRestrictToElementSize boolean <optional>
 false If true, restrict the quality to media element size
lowLatency boolean <optional>
 false If the stream is low latency and if true, low latency streaming mode is enabled.
cmcd object <optional>
 CMCD configuration and settings. (Common Media Client Data)
Properties
Name Type Attributes Default Description
enabled boolean <optional>
 false If true, enable CMCD data to be sent with media requests.
useHeaders boolean <optional>
 false If true, send CMCD data using the header transmission mode instead of query args.
sessionId string <optional>
 A GUID identifying the current playback session. A playback session typically ties together segments belonging to a single media asset. Maximum length is 64 characters. It is RECOMMENDED to conform to the UUID specification. By default the sessionId is automatically generated on each init() call.
contentId string <optional>
 A unique string identifying the current content. Maximum length is 64 characters. This value is consistent across multiple different sessions and devices and is defined and updated at the discretion of the service provider.
progressTimeEvents boolean <optional>
 false If true, fire progress time events
requireHdcp boolean <optional>
 false If true, requires a HDCP to reproduce DRM content. May be ignored if not supported by the device.
disableAudio boolean <optional>
 false If true, the audio tracks are ignored. Defaults to false.
disableVideo boolean <optional>
 false If true, the video tracks are ignored. Defaults to false.
disableText boolean <optional>
 false If true, the text tracks are ignored. Defaults to false.
disableThumbnails boolean <optional>
 false If true, the thumbnails tracks are ignored. Defaults to false.
useHLSCompatibilityMode boolean <optional>
 false If true, it is used a player mode that provides a better compatibility with stream that have A/V sync problems. Defaults to false.
playlistTypeEvent boolean <optional>
 false If true, the HLS playlist is identified as an EVENT playlist. Event playlists are typically used when you want to allow the user to seek to any point in the event.
requestLoader RequestLoader <optional>
 Custom request loader to manipulate request before sent to the server.
responseLoader ResponseLoader <optional>
 Custom response loader to manipulate responses from the server.
bufferConfig object <optional>
 Buffer settings
Properties
Name Type Attributes Description
bufferingGoal number <optional>
 The number of seconds of content that the player will attempt to buffer ahead of the playhead. This value must be greater than or equal to the rebuffering goal.
bufferBehind number <optional>
 The maximum number of seconds of content that the player will keep in buffer behind the playhead when it appends a new media segment. The player will evict content to meet this limit.
rebufferingGoal number <optional>
 The minimum number of seconds of content that the player must buffer before it can begin playback or can continue playback after it has entered into a buffering state
preferredVideoCodecs Array.<string> <optional>
 [] This property can be used to give priority to a specific video codec.
preferredAudioCodecs Array.<string> <optional>
 [] This property can be used to give priority to a specific audio codec.
bitrateConfig object <optional>
 Determines whether the video will start playing at the bitrate you set by default.
Properties
Name Type Attributes Description
disableABR number <optional>
 Disables the ABR to prevent the player from changing tracks regardless of bandwidth.
maxBitrate number <optional>
 The player should ignore any bitrate profiles in the manifest above this value, and never play them.
minBitrate number <optional>
 The player should ignore any bitrate profiles in the manifest under this value, and never play them.
startingBitrate number <optional>
 The bitrate the player will try to start playing.
withCredentials object <optional>
 Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates.
Properties
Name Type Attributes Default Description
license boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in license requests
manifest boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in manifest requests
segment boolean <optional>
 false Indicates whether or not cross-site Access-Control requests should be made using credentials such as cookies, authorization headers or TLS client certificates in segment requests
liveSync object <optional>
 Properties for live synchronization. Note: only works for live Streams.
Properties
Name Type Attributes Default Description
enabled boolean <optional>
 false Indicates if live synchronization is enabled or disabled.
synchronizationDistance boolean <optional>
 2 Indicates the live synchronization distance in seconds. The live point is the seek range end.
syncAlways boolean <optional>
 true Indicates if live synchronization is always enabled or only for the initial load. If true, if the user play/pause, the player always go to live synchronization point.
maxAbrResolution object <optional>
 Determines the max resolutions picked by the ABR.
Properties
Name Type Attributes Default Description
width object <optional>
 Infinity Max width picked by the ABR.
height object <optional>
 Infinity Max height picked by the ABR.
retryParameters object <optional>
 Retry parameters for DRM, manifest and segments requests requests.
Properties
Name Type Attributes Default Description
drmConnectionTimeout number <optional>
 10000 The DRM request connection timeout, in milliseconds. Zero means "unlimited". Defaults to 10000 milliseconds.
manifestConnectionTimeout number <optional>
 10000 The manifest request connection timeout, in milliseconds. Zero means "unlimited". Defaults to 10000 milliseconds.
segmentsConnectionTimeout number <optional>
 5000 The segments requests connection timeout, in milliseconds. Zero means "unlimited". Defaults to 5000 milliseconds.
ui object <optional>
 UI configuration and settings.
Properties
Name Type Attributes Default Description
enabled object <optional>
 false UI enabled.
locale object <optional>
 navigator.language UI language.
singleClickForPlayAndPause object <optional>
 true UI single click for play/pause. Disabled on VR mode.
doubleClickForFullscreen object <optional>
 true UI double click for fullscreen. Disabled on VR mode.
useiOSFullScreen object <optional>
 true Use native fullscreen on iOS. Disabled on VR mode.
autoHide object <optional>
 true Auto hide the UI.
showMetadata object <optional>
 false Show ID3 metadata (eg: TIT2, TPE1).
showButtons object <optional>
 true Show the buttons in the UI.
showRemainingTimeForAds object <optional>
 true Show remaining time counter for ads.
socialSharing object <optional>
 Configuration for social sharing utilities.
Properties
Name Type Attributes Default Description
shareUrl string <optional>
 window.location.href URL to be shared. Its default value is window.location.href.
social Array.<object> List of social medias to appear in the UI for sharing a URL.
Properties
Name Type Attributes Description
id SocialId Identifier of the social media to add to the UI.
icon string <optional>
 Social media's image path. If no icon is provided the social media id will be used as a text button. Some social medias like Facebook, X (Twitter), and Reddit use a default icon that is used if it is not overriden by this property.
shareUrl string <optional>
 Overrides the Config.ui.socialSharing.shareUrl property's value for this specific social media.
embedCode string <optional>
 Only valid when using HisPlayer.SocialId.EMBED, this property must be filled with the markup code. By default the code used is: 
< iframe width="560" height="315" src= Config.ui.socialSharing.shareUrl
                   title="HISPlayer video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write;
                   encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen>
customName string <optional>
 Use for custom social media sharing. Name of the custom social media displayed in the UI in case no icon is provided.
callback function <optional>
 Use for custom social media sharing. This function is executed when clicking the icon. This callback function will receive the URL to share in its argument.
options object <optional>
 UI options.
Properties
Name Type Attributes Default Description
hideTimes boolean <optional>
 false Hide times in the UI.
hideSeekBar boolean <optional>
 false Hide seek bar in the UI.
hideVolume boolean <optional>
 false Hide volume icon in the UI.
hidePlay boolean <optional>
 false Hide play icon in the UI.
hideRewind boolean <optional>
 false Hide rewind icon in the UI.
hideForward boolean <optional>
 false Hide forward icon in the UI.
seekValue number <optional>
 30 Value in seconds to be used when clicking the forward and/or rewind buttons. The default value is 30 seconds. Personalized icons with the seek value displayed in them will appear in the UI in case this property is set to 5, 10 or 30, otherwise, the icons will have no numbers displayed in them.
hideLoop boolean <optional>
 true Hide loop icon in the UI.
hidePlaybackRates boolean <optional>
 true Hide playback rates icon in the UI.
playbackRates boolean <optional>
 [0.5, 0.75, 1, 1.25, 1.5, 1.75, 2] Playback rates values in the UI.
hideQualityLevels boolean <optional>
 false Hide quality levels icon in the UI.
hideChapters boolean <optional>
 false Hide chapters icon in the UI. Only SmartTVs and Consoles.
hideAudios boolean <optional>
 false Hide audio icon in the UI.
hideSubtitles boolean <optional>
 false Hide subtitle icon in the UI.
hideAirPlay boolean <optional>
 true Hide AirPlay icon in the UI.
hideChromecast boolean <optional>
 true Hide Chromecast icon in the UI.
hideStereoVR boolean <optional>
 false Hide Stereo VR icon in the UI.
hideResetVR boolean <optional>
 false Hide Reset VR icon in the UI.
hideVRControl boolean <optional>
 false Hide VR Control icon in the UI. Only SmartTVs and Consoles.
hidePip boolean <optional>
 false Hide pip icon in the UI.
hideFullscreen boolean <optional>
 false Hide fullscreen icon in the UI.
contextMenu Array.<ContextMenuElement> <optional>
 Menu to be shown when right-clicking on the screen.
chromecast object <optional>
 Chromecast configuration.
Properties
Name Type Attributes Description
receiverAppId string <optional>
 The receiver application id. If no value is provided the HISPlayer's default app will be used.
androidReceiverCompatible boolean <optional>
 Indicates if the app is compatible with an Android Receiver.

ContextMenuElement

ContextMenuElement Element displayed in the context menu.
Properties:
Name Type Attributes Description
name string Text to be displayed for this option.
icon string <optional>
 URL of the SVG icon's path
action function Function executed when this option is clicked.
submenu Array.<ContextMenuElement> <optional>
 Menu that will appear nested when hovering over this option.

PlaylistElement

PlaylistElement
Properties:
Name Type Attributes Default Description
src string URL of the stream to add the playlist.
externalSubtitles Array.<object> <optional>
 [] Used to provide subtitle files as external subtitles.
Properties
Name Type Description
src string Subtitles file URL.
language string Subtitle language identifier.
staticThumbnailsVTT string <optional>
 External thumbnails URL in WebVTT format.
externalChapters Array.<object> <optional>
 [] Used to provide the player an external chapters.
Properties
Name Type Attributes Description
src string <optional>
 Chapter file URL.
markers Array.<object> <optional>
 Chapter markers.
Properties
Name Type Attributes Description
time number <optional>
 Chapter time.
title string <optional>
 Chapter title.
language string Chapter language identifier.
ads Ads Ads configuration.
thumbnail string <optional>
 URL of the image to be used as a thumbnail for the stream. This image will be shown in the playlist menu.
title string <optional>
 Title description to be shown in the playlist menu for this item.
subtitle string <optional>
 Secondary title description to be shown in the playlist menu for this item.

RequestLoader(requestType, request)

RequestLoader function definition
Parameters:
Name Type Description
requestType string The id of the track.
request object
Properties
Name Type Attributes Description
uris Array.<string> An array of URIs to attempt. They will be tried in the order they are given.
headers Object.<string, string> A mapping of headers for the request. e.g.: {'HEADER': 'VALUE'}
method string The HTTP method to use for the request.
data BufferSource <nullable>
 The body of the request.

ResponseLoader(requestType, response)

ResponseLoader function definition
Parameters:
Name Type Description
requestType string The id of the track.
response object
Properties
Name Type Description
uri string The URI which was loaded. Server redirects can cause this to be different from the original request URIs.
originalUri string The original URI passed to the browser for networking. This is before any redirects.
headers Object.<string, string> A map of response headers, if supported by the underlying protocol. All keys should be lowercased. For HTTP/HTTPS, may not be available cross-origin.
status number | undefined The response HTTP status code.
data BufferSource The body of the response.

SubtitleTrack

SubtitleTrack definition
Properties:
Name Type Description
id string The id of the track.
language string The subtile language.
forced boolean Indicates if the subtitle is forced.

Thumbnail

Thumbnail definition
Properties:
Name Type Description
imageHeight number The image height in px. The image height could be different to height if the layout is different to 1x1.
imageWidth number The image width in px. The image width could be different to width if the layout is different to 1x1.
height number The thumbnail height in px.
positionX number The thumbnail left position in px.
positionY number The thumbnail top position in px.
startTime number The start time of the thumbnail in the presentation timeline, in seconds.
duration number The duration of the thumbnail, in seconds.
uris Array.<string> An array of URIs to attempt. They will be tried in the order they are given.
width number The thumbnail width in px.

Track

Track definition
Properties:
Name Type Attributes Description
id string The id of the track.
width number <nullable>
 The track width in px.
height number <nullable>
 The track height in px.
bitrate number <nullable>
 The track bitrate.
framerate number <nullable>
 The track framerate.

WebRTCConfig

WebRTCConfig
Properties:
Name Type Attributes Default Description
licenseKey string HISPlayer license key to validate the playback.
div Element The div container of the player.
src string The URL of the WebRTC stream (WebSocket URL) to be played. E.g. wss://your-signaling-server.com/webrtc/stream-name.
accessToken string <optional>
 The access token to authenticate the playback.
iceServer object <optional>
 The ICE server configuration.
Properties
Name Type Attributes Description
urls Array.<string> The URLs of the ICE server. E.g. ['turn:your-turn-server.com:port'].
username string <optional>
 The username of the ICE server.
credential string <optional>
 The credential of the ICE server.
autoplay boolean <optional>
 true Determines whether the playback must start automatically or not.
mutedAtStart boolean <optional>
 true Determines whether the playback must start muted or not.
ui boolean <optional>
 true Determines whether the player UI must be displayed or not.
logosrc string <optional>
 The URL of the logo image to be displayed on the player.

YouTubeConfig

YouTubeConfig
Properties:
Name Type Attributes Default Description
licenseKey string HISPlayer license key to validate the playback.
div Element The div container of the player.
src string the YouTube URL.
autoplay boolean <optional>
 true Determines whether the playback must start automatically or not.
resumePosition number <optional>
 Determines the position where the video will start playing.
logosrc string <optional>
 Company URL logo.