Skip to main content

canCopyAudioTrack()

warning

我们正在逐步淘汰 Remotion WebCodecs，并转向 Mediabunny！

属于 @remotion/webcodecs 软件包的一部分.

🌐 Part of the @remotion/webcodecs package.

warning

不稳定的 API：此软件包处于实验阶段。在我们移除此提示之前，API 可能随时更改。

给定一个 AudioTrack，确定它是否可以在不重新编码的情况下复制到输出。

🌐 Given an AudioTrack, determine if it can be copied to the output without re-encoding.

你可以使用 parseMedia() 获取 AudioTrack，或者在使用 convertMedia() 的 onAudioTrack 回调的转换过程中获取。

🌐 You can obtain an AudioTrack using parseMedia() or during the conversion process using the onAudioTrack callback of convertMedia().

示例​

🌐 Examples

Check if an audio track can be copied
import {parseMedia} from '@remotion/media-parser';
import {canCopyAudioTrack} from '@remotion/webcodecs';

const {tracks, container} = await parseMedia({
  src: 'https://remotion.media/BigBuckBunny.mp4',
  fields: {
    tracks: true,
    container: true,
  },
});

const audioTracks = tracks.filter((t) => t.type === 'audio');

for (const track of audioTracks) {
  canCopyAudioTrack({
    inputCodec: track.codecEnum,
    outputContainer: 'webm',
    inputContainer: container,
    outputAudioCodec: null,
  }); // bool
}
Copy an audio track to Opus, otherwise drop it
import {convertMedia, canCopyAudioTrack} from '@remotion/webcodecs';

await convertMedia({
  src: 'https://remotion.media/BigBuckBunny.mp4',
  container: 'webm',
  videoCodec: 'vp8',
  audioCodec: 'opus',
  onAudioTrack: async ({track, outputContainer, inputContainer}) => {
    const canCopy = canCopyAudioTrack({
      inputCodec: track.codecEnum,
      outputContainer,
      inputContainer,
      outputAudioCodec: null,
    });

    if (canCopy) {
      return {type: 'copy'};
    }

    // Just to keep the example brief, in reality, you would re-encode the track here
    return {type: 'drop'};
  },
});

应用编程接口​

🌐 API

inputCodec​

字符串 MediaParserAudioCodec

🌐 string MediaParserAudioCodec

输入音轨的编解码器。

🌐 The codec of the input audio track.

inputContainer​

字符串 MediaParserContainer

🌐 string MediaParserContainer

输入媒体的容器格式。

🌐 The container format of the input media.

outputContainer​

字符串 ConvertMediaContainer

🌐 string ConvertMediaContainer

输出媒体的容器格式。

🌐 The container format of the output media.

outputAudioCodec​

字符串 | 空 ConvertMediaAudioCodec

🌐 string | null ConvertMediaAudioCodec

输出媒体所需的音频编解码器。如果是 null，则表示你不关心音频编解码器，只要可以复制即可。

🌐 The desired audio codec of the output media. If null, it means you don't care about the audio codec as long as it can be copied.

返回值​

🌐 Return value

返回一个 boolean。

🌐 Returns a boolean.

另请参阅​

🌐 See also

Last updated on