YouTube 嵌入式播放器参数
目录
概述
本文档介绍了 YouTube 嵌入式播放器可以使用的所有参数。通过在 SWF 网址末尾附加这些参数,您可以设置颜色和边框等内容,还可以设置是否对播放器启用 JavaScript API。
参数
以下所有参数均为可选参数。只有 YouTube 嵌入式播放器正式支持这些参数,但其中一部分参数也可用于其他播放器(例如播放列表播放器或自定义播放器)。
rel- 值:
0或1。默认值为1。用于设置播放器是否应在初始视频开始播放后载入相关视频。按下菜单按钮后,“genie 菜单”中会显示相关视频。如果rel设置为0,则播放器搜索功能会停用。 autoplay- 值:
0或1。默认值为0。用于设置初始视频是否在载入播放器时自动播放。 loop- 值:
0或1。默认值为0。如果播放器是单视频播放器,则将值设置为1会让该播放器反复播放初始视频。如果播放器是播放列表播放器(或自定义播放器),则会播放播放列表中的所有视频,然后再从第一个视频开始从头播放。 enablejsapi- 值:
0或1。默认值为0。将该值设置为1会启用 Javascript API。有关 Javascript API 及其用法的详细信息,请参见 JavaScript API 文档。 playerapiid- 值可以是任意字母数字字符串。此设置可以和 JavaScript API 结合使用。有关详细信息,请参见 JavaScript API 文档。
disablekb- 值:
0或1。默认值为0。将该值设置为1会停用播放器的键盘控件。键盘控件如下:
空格键:播放/暂停
向左箭头:当前视频后退 10%
向右箭头:当前视频前进 10%
向上箭头:调高音量
向下箭头:降低音量 egm- 值:
0或1。默认值为0。将该值设置为1会启用“增强的 Genie 菜单”。这样,只要用户将鼠标移入视频显示区,genie 菜单(如果有的话)就会出现,而不是只在用户按下菜单按钮时出现。 border- 值:
0或1。默认值为0。将该值设置为1会在整个视频播放器周围显示边框。可以使用color1参数设置边框的基本色,使用color2参数设置辅助色。 color1, color2- 值:任何十六进制格式的 RGB 值。
color1代表边框的基本色,color2代表视频控件栏的背景颜色和边框辅助色。 start- 值:正整数。此参数可让播放器从视频中的指定位置开始播放视频,具体位置以距视频开头的秒数表示。请注意,与
seekTo函数类似,播放器会查找与指定时间最接近的关键帧。也就是说,播放头的定位有时会稍早于请求时间,但通常与请求时间的间隔不超过 2 秒。 fs- 值:
0或1。默认值为0。将该值设置为1会启用全屏按钮。此设置不会对 Chromeless Player 产生影响。请注意,要启用该功能,您需要在嵌入代码中另外添加一些参数。以下示例中的粗体部分用于启用全屏功能:<object width="425" height="344">
<param name="movie" value="https://www.youtube.com/v/u1zgFlCw8Aw?fs=1"</param>
<param name="allowFullScreen" value="true"></param>
<embed src="https://www.youtube.com/v/u1zgFlCw8Aw?fs=1"
type="application/x-shockwave-flash"
allowfullscreen="true"
width="425" height="344">
</embed>
</object> hd- 值:
0或1。默认值为0。默认情况下,将该值设置为1即可启用高清播放效果。此设置不会对 Chromeless Player 产生影响。如果视频没有高清版,则此设置无效。如果您启用了此选项,请记住,连接速度较慢的用户可能无法得到最佳的用户体验,除非关闭了 HD。因此,您应确保播放器的大小足以使用原生分辨率显示视频。 showsearch- 值:
0或1。默认值为1。将该值设置为0会禁止搜索框在视频最小化的情况下显示。请注意,如果rel参数设置为0,那么,不管showsearch设为哪一个值,都会停用搜索框。 showinfo- 值:
0或1。默认值为1。将该值设置为0,播放器就不会在开始播放视频之前显示相关信息(例如视频标题和评分)。 iv_load_policy- 值:
1或3。默认值为1。将该值设置为1会在默认情况下显示视频注释,而设置为3则不会在默认情况下显示视频注释。 cc_load_policy- 值:
1。默认值根据用户偏好设置决定的。将该值设置为1会在默认情况下显示隐藏字幕,即使在用户关闭字幕的情况下也是如此。
用法示例
要使用上述任何一个参数,只需在 YouTube 视频 SWF 网址的末尾附加相应参数即可。
SWF 网址的常见形式如下:
http://www.youtube.com/v/VIDEO_ID
<media:content url="http://www.youtube.com/v/VIDEO_ID" type="application/x-shockwave-flash" medium="video"
isDefault="true" expression="full" duration="100" yt:format="5"/>
要将颜色方案更改为天蓝色主题,请修改两个
color 参数。http://www.youtube.com/v/VIDEO_ID?color1=0x2b405b&color2=0x6b8ab6&fs=1
然后,将经过修改的网址添加到嵌入代码中:
<object width="425" height="355">
<param name="movie" value="https://www.youtube.com/v/u1zgFlCw8Aw?rel=1&color1=0x2b405b&
color2=0x6b8ab6&border=1&fs=1"></param>
<param name="allowFullScreen" value="true"></param>
<embed src="https://www.youtube.com/v/u1zgFlCw8Aw?rel=1&color1=0x2b405b&color2=0x6b8ab6&border=1&fs=1"
type="application/x-shockwave-flash"
width="425" height="355"
allowfullscreen="true"></embed>
</object>
rel、color1、color2 和 border 参数已经过修改,以生成带边框的蓝色播放器(如下所示)。由于 rel 参数设置为 1,因此,按下“菜单”按钮也会载入相关视频。文章標籤
全站熱搜