🎞️
GitHub Pull Request に添付した動画が途中で止まる問題は `?raw=true` オプションで解決！
GitHub の Pull Request に動画（例: .mov や .webm）を添付したときに、
「動画が途中で止まって最後まで見られない」という現象に悩まされたことはありませんか？
これは GitHub 上の動画プレビュー機能の仕組み に起因しています。
解決策：URL に ?raw=true を付ける
GitHub にアップロードしたファイルには、実は「生ファイル（raw）」に直接アクセスするためのオプションがあります。
動画ファイルの URL の末尾に ?raw=true を付けるだけです。
例:
これにより、動画は GitHub の埋め込みプレイヤーを経由せず、ブラウザが直接ファイルを取得して再生 するようになります。
そのため、
- 途中で止まらずほぼ安定して再生できる
- ダウンロード保存しやすい
- 外部プレイヤー（例: VLC, QuickTime）での再生が安定
といったメリットがあります。
原因：GitHub の動画プレビューは内部プレイヤーによる簡易ストリーミング再生
Pull Request 上で動画をクリックすると、その場でプレビュー再生が始まります。
しかし、このプレビューは GitHub が内部で用意した埋め込みプレイヤーを使っており、以下のような制限があります。
- 長い動画や高解像度動画は途中で読み込みが途切れやすい
- 可変フレームレートや
.mov形式など、一部コーデックと相性が悪い - ネットワーク状況やブラウザキャッシュの影響を受けやすい
結果として「途中までしか再生されない」「シークできない」といった不安定さが発生します。
まとめ
- PR 上の動画が不安定に止まるのは、GitHub のプレビュー再生機能の制限が原因
-
?raw=trueを付けて直リンクにすると、安定して最後まで再生できる可能性が高い
Discussion