Nothing Special   »   [go: up one dir, main page]

Skip to content

pili-engineering/QPlayer2-HarmonyOS-NEXT

Repository files navigation

QPlayer2

Qplayer2是一款跨平台的播放器SDK,除了基础的播放器能力外,更致力于各种应用场景的对接。

播放器 SDK 合规使用说明请参考七牛 SDK 合规使用说明;隐私政策说明请参考七牛 SDK 隐私策略

支持的平台

Platform Build Status
Android https://github.com/pili-engineering/QPlayer2-Android
IOS https://github.com/pili-engineering/QPlayer2-IOS
Windows https://github.com/pili-engineering/QPlayer2-Windows
HarmonyOS NEXT Last Version: 1.5.0
Mac 敬请期待
Linux 敬请期待

qplayer2-core 功能列表

能力 亮点 备注
媒体资源组成形式 一个媒体资源支持多url,比如一个音频url和一个视频url组成一个媒体资源,提升拉流速度和解封装速度
播放协议及视频类型 http/https/rtmp flv/m3u8/mp4/flac/wav(PCM_S24LE) 新增协议和视频类型请联系技术支持
解码 软解/硬解/自动解码
色盲模式 能在业务场景中更好的服务视觉有障碍的客户
倍速 变速不变调
清晰度切换 通用清晰度切换方案,无缝切换,即使媒体资源gop不对齐
seek 支持精准/关键帧 seek 两种方式
指定起播位置 从指定位置开始播放
起播方式 起播播放/起播暂停 设置起播暂停时,起播后首帧渲染出来就停止画面
SEI数据回调 所有解码方式都支持
纯音频播放/纯视频播放 播放只有单音频流或者只有单视频流的视频
VR视频 支持Equirect-Angular类型的vr视频播放
后台播放 支持设置是否开启后台播放
预加载 提前加载点播视频,获得更好的首帧体验
截图 自动转换成jpeg格式,可以展示在UI上,也可存放到相册
缩放/旋转/镜像 方便用户对视频画面进行一些自定义操作
字幕 支持srt字幕文件加载并根据时间回调当前时间的文案给上层
DRM 支持HLS 私有加密/通用加密 2种方式,支持 MP4 CENC-AES-CTR 加密,支持七牛私有 MP4 加密方式
音视频数据上抛 适用于业务层需要获取当前播放的音视频数据的场景(比如推流等)

环境要求

类别 说明
系统版本 版本为 5.0.0.102 的 harmony-next 手机
IDE 版本 DevEco Studio NEXT Release version 5.0.3.900

权限要求

  {
    "name": "ohos.permission.INTERNET"
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    "name": "ohos.permission.KEEP_BACKGROUND_RUNNING"
  }

Harmony

引入依赖

须在 oh-package.json5 文件中 dependencies 字段中列出引用的三方库,sdk 在demo 工程的dependency 目录下。

{
  "dependencies": {
    "@qiniu/qplayer2-core": "^1.5.0",  //依赖 open harmony 中心仓
  }
}
鉴权
权限 说明 鉴权失败结果
Base 基础播放能力 播放器进入error状态
VR 播放VR视频 播放vr视频,起播后播放器进入error状态
SEI SEI数据回调 开启sei 回调,且视频有sei数据。能正常播放视频,SEI数据不回调,同时抛出鉴权失败错误码
BLIND 色盲滤镜 开启色盲滤镜,视频正常播放,滤镜不生效。
APM 性能埋点上报 关闭埋点上报,不影响播放器核心功能使用

如需使用该套sdk到其他工程中,可通过 400-808-9176 联系七牛商务开通帐号和权限 或者 通过 工单 联系七牛的技术支持。

接入文档

https://developer.qiniu.io/pili/12702/qplayer2-harmony

Demo介绍
  1. demo 工程内的 长视频播放页 是基于 qplayer2-core 来实现的

  2. demo 下载:https://sdk-release.qnsdk.com/qplayer2-demo-v1.5.0.hap

  3. 电脑连接 harmony next 手机,执行下方命令安装 hap 包

hdc install qplayer2-demo-v1.5.0.hap
技术支持与交流

产品及服务咨询:400-808-9176

问题反馈:如有问题请提交issue