This page demonstrates the YouTube Player API's functions. To allow room for critical player functionality, players must be at least 200px by 200px.
You need Flash player 9+ and JavaScript enabled to view this video.
Update player with selected options
Type:
Display an
IFrame
AS3
AS2
embedded player
chromeless player
Content:
Controls:
The controls in this section let you play, pause or stop a video. You
can also seek to a specific point in the video by entering a number in
the Seek to field, which specifies the time offset
from the beginning of the video when playback should begin.
Size:
This section lets you modify the size of the player, using the
setSize(width, height) function. Typically, this
function would only be useful in an ActionScript application. In a
JavaScript application, the resized player will still be inserted in
the object that contains the video player, even if that object is
smaller or larger than the resized player.
Note that on this page, the maximum dimensions for the player are 640
pixels wide and 360 pixels high – 640x360 in widescreen (16:9)
format or 480x360 in standard (4:3) format.
Aspect ratio:
16x9
4x3
|
Width:
|
Height: 360
Statistics:
The information in this section describes the status of the video
player and the video being played (or the last video to play). The
following list shows the API function associated with each field
in this section:
Duration: getDuration()
Current time: getCurrentTime()
Player state: getPlayerState()
Percentage of video loaded: getVideoLoadedFraction()
Start bytes: getVideoStartBytes()
Quality level: getPlaybackQuality()
Available levels: getAvailableQualityLevels()
Volume (on/off): isMuted()
Number of videos in playlist: count(getPlaylist())
Position of current video: getPlaylistIndex()
Videos in playlist: getPlaylist()
Bytes loaded: getVideoBytesLoaded() (deprecated)
Total bytes: getVideoBytesTotal() (deprecated)
Duration:
--:-- ,
Current time:
--:-- ,
Player state:
--
Start bytes: -- ,
Percentage of video loaded: --
Quality level: -- ,
Available levels: ,
Volume (on/off):
Playback rate: -- ,
Available rates:
Deprecated:
Bytes loaded: -- ,
Total bytes: --
Number of videos in playlist:
Position of current video ('0' = first video):
History
This page calls the getVideoUrl() and
getEmbedCode() functions when the player is ready to
play a video. These functions are called again if you load or cue a
video.
If you call getVideoUrl() after a video has played for
at least 10 seconds, the URL will include a parameter that specifies the
time offset at which the player should begin playing the video.
Errors
None yet.
Events and Function Calls
None yet.
Embed code
Note: You cannot use an <iframe>
or <object>
tag to embed a chromeless player. However, you can very closely approximate the behavior of a chromeless player by using a standard IFrame embedded player and setting the controls
and showinfo
parameter values to 0
.
Player parameters
• checked box = parameter value of 1
• unchecked box = parameter value of 0
• Supported players are listed for each parameter.
Parameter
Value
autohide
[no value] (default) – In the AS3 and
AS2 players, which support this parameter, the default behavior
is for the player controls (play button, volume control, etc.
to fade out while the video progress bar remains visible.
In the HTML5 player, which does not support it, the default
behavior is for the player controls to and video progress bar
to be visible throughout the video.
1 – Automatically slide the video
progress bar and the player controls out of view a couple
of seconds after the video starts playing. They will only
reappear if the user moves her mouse over the video player
or presses a keyboard key.
0 (default) – The video progress bar
and player controls will be visible throughout the video.
(AS3, AS2)
[no value]
1
0
color
This parameter specifies the color that will be used in the
player's video progress bar to highlight the amount of the
video that the viewer has already seen. The default value
is red .
(AS3, AS2)
red
white
iv_load_policy
1 (default) – Show video annotations.
3 – Do not show video annotations.
(AS3, AS2)
1
3
theme
This parameter indicates whether the embedded player will
display player controls (like a 'play' button or volume
control) within a dark or light control bar. The default
theme is dark
(AS3, AS2, HTML5)
dark
light