项目简介
ChimeeMobilePlayer 是一个基于 Chimeejs 框架开发的移动端播放器项目。它提供了简洁、易用且高度可定制的 HTML5 移动端播放器,集成官方 UI 插件,能有效提高开发效率与用户体验,可应对点播和直播两种场景。
项目的主要特性和功能
- 兼容性强:基于 Chimeejs 框架,支持多种浏览器和设备。
- 集成 UI 插件:集成移动控制条和移动状态插件,带来直观的视频播放控制体验。
- 高度可定制:可按需调整插件配置参数,也能通过配置移除预装插件。
- 支持多格式:支持多种视频格式,直播场景支持 HLS 直播流。
- 提供默认样式:提供默认样式用于快速搭建播放器界面,开发者也可自定义 CSS 样式。
安装使用步骤
安装依赖
确保项目已安装 Node.js 和 npm,通过以下命令安装 ChimeeMobilePlayer 依赖:
bash
npm install chimee-mobile-player --save
引入播放器
在项目中引入 ChimeeMobilePlayer:
javascript
import ChimeeMobilePlayer from 'chimee-mobile-player';
import 'chimee-mobile-player/lib/chimee-mobile-player.browser.css';
基本用法
点播场景
javascript
new ChimeeMobilePlayer({
wrapper: '#wrapper', // video dom容器
src: 'http://cdn.toxicjohann.com/lostStar.mp4',
autoplay: true,
controls: true,
playsInline: true,
preload: 'auto',
x5VideoPlayerFullscreen: true,
x5VideoOrientation: 'landscape|portrait',
xWebkitAirplay: true,
muted: true,
});
直播场景
javascript
new ChimeeMobilePlayer({
wrapper: '#wrapper', // video dom容器
src: 'http://chimee.org/xxx/fff.m3u8',
isLive: true,
autoplay: true,
controls: true,
playsInline: true,
preload: 'auto',
x5VideoPlayerFullscreen: true,
x5VideoOrientation: 'landscape|portrait',
xWebkitAirplay: true,
muted: true,
disableUA: ['Mozilla/5.0 (Linux; Android 4.4.2; HM NOTE 1TD Build/KOT49H; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/62.0.3202.97 Mobile Safari/537.36']
});
注意事项
- 默认配置自带控制条和中部状态,可通过配置去掉。
- 暂不支持在该元素上使用缩放 zoom / scale。
- iOS 上的声音和机器的声音同步,设置 volume 无效,muted 有效。
- 在 chimee@0.8.3 之后将 playsline / x5VideoPlayerType 分开配置。
- 在 0.1.5 版本后,样式文件单独打包,需单独引入
lib/chimee-mobile-player.browser.css
。 - 当出现覆盖不掉原生控制条的情况,可配置 disableUA 来覆盖。
FAQ
- 为什么移动端不能播放 m3u8 直播流?
移动端原生支持 m3u8 播放,无需使用
chimee-kernel-hls
编解码。若不能顺利播放,注意box
值是否设为native
。 - 为什么我在移动端播放没有音量?
注意是否设置了
muted
为true
。移动播放器一般只允许静音视频自动播放,若需自动播放,最好将 muted 设为 true。 - 为什么我不能调节音量? 若为 iOS 设备,声音和机器声音同步,设置 volume 无效。
- 预装的内部插件可以去掉吗? chimee-mobile-player 预装插件不多,有 chimee-plugin-mobile-controlbar 和 chimee-plugin-mobile-state,可自行利用 chimee 搭建或使用 removeInnerPlugins 移除。
- 注意 若要兼容低级手机浏览器,需引入 babel-polyfill。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】