VModal Android SDK/com.vmodal.sdk/VideoUploadOptions

VideoUploadOptions

data class VideoUploadOptions(val multipart: Boolean = false, val multipartThresholdBytes: Long = 100L * 1024 * 1024, val partSizeBytes: Long = 64L * 1024 * 1024, val maxConcurrency: Int = 4, val maxPartAttempts: Int = 5, val partTimeoutSeconds: Long = 300, val resume: Boolean = true, val sessionStore: UploadSessionStore = UploadSessionStores.memory, val adaptiveConditions: UploadConditions? = null, val videoFilename: String? = null, val metadataText: String? = null, val metadataTags: List<String>? = null, val startDatetimeUser: String? = null, val reProcess: Boolean = false)

Signed-upload policy including retry, resume, cancellation, and explicit multipart behavior. Multipart is never selected implicitly by file size.

Constructors

VideoUploadOptions

constructor(multipart: Boolean = false, multipartThresholdBytes: Long = 100L * 1024 * 1024, partSizeBytes: Long = 64L * 1024 * 1024, maxConcurrency: Int = 4, maxPartAttempts: Int = 5, partTimeoutSeconds: Long = 300, resume: Boolean = true, sessionStore: UploadSessionStore = UploadSessionStores.memory, adaptiveConditions: UploadConditions? = null, videoFilename: String? = null, metadataText: String? = null, metadataTags: List<String>? = null, startDatetimeUser: String? = null, reProcess: Boolean = false)

Types

Companion

object Companion

Shared upload limits.

Properties

adaptiveConditions

val adaptiveConditions: UploadConditions?

optional platform conditions for adaptive tuning

maxConcurrency

val maxConcurrency: Int

maximum parallel parts

maxPartAttempts

val maxPartAttempts: Int

maximum attempts per part

metadataTags

val metadataTags: List<String>?

optional metadata tags sent when finalizing the upload

metadataText

val metadataText: String?

optional metadata text sent when finalizing the upload

multipart

val multipart: Boolean

whether to use multipart upload

multipartThresholdBytes

val multipartThresholdBytes: Long

Retained for source compatibility. Upload strategy is never selected by file size.

partSizeBytes

val partSizeBytes: Long

target bytes per multipart part

partTimeoutSeconds

val partTimeoutSeconds: Long

timeout for each part

reProcess

val reProcess: Boolean

whether the uploaded video should be processed again

resume

val resume: Boolean

whether to resume a compatible checkpoint

sessionStore

val sessionStore: UploadSessionStore

multipart checkpoint store

startDatetimeUser

val startDatetimeUser: String?

offset-aware CCTV footage start time

transcoder

var transcoder: VideoTranscoder

Pre-upload transcoder. The default performs no transcoding. An Android app injects its own device transcoder here, for example options.transcoder = Media3TransformerTranscoder(ctx). Kept outside the primary constructor to preserve binary compatibility of this data class.

videoFilename

val videoFilename: String?

canonical CCTV filename sent when finalizing the upload

Functions

resolvedFor

fun resolvedFor(size: Long): VideoUploadOptions

Applies the optional adaptive policy without mutating this value. Preserves transcoder.

validate

fun validate(size: Long)

Validates the source size and multipart settings.