Returns a single media using a specific MediaConnector.
The connector needs to list detail as a supported capability.
Media item
unique id of the Media connector
unique id of the Media
context that will be available in the connector script.
The combination of a connectorId and mediaId is typically enough for a media connector to
perform the download of this asset. The download endpoint is capable of relaying this information to the
media connector instance running in the editor engine.
unique id of the media connector
unique id of the media to download
hint to the media connector about desired quality of the downloaded media
context that will be available in the connector script.
This method returns what capabilities the selected connector has. It gives an indication what methods can be used successfully for a certain connector.
MediaConnectorCapabilities
unique id of the media connector
All connectors have a certain set of mappings they allow to be passed into the connector methods their context. This
method allows you to discover which mappings are available for a given connector. If you want to use any of these
mappings, they will be available in the context parameter of any connector method.
connector mappings
unique id of the media connector
This method will parse the deprecatedMediaDownloadType to the new media download type. This method will be removed once the deprecatedMediaDownloadType is out of use
MediaDownloadType
legacy download type
This method will parse the deprecatedMediaType to the new media type. This method will be removed once the deprecatedMediaType is out of use
connector capabilities
is 0 or 1
Query a specific MediaConnector for data using both standardized queryOptions and the dynamic context as parameters. This call returns an array of Media items.
array of Media items
unique id of the media connector
stringified instance of QueryOptions
context that will be available in the connector script.
Generated using TypeDoc
The MediaConnectorController is responsible for all communication regarding media connectors. Methods inside this controller can be called by
window.SDK.mediaConnector.{method-name}The way GraFx Studio handles different sources of media is called 'MediaConnector'. A MediaConnector is an implementation of a set of capabilities we need to interact with a certain Digital Asset Management system. In essence, a connector is the combination of a JavaScript snippet and some metadata. The JavaScript snippet is loaded in the studio engine using a sandboxed JavaScript execution engine (QuickJs). This allows us to execute the media connector both on web using webassembly and on the server side during e.g. animation output generation. This controller is an interface to the running connector instance inside the studio engine.