Packageorg.openvideoplayer.plugins
Interfacepublic interface IOvpPlayer extends flash.events.IEventDispatcher

The OVP player interface. This interface allows plug-ins to get properties from the player and listen for events.



Public Properties
 PropertyDefined By
  advertisingMode : Boolean
[write-only] Puts the player in advertising mode, meaning: the video is paused. all transport controls are disabled
IOvpPlayer
  captionsActive : Boolean
[read-only] True if the player is in caption mode (displaying closed captions).
IOvpPlayer
  contentHeight : int
[read-only] The rendering content's current height.
IOvpPlayer
  contentTitle : String
[read-only] The rendering content's current title.
IOvpPlayer
  contentURL : String
[read-only] The rendering content's URL.
IOvpPlayer
  contentWidth : int
[read-only] The rendering content's current width.
IOvpPlayer
  currentBitrate : int
[read-only] Returns the bitrate of the currently loaded video, in kilobits per second, for example 500 means 500kbps.
IOvpPlayer
  duration : Number
[read-only] The duration of the currently rendering content.
IOvpPlayer
  flashvars : Object
[read-only] Returns the flashvars passed into the player as an Object.
IOvpPlayer
  fullScreen : Boolean
[read-only] True if the player is in full screen mode.
IOvpPlayer
  hasAudio : Boolean
[read-only] True if the rendering content contains audio.
IOvpPlayer
  hasCaptions : Boolean
[read-only] True if the rending content has caption, this does not necessary mean they are active.
IOvpPlayer
  hasVideo : Boolean
[read-only] True if the rendering content contains video.
IOvpPlayer
  itemCount : int
[read-only] Number of items in the current play list.
IOvpPlayer
  itemsPlayed : int
[read-only] Number of items that have played.
IOvpPlayer
  playerHeight : int
[read-only] The current player height.
IOvpPlayer
  playerWidth : int
[read-only] The current player width.
IOvpPlayer
  plugins : Array
[read-only] Returns an Array of Sprite objects.
IOvpPlayer
  position : int
[read-only] The current position of the rendering content.
IOvpPlayer
Public Methods
 MethodDefined By
  
addCuePoint(cuePoint:Object):void
Adds an ActionScript cue point.
IOvpPlayer
  
getSpriteById(id:String):Sprite
Asks the player to return a specific sprite with the ID specified.
IOvpPlayer
  
Pauses the current content.
IOvpPlayer
  
Resumes (after pause) the current content.
IOvpPlayer
  
Starts the current content playing.
IOvpPlayer
  
stopPlayer():void
Stops the current content.
IOvpPlayer
Events
 Event Summary Defined By
  Dispatched when an ActionScript cue point requested by the plug-in has been reached.IOvpPlayer
  Plug-ins can dispatch this event to allow a player to easily show an end-user what is happening.IOvpPlayer
  The player can dispatch serious errors if it wishes to.IOvpPlayer
  The player dispatches this event when it's state has changed.IOvpPlayer
  The player can dispatch this event when the server acknowledges the switch request.IOvpPlayer
  The player can dispatch this event when the switch has completed and is visible to the user.IOvpPlayer
  The player can dispatch this event when it is playing multi-bitrate content (dynamic streaming).IOvpPlayer
  The volume changed in the player.IOvpPlayer
Property Detail
advertisingModeproperty
advertisingMode:Boolean  [write-only]

Puts the player in advertising mode, meaning:

  1. the video is paused.
  2. all transport controls are disabled


Implementation
    public function set advertisingMode(value:Boolean):void
captionsActiveproperty 
captionsActive:Boolean  [read-only]

True if the player is in caption mode (displaying closed captions).


Implementation
    public function get captionsActive():Boolean
contentHeightproperty 
contentHeight:int  [read-only]

The rendering content's current height.


Implementation
    public function get contentHeight():int
contentTitleproperty 
contentTitle:String  [read-only]

The rendering content's current title.


Implementation
    public function get contentTitle():String
contentURLproperty 
contentURL:String  [read-only]

The rendering content's URL.


Implementation
    public function get contentURL():String
contentWidthproperty 
contentWidth:int  [read-only]

The rendering content's current width.


Implementation
    public function get contentWidth():int
currentBitrateproperty 
currentBitrate:int  [read-only]

Returns the bitrate of the currently loaded video, in kilobits per second, for example 500 means 500kbps. The player should return 0 if no video is loaded.


Implementation
    public function get currentBitrate():int
durationproperty 
duration:Number  [read-only]

The duration of the currently rendering content.


Implementation
    public function get duration():Number
flashvarsproperty 
flashvars:Object  [read-only]

Returns the flashvars passed into the player as an Object.


Implementation
    public function get flashvars():Object
fullScreenproperty 
fullScreen:Boolean  [read-only]

True if the player is in full screen mode.


Implementation
    public function get fullScreen():Boolean
hasAudioproperty 
hasAudio:Boolean  [read-only]

True if the rendering content contains audio.


Implementation
    public function get hasAudio():Boolean
hasCaptionsproperty 
hasCaptions:Boolean  [read-only]

True if the rending content has caption, this does not necessary mean they are active.


Implementation
    public function get hasCaptions():Boolean

See also

hasVideoproperty 
hasVideo:Boolean  [read-only]

True if the rendering content contains video.


Implementation
    public function get hasVideo():Boolean
itemCountproperty 
itemCount:int  [read-only]

Number of items in the current play list.


Implementation
    public function get itemCount():int
itemsPlayedproperty 
itemsPlayed:int  [read-only]

Number of items that have played.


Implementation
    public function get itemsPlayed():int
playerHeightproperty 
playerHeight:int  [read-only]

The current player height.


Implementation
    public function get playerHeight():int
playerWidthproperty 
playerWidth:int  [read-only]

The current player width.


Implementation
    public function get playerWidth():int
pluginsproperty 
plugins:Array  [read-only]

Returns an Array of Sprite objects. Each object is the main display object for the plug-in.


Implementation
    public function get plugins():Array
positionproperty 
position:int  [read-only]

The current position of the rendering content.


Implementation
    public function get position():int
Method Detail
addCuePoint()method
public function addCuePoint(cuePoint:Object):void

Adds an ActionScript cue point.

Parameters

cuePoint:Object

getSpriteById()method 
public function getSpriteById(id:String):Sprite

Asks the player to return a specific sprite with the ID specified. This allows a plug-in to add itself as a child to a sprite in the player.

Parameters

id:String

Returns
Sprite
pausePlayer()method 
public function pausePlayer():void

Pauses the current content.

resumePlayer()method 
public function resumePlayer():void

Resumes (after pause) the current content.

startPlayer()method 
public function startPlayer():void

Starts the current content playing.

stopPlayer()method 
public function stopPlayer():void

Stops the current content.

Event Detail
cuepoint Event
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

Dispatched when an ActionScript cue point requested by the plug-in has been reached. Plug-ins can set ActionScript cue points via the addCuePoint method.

debugmsg Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

Plug-ins can dispatch this event to allow a player to easily show an end-user what is happening. The data object will be the debug message as a String.

error Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The player can dispatch serious errors if it wishes to. The data object will be an error message in this case.

statechange Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The player dispatches this event when it's state has changed. The data object will contain one of the STATE_CHANGE event data values found in the OvpPlayerEvent class. See the OvpPlayerEvent class for the possible states for this event.

switchAcknowledged Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The player can dispatch this event when the server acknowledges the switch request. See the OvpPlayerEvent class for details on this event.

switchComplete Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The player can dispatch this event when the switch has completed and is visible to the user. See the OvpPlayerEvent class for details on this event.

switchRequested Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The player can dispatch this event when it is playing multi-bitrate content (dynamic streaming). This event indicates a switch has been requested. The data object within the event object contains details of the switch request. See the OvpPlayerEvent class for properties on the data object for this event.

volumechange Event  
Event Object Type: org.openvideoplayer.plugins.OvpPlayerEvent

The volume changed in the player. The data object will be an Number with a value from 0 (muted) to 1 (full volume);