Flutter 鸿蒙化实战:record_mp3 适配 OpenHarmony,边录音边出 MP3

Flutter 鸿蒙化实战:record_mp3 适配 OpenHarmony

前言

随着鸿蒙生态的快速发展,越来越多的 Flutter 应用需要适配 OpenHarmony 平台。但生态早期,大量常用三方库只有 Android / iOS 实现,鸿蒙侧只能自己造轮子。

为了解决这个问题,CPF-Flutter 社区 对一批高频使用的 Flutter 三方库做了 OpenHarmony 平台适配,统一托管在 GitCode 的 CPF-Flutter 组织 下,全部通过 TAG 版本隔离、配套门禁编译验证,开箱即用。

本篇是系列文章之一,主角是 record_mp3 ------ 录音并输出 MP3 的插件。

record_mp3 是什么

record_mp3(原库 3.0.0)是录音并直接输出 MP3 文件的小插件:

  1. 一键录音 :start(path, onError) 开始录制并指定输出路径;
  2. 暂停/恢复/停止 :pause / resume / stop 完整的录音控制;
  3. 错误回调 :onRecordError 监听录制过程中的错误,path 读取输出路径。

适配情况

Flutter 框架版本 TAG 名称 分支名
3.7 3.0.0-ohos-1.0.0 master
3.27 3.0.0-ohos-1.0.0 master
3.35 3.0.0-ohos-1.0.0 master

快速接入

在 pubspec.yaml 中添加 git 依赖:

yaml 复制代码
dependencies:
  record_mp3:
    git:
      url: https://gitcode.com/CPF-Flutter/fluttertpc_record_mp3.git
      # 按你的 Flutter 框架版本,从上方映射表选择对应 TAG
      ref: 3.0.0-ohos-1.0.0

执行:

bash 复制代码
flutter pub get

使用示例

dart 复制代码
import 'package:record_mp3/record_mp3.dart';

// 开始录音,输出到指定路径
await RecordMp3.start('/data/audio/record.mp3', (err) {
  print('录制错误: ${err?.code}');
});

// 暂停 / 恢复
await RecordMp3.pause();
await RecordMp3.resume();

// 停止录音
final path = await RecordMp3.stop();
print('音频已保存: $path');

API 支持一览

API 说明 ohos 支持
start(path, onError) 开始录音并指定输出路径 yes
pause() 暂停录音 yes
resume() 恢复录音 yes
stop() 停止录音并返回路径 yes
path 当前输出路径 yes
onRecordError 录制错误回调 yes

!TIP ohos Support 为 yes 表示鸿蒙平台支持该能力,使用方式与 iOS / Android 保持一致。

仓库地址

系列预告

截至目前,CPF-Flutter 社区已完成 250+ 个 Flutter 三方库的 OpenHarmony 平台适配,覆盖权限管理、UI 组件、设备信息、位置服务、媒体处理、网络、支付等多个领域,完整的适配清单(含每个库的版本映射表)见:

本系列后续会陆续挑选高频库展开讲解,比如扫码识别(flutter_barcode_scanner)、自定义光标(flutter_custom_cursor)、全局异常捕获(catcher)等。

如果你的 Flutter 应用正在计划适配鸿蒙,欢迎关注 CPF-Flutter 组织,也欢迎参与共建。

相关推荐
爱写Bug的浮游1 天前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
程序猿追2 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos2 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji2 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207412 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos
码间留白2 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
uni-app·harmonyos·鸿蒙·uts插件·微信商家转账
GitCode官方3 天前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
程序猿追3 天前
鸿蒙 PC 用 Tauri 做本地查找,怎样让慢请求给新请求让路
华为·状态模式·harmonyos
程序猿追3 天前
鸿蒙 PC 用 Ionic 做巡检目录,缩窄窗口后草稿还在吗
华为·harmonyos
jianqiang.xue3 天前
1颗NPU分时复用:鸿蒙把轻AI塞进了MCU
人工智能·单片机·mcu·嵌入式·harmonyos·鸿蒙·端侧ai