🎥 Make videos programmatically with React
const PRORES_DOCS_URL = 'https://www.remotion.dev/docs/videos/prores';
// Message shown when @remotion/media encounters a ProRes source but the
// ProRes decoder has not been registered. Kept specific so users don't
// confuse decoding a ProRes *source* (this case) with exporting to ProRes.
export const proresDecoderNotEnabledMessage = (src: string) => {
return (
`Cannot decode "${src}": it is encoded with Apple ProRes, which WebCodecs does not support natively. ` +
`ProRes decoding is not enabled by default. Register the ProRes decoder by calling ` +
`registerProresDecoder() from "@mediabunny/prores" in your entry point, before registerRoot(). ` +
`See ${PRORES_DOCS_URL}.`
);
};
// Thrown when @remotion/media cannot decode a ProRes source because the decoder
// is not registered. This is an unrecoverable error: unlike a generic decode
// failure it must NOT fall back to <OffthreadVideo> (rendering) or a native
// <video> (preview), because neither can decode ProRes. Registering the decoder
// is the only fix. The error type lets the fallback handlers recognize it and
// rethrow instead of silently falling back.
export class ProResDecoderNotEnabledError extends Error {
constructor(src: string) {
super(proresDecoderNotEnabledMessage(src));
this.name = 'ProResDecoderNotEnabledError';
}
}