Create From Video

import android.net.Uri
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.withContext
import ly.img.engine.DesignBlock
import ly.img.engine.DesignBlockType
import ly.img.engine.Engine

private const val SAMPLE_VIDEO_URI = "https://img.ly/static/ubq_video_samples/bbb.mp4"

suspend fun createSceneFromVideoURL(engine: Engine): DesignBlock = withContext(Dispatchers.Main) {
    val videoRemoteUri = Uri.parse(SAMPLE_VIDEO_URI)
    val scene = engine.scene.createFromVideo(videoUri = videoRemoteUri)

    // Find the automatically added graphic block in the scene that contains the video fill.
    val block = engine.block.findByType(type = DesignBlockType.Graphic).first()
    engine.block.setOpacity(block = block, value = 0.5F)

    val page = engine.scene.getPages().first()

    val duration = engine.block.getDuration(block = page)

    if (engine.block.supportsPlaybackTime(block = page) && duration >= 1.0) {
        engine.block.setPlaybackTime(block = page, time = 1.0)
        engine.block.setPlaying(block = page, enabled = true)
        engine.block.setPlaying(block = page, enabled = false)
    }

    scene
}

Starting from an existing video lets you build editors for customizing video content — trimmers, overlay editors, or upload-and-edit flows. Create a scene from a single video with engine.scene.createFromVideo().

This guide covers creating a scene from a video and reaching the video block to adjust its properties.

Create a Scene From a Video URL#

Pass a video Uri to engine.scene.createFromVideo(). The URI can point to a local file, a content URI, or a remote resource that your Android app can access. The call loads the video and returns a handle to the new scene.

val videoRemoteUri = Uri.parse(SAMPLE_VIDEO_URI)
val scene = engine.scene.createFromVideo(videoUri = videoRemoteUri)

When you start from a video, the scene’s page dimensions match the resource, the scene uses pixel design units, and it is set up for time-based editing.

Work With the Video Block#

CE.SDK places the video inside a graphic block that carries a video fill. Retrieve it with engine.block.findByType(DesignBlockType.Graphic), which returns every graphic block in the scene. A scene created from a single video contains one graphic block, so the first result is the video block. From there, modify the block like any other element — for example, change its opacity with engine.block.setOpacity().

// Find the automatically added graphic block in the scene that contains the video fill.
val block = engine.block.findByType(type = DesignBlockType.Graphic).first()
engine.block.setOpacity(block = block, value = 0.5F)

See Blocks for the full Block API. The page also exposes playback state, so editor UIs can connect the same scene to trimming, seeking, and playback controls in the dedicated video guides.

API Reference#

Methods#

Next Steps#

• Blocks — Edit blocks, layout, and properties in the scene
• Saving Scenes — Persist your scene and reload it later
• Insert Videos — Add and configure additional video blocks programmatically
• Control Audio and Video — Trim, seek, and control video and audio playback