Skip to main content
Language:

Deserialization

VideoEditor SDK supports serialization and deserialization, allowing your users to save and revise their work at any time. Deserialization requires the backend:serializer module. Refer to our documentation on how to include the module in your project.

Restoring a settings file#

For the sake of this example, we load a video from the resources into the video editor.

To restore an editor instance to a previous state, we read the serialization from a JSON file using the IMGLYFileReader.readJson() method. Since reading a file is an IO Operation, we do this inside of a coroutine on the IO Dispatcher.

The IMGLYFileReader.readJson() method is overloaded to also accept a String or a ByteArray to read into a SettingsList.

File:
class VideoDeserialization(private val activity: AppCompatActivity) : Example(activity) {
override fun invoke() {
// In this example, we need access to the Uri(s) after the editor is closed
// so we pass true in the constructor
val settingsList = VideoEditorSettingsList(false)
// Set the source as the Uri of the video to be loaded
.configure<LoadSettings> {
it.source = activity.resourceUri(R.raw.skater)
}
activity.lifecycleScope.launch {
withContext(Dispatchers.IO) {
val file = File(activity.getExternalFilesDir(null), "vesdk.json")
if (file.exists()) {
try {
// Deserialize JSON file and read it into SettingsList
IMGLYFileReader(settingsList).readJson(file)
} catch (e: IOException) {
withContext(Dispatchers.Main) {
showMessage("Error reading serialisation")
}
}
} else {
withContext(Dispatchers.Main) {
showMessage("Serialisation file not found")
}
}
}
// Start the video editor using VideoEditorBuilder
// The result will be obtained in onActivityResult() corresponding to EDITOR_REQUEST_CODE
VideoEditorBuilder(activity)
.setSettingsList(settingsList)
.startActivityForResult(activity, EDITOR_REQUEST_CODE)
// Release the SettingsList once done
settingsList.release()
}
}
override fun onActivityResult(requestCode: Int, resultCode: Int, intent: Intent?) {
super.onActivityResult(requestCode, resultCode, intent)
intent ?: return
if (requestCode == EDITOR_REQUEST_CODE) {
val result = EditorSDKResult(intent)
when (result.resultStatus) {
EditorSDKResult.Status.CANCELED -> showMessage("Editor cancelled")
EditorSDKResult.Status.EXPORT_DONE -> showMessage("Result saved at ${result.resultUri}")
else -> {
}
}
}
}