Media Support for Content Distribution
Distribution Properties
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 ToiMediaSession::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" |
Distribution Protocol Value Definitions
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" |
Distribution Content Protection Value Definitions
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" |
Distribution Content Audio Transcoding Language Definitions
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 |
Distribution Content Audio Transcoding DVS Enabled Definitions
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" |
Distribution Content IP Client MAC Address Definitions
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 |
Distribution Content IP Client MAC Address Definitions
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 |
|
