本页介绍了 YouTube Player API 的各个函数。 嵌入式播放器必须具有一个尺寸至少为200x200像素的视口。如果播放器显示控件，>那么它必须足够大，可以在无需将视口缩小到最小尺寸以下的情况下完整显示控件。我们建议16:9播放器的宽至少为480像素、高至少为270像素。
IFrame 嵌入代码

内容 您可以选择在播放器中加载还是插入内容。 如果您选择了加载内容并更新播放器，播放器将播放指定的内容而非目前已在播放的视频（如果有的话）。

如果您选择了插入内容并更新播放器，播放器将会加载视频但不播放。要播放视频，您需要点击播放器控件部分中或视频播放器上的播放链接。

根据您的选择，本页会调用下述 API 函数之一：
  • loadVideoById
  • loadVideoByUrl
  • loadPlaylist
  • cueVideoById
  • cueVideoByUrl
  • cuePlaylist
 
 
控件 本部分的控件可以用来播放、暂停和停止播放视频。

要跳转到视频的特定时间点，可在跳转到字段中输入代表距离开头秒数的数字，即可从该时间点继续播放。
播放 | 暂停 | 停止
   
音量 静音控件和取消静音控件可关闭或开启声音。统计信息部分中的声音开启/关闭字段指示播放器是否处于静音状态。

您可以在设置音量字段中输入 0 到 100 之间的一个数字，以调整播放器的音量。然后，将光标移到输入框外面（或点击输入框以外的地方）即可更新音量。
静音 | 取消静音 | 设置：   (0-100) [ 当前音量：  --]
画质 使用此下拉菜单可以调用 setPlaybackQuality() 函数，更改正在播放的视频的画质。如果您更改了画质，视频将会暂停，然后从头重新开始播放。

统计信息部分中的可用级别字段会列出此视频可选择的画质级别。

如果您选择的画质暂时无法提供，YouTube 会从可提供的画质级别中选择最接近的那个。例如，如果您将画质级别设为小，但支持的级别却是中和大，YouTube 会将画质级别设为中。
速率 播放速率表示视频当前的播放速度。getAvailablePlaybackRates() 函数可返回当前视频支持的各种播放速率。在此演示中，可用的播放速率显示在统计信息部分中。

值 1 表示视频以常速播放。
   
尺寸 您可以使用本部分的 setSize(width, height) 函数修改播放器的尺寸。通常，此函数只能在 ActionScript 应用中使用。但在 JavaScript 应用中，即使包含视频播放器的对象与调整大小后的播放器不一样大，系统仍会将调整大小后的播放器插入到该对象中。
 x 405   
历史记录 本页会在播放器准备好播放视频时调用 getVideoUrl() 和 getEmbedCode() 函数。在您加载或插入视频时，系统会再次调用这两个函数。

如果您在视频播放了 10 秒以上后调用 getVideoUrl()，网址中会包含一个参数，指定播放器应在距离视频开头几秒的地方开始播放视频。 		（清除）
错误
尚无错误。

事件和函数调用
尚无错误。

播放器参数
  • 选中方框 = 参数值为 1
  • 不选中方框 = 参数值为 0
  • 使用 IFrame 嵌入代码嵌入具有指定功能的播放器。

参数 值
autoplay  1 – 在播放器加载完视频后自动开始播放视频。

0（默认值）– 在播放器加载完视频后不自动播放视频。
cc_load_policy  1 – 致使系统默认显示字幕，即便用户已关闭字幕。默认行为是根据用户偏好设置决定的。
color 此参数指定播放器的视频播放进度栏中用于显示用户已观看部分所占比例的颜色。默认值为红色。
controls  1（默认值）– 在视频播放器中显示播放器控件。

0 – 视频播放器中不显示播放器控件。
disablekb  1 – 停用播放器键盘控制。

0（默认值）- 启用播放器键盘控制。键盘控制键包括：
  • 空格键：播放/暂停
  • 向左箭头：在当前视频中后退数秒
  • 向右箭头：在当前视频中前进数秒
  • 向上箭头：增大音量
  • 向下箭头：减小音量
enablejsapi  1 – 允许使用 IFrame Player API 控制播放器。

0（默认值）– 不启用 API。
end  指定视频应在距离开头多少秒的地方停止播放。值是一个正整数，指定播放器应在视频的第几秒处停止播放。
fs  1（默认值）– 播放器将显示可通过全屏模式观看视频的按钮。

0 – 播放器不显示该按钮。
hl  设定播放器的界面语言。参数值为两个字母的 ISO 639-1 语言代码或完整表示的语言区域，例如 fr 或 fr-ca。系统或许也能正确处理 IETF 语言标记 (BCP 47) 之类的语言输入代码。

界面语言会指定播放器中的工具提示的显示语言，也会影响默认字幕轨道的语言。
iv_load_policy 1（默认值）– 显示视频注释。 3 – 不显示视频注释。
list  此参数与 list 参数一起使用，可指定在播放器中加载的内容。
  • playlist（播放列表）– list 参数会指定 YouTube 播放列表 ID。请确保参数值是以字母 PL 开头。
  • search（搜索查询）– list 参数会指定选择要播放的内容时所用的搜索查询字词。
  • user_uploads（用户上传的视频）– list 参数会指定要加载哪个 YouTube 频道中的用户上传的视频。
listType 此参数与 list 参数一起使用，可指定在播放器中加载的内容。
  • search（搜索查询）– list 参数会指定选择要播放的内容时所用的搜索查询字词。
  • user_uploads（用户上传的视频）– list 参数会指定要加载哪个 YouTube 频道中的用户上传的视频。
  • playlist（播放列表）– list 参数会指定 YouTube 播放列表 ID。请确保参数值是以字母 PL 开头。
loop  1 – 如果播放器加载的是单个视频，就重复播放该视频。如果播放器加载的是播放列表，则顺序播放其中的所有视频，然后再从第一个视频开始播放。

0（默认值）– 不持续播放视频或不全部播放播放列表中的所有视频。
modestbranding  1 – 不在播放器控制栏中显示 YouTube 徽标。但当用户的鼠标指针悬停在播放器上时，仍显示 YouTube 文字标签或水印。

0 – 在播放器控制栏中显示 YouTube 徽标。
playlist  连续播放的视频的 ID 列表（以逗号分隔）。
playsinline  1 – 致使 allowsInlineMediaPlayback 属性设为 TRUE 的 UIWebViews 进行内嵌式播放。

0（默认值）– 进行全屏播放。请注意，默认值可能会随时进行更改。
start  指定在距离开头多少秒的地方开始播放视频。此值是一个正整数，指定播放器应从视频的第几秒开始播放。播放器会找到与您指定的时间点最接近的关键帧。
统计信息   本部分中的信息介绍了视频播放器的状态以及正在播放的视频（或排在最后播放位置的视频）。下面列出了与本部分中各个字段相关联的 API 函数：
  • 时长：getDuration()
  • 当前时间：getCurrentTime()
  • 播放器状态：getPlayerState()
  • 视频已加载的百分比：getVideoLoadedFraction()
  • 开始字节数：getVideoStartBytes()
  • 画质级别：getPlaybackQuality()
  • 可用级别：getAvailableQualityLevels()
  • 声音（开启/关闭）：isMuted()
  • 播放列表中的视频数：count(getPlaylist())
  • 当前视频所在的位置：getPlaylistIndex()
  • 播放列表中的视频：getPlaylist()
  • 已加载的字节数：getVideoBytesLoaded()（已弃用）
  • 总字节数：getVideoBytesTotal()（已弃用）
时长： --:--
当前时间： --:--
播放器状态： --
开始字节数： --
视频已加载的百分比： --
声音（开启/关闭）：
播放速率： --
可用速率：
已弃用
已加载的字节数： --
总字节数： --