Getting Started

설치

AI-assisted 설정을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

다음 명령어를 사용하여 다음 프롬프트를 사용하세요:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-video-thumbnails` plugin in my project.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요:

bun add @capgo/capacitor-video-thumbnails
bunx cap sync

import

import { CapgoVideoThumbnails } from '@capgo/capacitor-video-thumbnails';

API 개요

getThumbnail

특정 시간 위치에서 비디오 파일에서 썸네일 이미지를 생성합니다.

import { CapgoVideoThumbnails } from '@capgo/capacitor-video-thumbnails';

const result = await CapgoVideoThumbnails.getThumbnail({
  sourceUri: 'file:///path/to/video.mp4',
  time: 5000,
  quality: 0.8
});
console.log('Thumbnail URI:', result.uri);
console.log('Dimensions:', result.width, 'x', result.height);

타입 참조

VideoThumbnailsOptions

비디오 썸네일을 생성하는 옵션입니다.

export interface VideoThumbnailsOptions {
  /**
   * The URI of the video file. Can be a local file path or a remote URL.
   * For local files, use file:// protocol or absolute path.
   * For remote files, use http:// or https:// protocol.
   */
  sourceUri: string;

  /**
   * The time position in milliseconds from which to extract the thumbnail.
   * Defaults to 0 (first frame).
   */
  time?: number;

  /**
   * Quality of the generated image, from 0.0 (lowest) to 1.0 (highest).
   * Defaults to 1.0.
   */
  quality?: number;

  /**
   * HTTP headers to include when fetching remote video URIs.
   * Only applicable for remote URLs.
   */
  headers?: Record<string, string>;
}

VideoThumbnailsResult

썸네일 생성 결과입니다.

export interface VideoThumbnailsResult {
  /**
   * The local URI path to the generated thumbnail image.
   * This can be used directly in img tags or Image components.
   */
  uri: string;

  /**
   * Width of the generated thumbnail in pixels.
   */
  width: number;

  /**
   * Height of the generated thumbnail in pixels.
   */
  height: number;
}

진실의 근원

이 페이지는 플러그인의 src/definitions.ts업스트림에서 pubic API이 변경되었을 때 다시 싱크를 실행하세요.

Getting Started에서 계속

Capacitor를 사용 중이라면 Getting Started 자연스러운 미디어 및 인터페이스 동작을 계획하려면 연결하세요. Using @capgo/capacitor-video-thumbnails for native capability in Using @capgo/capacitor-video-thumbnails Using @capgo/capacitor-live-activities for native capability in Using @capgo/capacitor-live-activities @capgo/capacitor-live-activities for implementation detail in @capgo/capacitor-live-activities Using @capgo/capacitor-video-player for native capability in Using @capgo/capacitor-video-player, and @capgo/capacitor-video-player for implementation detail in @capgo/capacitor-video-player.