Flutter ISO基础媒体处理插件iso_base_media的使用

iso_base_media

一个用于解析ISO基础媒体文件格式（如MP4、HEIC、AVIF、JXL文件）的dart包。

使用

提取HEIC文件中的hvcC盒子

Future<void> main() async {
  // 打开HEIC文件
  final fileBox = await ISOBox.openFileBoxFromPath('./test/test_files/a.heic');
  
  // 获取`ipco`盒子
  final ipcoBox = await fileBox.getChildByTypePath(['meta', 'iprp', 'ipco']);
  if (ipcoBox == null) {
    print('ipco box not found');
    return;
  }
  
  // 获取`hvcC`盒子
  final hvcCBoxList = await ipcoBox.getDirectChildrenByTypes({'hvcC'});
  if (hvcCBoxList.isEmpty) {
    print('hvcC box not found');
    return;
  }
  
  // 打印`hvcC`盒子的信息
  for (final hvcCBox in hvcCBoxList) {
    print('hvcC: start: ${hvcCBox.headerOffset}, size: ${hvcCBox.boxSize}');
  }
  /**
    * 输出:
    hvcC: start: 253, size: 108
    hvcC: start: 381, size: 107
   */
}

确定哪些盒子是容器或完整盒子

该包自带了一套默认规则来确定盒子是否为容器或完整盒子。你可以通过isContainerCallback和isFullBoxCallback提供自己的规则。

await fileBox.getChildByTypePath(['meta', 'iprp', 'ipco'], isContainerCallback: (type) {
  // 只有`meta`盒子被认为是容器。
  if (type == 'meta') {
    return true;
  }
  return false;
}, isFullBoxCallback: (type) {
  // 只有`mvhd`盒子被认为是完整盒子。
  if (type == 'mvhd') {
    return true;
  }
  return false;
});

扩展方法

基础盒子类有一些内置的扩展方法：

extension ISOBoxExtension on ISOBoxBase {
  /// 返回直接子盒子列表。
  /// [isContainerCallback] 是一个回调函数，用于确定一个盒子是否为容器。
  /// [isFullBoxCallback] 是一个回调函数，用于确定一个盒子是否为完整盒子。
  /// [filter] 是一个回调函数，用于过滤盒子。
  Future<List<ISOBox>> getDirectChildren({
    bool Function(String type)? isContainerCallback,
    bool Function(String type)? isFullBoxCallback,
    bool Function(ISOBox box)? filter,
  });

  /// 返回直接子盒子列表，通过给定的异步过滤器。
  /// [isContainerCallback] 是一个回调函数，用于确定一个盒子是否为容器。
  /// [isFullBoxCallback] 是一个回调函数，用于确定一个盒子是否为完整盒子。
  Future<List<ISOBox>> getDirectChildrenByAsyncFilter(
    Future<bool> Function(ISOBox box) filter, {
    bool Function(String type)? isContainerCallback,
    bool Function(String type)? isFullBoxCallback,
  });

  /// 返回指定类型的直接子盒子。
  /// 空的[types]集合将返回第一个子盒子。
  /// [isContainerCallback] 是一个回调函数，用于确定一个盒子是否为容器。
  /// [isFullBoxCallback] 是一个回调函数，用于确定一个盒子是否为完整盒子。
  Future<ISOBox?> getDirectChildByTypes(
    Set<String> types, {
    bool Function(String type)? isContainerCallback,
    bool Function(String type)? isFullBoxCallback,
  });

  /// 返回指定类型的直接子盒子列表。
  /// 空的[types]集合将返回所有子盒子。
  /// [isContainerCallback] 是一个回调函数，用于确定一个盒子是否为容器。
  /// [isFullBoxCallback] 是一个回调函数，用于确定一个盒子是否为完整盒子。
  Future<List<ISOBox>> getDirectChildrenByTypes(
    Set<String> types, {
    bool Function(String type)? isContainerCallback,
    bool Function(String type)? isFullBoxCallback,
  });

  /// 返回给定类型路径的子盒子。
  /// [isContainerCallback] 是一个回调函数，用于确定一个盒子是否为容器。
  /// [isFullBoxCallback] 是一个回调函数，用于确定一个盒子是否为完整盒子。
  Future<ISOBox?> getChildByTypePath(
    List<String> path, {
    bool Function(String type)? isContainerCallback,
    bool Function(String type)? isFullBoxCallback,
  });
}

/// 将盒子列表写入字节。
Future<Uint8List> isoBoxesToBytes(List<ISOBox> boxes);

完整示例Demo

以下是一个完整的示例代码，展示了如何使用iso_base_media插件来提取HEIC文件中的hvcC盒子信息。

// ignore_for_file: avoid_print

import 'package:iso_base_media/iso_base_media.dart';

Future<void> main() async {
  // 打开HEIC文件
  final fileBox = await ISOBox.openFileBoxFromPath('./test/test_files/a.heic');
  
  // 获取`ipco`盒子
  final ipcoBox = await fileBox.getChildByTypePath(['meta', 'iprp', 'ipco']);
  if (ipcoBox == null) {
    print('ipco box not found');
    return;
  }
  
  // 获取`hvcC`盒子
  final hvcCBoxList = await ipcoBox.getDirectChildrenByTypes({'hvcC'});
  if (hvcCBoxList.isEmpty) {
    print('hvcC box not found');
    return;
  }
  
  // 打印`hvcC`盒子的信息
  for (final hvcCBox in hvcCBoxList) {
    print('hvcC: start: ${hvcCBox.headerOffset}, size: ${hvcCBox.boxSize}');
  }
  /**
    * 输出:
    hvcC: start: 253, size: 108
    hvcC: start: 381, size: 107
   */
}