ビデオフレーム抽出ガイド

ビデオ コーデックとコンテナ: ファイルが開くか失敗する理由

MP4、MOV、WebM、MKV、および AVI はコンテナーを表します。内部の圧縮ビデオ ストリームはコーデックを使用しており、ブラウザのサポートはストリームの詳細とそのブラウザで利用できるオペレーティング システム デコーダの両方に依存します。

最終更新:2026年9月9日
01

コンテナをビデオコーデックから分離する

コンテナは、トラック、タイミング、メタデータ、インデックスをパッケージ化します。コーデックは、ビデオ トラックの圧縮方法とデコード方法を定義します。 ZIP ファイル名を変更してもファイル内のファイルが変換されないのと同様、HEVC ファイルの名前を .mov から .mp4 に変更しても、H.264 には変わりません。

MP4 は通常、H.264、HEVC、または AV1 ビデオを伝送します。 WebM は通常、VP8、VP9、または AV1 を搭載します。 MOV、MKV、AVI にはさまざまな組み合わせを含めることができます。現在の MDN ビデオ コーデック ガイド には一般的なコーデックとコンテナの関係がリストされていますが、実際の再生はプロファイル、ビット深度、ハードウェア、ライセンス、ブラウザのリリースによって異なる場合があります。

これが、拡張リストが可能性の高い入力のみを記述できる理由です。ブラウザで読み取り可能な MP4/H.264 ファイルは、保守的な最初のテストです。正直なブラウザ ツールでは、拡張子を共有するすべてのファイルがデコードされることを保証できません。

02

ランダムな再試行の代わりに診断ラダーを使用する

  • 通常の再生をテストします。 同じブラウザでファイルを直接開きます。再生できない場合、フレーム抽出によってデコーダがそれをサポートすることはできません。
  • 既知の正常なローカル ファイルを試してください。 短い H.264 MP4 または一般的な WebM サンプルにより、サイト全体の問題とソース固有の問題が分離されます。
  • 同じデバイス上で別の現在のブラウザをテストします。 1 つのオペレーティング システム上であっても、ブラウザが異なれば、異なるデコーダ パスが使用される場合があります。
  • 別のデバイスまたはオペレーティング システムをテストします。 これは、ハードウェアまたはプラットフォームのサポートにばらつきがある HEVC 以降のプロファイルに特に役立ちます。
  • ストリーム メタデータを検査します。 ローカル メディア インスペクターは、コーデック名、プロファイル、レベル、ピクセル フォーマット、ビット深度、サイズ、フレーム レート モード、および継続時間を明らかにできます。
  • 互換性のある派生物を作成します。 信頼できるローカル ツールを使用してコピーのみをトランスコードし、オリジナルを記録ソースとして保存します。
03

よくある失敗パターンを認識する

ブラウザではこの形式はサポートされていないと表示されます

コンテナまたはプライマリ ビデオ トラックには利用可能なデコーダがない可能性があります。コーデック ファミリがサポートされているように見えても、高ビット深度、特殊なクロマ フォーマット、高度なプロファイル、またはコーデックのライセンス境界が重要になる場合があります。

再生は機能しますが、シークは信頼できません

ファイルには、まばらなキーフレーム、不完全なインデックス、異常なタイムスタンプ、または破損したメタデータが含まれている可能性があります。順方向再生は順番にデコードするため成功しますが、ランダム アクセスはタイミングとインデックス情報に依存します。

最初のフレームは機能しますが、後のフレームは失敗します

セグメントの破損、タイムスタンプの不連続、メモリ負荷、またはストリーム後半のデコード エラーが原因である可能性があります。障害の周囲でより短い範囲を試し、別のプレーヤーの動作を比較してください。

音声は再生されるが画像が表示されない

コンテナには個別のトラックが搭載されています。ブラウザは、オーディオ コーデックをサポートしていても、ビデオ コーデックまたはそのプロファイルをサポートしていない可能性があります。

04

リモート URL はネットワーク ルールをメディア ルールに追加します

直接 URL は、ブラウザがフェッチしてデコードできるメディアを指している必要があります。共有ページ、クラウド プレビュー ページ、認証されたダウンロード、または HTML 応答は、直接のビデオ ファイルではありません。リモート サーバーは、ツールがビデオをキャンバスに描画するときに、クロスオリジンの使用を許可する必要もあります。そうしないと、再生が可能であるように見えても、ブラウザのセキュリティ ルールによりエクスポートがブロックされる可能性があります。

リダイレクト、署名の期限切れ、バイト範囲サポートの欠如、ホットリンク保護、認証 Cookie、コンテンツ タイプの間違いなどにより、リモート ソースの信頼性がローカル ファイルよりも低くなる可能性があります。使用を許可されているファイルをダウンロードしてローカルで選択すると、これらのネットワーク変数のほとんどが削除されます。

リモート URL が使用される場合、ブラウザはサードパーティのホストに直接接続します。ホストは、IP アドレスやブラウザ ヘッダーなどの通常のリクエスト情報を受信できます。 VideoToImg の プライバシー ポリシー で境界について説明されています。

05

保守的な互換性ターゲットを選択する

主に現在のブラウザを対象とした派生版の場合、MP4 コンテナ内の H.264 ビデオは引き続き広範な互換性のあるベースラインです。一般的な WebM の組み合わせも有用なターゲットです。実際のタスクに適した寸法とフレーム レートを維持します。ソースをより大きな解像度またはより高いフレーム レートに変換しても、視覚情報が失われることはありません。

プライベートな映像の場合は、未知のサービスにアップロードするのではなく、信頼できるローカル コンバーターを使用してください。オリジナルを個別に保存し、タイミングや視覚的な忠実性が重要な場合は変換設定を文書化します。ロスレス ワークフローが意図的に選択されない限り、再エンコードには損失が伴います。そのため、互換性コピーがソース マスターを黙って置き換えるべきではありません。

FFmpeg 形式のドキュメント は、FFmpeg でサポートされるデマルチプレクサーとマルチプレクサーの主なリファレンスですが、コマンド オプションとコーデックの可用性は、インストールされているビルドによって異なります。このサイトはブラウザで FFmpeg を実行せず、同等のフォーマットをカバーしているとは主張しません。

06

再現可能な互換性レポートを作成する

ブラウザの名前とバージョン、オペレーティング システム、ファイル拡張子、コーデックとプロファイル (既知の場合)、サイズ、再生時間、通常の再生が機能するかどうか、抽出が失敗した正確なポイントを記録します。ソースがローカルかリモートか、また小さな既知の正常なファイルが同じセッションで動作したかどうかを示します。

バグを証明するためだけに非公開のソース ビデオを送信しないでください。機密性のない短い複製ファイルまたは完全なメタデータの方が安全であり、多くの場合、より便利です。スクリーンショットまたはログから個人のファイル名、署名付き URL パラメータ、およびアカウント識別子を削除します。

再現可能なレポートを hello@videotoimg.com に送信するか、ビデオから画像へのコンバーター を開いてブラウザーで読み取り可能なローカル ファイルをテストします。