Skip to content

動画フレーム ​

この機能は Android でのみ利用可能です。

動画フレームのサポートを追加するには、拡張ライブラリをインポートします:

kotlin
implementation("io.coil-kt.coil3:coil-video:3.6.3")

Coil はサービスローダーを介して自動的に VideoFrameDecoder.Factory を登録します。サービスローディングを無効にしている場合は、ImageLoader のコンポーネントレジストリにファクトリを追加してください:

kotlin
val imageLoader = ImageLoader.Builder(context)
    .components {
        add(VideoFrameDecoder.Factory())
    }
    .build()

このデコーダーは、MIME タイプが video/ で始まるソースを自動的に処理します。Coil は認識可能なファイル拡張子からこの MIME タイプを推測できます。ソースの MIME タイプが見つからない場合や正しくない場合は、リクエストに対して明示的にデコーダーを設定してください:

kotlin
imageView.load("/path/to/video") {
    decoderFactory { result, options, _ -> VideoFrameDecoder(result.source, options) }
}

動画から抽出するフレームの時間を指定するには、videoFrameMillis または videoFrameMicros を使用します:

kotlin
imageView.load("/path/to/video.mp4") {
    videoFrameMillis(1000)  // 動画の1秒時点のフレームを抽出
}

正確なフレーム番号を指定するには、videoFrameIndex を使用します(API レベル 28 が必要です):

kotlin
imageView.load("/path/to/video.mp4") {
    videoFrameIndex(1234)  // 動画の1234番目のフレームを抽出
}

動画の総再生時間に対するパーセンテージに基づいて動画フレームを選択するには、videoFramePercent を使用します:

kotlin
imageView.load("/path/to/video.mp4") {
    videoFramePercent(0.5)  // 動画の再生時間の中間にあるフレームを抽出
}

フレームの位置が指定されていない場合は、動画の最初のフレームがデコードされます。