HLS or DASH over CMAF
Below are the parameters accessed in the HLS or DASH over CMAF output.
General
General
| Parameter | Description |
|---|---|
| Output name | Output name. The name you want to use for the output. |
| Naming scheme | Naming schemes for DASH manifests. Possible schemes: Index or Timeline. In Index mode, fragment names are computed by the played based on data given in the manifest. In Timeline mode, every fragment is listed and requested by the player. |
| GOP per segment | The number of GOP (group of pictures) included into each segment. |
| Segments per manifest | Number for segments to include in the manifests. |
| trun v1 | Enable trun version 1 for fragments allowing negative CTO (Composition Time Offset) values |
| Trick Mode support | Enables IFrame representations. |
| Low latency | Enables low latency mode. |
| Enable thumbnails | Enable thumbnails generation |
Subtitles
| Parameter | Description |
|---|---|
| Name | Name of the subtitle track. This name will be used in generated manifests/playlists. This setting does not apply to OnDemand assets where subtitles are delivered as passthrough from the source TTML file. |
| Type | Type of subtitle. Possible values: 'Closed captions [14]', 'DVB Subtitles' or 'DVB Teletext' This setting does not apply to OnDemand assets where subtitles are delivered as passthrough from the source TTML file. |
| Convert | Defines the conversion that applies to ingested subtitle or closed caption. Possible values: 'None', 'Passthrough', 'SMPTETT' or 'WebVTT'. For all assets a value of 'None' disables the given subtitle or closed caption track. For OnDemand assets, 'Passthrough' means that subtitles are delivered as passthrough from the source TTML file. 'Passthrough' does not apply to Live assets. For OnDemand assets, if a conversion is applied, then specified filename will be delivered in fragmented packages. |
Parameters mapping & advanced settings
| Parameter | Description |
|---|---|
| Parameters mapping key | Mapping key that will be used to override output parameters in individual OnDemand content or Live Packaging Services |
| Event Message Box version | Version of Event Message Box (emsg) used to carry timed metadata information. Possible values: 'Version 0' for legacy DASH or 'Version 1' for CMAF compatible DASH |
Related information
HLS or DASH over CMAF output configuration
Dash
Manifest
| Parameter | Description |
|---|---|
| Name | Name of the manifest/playlist generated for the current output.. Default value is index (for HLS) or manifest (for HSS and DASH). If a filtering has been applied to the manifest/playlist, it is recommended to use a name that clearly identifies the defined filtering. Important: The manifest name must be unique and different from any other manifest name. |
Filtering - Stream characteristics
| Parameter | Description |
|---|---|
| Audio streams filter | Build a filter to select the audio streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps |
| Video streams filter | Build a filter to select the video streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps and codec (H.264 or HEVC) |
| Subtitle streams filter | Build a filter to select the subtitle streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps |
| Thumbnail streams filter | Build a filter to select the thumbnail streams that will be included in manifest/playlist. Applicable filters: width and height in pixels |
Nielsen Watermarking
| Parameter | Description |
|---|---|
| No Filtering | All the available audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| Linear | Only the linear audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| C3 | Only the C3 (catch-up 3-days) audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| C7 | Only the C7 (catch-up 7-days) audio streams within the audio bitrate range defined above will be integrated to the generated output. |
Player wall-clock
| Parameter | Description |
|---|---|
| Scheme | Scheme to use for the UTCTiming element in DASH manifest. |
| Value | Value to use for UTCTiming element depending on the selected scheme. |
Advanced settings
| Parameter | Description |
|---|---|
| Audio merge policy | Defines the merge policy to apply to audio AdataptationSets. |
| Compatibility mode | Enables compatibility mode. |
HLS
Playlist
| Parameter | Description |
|---|---|
| Name | Name of the manifest/playlist generated for the current output. Default value is index (for HLS) or manifest (for HSS and DASH). Recommendation: If a filtering has been applied to the manifest/playlist, it is recommended to use a name that clearly identifies the defined filtering. |
Important: The manifest name must be unique and different from any other manifest name.
Filtering - Stream characteristics
| Parameter | Description |
|---|---|
| Audio streams filter | Build a filter to select the audio streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps |
| Video streams filter | Build a filter to select the video streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps and codec (H.264 or HEVC) |
| Subtitle streams filter | Build a filter to select the subtitle streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps |
| Thumbnail streams filter | Build a filter to select the thumbnail streams that will be included in manifest/playlist. Applicable filters: width and height in pixels |
Filtering - Stream index
| Parameter | Description |
|---|---|
| Indexes | Range or comma separated list of stream indexes, based on the stream position in the input. Index of the first stream is '0'. |
Nielsen Watermarking
| Parameter | Description |
|---|---|
| No Filtering | All the available audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| Linear | Only the linear audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| C3 | Only the C3 (catch-up 3-days) audio streams within the audio bitrate range defined above will be integrated to the generated output. |
| C7 | Only the C7 (catch-up 7-days) audio streams within the audio bitrate range defined above will be integrated to the generated output. |
URL signing
| Parameter | Description |
|---|---|
| Replacement type | Defines the content replacement strategy applied to the output. Possible values: None or POIS (Placement Opportunity Information Service) |
Cisco URL signature
| Parameter | Description |
|---|---|
| Version | URL signing version number. Version 0 uses MD5 hash algorithm. Version 2 uses SHA1 hash algorithm. |
| Key owner | Key owner value (Provided by Cisco) |
| Key ID | Key ID associated to the Key (Provided by Cisco) |
| Key | Key value (Provided by Cisco) |
| Expiration time | Duration of availabilty of the URL with current signature Default: 3600 |
| URL preambule | URL preambue to be use for this output |
| Client IP | IP address of the client |
Delivery
General parameters
| Parameter | Description |
|---|---|
| Access URL | Portion of the complete access URL that defines the service. Prefer URI unreserved characters (alphanumerical characters plus (, ), -, _, .). Declaring a subpath (a/b) is possible but may impact performance. Example: https://[Server IP or FQDN]/[Output Access URL]/[Live Packaging Service Access URL]/[index.m3u8 OR manifest OR manifest.mpd] |
External origin Server
| Parameter | Description |
|---|---|
| Details | Remote location for playlists, manifests and segments. Example: http://host/directory or file://host/directory |
Common encryption (CENC)
Fixed key generation mode
| Parameter | Description |
|---|---|
| Key | AES key used for encrypting the content. |
| Key ID | Identifier used to uniquely identify the key within the system. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
| Marlin MS3 | Enables Marlin MS3 encryption. |
PlayReady mode enabled:
| Parameter | Description |
|---|---|
| License acquisition URL | License acquisition URL to be used by the player. |
| License UI URL | Nonsilent license acquisition URL to be used by the player. |
| Domain service ID | Domain service identifier.<br>Microsoft provides a unique identifier to the PlayReady technology supplier. |
Widevine mode enabled:
| Parameter | Description |
|---|---|
| Provider | Name of the content provider. Also used as the name of the signer. |
| Policy | Usage rules for the encypted output. |
Compatible CPIX ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
| Marlin MS3 | Enables Marlin MS3 encryption. |
Key rotation enabled:
| Parameter | Description |
|---|---|
| Period | Key rotation period. Choose a value and a unit for the period |
| Start time | Date and time of the first occurrence |
| Time spread | Duration (in seconds) of the time window for spreading key requests out in time |
| Period mode | Choose mode for rotation keys.Possible values are: - index: the interval is defined by a sequence number. - start/end: the interval is defined by [start, end], meaning that the key is in use at the start time but not at the end time. |
| Number of key periods to request | Number of key periods to request in advance from the key server |
Key usage rules
| Parameter | Description |
|---|---|
| Track filters/Filtering | Build a filter to select the streams that will be included in Cpix track. Applicable filters: streamType (video or audio), width (in pixels), height (in pixels) and codec (H.264 or HEVC) |
| Track type | Type of a track associated to the track. Only AZaz09 _,;:@ and space character are accepted |
| Labels | List of labels associated to the track Only AZaz09 _,;:@ and space character are accepted |
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Google Widevine interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| Provider | Name of the content provider. Also used as the name of the signer. |
| Signature initialization vector | Signature Initialization Vector to be used with the signature key. |
| Signature AES key | AES key used to sign the request. |
| Policy | Usage rules for the encypted output. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Bouygues Telecom interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Verimatrix Telecom interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| Site ID | Unique identifier of the site for which the content is being created. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Kaltura interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| Account ID | Identifier of the key requestor. |
| Signature AES key | AES key used to sign the request. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Irdeto interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| Account ID | Identifier of the key requestor. |
| Crypto period | Time span that a key is authorized for use. A new key is retrieved at the start of each new period. A value of '0' means that a single key will be used. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Nagra KSS interface ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| Key update period | Defines the period between two key requests from the packager to the key server. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Common encryption (CBCS)
Fixed key generation mode
| Parameter | Description |
|---|---|
| Key | AES key used for encrypting the content. Unit: hexadecimal. |
| Initialization vector | Initialization vector to be used with the key. |
| Key ID | Identifier used to uniquely identify the key within the system. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
| Apple | Enables Apple encryption. |
PlayReady mode enabled:
| Parameter | Description |
|---|---|
| License acquisition URL | License acquisition URL to be used by the player. |
| License UI URL | Nonsilent license acquisition URL to be used by the player. |
| Domain service ID | Domain service identifier. Microsoft provides a unique identifier to the PlayReady technology supplier. |
Widevine mode enabled:
| Parameter | Description |
|---|---|
| Provider | Name of the content provider. Also used as the name of the signer. |
| Policy | Usage rules for the encypted output. |
Apple mode enabled:
| Parameter | Description |
|---|---|
| URI | URI to be used by the player. |
| Key format | Specify how the key is declared in the resource specified in the URL. |
| Key format versions | Indicate which version of the key format is used. |
Key usage rules
| Parameter | Description |
|---|---|
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Compatible CPIX ext. key
| Parameter | Description |
|---|---|
| Key server URL | URL of the server that will deliver the encryption keys. |
| PlayReady | Enables PlayReady encryption. |
| Widevine | Enables Widevine encryption. |
| Apple | Enables Apple encryption. |
Key rotation enabled:
| Parameter | Description |
|---|---|
| Period | Key rotation period. Choose a value and a unit for the period |
| Start time | Date and time of the first occurrence |
| Time spread | Duration (in seconds) of the time window for spreading key requests out in time |
| Period mode | Choose mode for rotation keys.Possible values are: - index: the interval is defined by a sequence number. - start/end: the interval is defined by [start, end], meaning that the key is in use at the start time but not at the end time. |
| Number of key periods to request | Number of key periods to request in advance from the key server |
Key usage rules
| Parameter | Description |
|---|---|
| Track filters/Filtering | Build a filter to select the streams that will be included in Cpix track. Applicable filters: streamType (video or audio), width (in pixels), height (in pixels) and codec (H.264 or HEVC) |
| Track type | Type of a track associated to the track. Only AZaz09 _,;:@ and space character are accepted |
| Labels | List of labels associated to the track Only AZaz09 _,;:@ and space character are accepted |
| Disable audio encryption | Disables audio encryption for the output. This setting overrides any encryption setting received from the key provider. |
Content replacement
Placement opportunity information service (POIS)
| Parameter | Description |
|---|---|
| POIS server URL | URL of the POIS (Placement Opportunity Information Service). Upon placement opportunity notification, POIS returns either a list of URLs to insert in place of the initial one, or specific tags to be inserted within the playlist. |
Related information
HLS or DASH over CMAF output configuration
HLS over TS output configuration
HSS output configuration