MSmilPlayer Class Reference

class MSmilPlayer

Callback interface between SMIL engine and player application.

Member Functions Documentation

EvaluateContentControlAttribute(const TDesC &, const TDesC &)

TBool EvaluateContentControlAttribute(const TDesC &aName,
const TDesC &aValue
)[pure virtual]

Evaluate a content control attribute for true or false. Attributes systemOperatingSystem systemCPU systemScreenSize systemScreenDepth are handled inside the SMIL engine, the rest are passed to this method.

Parameters

const TDesC & aName
const TDesC & aValue

GetControl(const CSmilPresentation *)

CCoeControl *GetControl(const CSmilPresentation *aPres)[pure virtual]

Return the EIKON GUI control that is used as the view for the given presentation.

SMIL Engine never calls this method. It might be used by implementations of MSmilMediaRenderer interface.

Parameters

const CSmilPresentation * aPres

GetDimensions(const CSmilPresentation *)

TRect GetDimensions(const CSmilPresentation *aPres)[pure virtual]

Return the dimensions of the drawing surface

Parameters

const CSmilPresentation * aPres

GetMediaFactory(const CSmilPresentation *)

MSmilMediaFactory *GetMediaFactory(const CSmilPresentation *aPres)const [pure virtual]

Return the media factory object that is responsible of creating the media renderers

Parameters

const CSmilPresentation * aPres

GetTransitionFactory(const CSmilPresentation *)

MSmilTransitionFactory *GetTransitionFactory(const CSmilPresentation *aPres)const [pure virtual]

Return the transition factory object that is responsible of creating the transition renderers

Parameters

const CSmilPresentation * aPres

OpenDocumentL(const TDesC &, const CSmilAnchor *, const CSmilPresentation *)

voidOpenDocumentL(const TDesC &aUrl,
const CSmilAnchor *aAnchor,
const CSmilPresentation *aPres
)[pure virtual]

This method is called by the engine as a result of hyperlink activation. Player should open the given (relative to the presentation base) url. However, the current presentation MUST NOT be deleted during execution of this method, as this method is invoked by the current presentation,

aAnchor - contains addition information about the link. can be 0.

source/destination states: EPlay - (continue) play the presentation EStop - stop the source presentation or open destination presentation in stopped state EPause - pause the source presentation, continue it after, destination finishes

3GPP profile does not require respecting these states, aAnchor may be ignored

Parameters

const TDesC & aUrl
const CSmilAnchor * aAnchor
const CSmilPresentation * aPres

PresentationEvent(TInt, const CSmilPresentation *, const TDesC &)

voidPresentationEvent(TIntaEvent,
const CSmilPresentation *aPres,
const TDesC &aText =  TPtrC()
)[pure virtual]

Invoked when a presentation state changes. aEvent is EStarted - presentation started playing, EStopped - presentation was stopped, EPaused - presentation was paused EResumed - paused presentation was resumed ESeeked - presentation was seeked to a new position on timeline EMediaNotFound - opening media failed, aText contains the media url or EEndReached - presentation has reached its end time. whether it is paused or stopped depends on EndAction setting. one of the negative system wide error codes (from a trapped leave inside engine RunL() method). In this case the playing presentation is stopped automatically and the presentation can not be restarted.

Parameters

TInt aEvent
const CSmilPresentation * aPres
const TDesC & aText =  TPtrC()

Redraw(TRect, CSmilPresentation *)

voidRedraw(TRectaArea,
CSmilPresentation *aPres
)[pure virtual]

The engine calls this method to initiate redrawing of the given area. Implementation of this method should in turn call Draw method of the given presentation object.

Parameters

TRect aArea
CSmilPresentation * aPres

Member Enumerations Documentation

Enum TEventType

Enumerators

EStarted
EStopped
EPaused
EResumed
ESeeked
EStalled
EMediaNotFound
EEndReached
ELastSlideReached