Motorola Mobility Confidential Restricted.
ToiMediaPlayerBase Interface Reference

Description

The ToiMediaPlayerBase interface is the base interface for player instances. It contains only read-only methods and no control functionality.

See also:
ToiMediaService
ToiMediaPlayer

import "ToiMediaPlayerBase.idl";

Inheritance diagram for ToiMediaPlayerBase:
ToiEventTarget ToiMediaPlayer

List of all members.

Public Member Functions

TToiState getState ()
ToiMediaPlayerBaseError getError ()
ToiMediaSession::TToiSessionId getSessionId () raises (TToiSessionViolationException)
string getUrl () raises (TToiSessionViolationException)
ToiMediaPlayerBaseStreamInfo getStreamInfo () raises (TToiSessionViolationException, TToiUnavailableException)
ToiMediaPlayerBaseVideoStreamInfo getVideoStreamInfo (in ToiMediaPlayerBaseComponentEntry mediaComponent) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
ToiMediaPlayerBaseAudioStreamInfo getAudioStreamInfo (in ToiMediaPlayerBaseComponentEntry mediaComponent) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
ToiMediaPlayerBaseSubtitleStreamInfo getSubtitleStreamInfo (in ToiMediaPlayerBaseComponentEntry mediaComponent) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
ToiMediaPlayerBaseTeletextStreamInfo getTeletextStreamInfo (in ToiMediaPlayerBaseComponentEntry mediaComponent) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
long getCapabilities () raises (TToiSessionViolationException, TToiUnavailableException)
long getPosition () raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
long getPace () raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
ToiMediaPlayerBasePositionInfo getPositionInfo () raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
boolean isTimeshiftPlayback () raises (TToiSessionViolationException, TToiUnavailableException)
ToiMediaPlayerBaseTimeshiftInfo getTimeshiftInfo () raises (TToiSessionViolationException, TToiUnavailableException)
ToiMediaPlayerBaseError getTimeshiftError ()
ToiMediaPlayerBaseMediaBufferInfo getMediaBufferInfo () raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
string getParameter (in string name) raises (TToiInvalidArgumentException, TToiUnavailableException)
void subscribeParameter (in ToiEventListener eventListener, in string name) raises (TToiInvalidArgumentException, TToiUnavailableException)
void unsubscribeParameter (in ToiEventListener eventListener, in string name) raises (TToiInvalidArgumentException, TToiUnavailableException)
void releaseInstance ()
ToiMediaPlayerBasePresentationInfo getPresentationInfo () raises (TToiSessionViolationException, TToiUnavailableException)

Public Attributes

const long PACE_PAUSE = 0
const long PACE_PLAY = 1000
const long PACE_FASTFORWARD = 5000
const long PACE_REWIND = -5000
const long POSITION_LIVE = -1616928864
const long CAPABILITY_PAUSE = 1
const long CAPABILITY_REWIND = 2
const long CAPABILITY_FASTFORWARD = 4
const long CAPABILITY_GETPOSITION = 8
const long CAPABILITY_SETPOSITION = 16
const long CAPABILITY_FREEZE = 32
const long CAPABILITY_TIMESHIFT = 64
const long CAPABILITY_MEDIA_BUFFER = 128
Events
const long ON_STATE_CHANGED = 1700
const long ON_DATA_AVAILABLE = 1701
const long ON_POSITION_CHANGED = 1702
const long ON_POSITION_STATUS_CHANGED = 1703
const long ON_STREAM_INFO_CHANGED = 1704
const long ON_PARAMETER_CHANGED = 1705
const long ON_TIMESHIFT_STATE_CHANGED = 1706
const long ON_CAPABILITIES_CHANGED = 1707
const long ON_PRESENTATION_STATUS_CHANGED = 1708
const long ON_MEDIA_BUFFER_STATUS_CHANGED = 1709
TToiComponentType
const TToiComponentType COMPONENT_AUDIO = 0
const TToiComponentType COMPONENT_VIDEO = 1
const TToiComponentType COMPONENT_SUBTITLE = 2
const TToiComponentType COMPONENT_SUBTITLE_CAPTION = 3
const TToiComponentType COMPONENT_SUBTITLE_SUPERIMPOSE = 4
const TToiComponentType COMPONENT_TELETEXT_VBI = 5
TToiErrorSource
const TToiErrorSource SOURCE_UNKNOWN = 0
const TToiErrorSource SOURCE_INTERNAL = 1
const TToiErrorSource SOURCE_BITBAND = 2
TToiState
const TToiState STATE_IDLE = 0
const TToiState STATE_CONNECTING = 1
const TToiState STATE_PAUSED = 2
const TToiState STATE_PLAYING = 3
const TToiState STATE_FASTFORWARDING = 4
const TToiState STATE_REWINDING = 5
const TToiState STATE_FAILED = 6
TToiTimeshiftState
const TToiTimeshiftState TIMESHIFT_STATE_INACTIVE = 0
const TToiTimeshiftState TIMESHIFT_STATE_BUFFERING = 1
const TToiTimeshiftState TIMESHIFT_STATE_STOPPED = 2
const TToiTimeshiftState TIMESHIFT_STATE_BUFFERING_FAILED = 3
TToiAudioAudienceType
const TToiAudioAudienceType AUDIO_AUDIENCE_TYPE_UNKNOWN = 0
const TToiAudioAudienceType AUDIO_AUDIENCE_TYPE_NORMAL = 1
const TToiAudioAudienceType AUDIO_AUDIENCE_TYPE_VISUALLY_IMPAIRED = 2
const TToiAudioAudienceType AUDIO_AUDIENCE_TYPE_HEARING_IMPAIRED = 3
TToiAudioChannelFormat
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_UNKNOWN = 0
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_SINGLE_MONO = 1
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_DUAL_MONO = 2
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_STEREO = 3
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_3_FRONT_1_BACK = 4
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK = 5
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK_LFE = 6
const TToiAudioChannelFormat AUDIO_CHANNEL_FORMAT_3_FRONT_2_SIDE_2_BACK_LFE = 7
TToiAudioChannelMode
const TToiAudioChannelMode AUDIO_CHANNEL_MODE_NORMAL = 0
const TToiAudioChannelMode AUDIO_CHANNEL_MODE_DUAL_MONO_LEFT_ONLY = 1
const TToiAudioChannelMode AUDIO_CHANNEL_MODE_DUAL_MONO_RIGHT_ONLY = 2
const TToiAudioChannelMode AUDIO_CHANNEL_MODE_DUAL_MONO_STEREO = 3
const TToiAudioChannelMode AUDIO_CHANNEL_MODE_DUAL_MONO_MIXED = 4
TToiAspectRatio
const TToiAspectRatio ASPECT_RATIO_UNKNOWN = 0
const TToiAspectRatio ASPECT_RATIO_4_3 = 1
const TToiAspectRatio ASPECT_RATIO_16_9 = 2
TToiActiveFormatDescriptor
const TToiActiveFormatDescriptor ACTIVE_FORMAT_UNKNOWN = 0
const TToiActiveFormatDescriptor ACTIVE_FORMAT_16_9_TOP = 1
const TToiActiveFormatDescriptor ACTIVE_FORMAT_14_9_TOP = 2
const TToiActiveFormatDescriptor ACTIVE_FORMAT_MORE_THAN_16_9_CENTRE = 3
const TToiActiveFormatDescriptor ACTIVE_FORMAT_SAME_AS_CODED = 4
const TToiActiveFormatDescriptor ACTIVE_FORMAT_4_3_CENTRE = 5
const TToiActiveFormatDescriptor ACTIVE_FORMAT_16_9_CENTRE = 6
const TToiActiveFormatDescriptor ACTIVE_FORMAT_14_9_CENTRE = 7
const TToiActiveFormatDescriptor ACTIVE_FORMAT_4_3_SHOOT_AND_PROTECT_14_9_CENTRE = 8
const TToiActiveFormatDescriptor ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_14_9_CENTRE = 9
const TToiActiveFormatDescriptor ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_4_3_CENTRE = 10
TToiVideo3dSourceFormat
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_CHECKERBOARD = 0
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_COLUMN_BASED = 1
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_ROW_BASED = 2
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_SIDE_BY_SIDE = 3
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_TOP_BOTTOM = 4
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_TEMPORAL = 5
const TToiVideo3dSourceFormat VIDEO_3D_SRC_FORMAT_RESERVED = 6
const TToiVideo3dSourceFormat VIDEO_3D_FORMAT_CANCELED = 0x80
const TToiVideo3dSourceFormat VIDEO_3D_FORMAT_NOT_SPECIFIED = 0xff
TToiSubtitleType
const TToiSubtitleType SUBTITLE_UNKNOWN = 0
const TToiSubtitleType SUBTITLE_NORMAL = 1
const TToiSubtitleType SUBTITLE_HEARING_IMPAIRED = 2
TToiSubtitleFormat
const TToiSubtitleFormat SUBTITLE_DVB = 0
const TToiSubtitleFormat SUBTITLE_ARIB = 1
const TToiSubtitleFormat SUBTITLE_TELETEXT = 2
const TToiSubtitleFormat SUBTITLE_DVD = 3
const TToiSubtitleFormat SUBTITLE_XSUB = 4
TToiReceiveDmfMode
const TToiReceiveDmfMode RECEIVE_DMF_MODE_AUTO = 0
const TToiReceiveDmfMode RECEIVE_DMF_MODE_NON_AUTO = 1
const TToiReceiveDmfMode RECEIVE_DMF_MODE_SELECT = 2
const TToiReceiveDmfMode RECEIVE_DMF_MODE_SPECIAL = 3
TToiRecordDmfMode
const TToiRecordDmfMode RECORD_DMF_MODE_AUTO = 0
const TToiRecordDmfMode RECORD_DMF_MODE_NON_AUTO = 1
const TToiRecordDmfMode RECORD_DMF_MODE_SELECT = 2
TToiMediaBufferType
const TToiMediaBufferType MEDIA_BUFFER_TYPE_TIMESHIFT = 0
const TToiMediaBufferType MEDIA_BUFFER_TYPE_DOWNLOAD = 1

Public Types

typedef long TToiComponentType
typedef sequence
< ToiMediaPlayerBaseComponentEntry
TToiComponentSequence
typedef sequence< long > TToiPaceSequence
typedef long TToiErrorSource
typedef long TToiState
typedef long TToiTimeshiftState
typedef long TToiAudioAudienceType
typedef long TToiAudioChannelFormat
typedef long TToiAudioChannelMode
typedef long TToiAspectRatio
typedef long TToiActiveFormatDescriptor
typedef long TToiVideo3dSourceFormat
typedef long TToiSubtitleType
typedef long TToiSubtitleFormat
typedef long TToiReceiveDmfMode
typedef long TToiRecordDmfMode
typedef long TToiMediaBufferType
typedef sequence
< TToiMediaBufferType
TToiMediaBufferTypeSequence

Member Typedef Documentation

Active format descriptor used to identify the active video format provided in the ToiMediaPlayerBaseVideoStreamInfo structure.

Aspect ratio identifier used to identify the video aspect ratio provided in the ToiMediaPlayerBaseVideoStreamInfo structure.

Audio type identifier used to identify the audio type provided in the ToiMediaPlayerBaseAudioStreamInfo structure.

The audio channel format specifies the number of channels and desired speaker setup.

The audio channel mode specifies audio channel to speaker mappings.

List of media component entries

Media component identifier types used to set and get information about media components of a session.

Enumeration of various sources that can cause an OnError event to occur. Typically, this can be a streamer element or similar low-level component.

Media buffer types supported by the media player. Only one media buffer type is used for a given media player session

List of supported media buffer types.

typedef sequence< long > ToiMediaPlayerBase::TToiPaceSequence
Technical Preview:
List of supported paces

Receive DMF mode used for ARIB CC/CS

Receive DMF mode used for ARIB CC/CS

Enumeration of media player states.

Subtitle format identifier used to identify the subtitle format provided in the ToiMediaPlayerBaseSubtitleStreamInfo structure.

Subtitle type identifier used to identify the subtitle type provided in the ToiMediaPlayerBaseSubtitleStreamInfo structure.

State identifier used to identify the media player timeshift state.

Technical Preview:
This enum is a TECHNICAL PREVIEW, it may change. Defines the 3D video formats as specified in H.264 SEI frame packing message (see related ISO/IEC document for details).

Member Function Documentation

Returns information about a specified audio stream in the current media stream multiplex in the form of an audio stream info structure.

Parameters:
mediaComponentThe media component entry for which the stream info has to be retrieved.
Return values:
streamInfoInformation about the specified audio stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentExceptionIf the mediaComponent given as argument does not identify an audio stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
long ToiMediaPlayerBase::getCapabilities ( ) raises (TToiSessionViolationException, TToiUnavailableException)

Returns the capabilities present for the current session.

Return values:
capabilityMaskA bit mask describing the capabilities of the current session. The mask can include the following capabilities:
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
ToiMediaPlayerBaseError ToiMediaPlayerBase::getError ( )

Returns the last error. This is typically called when state is changed to ToiMediaPlayerBase::STATE_FAILED. The result is undefined if no error has occurred.

Return values:
errorThe error

Returns information about the current status of the media buffer.

Return values:
infoThe current media buffer information.
Exceptions:
TToiSessionViolationExceptionRaised if the player is in ToiMediaPlayerBase::STATE_IDLE.
TToiOperationNotSupportedExceptionRaised if the session lacks the capability ToiMediaPlayerBase::CAPABILITY_MEDIA_BUFFER to get media buffer info.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
See also:
ToiMediaPlayerMediaBufferStatusChangedEvent

Returns the current pace that the media stream is played with.

Deprecated:
The same information can be obtained by ToiMediaPlayerBase::getPositionInfo().
Return values:
paceThe pace at which the position changes, given as a multiplier of normal playback times 1000. If the stream is paused the pace is zero. When the stream is played at normal speed the pace is 1000. In ToiMediaPlayerBase::STATE_FASTFORWARDING the pace is generally above 1000, and in ToiMediaPlayerBase::STATE_REWINDING generally below -1000. For example, if the stream is rewinded at a pace three times normal playback, the pace is -3000.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiOperationNotSupportedExceptionIf the session lacks the capability to get position, the operation not supported exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
string ToiMediaPlayerBase::getParameter ( in string  name) raises (TToiInvalidArgumentException, TToiUnavailableException)

Get the current value of a parameter.

Parameters:
nameName of the requested parameter.
Return values:
valueThe current value of the parameter.
Exceptions:
TToiInvalidArgumentExceptionThe parameter name is invalid or not recognized.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
See also:
ToiMediaPlayer::setParameter()
ToiMediaPlayer::unsetParameter()
ToiMediaPlayerBase::subscribeParameter()

Returns the current position in the media stream.

Deprecated:
The same information can be obtained by using ToiMediaPlayerBase::getPositionInfo().
Return values:
positionThe current position in milliseconds. If asset start is 0, relative position from start is equal to current position. Otherwise, relative position from start is current position - asset start.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiOperationNotSupportedExceptionIf the session lacks the capability to get position, the operation not supported exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.

Returns pace and position information for the current media session.

Return values:
positionInfoPosition and pace information for the current media session.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiOperationNotSupportedExceptionIf the session lacks the capability to get position, the operation not supported exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
ToiMediaPlayerBasePresentationInfo ToiMediaPlayerBase::getPresentationInfo ( ) raises (TToiSessionViolationException, TToiUnavailableException)
Technical Preview:
This method is a TECHNICAL PREVIEW, it may change. Returns the presentation information about current video and audio lock status. Audio locked means audio decoder is started, sample rate is locked and no sync loss. Video locked means video decoder is started and no sync loss.
Return values:
infoInfomation about the current lock status of video and audio.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
ToiMediaSession::TToiSessionId ToiMediaPlayerBase::getSessionId ( ) raises (TToiSessionViolationException)

Returns the session identifier. This identifier can be used to open a session object with (C++) ToiMediaService::OpenSession().

Return values:
idThe session identifier.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
See also:
ToiMediaService::openSession()
TToiState ToiMediaPlayerBase::getState ( )

Returns the current state of the media player instance.

Return values:
stateThe current player state.

Returns information about the current stream in form of a stream info structure. The lists of audio and video streams provided as parts of this information can be used for further exploration using the ToiMediaPlayerBase::getAudioStreamInfo() and ToiMediaPlayerBase::getVideoStreamInfo() functions, respectively.

Return values:
streamInfoInformation about the current stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.

Returns information about a specified subtitle stream in the current media stream multiplex in the form of a subtitle stream info structure.

Parameters:
mediaComponentThe media component entry for which the stream info has to be retrieved.
Return values:
streamInfoInformation about the specified subtitle stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentExceptionIf the streamId given as argument does not identify a subtitle stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.

Returns information about a specified teletext stream in the current media stream multiplex in the form of a teletext stream info structure.

Parameters:
mediaComponentThe media component entry for which the stream info has to be retrieved.
Return values:
streamInfoInformation about the specified teletext stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentExceptionIf the mediaComponent given as argument does not identify a teletext stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
ToiMediaPlayerBaseError ToiMediaPlayerBase::getTimeshiftError ( )

Returns the last timeshift error. This is typically called after a state change to ToiMediaPlayerBase::TIMESHIFT_STATE_BUFFERING_FAILED. The result is undefined if no error has occurred.

Return values:
timeshiftErrorThe error.

Retrieve information about the current timeshift operation.

Return values:
timeshiftInfoInformation about the current timeshift operation.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
string ToiMediaPlayerBase::getUrl ( ) raises (TToiSessionViolationException)

Returns the URL for the media stream.

Return values:
urlThe URL for the media stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.

Returns information about a specified video stream in the current media stream multiplex in the form of a video stream info structure.

Parameters:
mediaComponentThe media component entry for which the stream info has to be retrieved.
Return values:
streamInfoInformation about the specified video stream.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentExceptionIf the mediaComponent given as argument does not identify a video stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableExceptionTToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
boolean ToiMediaPlayerBase::isTimeshiftPlayback ( ) raises (TToiSessionViolationException, TToiUnavailableException)

Returns true if the player is playing from the timeshift buffer.

Return values:
timeshiftPlaybackTrue if the player is playing from the timeshift buffer, otherwise false.
Exceptions:
TToiSessionViolationExceptionIf the player is in ToiMediaPlayerBase::STATE_IDLE a session violation exception is raised.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
void ToiMediaPlayerBase::releaseInstance ( )

This function releases the resources used by this instance. When this function returns all observers has also been released.

void ToiMediaPlayerBase::subscribeParameter ( in ToiEventListener  eventListener,
in string  name 
) raises (TToiInvalidArgumentException, TToiUnavailableException)

This function makes the application subscribe to updates of a specific named parameter. When the subscription is made there will be an immediate call to ToiMediaPlayerParameterChangedEvent if there is a value available.

Parameters:
eventListenerToiEventListener
nameThe name of the parameter for which changes the application wants to subscribe to.
Exceptions:
TToiInvalidArgumentExceptionThe parameter name is invalid or not recognized.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
See also:
ToiMediaPlayerBase::unsubscribeParameter()
void ToiMediaPlayerBase::unsubscribeParameter ( in ToiEventListener  eventListener,
in string  name 
) raises (TToiInvalidArgumentException, TToiUnavailableException)

This function undoes the effect of a previous call to ToiMediaPlayerBase::subscribeParameter().

Parameters:
eventListenerToiEventListener
nameThe name of the parameter that the application is no longer interested in.
Exceptions:
TToiInvalidArgumentExceptionThe parameter name is invalid or not recognized.
TToiUnavailableExceptionRaised if the player is temporarily unavailable due to platform resource management.
See also:
ToiMediaPlayerBase::subscribeParameter()

Member Data Documentation

The active format descriptor is 14:9 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_14_9_CENTRE.

The active format descriptor is 14:9 top.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_14_9_TOP.

The active format descriptor is 16:9 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_16_9_CENTRE.

The active format descriptor is 16:9 with shoot and protect 14:9 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_14_9_CENTRE.

The active format descriptor is 16:9 with shoot and protect 4:3 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_4_3_CENTRE.

The active format descriptor is 16:9 top.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_16_9_TOP.

The active format descriptor is 4:3 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_4_3_CENTRE.

The active format descriptor is 4:3 with shoot and protect 14:9 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_4_3_SHOOT_AND_PROTECT_14_9_CENTRE.

The active format descriptor is > 16:9 centre.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_MORE_THAN_16_9_CENTRE.

The active format descriptor is same as coded.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_SAME_AS_CODED.

The active format descriptor is not known.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ACTIVE_FORMAT_UNKNOWN.

The aspect ratio is 16:9

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ASPECT_RATIO_16_9.

The aspect ratio is 4:3

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ASPECT_RATIO_4_3.

The aspect ratio is not known.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ASPECT_RATIO_UNKNOWN.

The audio is prepared for the hearing impaired.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_AUDIENCE_TYPE_HEARING_IMPAIRED.

The audio is prepared for normal audiance.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_AUDIENCE_TYPE_NORMAL.

The audience type of the audio is not known.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_AUDIENCE_TYPE_UNKNOWN.

The audio is prepared for the visually impaired.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_AUDIENCE_TYPE_VISUALLY_IMPAIRED.

Four audio channels. Three front and one back speakers.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_3_FRONT_1_BACK.

Five audio channels. Three front and two back speakers.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK.

Five audio channels. Three front and two back speakers. One low frequency effects channel (LFE). One subwoofer speaker.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK_LFE.

Seven audio channels. Three front, two side and two back speakers. One low frequency effects channel (LFE). One subwoofer speaker.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_3_FRONT_2_SIDE_2_BACK_LFE.

Two content separate audio channels. Either one or two speakers.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_DUAL_MONO.

One audio channel. One speaker.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_SINGLE_MONO.

Two audio channels. Two front speakers.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_STEREO.

The audio channel format is not known.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_FORMAT_UNKNOWN.

The dual mono mode where the left channel is sent to both left and right front speaker outputs.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_MODE_DUAL_MONO_LEFT_ONLY.

The dual mono mode where the left and right channels are mixed and sent to both left and right front speaker outputs

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_MODE_DUAL_MONO_MIXED.

The dual mono mode where the right channel is sent to both left and right front speaker outputs.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_MODE_DUAL_MONO_RIGHT_ONLY.

The dual mono mode where the left channel is sent to the left front speaker output and the right channel is sent to the right front speaker output

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_MODE_DUAL_MONO_STEREO.

The normal mode where each channel is sent to its speaker output.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.AUDIO_CHANNEL_MODE_NORMAL.

When this bit is set the session accepts the ToiMediaPlayer::Play([pace > 0]) command.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_FASTFORWARD.

When this bit is set the session accepts the ToiMediaPlayer::Play(PACE_PAUSE) command. Freeze is similar to pause, except that when resuming a frozen session it will continue from the current live position.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_FREEZE.

When this bit is set the session provides a position value which the client may read with ToiMediaPlayerBase::getPosition() and similar commands.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_GETPOSITION.

When this bit is set the session supports some type of media buffering and the client can get media buffer information using ToiMediaPlayerBase::getMediaBufferInfo().

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_MEDIA_BUFFER.

When this bit is set the session accepts the ToiMediaPlayer::Play(PACE_PAUSE) command. When a paused session is resumed it will continue playing from the position where the pause occured. This is similar to freeze.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_PAUSE.

When this bit is set the session accepts the ToiMediaPlayer::Play([pace < 0]) command.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_REWIND.

When this bit is set the session accepts the position to be set ToiMediaPlayer::playFromPosition().

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_SETPOSITION.

When this bit is set the session can perform timeshift buffering operations. It will not be unset when buffering or playing from the buffer as long as the session still supports timeshift operations.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.CAPABILITY_TIMESHIFT.

Audio components have information of type ToiMediaPlayerBaseAudioStreamInfo.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_AUDIO.

Denotes a regular subtitling component.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_SUBTITLE.

Technical Preview:
This enumerator is a TECHNICAL PREVIEW, it may change. This is an ARIB specific type of subtitles.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_SUBTITLE_CAPTION.

Technical Preview:
This enumerator is a TECHNICAL PREVIEW, it may change. This is an ARIB specific type of subtitles and used mainly for displaying alert messages on screen.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_SUBTITLE_SUPERIMPOSE.

Technical Preview:
This enumerator is a TECHNICAL PREVIEW, it may change. Teletext VBI component have information of type ToiMediaPlayerBaseTeletextStreamInfo.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_TELETEXT_VBI.

Video components have information of type ToiMediaPlayerBaseVideoStreamInfo.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.COMPONENT_VIDEO.

Media download buffer Used

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.MEDIA_BUFFER_TYPE_DOWNLOAD.

Timeshifter buffer Used

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.MEDIA_BUFFER_TYPE_TIMESHIFT.

This is an Event identifier for ToiMediaPlayerCapabilitiesChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_CAPABILITIES_CHANGED.

This is an Event identifier for ToiMediaPlayerDataAvailableEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_DATA_AVAILABLE.

This is an Event identifier for ToiMediaPlayerMediaBufferStatusChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_MEDIA_BUFFER_STATUS_CHANGED.

This is an Event identifier for ToiMediaPlayerParameterChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_PARAMETER_CHANGED.

This is an Event identifier for ToiMediaPlayerPositionChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_POSITION_CHANGED.

This is an Event identifier for ToiMediaPlayerPositionStatusChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_POSITION_STATUS_CHANGED.

This is an Event identifier for ToiMediaPlayerPresentationStatusChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_PRESENTATION_STATUS_CHANGED.

This is an Event identifier for ToiMediaPlayerStateChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_STATE_CHANGED.

This is an Event identifier for ToiMediaPlayerStreamInfoChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_STREAM_INFO_CHANGED.

This is an Event identifier for ToiMediaPlayerTimeshiftStateChangedEvent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.ON_TIMESHIFT_STATE_CHANGED.

Predefined argument value for ToiMediaPlayer::play(). Indicates that the player should play with a normal fast forward speed.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.PACE_FASTFORWARD.

Predefined argument value for ToiMediaPlayer::play(). Indicates that the player should be paused.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.PACE_PAUSE.

const long ToiMediaPlayerBase::PACE_PLAY = 1000

Predefined argument value for ToiMediaPlayer::play(). Indicates that the player should play with normal speed.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.PACE_PLAY.

const long ToiMediaPlayerBase::PACE_REWIND = -5000

Predefined argument value for ToiMediaPlayer::play(). Indicates that the player should play with a normal rewind speed.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.PACE_REWIND.

const long ToiMediaPlayerBase::POSITION_LIVE = -1616928864

Predefined argument value for ToiMediaPlayer::playFromPosition(). Indicates that the player should stop playing from the timeshift buffer and instead start playback of the live stream.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.POSITION_LIVE.

Automatic mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECEIVE_DMF_MODE_AUTO.

Non-automatic mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECEIVE_DMF_MODE_NON_AUTO.

Select mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECEIVE_DMF_MODE_SELECT.

Special mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECEIVE_DMF_MODE_SPECIAL.

Automatic mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECORD_DMF_MODE_AUTO.

Non-automatic mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECORD_DMF_MODE_NON_AUTO.

Select mode.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.RECORD_DMF_MODE_SELECT.

ToiMediaPlayerBase::SOURCE_BITBAND - A BitBand element has failed for some reason.

Deprecated:
Bitband is not supported.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SOURCE_BITBAND.

ToiMediaPlayerBase::SOURCE_INTERNAL - An internal failure occured before an error code could be retrieved.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SOURCE_INTERNAL.

ToiMediaPlayerBase::SOURCE_UNKNOWN - An error of unknown type has occurred.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SOURCE_UNKNOWN.

In ToiMediaPlayerBase::STATE_CONNECTING the media player has an active session and is in the process of establishing a connection to a media stream source. The media player will leave this state automatically and enter ToiMediaPlayerBase::STATE_PAUSED when it has successfully established the connection to the stream source. If the media player decides it cannot connect, it will enter ToiMediaPlayerBase::STATE_FAILED instead. If the application is not interrested in knowing when the player has connected, it may call ToiMediaPlayer::play() to set the player in ToiMediaPlayerBase::STATE_PLAYING directly. The application may also end the session by calling ToiMediaPlayer::close(), which makes the player go to ToiMediaPlayerBase::STATE_IDLE.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_CONNECTING.

In ToiMediaPlayerBase::STATE_FAILED the media player may or may not have a connection to a media source but the process of getting the stream from that source has failed in some fatal way. The media player will only leave ToiMediaPlayerBase::STATE_FAILED on a call by the application to ToiMediaPlayer::close().

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_FAILED.

In ToiMediaPlayerBase::STATE_FASTFORWARDING the media player has a connection to a media source and plays the stream from that source in forward direction at a pace above normal playback. For streams on which this operation cannot be performed, this state is not available. On a command from the application, the player will leave this state for one of the other playback states ToiMediaPlayerBase::STATE_PLAYING, ToiMediaPlayerBase::STATE_PAUSED, or ToiMediaPlayerBase::STATE_REWINDING. The application may also end the session by calling ToiMediaPlayer::close(), which makes the player go to ToiMediaPlayerBase::STATE_IDLE. If an error occurs with the stream severe enough for the player to determine it cannot continue playback, the player will go to ToiMediaPlayerBase::STATE_FAILED.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_FASTFORWARDING.

In ToiMediaPlayerBase::STATE_IDLE there is no active session. The media player does not handle a stream, and consequently has no connection to a media stream source. All functions requiring a session will raise a TToiSessionViolationException in ToiMediaPlayerBase::STATE_IDLE. The media player will only leave ToiMediaPlayerBase::STATE_IDLE on a successful call to ToiMediaPlayer::open().

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_IDLE.

In ToiMediaPlayerBase::STATE_PAUSED the media player has a connection to a media source but playback is halted. On a command from the application, the player will leave this state for one of the other playback states ToiMediaPlayerBase::STATE_PLAYING, ToiMediaPlayerBase::STATE_FASTFORWARDING, or ToiMediaPlayerBase::STATE_REWINDING. The application may also end the session by calling ToiMediaPlayer::close(), which makes the player go to ToiMediaPlayerBase::STATE_IDLE. If an error occurs with the stream severe enough for the player to determine it cannot continue playback, the player will go to ToiMediaPlayerBase::STATE_FAILED.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_PAUSED.

In ToiMediaPlayerBase::STATE_PLAYING the media player has a connection to a media source and plays the stream from that source in normal pace. On a command from the application, the player will leave this state for one of the other playback states ToiMediaPlayerBase::STATE_PAUSED, ToiMediaPlayerBase::STATE_FASTFORWARDING, or ToiMediaPlayerBase::STATE_REWINDING. The application may also end the session by calling ToiMediaPlayer::close(), which makes the player go to ToiMediaPlayerBase::STATE_IDLE. If an error occurs with the stream severe enough for the player to determine it cannot continue playback, the player will go to ToiMediaPlayerBase::STATE_FAILED.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_PLAYING.

In ToiMediaPlayerBase::STATE_REWINDING the media player has a connection to a media source and plays the stream from that source in backward direction at a pace above normal playback. For streams on which this operation cannot be performed, this state is not available. On a command from the application, the player will leave this state for one of the other playback states ToiMediaPlayerBase::STATE_PLAYING, ToiMediaPlayerBase::STATE_PAUSED, or ToiMediaPlayerBase::STATE_FASTFORWARDING. The application may also end the session by calling ToiMediaPlayer::close(), which makes the player go to ToiMediaPlayerBase::STATE_IDLE. If an error occurs with the stream severe enough for the player to determine it cannot continue playback, the player will go to ToiMediaPlayerBase::STATE_FAILED.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.STATE_REWINDING.

The subtitles are in ARIB format.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_ARIB.

The subtitles are in DVB format.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_DVB.

The subtitles are in DVD format.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_DVD.

The subtitles are designed for the hearing impaired.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_HEARING_IMPAIRED.

The subtitles are designed for normal audience.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_NORMAL.

The subtitles are in Teletext format.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_TELETEXT.

The type of subtitles is not known.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_UNKNOWN.

The subtitles are in XSUB or XSUB plus format.

Note:
{Request "_AviSubtitleXSubPlus<trackId>" parameter to specify which one.}

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.SUBTITLE_XSUB.

In ToiMediaPlayerBase::TIMESHIFT_STATE_BUFFERING the media player is buffering the current media source to the timeshift buffer. In this state the capabilities change to include trick play capabilities such as pause, fast forward and rewind.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.TIMESHIFT_STATE_BUFFERING.

In ToiMediaPlayerBase::TIMESHIFT_STATE_BUFFERING_FAILED the timeshift buffering has failed for some reason. The reason can be retrieved by calling ToiMediaPlayerBase::getTimeshiftError(). The media player will only leave ToiMediaPlayerBase::TIMESHIFT_STATE_BUFFERING_FAILED on a call by the application to ToiMediaPlayer::discardTimeshiftBuffer().

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.TIMESHIFT_STATE_BUFFERING_FAILED.

In ToiMediaPlayerBase::TIMESHIFT_STATE_INACTIVE the timeshift operation is not enabled. The capacity of the buffer is unknown and the capabilities are the same as for the current media source, e.g. if you play a multicasted stream, trick play capabilities such as pause, fast forward and rewind are not allowed. This is also the default state for the normal timeshift recording policy when closing the media session, see ToiInformationService::CFG_MEDIA_TIMESHIFT_RECORDINGPOLICY.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.TIMESHIFT_STATE_INACTIVE.

In ToiMediaPlayerBase::TIMESHIFT_STATE_STOPPED the timeshift buffering has been stopped for some reason. The reason might be that ToiMediaPlayer::stopTimeshiftBuffering() has been called or the buffer has become full and could not continue buffering. This is also the default state for the continuous timeshift recording policy when closing the media session, see ToiInformationService::CFG_MEDIA_TIMESHIFT_RECORDINGPOLICY.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.TIMESHIFT_STATE_STOPPED.

Indicates cancel flag set.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_FORMAT_CANCELED.

Indicates SEI message absent.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_FORMAT_NOT_SPECIFIED.

Checkboard based arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_CHECKERBOARD.

Column based arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_COLUMN_BASED.

Reserved values.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_RESERVED.

Row based arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_ROW_BASED.

Side-by-side packing arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_SIDE_BY_SIDE.

Temporal interleaving arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_TEMPORAL.

Top-bottom packing arrangement.

This constant can also be accessed from toi.consts.ToiMediaPlayerBase.VIDEO_3D_SRC_FORMAT_TOP_BOTTOM.