ArtPlayer/CHANGELOG_CN.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

• 添加 art.type 属性，用于获取和设置视频类型
• 添加 art.video 属性，用于获取 video 元素
• 添加 artplayer-plugin-iframe 插件，用于控制 iframe 里的播放器
• 添加 artplayer-plugin-hls-quality 插件，用于添加 Hls 画质列表到播放器
• 新增 Artplayer.PLAYBACK_RATE 用于设置默认播放速度，默认 [0.5, 0.75, 1, 1.25, 1.5, 2]
• 新增 Artplayer.ASPECT_RATIO 用于设置默认长宽比，默认 ['default', '4:3', '16:9']
• 新增 Artplayer.FLIP 用于设置默认翻转功能，默认 ['normal', 'horizontal', 'vertical']
• 新增 Artplayer.PROGRESS_HEIGHT 用于设置进度条高度，默认为 4
• 添加 legacy.js 版本，用于兼容更老的浏览器，但相对体积较大
• 移除 examples 目录，不再提供 vue.js 和 react.js 的例子文件

[4.5.8] - 2022-10-9

• 添加 farsi 语言
• 新增 Artplayer.DEGUG 用于打印 debug 信息，默认为 false
• 新增 art.setting.update() 用于动态更新设置面板
• 优化 artplayer.d.ts

[4.5.7] - 2022-9-28

• 新增 Artplayer.VOLUME_STEP 用于控制调整 音量 的步长，默认为 0.1
• 新增 Artplayer.SEEK_STEP 用于控制调整 快进/快退 的步长，默认为 5 秒
• 修复部分 svg 图标在移动端不显示的问题
• 修复在桌面端进度条不能同时点击和拖动的问题
• 修复在移动端进度条不能点击和拖动的问题
• 新增 art.isRotate 属性，用于识别是否自动全屏旋转
• 设置面板 range 添加 onChange 选项，可以实时获取当前值

var art = new Artplayer({
    container: '.artplayer-app',
    url: '/assets/sample/video.mp4',
    setting: true,
    settings: [
        {
            html: 'Slider',
            tooltip: '5x',
            range: [5, 1, 10, 0.1],
            onChange: function (item) {
                return item.range + 'x';
            },
        },
    ],
});

[4.5.6] - 2022-9-19

• 修复 hls.js 在 Safari 播放失效的问题

[4.5.5] - 2022-9-19

• 广告插件添加 option.muted 选项，用于静音自动播放广告
• 弹幕库插件暴露 art.plugins.artplayerPluginDanmuku.reset() 方法，用于清空当前弹幕显示
• 弹幕库插件暴露 art.plugins.artplayerPluginDanmuku.option 属性，用于获取当前弹幕配置
• 修复在 IOS 全屏模式下，字幕失效的问题
• 添加西班牙语支持

[4.5.4] - 2022-8-1

Added

• 新增 Artplayer.AUTO_PLAYBACK_MIN 用于控制最小可以记忆播放的进度值，默认为 5 秒
• 新增 Artplayer.TOUCH_MOVE_RATIO 用于控制移动端进度条拖放比例，默认为 0.5
• option.thumbnails 添加可选的 width 和 height
• 新增播放器编号选项 option.id，可用于记忆播放时的唯一标识

[4.5.3] - 2022-7-13

Added

• url 选项允许传空字符串，可用于异步设置 art.url

const art = new Artplayer({
    url: '',
    container: '.artplayer-app',
});

setTimeout(() => {
    art.url = '/assets/sample/video.mp4';
}, 1000);

• art.play() 方法统一返回 Promise, play 事件也改为异步触发

const art = new Artplayer({
    url: '/assets/sample/video.mp4',
    container: '.artplayer-app',
});

art.on('ready', async () => {
    try {
        await art.play();
        console.log('播放成功');
    } catch (error) {
        console.log('播放失败', error.message);
    }
});

• 新增 airplay (隔空播放) 功能，当前只在 Safari 下可用

const art = new Artplayer({
    url: '/assets/sample/video.mp4',
    container: '.artplayer-app',
    airplay: true,
});

[4.5.2] - 2022-6-22

Added

• 优化自动回放功能，让用户自行选择

[4.5.0] - 2022-6-21

Added

• 移除内置广告功能
• 新增广告插件

[4.4.7] - 2022-6-13

Added

• 兼容弹幕库 d.ts
• 更新依赖库

[4.4.6] - 2022-6-11

Added

• 添加弹幕库 d.ts
• 调整字幕字体大小参数
• 优化正则解析 xml 弹幕

[4.4.5] - 2022-6-2

Added

• 修复迷你模式时，主题色缺失的 bug

[4.4.3] - 2022-05-26

Added

• 修复弹幕库销毁时，自定义挂载输入框的残留
• 修复迷你模式的尺寸计算错误

[4.4.2] - 2022-05-20

Added

• 移除播放器 UI 初始化的 video:loadedmetadata 事件
• 弹幕库暴露 load 方法，用于切换弹幕源
• 添加 error 图标，出现于视频加载错误达到上限后
• 修复 setting 多次初始化时产生的 bug

[4.4.1] - 2022-05-17

Added

• 添加 art.isInput 属性，当为 true 的时候不自动隐藏控制栏，如弹幕正在输入时
• 添加 art.isLock 属性，在移动端当为 true 的时候不能操作快进、开始和暂停
• 修复弹幕输入框的固定宽度 bug
• 设置面板支持 range 和 onRange 选项
• 添加 isAndroid 和 isIOS 工具函数
• 弹幕库添加 lockTime 选项，可自定义输入框的锁定时间
• 弹幕库添加 maxLength 选项，控制输入最大可输入字数
• 弹幕库添加 minWidth 选项，控制输入框最小宽度
• 弹幕库添加 maxWidth 选项，控制输入框最大宽度
• 弹幕库添加 mount 选项，控制输入框自定义挂载位置
• 弹幕库添加 beforeEmit 选项，控制弹幕发送前的校验
• 弹幕库添加 theme 选项，控制输入框自定义挂载的主题色

[4.4.0] - 2022-05-15

Added

• 设置面板支持 switch 和 onSwitch 选项
• 弹幕库插件添加设置面板和弹幕发送
• 弹幕库的选项添加默认模式和默认字号
• 弹幕库字号支持按播放器的百分百
• 修复翻转设置的图标缺失
• 默认播放器获取了焦点后，不会自动隐藏控制栏
• 删除字幕开关按钮，需要自行配置字幕开关