鸿蒙平台使用 `video_thumbnail` 插件指南

最新推荐文章于 2025-12-23 23:08:59 发布

原创最新推荐文章于 2025-12-23 23:08:59 发布 · 428 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为

插件介绍

video_thumbnail 是一个用于生成视频缩略图的 Flutter 插件，支持在鸿蒙平台上使用。本项目基于 video_thumbnail 开发，提供了简单易用的 API 来从视频文件或 URL 中生成高质量的缩略图。

该插件适用于需要展示视频预览图、实现视频列表缩略图或提供视频截图功能的应用场景。

安装与使用

安装方式

在引用的项目中，pubspec.yaml 中 dependencies 新增配置：

dependencies:
  video_thumbnail_ohos:
    git:
      url: "https://atomgit.com/openharmony-sig/fluttertpc_video_thumbnail.git"
      path: "ohos"

执行命令安装依赖：

flutter pub get

权限配置

2.2.1 在 entry 目录下的module.json5中添加权限

打开 entry/src/main/module.json5，添加：

...
"requestPermissions": [
+  {
+    "name": "ohos.permission.READ_IMAGEVIDEO",
+    "reason": "$string:EntryAbility_label",
+    "usedScene": {
+      "abilities": [
+        "EntryAbility"
+      ],
+      "when":"inuse"
+    }
+  }
]

2.2.2 在 entry 目录下的string.json添加申请以上权限的原因

打开 entry/src/main/resources/base/element/string.json，添加：

...
{
  "string": [
+    {
+      "name": "EntryAbility_label",
+      "value": "video_thumbnail_ohos_example"
+    }
  ]
}

基本使用示例

以下是一个简单的使用示例，展示如何在鸿蒙平台上使用 video_thumbnail 插件生成视频缩略图：

import 'dart:async';
import 'dart:typed_data';

import 'package:flutter/material.dart';
import 'dart:io';

import 'package:video_thumbnail_ohos/video_thumbnail_ohos.dart';
import 'package:image_picker/image_picker.dart';
import 'package:path_provider/path_provider.dart';

Future<ThumbnailResult> genThumbnail(ThumbnailRequest r) async {
  Uint8List bytes;
  final Completer<ThumbnailResult> completer = Completer();
  if (r.thumbnailPath != null) {
    final thumbnailPath = await VideoThumbnailOhos.thumbnailFile(
        video: r.video,
        headers: {
          "USERHEADER1": "user defined header1",
          "USERHEADER2": "user defined header2",
        },
        thumbnailPath: r.thumbnailPath,
        imageFormat: r.imageFormat,
        maxHeight: r.maxHeight,
        maxWidth: r.maxWidth,
        timeMs: r.timeMs,
        quality: r.quality);

    print("thumbnail file is located: $thumbnailPath");

    final file = File(thumbnailPath);
    bytes = file.readAsBytesSync();
  } else {
    bytes = await VideoThumbnailOhos.thumbnailData(
        video: r.video,
        headers: {
          "USERHEADER1": "user defined header1",
          "USERHEADER2": "user defined header2",
        },
        imageFormat: r.imageFormat,
        maxHeight: r.maxHeight,
        maxWidth: r.maxWidth,
        timeMs: r.timeMs,
        quality: r.quality);
  }

  int _imageDataSize = bytes.length;
  print("image size: $_imageDataSize");

  final _image = Image.memory(bytes);
  _image.image
      .resolve(ImageConfiguration())
      .addListener(ImageStreamListener((ImageInfo info, bool _) {
    completer.complete(ThumbnailResult(
      image: _image,
      dataSize: _imageDataSize,
      height: info.image.height,
      width: info.image.width,
    ));
  }));
  return completer.future;
}

核心 API 说明

API 名称	描述	返回值	鸿蒙支持
`thumbnailData`	从视频中生成缩略图数据	`Future<Uint8List>`	yes
`thumbnailFile`	从视频中生成缩略图文件	`Future<String>`	yes

API 参数说明

thumbnailData Parameters

参数名称	描述	类型	鸿蒙支持
`video`	视频文件路径或 URL	`String`	partially
`headers`	网络资源的 HTTP 头	`Map<String, String>?`	yes
`imageFormat`	输出图像格式	`ImageFormat`	yes
`maxHeight`	最大高度（0 表示原始分辨率）	`int`	yes
`maxWidth`	最大宽度（0 表示原始分辨率）	`int`	yes
`timeMs`	从指定毫秒位置生成缩略图	`int`	yes
`quality`	图像质量（0-100，PNG 格式忽略）	`int`	yes

thumbnailFile Parameters

参数名称	描述	类型	鸿蒙支持
`video`	视频文件路径或 URL	`String`	partially
`headers`	网络资源的 HTTP 头	`Map<String, String>?`	yes
`thumbnailPath`	缩略图文件存储路径（null 表示存储在视频文件所在目录）	`String`	yes
`imageFormat`	输出图像格式	`ImageFormat`	yes
`maxHeight`	最大高度（0 表示原始分辨率）	`int`	yes
`maxWidth`	最大宽度（0 表示原始分辨率）	`int`	yes
`timeMs`	从指定毫秒位置生成缩略图	`int`	yes
`quality`	图像质量（0-100，PNG 格式忽略）	`int`	yes