Zenn
🚀

RustとFFmpegで動画ウォーターマークを追加：技術解説と実践ガイド

に公開
Rust
video
Audio
FFmpeg
media
tech

はじめに

ショートビデオ、ライブ配信、映画制作などの分野では、動画ウォーターマークは著作権保護、ブランド認知度の向上、または法令遵守のために一般的に使用されています。しかし、開発者がウォーターマークを追加する際に直面する課題は以下の通りです：

  • 手動処理の効率の低さ：Photoshopなどの画像編集ソフトで一つずつウォーターマークを追加するのは、大量のタスクに対応できません。
  • FFmpegコマンドラインの複雑さ：引数が多く、デバッグが難しいため、自動化プロセスに統合しづらい。
  • FFmpeg C APIの直接呼び出し：メモリ管理や型変換が複雑で、エラーが発生しやすく、開発効率が低い。
  • Rustエコシステムの相互運用性問題：FFI経由でFFmpegを呼び出す際、リソースを手動で管理する必要があり、Rustの安全性哲学に反する。

本記事では、RustとFFmpegを組み合わせて、効率的かつ安全に動画ウォーターマークを追加する方法を解説します。技術背景、コード例、シーン分析を通じて、開発者がこのスキルを習得し、実際のニーズに対応できるようにします。

シーン分析と技術要件

動画ウォーターマークの追加は、シーンによって異なる技術要件があります：

  1. ショートビデオプラットフォーム：

    • 要件：ユーザーがアップロードした動画に自動でブランドウォーターマークを追加。
    • 課題：動画の解像度が多様で、ウォーターマークの位置とサイズを動的に調整する必要がある。大量処理を効率的に行う必要がある。

  2. ライブストリーム：

    • 要件：リアルタイムで配信者IDやウォーターマークを重ねて、不正配信を防ぐ。
    • 課題：低遅延が求められ、パフォーマンスの最適化が必要。長時間の安定稼働が求められる。

  3. 映画制作：

    • 要件：サンプル動画に一時的なウォーターマークを追加し、透明度やアニメーション効果をサポート。
    • 課題：高い視覚効果が求められ、複数のエンコード形式に対応。カスタマイズの要求が多く、頻繁な調整が必要。

これらのシーンから、開発者はFFmpegの強力な機能を活用しつつ、Rustでシンプルかつ安全なソリューションを必要としていることがわかります。

依存関係のインストール

ウォーターマークの追加を実装する前に、以下の依存関係がインストールされていることを確認してください：

1. FFmpegのインストール

  • macOS：

    brew install ffmpeg

  • Windows：

    vcpkg install ffmpeg
# 初めてvcpkgを使用する場合は、環境変数 VCPKG_ROOT を設定する必要があります

2. Rustの依存関係を追加

RustプロジェクトのCargo.tomlを編集し、ez-ffmpegを追加：

[dependencies]
ez-ffmpeg = "*"

技術実装：FFmpegコマンドラインからRustコードへ

簡単な例として、動画input.mp4に左上隅にウォーターマークlogo.pngを追加し、output.mp4を出力します。

FFmpegコマンドラインでの実装

FFmpegはフィルター機能を使ってウォーターマークを追加します：

ffmpeg -i input.mp4 -i logo.png -filter_complex "[1:v]scale=100:-1[wm];[0:v][wm]overlay=10:10" output.mp4
  • パラメータの解析：
    • [1:v]scale=100:-1[wm]：ウォーターマークを幅100ピクセルにスケーリングし、高さは自動調整。
    • [0:v][wm]overlay=10:10：ウォーターマークを動画の(10, 10)座標に重ねる。

コマンドラインでの実装はシンプルですが、デバッグが複雑で、プログラム化されたプロセスに統合しづらいです。

Rustでの実装

**ez-ffmpeg**を使えば、Rustでよりエレガントに同じ機能を実現できます：

use ez_ffmpeg::{FfmpegContext, Output};

fn main() {
    let result = FfmpegContext::builder()
        .input("input.mp4")              // 入力動画
        .input("logo.png")              // 入力ウォーターマーク
        .filter_desc("[1:v]scale=100:-1[wm];[0:v][wm]overlay=10:10") // フィルターを設定
        .output(Output::from("output.mp4")) // 出力ファイル
        .build().build().unwrap() // コンテキストを構築
        .start().unwrap() // 処理を開始
        .wait().unwrap(); // 完了を待つ
}

コードの解析と知識ポイント

以下は、コードの技術的な詳細と重要な知識ポイントです：

  1. 入力とストリーム管理：

    • .input("input.mp4") と .input("logo.png") で動画とウォーターマークを読み込む。
    • フィルター内では、[0:v] は最初の入力のビデオストリームを、[1:v] は2番目の入力のビデオストリームを表す。

  2. FFmpegフィルターの構文：

    • .filter_desc("[1:v]scale=100:-1[wm];[0:v][wm]overlay=10:10")：
      • [1:v]scale=100:-1[wm]：ウォーターマークを幅100ピクセルにスケーリングし、高さは自動調整。
      • [0:v][wm]overlay=10:10：ウォーターマークを動画の(10, 10)座標に重ねる。
    • 拡張知識：FFmpegフィルターは透明度（format=yuva420p）や動的効果（enable='between(t,5,10)'）などの高度な操作をサポート。

  3. Rustの安全性：

    • FfmpegContext はFFmpegリソースの割り当てと解放を自動管理し、メモリリークを防ぐ。
    • Result 型を使用してエラー処理を強制し、コードの堅牢性を高める。

  4. パフォーマンスの考慮：

    • FFmpegのコア計算はCで実装されており、高いパフォーマンスを発揮。
    • Rustはパラメータの受け渡しとリソース管理のみを担当し、オーバーヘッドは極めて低い。

応用：ウォーターマークの位置をカスタマイズ

ウォーターマークを右下隅に配置するには、overlayパラメータを調整します：

.filter_desc("[1:v]scale=100:-1[wm];[0:v][wm]overlay=W-w-10:H-h-10")
  • W と H は動画の幅と高さを表し、w と h はウォーターマークの幅と高さを表す。
  • W-w-10 と H-h-10 でウォーターマークを右下隅に配置。

まとめ

RustとFFmpegを組み合わせることで、開発者は動画ウォーターマークの追加を効率的かつ安全に実現でき、ショートビデオのバッチ処理やライブ配信でのリアルタイムオーバーレイなど、さまざまなシーンに対応できます。**ez-ffmpeg**はシンプルなインターフェースを提供し、FFmpegの複雑なAPIに深く入り込むことなくタスクを完了できるため、Rustの安全性と簡潔さを維持します。

🔗 オープンソースプロジェクト：ez-ffmpeg!

Discussion