オーディオマーク

スタンドアロンの音声ファイル — BGM またはボイスオーバー — を動画にオーバーレイします。audio-mark にリモートの音声ファイルを指定すると、Imgix がそれを取得・ウィンドウ処理・フェード処理し、元のサウンドトラックの下にミックスするか、完全に置き換えます。

audio-mark は絶対 URL または audio-mark-base からの相対パスを受け付けます。

soundtrack はフレンドリーエイリアスです。 すべての audio-mark* パラメータは soundtrack* のスペルも受け付けます — soundtrack=music.mp3、soundtrack-volume=0.4、soundtrack[1] など。両方の形式はレンダリングおよびキャッシュの前に1つの正規名に正規化されるため、同じキャッシュエントリを共有します。

レイヤリング

最大 4レイヤー をサポートします。ベアの audio-mark パラメータはレイヤー 0 です。追加レイヤーには audio-mark[1]、audio-mark[2]、audio-mark[3] を使用します。URL が解決できないレイヤーは無視されます。すべてのレイヤーパラメータは同じ [N] サフィックスを受け付けます。

URL を値とするすべてのパラメータには Base64 ツイン (audio-mark64、audio-mark64[1]) があり、予約文字を含む URL に使用できます。

スコープ

音声オーバーレイは MP4、HLS/DASH、および音声のみ出力 (fm=m4a/mp3/wav) に適用されます。音声パスのない出力 — GIF、静止画サムネイル、スプライトシート、プレビュー、VTT — では無視されます。

音声トラックのないソースに audio-mark を追加すると、無音のベッドを合成してその上にオーバーレイをミックスするため、出力に音声トラックが追加されます。

レンダリングのトリガー。 audio-mark 単独ではレンダリングが実行されません。fm=mp4、fm=hls、fm=dash、または音声のみ出力 fm=m4a/mp3/wav も指定してください。

ソフト失敗

audio-mark URL の取得に失敗・サイズ上限超過・音声ファイル以外の場合、そのレイヤーはドロップされてレンダリングが続行されます。replace モード (audio-mark-mode=replace) の場合、唯一のオーバーレイがドロップされると元の音声が維持されます。