Plyr轻量级H5 Web播放器 - Plyr 参数
- enabled//完全禁用 Plyr。这将允许您执行用户代理检查或类似操作,以编程方式为某个 UA 启用或禁用 Plyr。
- debug//在控制台显示调试信息
- controls//控制栏:['play-large', 'play', 'progress', 'current-time', 'mute', 'volume', 'captions', 'settings', 'pip', 'airplay', 'fullscreen']
- settings//设置:['captions', 'quality', 'speed', 'loop']
- i18n//用于 UI 中文本的国际化 (i18n)。
- loadSprite//加载指定为选项的 SVG 精灵iconUrl(如果是 URL)。如果false,则假定您正在自己处理精灵加载。
- iconUrl//指定 SVG 精灵的 URL 或路径。
- iconPrefix//为默认控件中使用的图标指定 id 前缀(例如“plyr-play”将是“plyr”)。如果您使用自己的 SVG 精灵但使用默认控件,这是为了防止发生冲突。大多数人可以忽略这个选项。
- autoplay//加载时自动播放媒体。
- autopause//播放器互斥
- playsinline//允许在 iOS 上内联播放。
- seekTime//用户点击快进或快退时搜索的时间
- volume//音量
- muted//静音
- clickToPlay//单击(或点击)视频容器将切换播放/暂停。
- disableContextMenu//禁用视频上的右键单击菜单
- hideControls//在 2 秒没有鼠标或焦点移动、控制元素模糊(制表符退出)、播放开始或进入全屏时自动隐藏视频控件。只要移动鼠标、聚焦控制元素或暂停播放,控件就会立即重新出现。
- resetOnEnd//播放完成后将播放重置为开始。
- keyboard//热键:{ focused: true, global: false }
- tooltips//控件标签:{ controls: false, seek: true }
- duration//指定媒体的自定义持续时间。
- displayDuration//当前时间显示中显示媒体在“元数据加载”事件(启动时)上的持续时间。preload这仅在属性未设置为none(或根本未设置)并且您选择不显示持续时间(请参阅controls选项)时才有效。
- invertTime//将当前时间显示为倒计时而不是增量计数器。
- toggleInvert//允许用户单击以切换以上内容。
- listeners//允许在默认处理程序之前将事件侦听器绑定到控件。查看defaults.js可用的侦听器。如果您的处理程序阻止事件 ( event.preventDefault()) 的默认值,则默认处理程序将不会触发。
- captions//{ active: false, language: 'auto', update: false } active:切换字幕是否默认处于活动状态。language:设置要加载的默认语言(如果可用)。'auto' 使用浏览器语言。update:收听曲目变化和更新菜单。这对于某些流媒体库是必需的,但可能会导致无法选择语言选项)。
- fullscreen//全屏:{ enabled: true, fallback: true, iosNative: false, container: null } enabled:切换是否应启用全屏。fallback: 允许回退到全窗口解决方案 ( true/ false/ 'force')。iosNative:进入全屏时是否使用原生 iOS 全屏(无自定义控件)——注意这对 iPadOS 没有影响。container: 播放器元素祖先的选择器,允许上下文内容在全屏模式下保持可见。非祖先被忽略。
- ratio//强制所有视频的纵横比。格式是'w:h'- 例如'16:9'或'4:3'。如果未指定,则 HTML5 和 Vimeo 的默认设置是使用视频的原始分辨率。由于无法通过 SDK 从 YouTube 获得尺寸,因此强制将 16:9 作为合理的默认值。
- storage//{ enabled: true, key: 'plyr' } enabled:允许使用本地存储来存储用户设置。key:要使用的键名。
- speed//播放速度:{ selected: 1, options: [0.5, 0.75, 1, 1.25, 1.5, 1.75, 2, 4] } selected:默认播放速度。options:显示在 UI 中的速度选项。YouTube 和 Vimeo 将忽略 0.5-2 范围之外的任何选项,因此该范围之外的选项将自动隐藏。
- quality//片源质量:{ default: 576, options: [4320, 2880, 2160, 1440, 1080, 720, 576, 480, 360, 240] } default是默认质量级别(如果它存在于您的源代码中)。options是要显示的选项。这用于过滤可用的来源。
- loop//循环播放
- ads//广告:{ enabled: false, publisherId: '', tagUrl: '' }
- urls//如果您希望覆盖任何 API URL,那么您可以在此处执行此操作。您还可以为下载按钮设置自定义下载 URL。
- vimeo//Vimeo嵌入选项 { byline: false, portrait: false, title: false, speed: true, transparent: false }
- youtube//youtube嵌入选项 { noCookie: false, rel: 0, showinfo: 0, iv_load_policy: 3, modestbranding: 1 }
- previewThumbnails//缩略图:{ enabled: false, src: '' } nabled:是否启用预览缩略图(必须由您生成)。src必须是字符串或字符串数组,表示包含图像 URL 的 VTT 文件的 URL。在下面了解有关预览缩略图的更多信息。
- mediaMetadata//{ title: '', artist: '', album: '', artwork: [] } Media Session API 的MediaMetadata接口允许网页提供丰富的媒体元数据以在平台 UI 中显示。
- markers//{ enabled: false, points: [] } enabled:是否启用标记。是一个对象points数组,其中代表以秒为单位的标记位置,并且是要显示的 HTML 字符串。{ time: number; label: string; }timelabel
复制代码
|