Interface: MediaItemReference

Describes how to fetch a media item from a given provider.

The provider resolves the media item by its id. When an item is supplied, its properties are merged on top of the fetched result, allowing callers to override individual fields such as title or poster.

Properties

id

id: string

Media item ID used by the provider to look up the content.

provider

provider: "glomex" | MediaItemProvider | "joyn" | "external"

Provider that is responsible for resolving this media item.

environment?

optional environment: "stage" | "prod"

Target environment for the provider request.

Default Value

'prod'

item?

optional item: MediaItem

Optional partial media item whose properties are merged on top of the data returned by the provider, allowing individual fields to be overridden.

Required when the provider is external, since there is no remote source to fetch the media item from.