影片影格
此功能僅適用於 Android。
若要新增影片影格支援,請匯入擴充程式庫:
kotlin
implementation("io.coil-kt.coil3:coil-video:3.6.3")Coil 會透過其 service loader 自動註冊 VideoFrameDecoder.Factory。如果您已停用 service loading,請將該工廠新增至 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) // 擷取影片長度中間的影格
}如果未指定影格位置,則會解碼影片的第一個影格。
