# 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 scheme for DASH manifests. Timeline mode: every fragment is listed and requested by the player. |
| trun v1           | Enable trun version 1 for fragments allowing negative CTO (Composition Time Offset) values             |
| Enable thumbnails | Enable thumbnails generation                                                                           |

## Dash

### Manifest

| Parameter | Description                                                                                                                                                                                                                                                                                                                                                    |
| :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name      | Name of the manifest/playlist generated for the current output. Default value is index (for HLS) or manifest (for 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 and Language                        |
| Video streams filter     | Build a filter to select the video streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps, codec (H.264 or HEVC) and No video |
| Subtitle streams filter  | Build a filter to select the subtitle streams that will be included in manifest/playlist. Applicable filters: bitrate in kbps and Language                     |
| 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                      |

## HLS

### Playlist

| Parameter | Description                                                                                                                                                                                                                                                                           |   |
| :-------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | - |
| Name      | Name of the manifest/playlist generated for the current output. Default value is index (for HLS) or manifest (for 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

## 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]/packaging/[Output Access URL]/[Live Packaging Service Access URL]/[index.m3u8 OR manifest OR manifest.mpd]` |

## 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.                                    |
| Fairplay  | Enables Fairplay 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 encrypted 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.                             |
| Fairplay       | Enables Fairplay encryption.                             |
| Mediaroom      | Enables Mediaroom encryption.                            |
| Clearkey       | Enables Clearkey encryption.                             |

**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.                                                                    |

## 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.                                    |
| Fairplay              | Enables Fairplay encryption.                                    |

PlayReady mode enabled:

Widevine mode enabled:

Fairplay 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 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

**Key usage rules**
