【鸿蒙优选三方库】@ohos/ffmpeg-kit：把 FFmpeg 的全部能量带进 HarmonyOS

关注

原创最新推荐文章于 2026-10-28 15:14:51 发布 419 阅读 AI 写同款· GEO 优化 ›

react native ffmpeg 视频处理 1 FFmpegKit说明 https://github.com/tanersener/ffmpeg-kit 构建 FFmpeg 库的脚本 FFmpegKit在应用程序中运行FFmpeg/FFprobe命令的包装库支持安卓、iOS、macOS 和 tvOS 基于v4.4-dev带有可选系统和外部库的FFmpeg Github、Maven Central和CocoaPods 上提供了 8 个预构建的二进制包。根据许可LGPL 3.0，或者GPL v3.0如果启用了 GPL 许可的库 2 Androi 阅读详情

【鸿蒙优选三方库】@ohos/ffmpeg-kit：把 FFmpeg 的全部能量带进 HarmonyOS

想在鸿蒙应用里直接调用 FFmpeg 处理音视频？@ohos/ffmpeg-kit 是 FFmpegKit 在 OpenHarmony 上的官方移植——一套脚本、一套原生库、一套 ArkTS 封装，让你在 HarmonyOS 上像在 Android/iOS 一样运行 FFmpeg/FFprobe 命令。

包名：@ohos/ffmpeg-kit
当前版本：v1.0.1
协议：MIT
安装：ohpm install @ohos/ffmpeg-kit
仓库：https://gitcode.com/CPF-ApplicationTPC/ohos_ffmpeg_kit

一、它解决了什么问题？

FFmpeg 是音视频领域的"瑞士军刀"——转码、剪辑、拼接、滤镜、流媒体推拉，几乎无所不能。但要在 HarmonyOS 应用里使用 FFmpeg，传统路径是：自己编译 FFmpeg 源码 → 写 NAPI 桥接 → 处理异步回调与日志 → 还要考虑 license 与依赖……

@ohos/ffmpeg-kit 继承自业界知名的 FFmpegKit 跨平台项目（曾支持 Android/iOS/macOS/Linux/tvOS/Flutter/RN），把整套工程实践与脚本完整带到了 OHOS，让你 5 分钟接入 FFmpeg 能力。

📌 小贴士：上游 FFmpegKit 已于 2025 年正式宣告停止维护（< 6.0 版本二进制已于 2025-02-01 下线，6.0 版本于 2025-04-01 下线）。本仓库是 OpenHarmony 社区在 FFmpegKit 基础上的延续，专门为 HarmonyOS 生态服务。

二、核心特点

特性	说明
基于 FFmpeg v4.5-dev+	可选系统库与外部库支持
FFmpeg + FFprobe	完整命令执行能力
ArkTS NAPI 封装	异步执行、日志回调、返回码捕获
多架构构建脚本	沿用上游 `buildEnv.sh`、`android.sh` 等工程脚本
Flutter / RN 复用	同源支持 Flutter、React Native（`flutter/`、`react-native/` 目录）
集成 AKI 桥接	底层依赖 `@ohos/aki` 提供高效的 JS↔Native 互调
完整 native 库	`libffmpegkit_napi.so` 一并交付，免编译即可用

三、适用场景

音视频转码：把一种格式/编码转成另一种（如 mp4 → wav、H.264 → H.265）。
视频剪辑与拼接：客户端纯本地完成，无需上传服务端。
直播推流 / 拉流：使用 FFmpeg 拉 RTMP/HLS/HTTP-FLV 流并解码。
音视频元信息解析：通过 FFprobe 拿到时长、码率、编码格式等。
滤镜与特效：加水印、缩放、调色、混音等。
教育/工具类 App：在线转码器、格式转换工具、音频编辑器。
Flutter / RN 应用：如果你是 Flutter 或 React Native 开发者，本仓库也提供对应平台支持。

四、快速上手

1. 安装

ohpm install @ohos/ffmpeg-kit

依赖项会自动安装：

libffmpegkit_napi.so（native 库）
@ohos/aki（JS↔C++ 互调框架）

2. 执行一条 FFmpeg 命令

import { FFmpegKit, FFmpegSession, ReturnCode } from '@ohos/ffmpeg-kit'

// 异步执行 FFmpeg 命令
const session: FFmpegSession = FFmpegKit.execute(
  '-i /data/storage/el2/base/input.mp4 -vn -acodec copy /data/storage/el2/base/output.aac'
)

// 监听日志（可选）
session.setLogCallback((log) => {
  console.info(`[FFmpeg] ${log.getMessage()}`)
})

// 等待执行完成
session.complete.then((stats) => {
  if (ReturnCode.isSuccess(stats.getReturnCode())) {
    console.info('转码成功')
  } else if (ReturnCode.isCancel(stats.getReturnCode())) {
    console.info('转码被取消')
  } else {
    console.error('转码失败: ' + stats.getFailStackTrace())
  }
})

3. 用 FFprobe 探测媒体信息

import { FFprobeKit } from '@ohos/ffmpeg-kit'

FFprobeKit.getMediaInformation('/data/storage/el2/base/video.mp4')
  .then((session) => {
    const info = session.getMediaInformation()
    console.info('时长: ' + info.getDuration() + ' ms')
    console.info('码率: ' + info.getBitrate())
    console.info('格式: ' + info.getFormat())
  })