视频云平台HTML5播放器使用文档（For Polyv）

选项

参数	类型	默认值	说明
wrap	string / HTMLElement	-	页面上存在需要载入播放器的DOM元素或css选择器
width	number / string	100%	播放器的宽度
height	number / string	auto	播放器的高度
vid	string	-	从 polyv 后台上传的视频会生成一个视频唯一vid
loop	boolean	false	视频播放结束后是否循环播放
autoplay	boolean	undefined	播放器加载后视频是否自动播放,也可从后台设置
volume	number	0.75	视频默认音量大小，范围 (0, 1)，播放器会记录上一次播放的音量
flash	boolean	false	是否默认打开flash播放器,注意：设置后播放器皮肤为简雅蓝、高贵金、清新绿、活力红时才显示播放器切换按钮
df	number	-	视频默认清晰度，可设置为0、1、2、3，分别对应自动、流畅、高清、超清，设置该参数会覆盖后台的设置
hideRepeat	boolean	false	播放结束后是否显示重播面板，可通过play.HTML5.changeRepeat改变
code	string	-	跑马灯设置中自定义的code值
speed	boolean/array	[2, 1.5, 1.2, 0.5]	设置为false则关闭倍速，可传入数组自定义显示哪几种倍速，速率1不需要填入，会自动添加，所设置速率值必须大于0，少于或等于3，最多设置6种速率（不包含1），所设置值会按由大到小自动排序
showHd	boolean	true	是否显示清晰度选择
ignoreIE	boolean	false	设置该选项将会在ie浏览器中禁用HTML5播放器（edge浏览器除外，国内360，QQ等浏览器的兼容模式表现为ie浏览器，所以也会被禁用）
watchStartTime	number	undefined	从第几秒开始播放，需少于视频时长
watchEndTime	number	undefined	播放到第几秒结束播放，需少于视频时长，在该值到结束的进度条禁止点击，如果设置值少入watchStartTime，则watchStartTime失效
skinLocation	number	1	控制栏显示在视频区域内外或不显示，可选0（不显示）、1（视频内）、2（视频外)
ban_history_time	string	off	是否禁止记住播放进度，下次打开会从上次进度打开（设置watchStartTime后还是会从watchStartTime处开始播放），默认为off(不禁止)，on为禁止
hideSwitchPlayer	boolean	false	是否禁止显示HTML5与flash播放器切换按钮
priorityMode	string	video	默认打开视频模式还是音频模式，需要该视频有对应的音频转码可选video/audio
audioMode	boolean	true	是否开启音频模式
videoMode	boolean	true	是否开启视频模式，设置为false后将会以音频模式播放，无论是否有音频转码
screenshot	boolean	false	是否开启视频截图功能
ban_seek_by_limit_time	string	off	是否禁止视频拖拽未播放区域
ban_seek	string	off	设置为 on 播放器将会彻底禁止拖拽
loading_bg_img	string	-	视频默认封面图
ban_record_interaction_right_answer	string	off	设置为 on 问答回答正确不会记录，每次刷新播放都需重新回答
url	string	undefined	设置后播放器以该url为播放地址播放（支持m3u8、mp4或其他当前浏览器支持的格式视频），不与vid同时设置也可以从changeVid中切换vid或另外的播放url
start	number	undefined	子视频开始时间
end	number	undefined	子视频结束时间
lang	string	undefined	播放器显示语言，若未设置则读取后台设置，自动选择暂未支持，默认中文，可设置zh_CN/en
mainScreen	string	"ppt"	默认三分屏主屏(video/ppt)
subWidth/subHeight	number	355/200	默认三分屏副屏宽/高
pptVisible	boolean	true	三分屏初始化时是否需要默认显示
pptEnable	boolean	false	是否显示三分屏
show_rate	number	undefined	允许播放的最高清晰度 1（流畅）、2（高清）
preloadDataSize	number(kb)	15000	视频最大缓冲量，设置后会根据实际播放时长和清晰度加载切片数量（500 - 60000）
preloadDurationLength	number(秒)	undefined	视频最大缓冲时长，在使用常规加密视频会综合preloadDataSize的设置算出实际时长比较使用较大值，源视频文件使用preloadDurationLength
is_interaction	string	on	是否显示后台设置的问答
keyboardSeekTime	number	15000	键盘控制前进/后退毫秒数
allowFullscreen	boolean	true	是否允许全屏，界面上操作禁止全屏，接口全屏依然允许
viewerInfo	object	\	自定义观众信息。设置后，播放器上报的观看行为日志中会附带观众信息。
history_video_duration	number	5	视频总时长超过多少分钟时记录播放进度
showAuto	boolean	true	是否显示自动清晰度按钮
flashConfig	object	{}	切换flash播放器，或者在移动端下额外传入参数对象
video_align	string	"center" 视频内容对齐方式 top / bottom / left / right
srt_caption_txt_size	number	20	字幕字体大小， 20～40 px
srt_caption_txt_height	number	20	底部字幕离底部高度，单位px
srt_caption_base_height	number	720	字幕字体底部基准高度，视频尺寸变化，srt_caption_txt_height 值会根据该高度调整高度
srt_caption_base_width	number	1280	字幕字体大小基准宽度，字幕大小会随视频尺寸变化
fullscreenProxy	boolean	false	全屏代理，设置后点击全屏按钮或者双击播放器不会调用全屏api，会触发 window.onFullscreenProxy(vid, toFullscreen) 事件，调用者自行做全屏处理，适合在全屏状态下叠加用户自定义的元素
title_of_wrong_answer_explain	string	undefined	问答回答错误提示文案
title_of_right_answer_explain	string	undefined	问答回答正确提示文案
player_id ｜ string ｜ undefined	播放器id，传入后会使用该id的播放器设置
cover_display	string	'scaleToFill'	封面图的显示方式,可选 scaleToFill（对应background-size： 100% 100%） / scaleAspectFit（对应background-size： contain) / scaleAspectFill （对应background-size： cover)
full_page_screen	boolean	false	是否显示页面全屏按钮,配置window.onFullPageScreen 事件回调做相应页面全屏处理
cover_opacity ｜ number	70	封面遮罩层透明度
rightMenu	object[]	后台设置	右键菜单设置，例： [{rightName: "polyv",rightUrl: "http://www.polyv.net/"}]，rightUrl可为空
preview	boolean	false	使用视频预览，只需传入真实的视频vid，一般为播放视频前3分钟
ban_preview_video	boolean	false	关闭视频预览图显示

我的原创文章整理：

• 视频中常用的HLS(m3u8)协议分析
• 新版谷歌Chrome允许flash的选项已不再保存和添加了（如何解决？）
• 视频播放常见问题让IIS支持mp4、flv等mime类型的设置
• HTML5倍数功能视频播放器（加速2倍，1.5倍播放）
• HTML5之Video对象属性和方法（html5播放器设计必须研究的）

我的视频应用类原创文章：

• 微信公众号直播有哪些不一样的玩法？
• 微信视频直播如何做收费直播（如何做付费的微信直播）图文教程
• 说说视频编码格式、视频码率、视频帧率、分辨率的概念
• 原创教程：带ppt课件和讲师画面的教学视频录制完整教程
• 如何做电视节目的视频直播（电视台节目直播）
• 做视频直播时如何测试本地网络的上行带宽(网速测试)
• usb摄像头做教学直播实现pc和手机都可以在线观看教程
• 微信公众号直播有哪些不一样的玩法？
• 如何做电脑游戏桌面录屏直播实现手机直接观看
• 免费视频存储平台（微云、百度网盘、谷歌硬盘、酷播云）的截图对比
• 云课堂直播功能介绍，更贴合在线教育、企业内训的场景应用
• 基于微信小程序做直播的截图（微信小程序发起视频直播）
• 在线教学场景下 讲师们做PPT课件直播的一些介绍
• FMS/wowza/red5/SRS流媒体服务器产品对比
• 在微信公众号中添加外部的链接图文教程
• 企业级微信视频直播如何设定观看白名单（设定手机观看白名单、授权观看直播）
• 无广告视频存储加速一整套免费视频服务（youku视频广告太长）
• 在线教育网站如何更好的实现视频安全视频保护？
• 如何做新品发布会直播(新品推介会直播)基于云直播平台
• 医疗类直播(临床教学、手术观摩学习、医疗器械教学类)图文教程
• 在线教学直播中做ppt文档的在线直播(在线课常多画面直播)教程
• 双机位摄像机视频直播(多机位摄像机视频直播)时硬件连接示意图