Distribution properties names that can be used to control the behavior of the content distribution to remote client(s). Properties can either be set before any actual distribution starts or during content distribution. The IToiMediaSession::SetDistributionProperties method allows the application to set the distribution properties that can be used to customize the distributor streamer for sending content to an IP Client.
| TToiDistributionId Name | Distribution Property Description | TToiDistributionId Value |
|---|---|---|
| PROPERTY_DISTRIBUTION_PROTOCOL_TYPE | This identifies the distribution transport protocol to be used. This property must be included to stream content | "distribution.protocol.type" |
| PROPERTY_DISTRIBUTION_DRM_TYPE | This identifies the distribution content protection protocol to be used. This property must be included to stream content | "distribution.drm.type" |
| PROPERTY_DISTRIBUTION_TRANSCODING_AUDIO_LANG | This identifies the audio language to be used for the streaming session. This property is only included when transcoding is required If this property is not set then the first language is selected. | "distribution.transcoding.audiolang" |
| PROPERTY_DISTRIBUTION_TRANSCODING_DVS_ENABLED | This enables DVS for the streaming session. This property is only included when transcoding is required The default mode of operation is DVS disabled in this property is not set | "distribution.transcoding.dvsenabled" |
| PROPERTY_DISTRIBUTION_CLIENT_MAC_ADDRESS | This identifies the Mac Address of the IP Client. This property must be included to stream content. | "distribution.client.macaddress" |
| PROPERTY_DISTRIBUTION_START_POSITION | This identifies the start position of the dvr asset for streaming session. This property should only be included when the SourceURL is a dvr asset. The default value for this parameter when this property is not set is zero or start of the DVR asset. | "distribution.media.start.position" |
This selects the distribution transport protocol to be used to distribute content to IP Clients. This property must be set for content streaming to begin; also an error will be returned if the distribution sequence does not include this property.
| PROPERTY_DISTRIBUTION_PROTOCOL_TYPE Name | Distribution Transport Protocol Description | PROPERTY_DISTRIBUTION_PROTOCOL_TYPE Value |
|---|---|---|
| HTTP_DISTRIBUTION_PROTOCOL | This identifies the HTTP distribution transport protocol to be used. This inclues support for the DLNA defined HTTP headers for Playspeed and Timeseek | "http.distribution.protocol" |
| DLNA_DISTRIBUTION_PROTOCOL | This identifies the DLNA distribution transport protocol to be used. This inclues full DLNA version 1.5 compliant support | "dlna.distribution.protocol" |
| HLS_DISTRIBUTION_PROTOCOL | This identifies the HLS distribution transport protocol to be used. | "hls.distribution.protocol" |
| RTSP_DISTRIBUTION_PROTOCOL | This identifies the RTSP distribution transport protocol to be used. | "rtsp.distribution.protocol" |
| HMA_DISTRIBUTION_PROTOCOL | This identifies the HMA distribution transport protocol to be used. | "hma.distribution.protocol" |
This selects the distribution content protection protocol to be used to distribute content to IP Clients. This property must be set for content streaming to begin; also an error will be returned if the distribution sequence does not include this property.
| PROPERTY_DISTRIBUTION_DRM_TYPE Name | Distribution Content Protection Protocol Description | PROPERTY_DISTRIBUTION_DRM_TYPE Value |
|---|---|---|
| IPRM_DISTRIBUTION_DRM_TYPE | This identifies the IPRM content protection distribution protocol to be used. | "iprm.distribution.drm.type" |
| DTCPIP_DISTRIBUTION_DRM_TYPE | This identifies the DTCIP content protection distribution protocol to be used. | "dtcpip.distribution.drm.type" |
| HMA_DISTRIBUTION_DRM_TYPE | This identifies the HMA content protection distribution protocol to be used. | "hmadrm.distribution.drm.type" |
| SECUREMEDIA_DISTRIBUTION_DRM_TYPE | This identifies the Secure Media content protection distribution protocol to be used. | "securemdia.distribution.drm.type" |
This selects the Content Audio Transcoding Language to be used to distribute content to IP Clients. The default value will be set to "eng" if this property is not set
| PROPERTY_TRANSCODING_AUDIO_LANG Name | Distribution Content Audio Language Definitions | PROPERTY_TRANSCODING_AUDIO_LANG Value | |
|---|---|---|---|
| Not Applicable | This identifies the audio content transcoding language. | The Disribution Content Audio Language string definitions which affects the audio language component selection for transcoding prior to streaming content to IP Clients. Please note: the input string will follow the ISO639-3 stanard format. | string value |
This selects the Content Audio Transcoding DVS Enabled definition which affects the audio language component selection for transcoding prior to streaming content IP Clients. The default mode for audio transcoding language selection is DVS DISABLED if this property is not set.
| PROPERTY_TRANSCODING_DVS_ENABLED Name | Distribution Content Audio Transcoding DVS Enabled Type Definition | PROPERTY_TRANSCODING_DVS_ENABLED Value |
|---|---|---|
| TRUE | This value will enable the audio content transcoding dvs enabled audio language selection mode. | "TRUE" |
| FALSE | This value will disable the audio content transcoding dvs enabled audio language selection mode. | "FALSE" |
This provides the IP Client's MAC Address to streaming content IP Clients. This property must be set for content streaming to begin; also an error will be returned if the distribution sequence does not include this property.
| PROPERTY_TRANSCODING_IP_CLIENT_MAC_ADDRESS Name | Distribution Content IP Client MAC Address Definition | PROPERTY_TRANSCODING_IP_CLIENT_MAC_ADDRESS Value |
|---|---|---|
| Not Applicable | The string value can utilize two standard string based formats which use either ":" or "-" as the byte delimiters. For example: "00:1F:29:79:5A:52" or "00-1F-29-79-5A-52" For the hex decimals, it doesn't matter if they are upper or lower case. | string value |
This provides the IP Client's MAC Address to streaming content IP Clients. This property must be set for content streaming to begin; also an error will be returned if the distribution sequence does not include this property.
| PROPERTY_DISTRIBUTION_START_POSITION Name | Distribution Content DVR Asset Starting Address defintions | PROPERTY_DISTRIBUTION_START_POSITION Value |
|---|---|---|
| Not Applicable | The Distribution Content DVR Asset Starting Address definitions define the start position for streaming DVR assets to IP clients. The value passed in will be in form of milliseconds in decimal format with a range from 0 to +2147483647. The default value for this property will be 0 and negative values will return an error. | string value |