Flutter与OpenHarmony整合开发音乐播放器最近播放功能

1. 项目背景与核心需求

OpenHarmony作为国产分布式操作系统的新锐力量，正在构建自己的应用生态。而Flutter作为跨平台开发框架的佼佼者，其"一次编写，多端运行"的特性与OpenHarmony的分布式理念不谋而合。这次我们要实现的音乐播放器"最近播放"功能，看似简单，实则涉及OpenHarmony特有的数据持久化方案与Flutter状态管理的深度整合。

在传统Android/iOS平台上，类似功能可能只需要简单的SharedPreferences或UserDefaults就能搞定。但在OpenHarmony环境下，我们需要考虑：

• 分布式数据同步：设备间如何共享播放记录
• 数据安全存储：符合OpenHarmony的沙箱规范
• 性能优化：避免频繁IO操作影响播放流畅度

实测发现，直接套用Flutter的shared_preferences插件在OpenHarmony上会出现权限问题。这促使我们必须寻找更原生的解决方案。

2. 环境搭建与项目初始化

2.1 开发环境配置

首先需要准备：

bash复制# 安装Flutter for OpenHarmony定制版
git clone https://gitee.com/openharmony-sig/flutter_flutter
cd flutter_flutter
./flutter_prebuild.sh

关键点说明：

• 必须使用OpenHarmony SIG维护的Flutter分支
• 需要提前部署OpenHarmony 3.2+的SDK
• 推荐使用DevEco Studio作为辅助开发工具

2.2 项目结构设计

采用分层架构：

code复制lib/
├── models/
│   ├── play_record.dart    # 播放记录数据模型
├── services/
│   ├── storage_service.dart # 存储服务抽象
│   ├── ohos_storage.dart   # OpenHarmony具体实现
└── widgets/
    ├── recent_playlist.dart # UI组件

这种设计将平台相关代码隔离在service层，便于后续维护和跨平台扩展。

3. OpenHarmony存储方案实现

3.1 数据模型定义

首先定义播放记录的数据结构：

dart复制class PlayRecord {
  final String id;
  final String title;
  final String artist;
  final String coverUrl;
  final Duration duration;
  final DateTime playTime;
  
  // 转换为Map用于序列化
  Map<String, dynamic> toJson() => {...};
  
  // 从Map反序列化
  factory PlayRecord.fromJson(Map<String, dynamic> json) {...}
}

3.2 使用Preferences实现本地存储

OpenHarmony提供了轻量级存储方案Preferences，我们通过FFI封装调用：

dart复制// ohos_storage.dart
final DynamicLibrary _lib = ...; // 加载OpenHarmony native库

class OhosStorage implements StorageService {
  static const _maxRecords = 100; // 最大存储记录数
  
  Future<void> saveRecord(PlayRecord record) async {
    final prefs = await _getPreferences();
    final records = await getRecords();
    
    // 去重处理
    records.removeWhere((r) => r.id == record.id);
    records.insert(0, record);
    
    // 限制数量
    if (records.length > _maxRecords) {
      records.removeRange(_maxRecords, records.length);
    }
    
    // 序列化存储
    final jsonList = records.map((r) => r.toJson()).toList();
    await prefs.setStringList('recent_plays', jsonList);
  }
  
  Future<List<PlayRecord>> getRecords() async {
    final prefs = await _getPreferences();
    final jsonList = prefs.getStringList('recent_plays') ?? [];
    return jsonList.map((json) => PlayRecord.fromJson(json)).toList();
  }
}

注意：OpenHarmony的Preferences默认有加密存储，但分布式同步需要额外配置ability属性。

4. Flutter UI层实现

4.1 状态管理方案选型

考虑到播放记录需要全局访问，我们采用Riverpod+StateNotifier的方案：

dart复制// recent_play_provider.dart
final recentPlayProvider = StateNotifierProvider<RecentPlayNotifier, List<PlayRecord>>((ref) {
  return RecentPlayNotifier();
});

class RecentPlayNotifier extends StateNotifier<List<PlayRecord>> {
  final StorageService _storage;
  
  RecentPlayNotifier() : _storage = OhosStorage(), super([]) {
    _loadRecords();
  }
  
  Future<void> _loadRecords() async {
    state = await _storage.getRecords();
  }
  
  Future<void> addRecord(PlayRecord record) async {
    await _storage.saveRecord(record);
    _loadRecords(); // 刷新状态
  }
}

4.2 列表UI与交互设计

使用SliverList实现高性能滚动列表：

dart复制class RecentPlayList extends ConsumerWidget {
  @override
  Widget build(BuildContext context, WidgetRef ref) {
    final records = ref.watch(recentPlayProvider);
    
    return CustomScrollView(
      slivers: [
        SliverAppBar(
          title: Text('最近播放'),
          pinned: true,
        ),
        SliverList(
          delegate: SliverChildBuilderDelegate(
            (context, index) {
              final record = records[index];
              return ListTile(
                leading: CachedNetworkImage(record.coverUrl),
                title: Text(record.title),
                subtitle: Text(record.artist),
                trailing: Text(record.playTime.toString()),
                onTap: () => _playRecord(context, record),
              );
            },
            childCount: records.length,
          ),
        ),
      ],
    );
  }
}

5. 分布式同步实现

OpenHarmony的分布式能力是其特色功能，我们通过以下步骤实现跨设备同步：

5.1 配置分布式权限

在config.json中添加：

json复制{
  "abilities": [{
    "distributedNotificationEnabled": true,
    "distributedDataEnabled": true
  }]
}

5.2 实现数据同步

修改OhosStorage类：

dart复制class OhosStorage {
  final _distributedManager = DistributedDataManager.getInstance();
  
  Future<void> syncToAllDevices(List<PlayRecord> records) async {
    final json = jsonEncode(records.map((r) => r.toJson()).toList());
    await _distributedManager.sync('recent_plays', json, 
      SyncMode.FULL, 
      [DeviceSelectionPolicy.ALL]
    );
  }
}

6. 性能优化实践

6.1 存储压缩策略

实测发现直接存储JSON在记录多时会影响性能，我们采用以下优化：

1. 使用gzip压缩JSON字符串
2. 对封面图片只存储URL而非二进制数据
3. 采用LRU缓存最近10条记录

dart复制Future<void> saveRecord(PlayRecord record) async {
  final compressed = gzip.encode(utf8.encode(jsonEncode(record.toJson())));
  await prefs.setString('recent_${record.id}', base64Encode(compressed));
}

6.2 列表渲染优化

针对长列表：

1. 使用flutter_lazyload实现图片懒加载
2. 采用isolate解析压缩数据
3. 添加ListView.builder的itemExtent固定高度

7. 常见问题排查

7.1 存储权限问题

现象：保存记录时抛出SecurityException
解决方案：

1. 检查config.json是否声明ohos.permission.DISTRIBUTED_DATASYNC权限
2. 确保在首次使用时动态请求权限：

dart复制void _checkPermission() async {
  final status = await PermissionHandler()
      .requestPermission(Permission.distributedData);
  if (!status.granted) {
    showPermissionDialog(context);
  }
}

7.2 分布式同步延迟

现象：设备间数据不同步
排查步骤：

1. 确认所有设备登录相同华为账号
2. 检查网络是否开启WLAN和蓝牙
3. 调用DistributedDataManager的syncStatus查询同步状态

8. 进阶扩展方向

基于当前实现，还可以进一步扩展：

1. 添加智能推荐算法，基于播放记录推荐相似音乐
2. 实现多端播放进度同步
3. 接入OpenHarmony的AI引擎实现语音控制

我在实际开发中发现，OpenHarmony的分布式能力与Flutter的结合还有很多值得探索的空间。比如可以利用分布式软总线实现设备间低延迟的音频流转，这将是下一步重点研究的方向。