IToiMediaPlayerBase Interface Reference


Description

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

See also:
IToiMediaService
IToiMediaPlayer

import "IToiMediaPlayerBase.idl";

List of all members.

Public Member Functions

void GetState (out TToiState state)
void GetError (out TToiError error)
void GetSessionId (out IToiMediaSession::TToiSessionId id) raises (TToiSessionViolationException)
void GetUrl (out string url) raises (TToiSessionViolationException)
void GetStreamInfo (out TToiStreamInfo streamInfo) raises (TToiSessionViolationException, TToiUnavailableException)
void GetVideoStreamInfo (in TToiComponentEntry mediaComponent, out TToiVideoStreamInfo streamInfo) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
void GetAudioStreamInfo (in TToiComponentEntry mediaComponent, out TToiAudioStreamInfo streamInfo) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
void GetSubtitleStreamInfo (in TToiComponentEntry mediaComponent, out TToiSubtitleStreamInfo streamInfo) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
void GetTeletextStreamInfo (in TToiComponentEntry mediaComponent, out TToiTeletextStreamInfo streamInfo) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)
void GetCapabilities (out long capabilityMask) raises (TToiSessionViolationException, TToiUnavailableException)
void GetPosition (out long position) raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
void GetPace (out long pace) raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)
void IsTimeshiftPlayback (out boolean timeshiftPlayback) raises (TToiSessionViolationException, TToiUnavailableException)
void GetTimeshiftInfo (out TToiTimeshiftInfo timeshiftInfo) raises (TToiSessionViolationException, TToiUnavailableException)
void GetTimeshiftError (out TToiError timeshiftError)
void GetActiveComponents (out TToiComponentSequence components) raises (TToiSessionViolationException, TToiUnavailableException)
void GetParameter (in string name, out string value) raises (TToiInvalidArgumentException, TToiUnavailableException)
void SubscribeParameter (in string address, in string name) raises (TToiInvalidArgumentException, TToiUnavailableException)
void UnsubscribeParameter (in string address, in string name) raises (TToiInvalidArgumentException, TToiUnavailableException)
void ReleaseInstance ()
void RegisterObserver (in IToiApplicationService::TToiApplicationId applicationId, in string address) raises (TToiInvalidArgumentException)
void ReleaseObserver (in string address) raises (TToiInvalidArgumentException)

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

Classes

struct  TToiAudioStreamInfo
struct  TToiComponentEntry
struct  TToiError
struct  TToiStreamInfo
struct  TToiSubtitleStreamInfo
struct  TToiTeletextStreamInfo
struct  TToiTimeshiftInfo
struct  TToiVideoStreamInfo

Public Types

enum  TToiComponentType {
  COMPONENT_AUDIO, COMPONENT_VIDEO, COMPONENT_SUBTITLE, COMPONENT_SUBTITLE_CAPTION,
  COMPONENT_SUBTITLE_SUPERIMPOSE, COMPONENT_TELETEXT_VBI
}
enum  TToiErrorSource { SOURCE_UNKNOWN, SOURCE_INTERNAL, SOURCE_BITBAND }
enum  TToiState {
  STATE_IDLE, STATE_CONNECTING, STATE_PAUSED, STATE_PLAYING,
  STATE_FASTFORWARDING, STATE_REWINDING, STATE_FAILED
}
enum  TToiTimeshiftState { TIMESHIFT_STATE_INACTIVE, TIMESHIFT_STATE_BUFFERING, TIMESHIFT_STATE_STOPPED, TIMESHIFT_STATE_BUFFERING_FAILED }
enum  TToiAudioAudienceType { AUDIO_AUDIENCE_TYPE_UNKNOWN, AUDIO_AUDIENCE_TYPE_NORMAL, AUDIO_AUDIENCE_TYPE_VISUALLY_IMPAIRED, AUDIO_AUDIENCE_TYPE_HEARING_IMPAIRED }
enum  TToiAudioChannelFormat {
  AUDIO_CHANNEL_FORMAT_UNKNOWN, AUDIO_CHANNEL_FORMAT_SINGLE_MONO, AUDIO_CHANNEL_FORMAT_DUAL_MONO, AUDIO_CHANNEL_FORMAT_STEREO,
  AUDIO_CHANNEL_FORMAT_3_FRONT_1_BACK, AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK, AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK_LFE, AUDIO_CHANNEL_FORMAT_3_FRONT_2_SIDE_2_BACK_LFE
}
enum  TToiAudioChannelMode {
  AUDIO_CHANNEL_MODE_NORMAL, AUDIO_CHANNEL_MODE_DUAL_MONO_LEFT_ONLY, AUDIO_CHANNEL_MODE_DUAL_MONO_RIGHT_ONLY, AUDIO_CHANNEL_MODE_DUAL_MONO_STEREO,
  AUDIO_CHANNEL_MODE_DUAL_MONO_MIXED
}
enum  TToiAspectRatio { ASPECT_RATIO_UNKNOWN, ASPECT_RATIO_4_3, ASPECT_RATIO_16_9 }
enum  TToiActiveFormatDescriptor {
  ACTIVE_FORMAT_UNKNOWN, ACTIVE_FORMAT_16_9_TOP, ACTIVE_FORMAT_14_9_TOP, ACTIVE_FORMAT_MORE_THAN_16_9_CENTRE,
  ACTIVE_FORMAT_SAME_AS_CODED, ACTIVE_FORMAT_4_3_CENTRE, ACTIVE_FORMAT_16_9_CENTRE, ACTIVE_FORMAT_14_9_CENTRE,
  ACTIVE_FORMAT_4_3_SHOOT_AND_PROTECT_14_9_CENTRE, ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_14_9_CENTRE, ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_4_3_CENTRE
}
enum  TToiSubtitleType { SUBTITLE_UNKNOWN, SUBTITLE_NORMAL, SUBTITLE_HEARING_IMPAIRED }
enum  TToiSubtitleFormat {
  SUBTITLE_DVB, SUBTITLE_ARIB, SUBTITLE_TELETEXT, SUBTITLE_DVD,
  SUBTITLE_XSUB
}
enum  TToiReceiveDmfMode { RECEIVE_DMF_MODE_AUTO, RECEIVE_DMF_MODE_NON_AUTO, RECEIVE_DMF_MODE_SELECT, RECEIVE_DMF_MODE_SPECIAL }
enum  TToiRecordDmfMode { RECORD_DMF_MODE_AUTO, RECORD_DMF_MODE_NON_AUTO, RECORD_DMF_MODE_SELECT }
typedef sequence
< TToiComponentEntry
TToiComponentSequence
typedef sequence< long > TToiPaceSequence

Member Typedef Documentation

List of media component entries

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

Member Enumeration Documentation

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

Enumerator:
ACTIVE_FORMAT_UNKNOWN 

The active format descriptor is not known.

ACTIVE_FORMAT_16_9_TOP 

The active format descriptor is 16:9 top.

ACTIVE_FORMAT_14_9_TOP 

The active format descriptor is 14:9 top.

ACTIVE_FORMAT_MORE_THAN_16_9_CENTRE 

The active format descriptor is > 16:9 centre.

ACTIVE_FORMAT_SAME_AS_CODED 

The active format descriptor is same as coded.

ACTIVE_FORMAT_4_3_CENTRE 

The active format descriptor is 4:3 centre.

ACTIVE_FORMAT_16_9_CENTRE 

The active format descriptor is 16:9 centre.

ACTIVE_FORMAT_14_9_CENTRE 

The active format descriptor is 14:9 centre.

ACTIVE_FORMAT_4_3_SHOOT_AND_PROTECT_14_9_CENTRE 

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

ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_14_9_CENTRE 

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

ACTIVE_FORMAT_16_9_SHOOT_AND_PROTECT_4_3_CENTRE 

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

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

Enumerator:
ASPECT_RATIO_UNKNOWN 

The aspect ratio is not known.

ASPECT_RATIO_4_3 

The aspect ratio is 4:3

ASPECT_RATIO_16_9 

The aspect ratio is 16:9

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

Enumerator:
AUDIO_AUDIENCE_TYPE_UNKNOWN 

The audience type of the audio is not known.

AUDIO_AUDIENCE_TYPE_NORMAL 

The audio is prepared for normal audiance.

AUDIO_AUDIENCE_TYPE_VISUALLY_IMPAIRED 

The audio is prepared for the visually impaired.

AUDIO_AUDIENCE_TYPE_HEARING_IMPAIRED 

The audio is prepared for the hearing impaired.

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

Enumerator:
AUDIO_CHANNEL_FORMAT_UNKNOWN 

The audio channel format is not known.

AUDIO_CHANNEL_FORMAT_SINGLE_MONO 

One audio channel. One speaker.

AUDIO_CHANNEL_FORMAT_DUAL_MONO 

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

AUDIO_CHANNEL_FORMAT_STEREO 

Two audio channels. Two front speakers.

AUDIO_CHANNEL_FORMAT_3_FRONT_1_BACK 

Four audio channels. Three front and one back speakers.

AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK 

Five audio channels. Three front and two back speakers.

AUDIO_CHANNEL_FORMAT_3_FRONT_2_BACK_LFE 

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

AUDIO_CHANNEL_FORMAT_3_FRONT_2_SIDE_2_BACK_LFE 

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

The audio channel mode specifies audio channel to speaker mappings.

Enumerator:
AUDIO_CHANNEL_MODE_NORMAL 

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

AUDIO_CHANNEL_MODE_DUAL_MONO_LEFT_ONLY 

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

AUDIO_CHANNEL_MODE_DUAL_MONO_RIGHT_ONLY 

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

AUDIO_CHANNEL_MODE_DUAL_MONO_STEREO 

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

AUDIO_CHANNEL_MODE_DUAL_MONO_MIXED 

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

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

Enumerator:
COMPONENT_AUDIO 

Audio components have information of type TToiAudioStreamInfo.

COMPONENT_VIDEO 

Video components have information of type TToiVideoStreamInfo.

COMPONENT_SUBTITLE 

Denotes a regular subtitling component.

COMPONENT_SUBTITLE_CAPTION 
Technical Preview:
This enumerator is a TECHNICAL PREVIEW, it may change. This is an ARIB specific type of subtitles.
COMPONENT_SUBTITLE_SUPERIMPOSE 
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.
COMPONENT_TELETEXT_VBI 
Technical Preview:
This enumerator is a TECHNICAL PREVIEW, it may change. Teletext VBI component have information of type IToiMediaPlayerBase::TToiTeletextStreamInfo.

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

Enumerator:
SOURCE_UNKNOWN 

SOURCE_UNKNOWN - An error of unknown type has occurred.

SOURCE_INTERNAL 

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

SOURCE_BITBAND 

SOURCE_BITBAND - A BitBand element has failed for some reason.

Receive DMF mode used for ARIB CC/CS

Enumerator:
RECEIVE_DMF_MODE_AUTO 

Automatic mode.

RECEIVE_DMF_MODE_NON_AUTO 

Non-automatic mode.

RECEIVE_DMF_MODE_SELECT 

Select mode.

RECEIVE_DMF_MODE_SPECIAL 

Special mode.

Receive DMF mode used for ARIB CC/CS

Enumerator:
RECORD_DMF_MODE_AUTO 

Automatic mode.

RECORD_DMF_MODE_NON_AUTO 

Non-automatic mode.

RECORD_DMF_MODE_SELECT 

Select mode.

Enumeration of media player states.

Enumerator:
STATE_IDLE 

In 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 STATE_IDLE. The media player will only leave STATE_IDLE on a successful call to IToiMediaPlayer::Open().

STATE_CONNECTING 

In 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 STATE_PAUSED when it has successfully established the connection to the stream source. If the media player decides it cannot connect, it will enter STATE_FAILED instead. If the application is not interrested in knowing when the player has connected, it may call IToiMediaPlayer::Play() to set the player in STATE_PLAYING directly. The application may also end the session by calling IToiMediaPlayer::Close(), which makes the player go to STATE_IDLE.

STATE_PAUSED 

In 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 STATE_PLAYING, STATE_FASTFORWARDING, or STATE_REWINDING. The application may also end the session by calling IToiMediaPlayer::Close(), which makes the player go to 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 STATE_FAILED.

STATE_PLAYING 

In 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 STATE_PAUSED, STATE_FASTFORWARDING, or STATE_REWINDING. The application may also end the session by calling IToiMediaPlayer::Close(), which makes the player go to 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 STATE_FAILED.

STATE_FASTFORWARDING 

In 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 STATE_PLAYING, STATE_PAUSED, or STATE_REWINDING. The application may also end the session by calling IToiMediaPlayer::Close(), which makes the player go to 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 STATE_FAILED.

STATE_REWINDING 

In 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 STATE_PLAYING, STATE_PAUSED, or STATE_FASTFORWARDING. The application may also end the session by calling IToiMediaPlayer::Close(), which makes the player go to 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 STATE_FAILED.

STATE_FAILED 

In 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 STATE_FAILED on a call by the application to IToiMediaPlayer::Close().

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

Enumerator:
SUBTITLE_DVB 

The subtitles are in DVB format.

SUBTITLE_ARIB 

The subtitles are in ARIB format.

SUBTITLE_TELETEXT 

The subtitles are in Teletext format.

SUBTITLE_DVD 

The subtitles are in DVD format.

SUBTITLE_XSUB 

The subtitles are in XSUB or XSUB plus format.

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

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

Enumerator:
SUBTITLE_UNKNOWN 

The type of subtitles is not known.

SUBTITLE_NORMAL 

The subtitles are designed for normal audience.

SUBTITLE_HEARING_IMPAIRED 

The subtitles are designed for the hearing impaired.

State identifier used to identify the media player timeshift state.

Enumerator:
TIMESHIFT_STATE_INACTIVE 

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

TIMESHIFT_STATE_BUFFERING 

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

TIMESHIFT_STATE_STOPPED 

In TIMESHIFT_STATE_STOPPED the buffering has been stopped either due to an explicit call to IToiMediaPlayer::StopTimeshiftBuffering() or due to full buffer.

TIMESHIFT_STATE_BUFFERING_FAILED 

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


Member Function Documentation

void IToiMediaPlayerBase::GetActiveComponents ( out TToiComponentSequence  components  )  raises (TToiSessionViolationException, TToiUnavailableException)

This function returns the selected media components currently selected.

Deprecated:
Same information can be obtained by using GetStreamInfo().
Return values:
components The media component entries currently selected.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetAudioStreamInfo ( in TToiComponentEntry  mediaComponent,
out TToiAudioStreamInfo  streamInfo 
) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)

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

Parameters:
mediaComponent The media component entry for which the stream info has to be retrieved.
Return values:
streamInfo Information about the specified audio stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentException If the mediaComponent given as argument does not identify an audio stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetCapabilities ( out long  capabilityMask  )  raises (TToiSessionViolationException, TToiUnavailableException)

Returns the capabilities present for the current session.

Return values:
capabilityMask A bit mask describing the capabilities of the current session. The mask can include the following capabilities:

Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetError ( out TToiError  error  ) 

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

Return values:
error The error
void IToiMediaPlayerBase::GetPace ( out long  pace  )  raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)

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

Return values:
pace The 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 STATE_FASTFORWARDING the pace is generally above 1000, and in STATE_REWINDING generally below -1000. For example, if the stream is rewinded at a pace three times normal playback, the pace is -3000.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiOperationNotSupportedException If the session lacks the capability to get position, the operation not supported exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetParameter ( in string  name,
out string  value 
) raises (TToiInvalidArgumentException, TToiUnavailableException)

Get the current value of a parameter.

Parameters:
name Name of the requested parameter.
Return values:
value The current value of the parameter.
Exceptions:
TToiInvalidArgumentException The parameter name is invalid or not recognized.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
See also:
IToiMediaPlayer::SetParameter()
IToiMediaPlayer::UnsetParameter()
SubscribeParameter()
void IToiMediaPlayerBase::GetPosition ( out long  position  )  raises (TToiSessionViolationException, TToiOperationNotSupportedException, TToiUnavailableException)

Returns the current position in the media stream.

Return values:
position The 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:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiOperationNotSupportedException If the session lacks the capability to get position, the operation not supported exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetSessionId ( out IToiMediaSession::TToiSessionId  id  )  raises (TToiSessionViolationException)

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

Return values:
id The session identifier.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
See also:
IToiMediaService::OpenSession()
void IToiMediaPlayerBase::GetState ( out TToiState  state  ) 

Returns the current state of the media player instance.

Return values:
state The current player state.
void IToiMediaPlayerBase::GetStreamInfo ( out TToiStreamInfo  streamInfo  )  raises (TToiSessionViolationException, TToiUnavailableException)

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 GetAudioStreamInfo() and GetVideoStreamInfo() functions, respectively.

Return values:
streamInfo Information about the current stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetSubtitleStreamInfo ( in TToiComponentEntry  mediaComponent,
out TToiSubtitleStreamInfo  streamInfo 
) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)

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

Parameters:
mediaComponent The media component entry for which the stream info has to be retrieved.
Return values:
streamInfo Information about the specified subtitle stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentException If the streamId given as argument does not identify a subtitle stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetTeletextStreamInfo ( in TToiComponentEntry  mediaComponent,
out TToiTeletextStreamInfo  streamInfo 
) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)

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

Parameters:
mediaComponent The media component entry for which the stream info has to be retrieved.
Return values:
streamInfo Information about the specified teletext stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentException If the mediaComponent given as argument does not identify a teletext stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetTimeshiftError ( out TToiError  timeshiftError  ) 

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

Return values:
timeshiftError The error.
void IToiMediaPlayerBase::GetTimeshiftInfo ( out TToiTimeshiftInfo  timeshiftInfo  )  raises (TToiSessionViolationException, TToiUnavailableException)

Retrieve information about the current timeshift operation.

Return values:
timeshiftInfo Information about the current timeshift operation.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::GetUrl ( out string  url  )  raises (TToiSessionViolationException)

Returns the URL for the media stream.

Return values:
url The URL for the media stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
void IToiMediaPlayerBase::GetVideoStreamInfo ( in TToiComponentEntry  mediaComponent,
out TToiVideoStreamInfo  streamInfo 
) raises (TToiSessionViolationException, TToiInvalidArgumentException, TToiUnavailableException)

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

Parameters:
mediaComponent The media component entry for which the stream info has to be retrieved.
Return values:
streamInfo Information about the specified video stream.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiInvalidArgumentException If the mediaComponent given as argument does not identify a video stream in the current stream multiplex, an invalid argument exception is raised.
TToiUnavailableException TToiUnavailableException is raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::IsTimeshiftPlayback ( out boolean  timeshiftPlayback  )  raises (TToiSessionViolationException, TToiUnavailableException)

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

Return values:
timeshiftPlayback True if the player is playing from the timeshift buffer, otherwise false.
Exceptions:
TToiSessionViolationException If the player is in STATE_IDLE a session violation exception is raised.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
void IToiMediaPlayerBase::RegisterObserver ( in IToiApplicationService::TToiApplicationId  applicationId,
in string  address 
) raises (TToiInvalidArgumentException)

Register an observer of type IToiMediaPlayerObserver. The observer will receive events sent by this IToiMediaPlayerBase instance.

Parameters:
applicationId The identifier of the observing application.
address The address where the IToiMediaPlayerBase can find an IToiMediaPlayerObserver interface.
Exceptions:
TToiInvalidArgumentException Raised if the specified address is invalid or if the application has already registered itself as an observer with the same address.
See also:
IToiMediaPlayerObserver
void IToiMediaPlayerBase::ReleaseInstance (  ) 

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

void IToiMediaPlayerBase::ReleaseObserver ( in string  address  )  raises (TToiInvalidArgumentException)

Release an observer previously registered with RegisterObserver.

Parameters:
address The address where the IToiMediaPlayerBase can find the registered IToiMediaPlayerObserver interface.
Exceptions:
TToiInvalidArgumentException Raised if the specified address is invalid.
See also:
IToiMediaPlayerObserver
void IToiMediaPlayerBase::SubscribeParameter ( in string  address,
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 IToiMediaPlayerObserver::OnParameterChanged() if there is a value available.

Parameters:
address The observer address of the parameter that is subscribed.
name The name of the parameter for which changes the application wants to subscribe to.
Exceptions:
TToiInvalidArgumentException The parameter name is invalid or not recognized.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
See also:
UnsubscribeParameter()
void IToiMediaPlayerBase::UnsubscribeParameter ( in string  address,
in string  name 
) raises (TToiInvalidArgumentException, TToiUnavailableException)

This function undoes the effect of a previous call to SubscribeParameter().

Parameters:
address The observer address of the parameter that is unsubscribed.
name The name of the parameter that the application is no longer interested in.
Exceptions:
TToiInvalidArgumentException The parameter name is invalid or not recognized.
TToiUnavailableException Raised if the player is temporarily unavailable due to platform resource management.
See also:
SubscribeParameter()

Member Data Documentation

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

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

When this bit is set the session accepts the IToiMediaPlayer::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.IToiMediaPlayerBase.CAPABILITY_FREEZE.

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

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

When this bit is set the session accepts the IToiMediaPlayer::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.IToiMediaPlayerBase.CAPABILITY_PAUSE.

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

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

When this bit is set the session accepts the position to be set IToiMediaPlayer::PlayFromPosition().

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

When this bit is set the session can perform timeshift buffering.

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

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

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

Predefined argument value for IToiMediaPlayer::Play(). Indicates that the player should be paused.

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

const long IToiMediaPlayerBase::PACE_PLAY = 1000

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

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

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

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

const long IToiMediaPlayerBase::POSITION_LIVE = -1616928864

Predefined argument value for IToiMediaPlayer::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.IToiMediaPlayerBase.POSITION_LIVE.