Add VideoFrameDecoder to support decoding video frames from any source.

[colinrtwhite]

Fixes #687.

This finally adds support for decoding video frame from any source (including the network!) with an important caveat. VideoFrameDecoder creates a short lived file on disk to buffer the source into. This is less performant than decoding the file in memory and it requires enough space on disk to copy the video which could be a problem for very large video files.

VideoFrameFileFetcher and VideoFrameUriFetcher don't have this caveat which is why they're not deprecated. Long term (possibly in the next major version) we'll hopefully be able to remove this limitation on VideoFrameDecoder and deprecate the fetchers.

[colinrtwhite]

This class is basically pulled out entirely from VideoFrameFetcher without changes.

[Jawnnypoo]

We don't need write permissions to do this, right?

[colinrtwhite]

Yep! The cacheDir is free to write to.

[Jawnnypoo]

👍 Great work, I know this is much appreciated from those who need it.

[ultraon]

It doesn't look like a workable solution in conjunction with streaming content urls (mpd - MPEG DASH, m3u8 - HLS), right?

[colinrtwhite]

@ultraon It should work with any format supported by Android as long as the stream is not live and has completed. If you need video frames while the stream is in process I'd use ExoPlayer.

[yehia2030]

it still didn't work with me in compose and this is my example

        val context = LocalContext.current
        Image(
            modifier = Modifier
                .fillMaxWidth()
                .height(200.dp)
                .padding(horizontal = 10.dp),
            painter = rememberAsyncImagePainter(ImageRequest.Builder(LocalContext.current)
                .data(data = "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4")
                .apply(block = {
                 decoderFactory(VideoFrameDecoder.Factory())
                }).build()),
            contentDescription = "test",
        )

or this code

        AsyncImage(
            modifier = Modifier
                .fillMaxWidth()
                .height(200.dp)
                .padding(horizontal = 10.dp),
            model = ImageRequest.Builder(context)
                .data("http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4")
                .apply {  decoderFactory(VideoFrameDecoder.Factory()) }
                .build(),
            contentDescription = null
        )

if there is any solution please let me know

[yehia2030]

after a lot of pain the solution is

        val imageLoader = ImageLoader.Builder(context).build()
        val model = ImageRequest.Builder(LocalContext.current)
            .data(data = "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4")
            .apply(block = {
                decoderFactory(VideoFrameDecoder.Factory())
                videoFrameMillis(50)
                listener(
                    onStart = {println("Start")},
                    onError = { _, result -> println("Error ${result.throwable.message}")},
                    onSuccess = { _, _ ->  println("Success")},
                    onCancel = { println("Cancel") }
                )
                size(100)
            }).build()
        Image(
            modifier = Modifier
                .fillMaxWidth()
                .height(200.dp)
                .padding(horizontal = 10.dp),
            painter = rememberAsyncImagePainter(model, imageLoader = imageLoader,
                onError = {
                println("Error 2 ${it.result.throwable.message}")
            }, onLoading = {
                    println("Loading 2 ")
                }, onSuccess = {
                    println("Success 2${it.result.isSampled} ")

                }),
            contentDescription = "test"
        )
        LaunchedEffect(key1 = true) {
            imageLoader.execute(model)
        }

[yehia2030]

could we make a buffer of something like that as if the video is long it takes too much time to load the image ? as i think it loaded the fully video then get its thumbnail