Griffith - 知乎视频播放器
Griffith 是什么?
Griffith 是一个基于 React 的视频播放器,目前已在知乎 web 和 mobile web 内使用,并在 GitHub 上开源。
特性
简洁易用的 UI
Griffith 提供了简洁易用的播放器 UI。在知乎网页端,下面的视频就是通过 Griffith 来播放的。
快捷键支持
Griffith 参考 YouTube 进行了快捷键支持,后续还会添加更多的快捷键。
- 空格键:进度条处于选中状态时,可控制视频的播放/暂停。如果已经选中某个按钮,则可用于点击该按钮。
- K: 在播放器中暂停/播放视频。
- 选中进度条状态下的向左/向右箭头:快进/快退 5 秒钟。
- J:在播放器中快退 10 秒。
- L:在播放器中快进 10 秒。
- 选中进度条状态下的向上/向下箭头:将音量增大/减小 5%。
- 选中进度条状态下的数字 1 到 9(不是数字小键盘上的数字):跳至视频进度的 10% 到 90%。
- 选中进度条状态下的数字 0(不是数字小键盘上的 0):跳至视频的开头。
- F:启用全屏模式。如果已启用全屏模式,则再次按 F 键或按 Esc 键可退出全屏模式。
- M:切换静音。
React-friendly
Griffith 是一个基于 React 开发的 web 视频播放器。对于 React 应用,可以直接通过组件调用的方式使用。
Griffith 使用 Context API 进行状态管理。对于 React 应用,可以通过引入 Griffith 的 Context 来实现弹幕等自定义功能。
免构建
对于非 React 应用,或者不愿意通过 npm 包安装的用户,Griffith 提供了 standalone 模式可以免构建工具直接在浏览器中使用。
丰富的事件系统
Griffith 定义了丰富的事件系统。
对于视频播放器中常见的首帧时长,缓冲次数等指标,可以通过接收 Griffith 事件来进行打点记录。
对于一些需要与播放器进行通信的功能,可以通过往 Griffith 发送事件来与播放器进行交互[1]。
流式播放
Griffith 使用了 Media Source Extensions™ ,支持对 mp4 和 m3u8 格式的视频进行流式播放。
- 预加载策略: Griffith 可以通过 MSE 动态控制视频加载进度,以达到节省视频 CDN 带宽等目地。
- 动态平滑切换清晰度:Griffith 可以通过 MSE 实现动态平滑切换视频清晰度[2]。
如何使用
React 应用
import Player from 'griffith'
const sources = {
hd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_hd.mp4',
},
sd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_sd.mp4',
},
}
render(<Player sources={sources} />)
standalone 模式
<div id="player"></div>
<script src="https://unpkg.com/griffith-standalone/dist/index.umd.min.js"></script>
<script>
const target = document.getElementById('player')
const sources = {
hd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_hd.mp4',
} ,
sd: {
play_url: 'https://zhstatic.zhihu.com/cfe/griffith/zhihu2018_sd.mp4',
},
}
// 创建播放器
const player = Griffith.createPlayer(target)
// 载入视频
player.render({sources})
// 销毁视频
player.dispose()
</script>
示例:griffith-standalone - CodeSandbox
技术细节
- 使用 Yarn workspace 和 Lerna 进行多包管理。
- 使用 rollup 和 webpack 进行打包。
- 使用 new Context API 进行状态管理。
- 使用 CSS-in-JS 方案来管理样式。
- 使用 Jest 来进行单元测试编写。
- 使用 Prettier 进行代码格式统一。
- 使用 hlsjs 来实现流式播放 m3u8 格式视频。
- 使用 griffith-mp4 进行 mp4 到 fmp4 格式的转换并通过 MSE 实现流式播放。
结语
Griffith 所有的工作都会在 GitHub 上进行(知乎内部使用的也是同一个仓库)。如果有任何相关的疑问和 bug,欢迎在 GitHub 提交 issue、PR 帮助 Griffith 变得更好。
最后,感谢
对 Griffith 的帮助, 感谢设计师 @白晓双。