HarmonyOS APP开发---"刷刷"短视频App，需要用到这个库

想做一个短视频 App，上下滑动切换视频、支持倍速、还能拉 RTMP 直播流？系统播放器搞不定冷门编码和直播协议------@ohos/ijkplayer 把 B 站同源播放器搬进了鸿蒙，FFmpeg 内核，啥格式都能播。
📦 仓库地址：gitcode.com/CPF-Applica... ｜安装：ohpm install @ohos/ijkplayer

写在前面

"刷刷"的核心体验是"滑到就播"------用户上滑切换下一条视频，几乎无感知地开始播放。这背后对播放器的要求很高：

首帧要快：滑到新视频，500ms 内出画面，不然用户觉得卡
格式要全：MP4、FLV、HLS、甚至 RTMP 直播流都要能播
硬解码：省电不发烫，长时间刷不热
倍速播放：1.5x/2x 看视频是刚需

系统 AVPlayer 对直播流（RTMP/RTSP）和部分编码支持不全。ijkplayer 是 B 站开源的、基于 FFmpeg 的播放器，久经亿级 DAU 考验，@ohos/ijkplayer 是它在 OpenHarmony 上的官方移植。

这篇文章聊什么

播放器初始化------XComponent + IjkMediaPlayer 接入渲染
上下滑动切换------列表 + 播放器复用
倍速 + 截图------进阶控制能力

flowchart TD A[视频列表] --> B[用户上滑] B --> C[停止当前播放] C --> D[复用 IjkMediaPlayer] D --> E[setDataSource 新 URL] E --> F[prepareAsync] F --> G[onPrepared 回调] G --> H[start 播放] H --> I[首帧渲染] I --> J[用户可操作: 倍速/暂停/截图]

第一步：安装与权限

bash 复制代码

ohpm install @ohos/ijkplayer

json 复制代码

"requestPermissions": [
  { "name": "ohos.permission.INTERNET", "reason": "$string:NET_REASON" }
]

第二步：播放器与 XComponent 集成

ijkplayer 通过 XComponent 接入 ArkUI 渲染管线：

typescript 复制代码

import { IjkMediaPlayer, OnPreparedListener, OnErrorListener } from '@ohos/ijkplayer'

@Entry
@Component
struct VideoFeedPage {
  @State currentUrl: string = 'https://cdn.example.com/video_001.mp4'
  private player = IjkMediaPlayer.getInstance()

  build() {
    Stack() {
      XComponent({
        id: 'player-surface',
        type: 'SURFACE',
        libraryname: 'ijkplayer_napi',
        controller: this.player.getSurfaceController()
      })
        .onLoad(() => this.prepareAndPlay())
        .width('100%').height('100%')
    }
  }

  private prepareAndPlay() {
    this.player.setOnPreparedListener(() => {
      this.player.start() // 准备完成，开始播放
    })
    this.player.setOnErrorListener((what, extra) => {
      console.error(`播放错误: what=${what} extra=${extra}`)
    })
    this.player.setDataSource(this.currentUrl)
    this.player.prepareAsync()
  }
}

第三步：上下滑动切换视频

用户上滑，切换到下一条视频，复用同一个播放器实例：

typescript 复制代码

private videoList: string[] = [
  'https://cdn.example.com/video_001.mp4',
  'https://cdn.example.com/video_002.mp4',
  'https://cdn.example.com/video_003.flv',
]
private currentIndex: number = 0

// 上滑切换下一条
onSwipeUp() {
  this.player.stop()
  this.player.reset() // 重置播放器状态

  this.currentIndex++
  if (this.currentIndex >= this.videoList.length) {
    this.currentIndex = 0
  }

  this.currentUrl = this.videoList[this.currentIndex]
  this.player.setDataSource(this.currentUrl)
  this.player.prepareAsync()
  // onPrepared 回调里会自动 start
}

reset() 是关键------它清空上一条视频的状态，但不销毁播放器实例，避免了反复创建/销毁的开销，首帧速度更快。

第四步：倍速、暂停、截图

typescript 复制代码

// 倍速播放（API 12+）
setSpeed(speed: number) {
  this.player.setSpeed(speed) // 0.5 / 1.0 / 1.5 / 2.0
}

// 暂停/继续
togglePlay() {
  if (this.isPlaying) {
    this.player.pause()
  } else {
    this.player.start()
  }
  this.isPlaying = !this.isPlaying
}

// 截图（保存到相册）
captureFrame() {
  this.player.capture(async (path) => {
    if (path) {
      console.info('截图已保存: ' + path)
      promptAction.showToast({ message: '截图已保存到相册' })
    }
  })
}

第五步：拉直播流

ijkplayer 不只能播点播，RTMP/HLS/RTSP 直播流也行：

typescript 复制代码

// RTMP 直播流
this.player.setDataSource('rtmp://live.example.com/live/stream_001')
this.player.prepareAsync()

// HLS 直播流
this.player.setDataSource('https://live.example.com/hls/stream_001.m3u8')
this.player.prepareAsync()

系统播放器对 RTMP 支持有限，而 ijkplayer 底层是 FFmpeg，RTMP/RTSP/HLS 全覆盖。

为什么"刷刷"选了 ijkplayer？

需求	系统 AVPlayer	@ohos/ijkplayer
点播 MP4	✅	✅
FLV/MKV 冷门格式	❌	✅ FFmpeg 内核
RTMP/RTSP 直播	❌ 部分	✅ 全支持
硬解码	✅	✅ 自动启用
倍速播放	✅	✅
截图	❌	✅
B 站验证	❌	✅ 亿级 DAU

总结

"刷刷"这个场景里，@ohos/ijkplayer 解决了三件事：

快速切换 ------reset() 复用实例，上滑切换首帧快
全格式覆盖------点播 MP4/FLV + 直播 RTMP/HLS 都能播
进阶控制------倍速、截图、音量，API 齐全

如果你也在做短视频、直播、在线教育等视频播放类 App，@ohos/ijkplayer 的 FFmpeg 内核给你最大兼容性，B 站同源给你最大信心。