When upgrading to 5.10, the new and improved transcode system is automatically used. The old transcode system can still be used in 5.10 but will be deprecated in later releases.
This page describes the most important things to be aware of in relation to the new transcode system.
EXIF
In previous version of the old transcode system, it was possible to embed EXIF metadata in the generated renditions/transcodes. This is not supported in the new transcode system.
Search2
Search2 allows the tables media_transcode_proxy_destination
and media_transcode_proxy
to be referenced in both input and output, providing access to information about transcodes/renditions. Information about renditions generated with the new transcode system can not be accessed through these tables. If one of these tables is used in a search, it is recommended to start using the API or the SDK to retrieve information about transcodes instead. This can be done using the endpoint <api-url>/DigizuiteCore/LegacyService/api/assets/search
or IAssetSearchService
in the SDK.
Search2 allows URLs for renditions of old media formats to be retrieved with the functions urlAbsolut
, urlRelative
, downloadUrlAbsolut
, and downloadUrlRelative
. It has been ensured that this still works, even if the targeted old media format has been mapped to a new format. If an old media format has not been mapped to a new format, these functions work in exactly the same way as previously.
However, a few caveats should be mentioned in the case where an old media format is mapped to a new format:
A URL is always returned, even though a rendition of the asset in the old media format can not be generated. As an example, this means that a
thumb
URL is included for an asset in the defaultGetAssets
search, even if it can not be generated. Previously, thethumb
URL would be null in this case. Thus, it must be ensured that clients do no rely on the URL in a search to be null when it can’t be generated.If the
urlRelative
ordownloadUrlRelative
function is used, the returned relative URL will be relative to<api-url>
instead of<api-url>/dmm3bwsv3
as it was before.
If the caveats above are addressed, Search2 can still be used to retrieve valid URLs for old media formats that have been mapped to new formats, ensuring that the new transcode system is used. However, we generally recommend starting to rewrite applications that use Search2 to use the API or SDK instead. If this is not possible, it is still possible to opt-out of using the new transcode system by ensuring that no old media formats are mapped to new formats.