fc_native_video_thumbnail

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin Flutter que gera miniaturas de vídeo usando APIs nativas das plataformas em Android, iOS, macOS e Windows. Ele aproveita funcionalidades de nível do sistema para extrair quadros de vídeos de forma eficiente, garantindo alto desempenho e compatibilidade entre plataformas. O plugin foi projetado para desenvolvedores que precisam criar miniaturas confiáveis sem depender de bibliotecas de processamento de imagens multiplataforma. Integra-se perfeitamente em aplicativos Flutter que exigem pré-visualizações de vídeo ou recursos de navegação de mídia.

Casos de uso

Gerando visualizações de vídeo em galerias de mídia
Criando miniaturas para interfaces de reprodução de vídeo
Construindo interfaces de upload ou edição de vídeo
Habilitar extração rápida de metadados de vídeo
Suporte ao índice de conteúdo de vídeo off-line

Principais recursos

Usa APIs nativas para desempenho ideal
Suporte multiplataforma (Android, iOS, macOS, Windows)
API simples para extração de quadros
Geração de miniaturas de alta qualidade
Sobreposição mínima de dependência

Indicado para

Desenvolvedores de aplicativos de mídia
Aplicações de streaming de vídeo
sistemas de gerenciamento de conteúdo
Ferramentas educacionais ou criativas
Aplicativos com recursos de biblioteca de vídeo

Considerações

Requer permissões específicas da plataforma no Android e no iOS
Pode ter resultados variáveis com base no codec de vídeo ou formato
Personalização limitada da saída de miniaturas
Depende da disponibilidade do SDK nativo
Não adequado para geração em tempo real de miniaturas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A Flutter plugin to create video thumbnails via native APIs.

	iOS	Android	macOS	Windows	Linux
Source (Path)	✅	✅	✅	✅	✅
Source (Uri)	✅	✅	✅	-	-
Seeking	✅	⚠️	✅	-	✅

⚠️ Android seeking is only supported when the source file is a Uri.

Linux requires libavformat, libavcodec, libavutil, libswscale (FFmpeg) and libjpeg installed on the system.

Usage

saveThumbnailToFile saves the thumbnail to a file path.
- Returns true if thumbnail was successfully created. Or false if thumbnail is not available.
- Throws if error happens during thumbnail generation.
saveThumbnailToBytes returns the thumbnail as a byte array.
- Returns the thumbnail as bytes if successfully created. Or null if thumbnail is not available.
- Throws if error happens during thumbnail generation.

Example:

final plugin = FcNativeVideoThumbnail();

try {
  /// Extracts a thumbnail from [srcFile] with the given options and saves it to [destFile].
  ///
  /// [srcFile] source video path or Uri (See [srcFileUri]).
  /// [srcFileUri] If true, [srcFile] is a Uri (Android/iOS/macOS only).
  /// [destFile] thumbnail save path.
  /// [width] / [height] max dimensions of the thumbnail image.
  ///   Windows doesn't support non-square thumbnail images, only [width] is used in Windows, resulting in a [width]x[width] max thumbnail.
  /// [format] only "jpeg" is supported. Defaults to "jpeg".
  /// [quality] a fallback value for the quality of the thumbnail image (0-100). May be ignored by the platform.
  /// [at] the time position of the thumbnail.
  ///   Not supported on Windows, or Android if source file is a path.
  final generated = await plugin.saveThumbnailToFile(
            srcFile: srcFile,
            destFile: destFile,
            width: 300,
            height: 300,
            quality: 90);

  // `saveThumbnailToBytes` has the same options as `saveThumbnailToFile` except `destFile`.
  final thumbnailBytes = await plugin.saveThumbnailToBytes(
            srcFile: srcFile,
            width: 300,
            height: 300,
            quality: 90);
} catch (err) {
  // Handle platform errors.
}

Seeking to a specific time position

await plugin.saveThumbnailToFile(
            srcFile: srcFile,
            destFile: destFile,
            width: 300,
            height: 300,
            quality: 90,
            // Seek to 13 seconds to create the thumbnail.
            at: FcVideoThumbnailTime(13, .seconds),
// Supported units:
// .seconds
// .milliseconds
// .microseconds
);

Buscar pacotes, repositórios e categorias de apps