ContentStoreItem class Content

A single downloadable content product managed by the ContentStore.

This class models one content product (for example: a map/region, style, or voice pack). Do not construct instances directly; obtain items from the public ContentStore API.

The object exposes identification and localized display text, content type and language, size and downloaded-size metrics, availability/status and progress indicators, preview imagery, additional content-specific parameters and update metadata (version and update size).

Use this object to start/pause/cancel downloads, query state, access previews and delete local content.

Properties

availableSize → int
The size in bytes currently available (downloaded) on the client.
no setter
canDeleteContent → bool
Whether the local content associated with this item can be deleted.
no setter
chapterName → String
Get the product chapter name translated to interface language.
no setter
clientVersion → Version
The locally installed Version of the content.
no setter
contentParameters → ContentParameters?
Additional content-specific parameters if present.
no setter
countryCodes → List<String>
Get the country code (ISO 3166-1 alpha-3) list of the product as text.
no setter
downloadProgress → int
Current download progress for this item.
no setter
fileName → String
Get the full path to the local content data file when available.
no setter
hashCode → int
The hash code for this object.
no setterinherited
hasRegisteredAutoReleaseObject ↔ bool
getter/setter pairinherited
id → int
Get the unique id of the item in the content store.
no setter
imgPreview → Img
Get the image as a Img.
no setter
isCompleted → bool
Whether the content item is fully downloaded.
no setter
isImagePreviewAvailable → bool
Whether a preview image for this content item is available on the client.
no setter
isUpdatable → bool
Whether a newer version of this item is available in the content store.
no setter
language → Language?
Get the language of the product.
no setter
name → String
Get the name of the associated product.
no setter
pointerId → int
The pointer ID of the native object
no setterinherited
progressListener → ProgressListener?
Returns the currently registered progress listener for this item, if any.
no setter
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
status → ContentStoreItemStatus
Current status of the content item.
no setter
totalSize → int
The total size of the content in bytes.
no setter
type → ContentType
Get the content type of the product.
no setter
updateItem → ContentStoreItem?
Return the ContentStoreItem that represents an in-progress update for this item.
no setter
updateSize → int
The size in bytes of an available update for this item.
no setter
updateVersion → Version
The Version object describing an available update for this item.
no setter

Methods

asyncDownload(void onComplete(GemError err), {void onProgress(int progress)?, bool allowChargedNetworks = false, DataSavePolicy savePolicy = DataSavePolicy.useDefault, ContentDownloadThreadPriority priority = ContentDownloadThreadPriority.defaultPriority}) → ProgressListener
Start or resume an asynchronous download of the content product.
cancelDownload() → GemError
Cancel an ongoing download and remove any partially downloaded data.
deleteContent() → GemError
Delete the local content data for this item.
dispose() → void
Disposes the native object.
inherited
getContentParametersAs<T extends ContentParameters>() → T?
Typed accessor for contentParameters that avoids explicit casts.
getImagePreview({Size? size, ImageFileFormat? format}) → Uint8List?
Retrieve the raw preview bytes for this item if available.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
pauseDownload({void onComplete(GemError)?}) → GemError
Pause a running or previously started download.
registerAutoReleaseObject(int pointerId) → void
Registers an object for auto release.
inherited
setProgressListener(void onComplete(GemError err), void onProgress(int progress)?) → ProgressListener?
Replace the current progress listener for this item.
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited