カスタム埋め込みプレーヤー
AVCaptionの埋め込みプレーヤーは、自分のサイト、LMS、メンバーシップポータル、ブログ記事 — HTMLが動くあらゆる場所に貼れる単一のiframeです。あなたのブランドの見た目で、あなたの動画を再生し、あなたのアクセスルールを尊重します。
カスタマイズできる項目
ブランドカラー — ダッシュボードで1つのアクセントカラーを設定します。プログレスバー、ホバーハイライト、字幕アクセント、再生ボタンがすべて従います。
ロゴウォーターマーク(Premium) — PNGをアップロードします。動画の隅に調整可能な不透明度で表示され、再生中ずっと残ります。
視聴者別動的ウォーターマーク(Enterprise) — 認証された視聴者のメールアドレス、ID、IPアドレスを動画ストリームに焼き込みます。視聴者が画面録画して公開しても、ウォーターマークが本人を特定します。テキストは定期的に位置を変えて、単純なクロップを無効化します。
字幕スタイルプリセット — 書体、サイズ、背景、位置、エッジスタイル。事前作成済みプリセット(Netflix風、YouTube風、アニメhardsub風)またはカスタム。
プレーヤー操作 — 表示する操作を選べます: 再生/一時停止、音量、フルスクリーン、PIP、速度、画質選択、字幕選択、AirPlay、Cast。
autoplay / loop / muteの既定値 — 動画ごとに埋め込みURLパラメータでオーバーライド可能。
ドメインホワイトリスト — iframeをホストできるドメインを正確に指定します。それ以外からのホットリンクは403を受けます。
埋め込みコード
<iframe
src="https://avcaption.com/watch/{your_embed_token}"
frameborder="0"
allow="autoplay; encrypted-media; fullscreen"
allowfullscreen
loading="lazy"
width="100%"
style="aspect-ratio: 16/9"
></iframe>
これだけです。JS依存なし、scriptタグなし、サイトのCSSと衝突なし。Safari、Firefox、Chrome、Edge、モバイルブラウザ、アプリ内Webviewを含む近代ブラウザすべてで描画されます。
きめ細かい制御のためのURLパラメータ
iframeの src にクエリパラメータを付けて、埋め込みごとに既定値を上書きします:
?autoplay=1— ロード時に再生開始(ブラウザの自動再生ポリシーに従う — mutedとの併用推奨)。?muted=1— ミュートで開始(多くのブラウザでautoplayに必須)。?loop=1— 終了時に再開。?start=120— ロード時に120秒地点へシーク。?quality=1080— 特定のバリアントを強制。?subtitle=vi— 字幕言語を事前選択。?controls=0— 全操作を非表示(キオスク用途)。?theme=dark|light— プレーヤーテーマを上書き。
ブラウザサポート
- Chrome / Edge — Media Source Extensions(HLS.js)経由で完全HLS
- Firefox — HLS.js経由で完全HLS
- Safari(デスクトップ + iOS) — ネイティブHLS、JSライブラリ不要
- モバイルChrome(Android) — HLS.js経由で完全HLS
- iOS 16+ — PIP、AirPlay、フルスクリーン含め検証済み
- アプリ内Webview(LMSアプリ、ハイブリッドモバイルアプリ) — 主要プラットフォームで検証済み
パフォーマンス
プレーヤーはHLS.jsを含めて 60KB未満(minified+gzipped) です。ファーストフレームは4Gモバイルで平均600〜900ms、ブロードバンドで300ms未満。CDNキャッシュされたマスタープレイリストと最初のセグメントがクリティカルパスで、AVCaptionはアップロード時に両方を事前ウォーミングします。
他プラットフォームとの比較
- Wistia / Vimeo OTT — マーケティングツールが多く重いプレーヤー。ファーストフレームが遅く、JSペイロードが大きい。
- Mux Player — Wistiaより軽量だが、ウォーターマークやブランディングのUIは自前で構築。AVCaptionはダッシュボードでブランド制御を提供。
- JW Player — 機能完全だがJSペイロードが大きく、SDKはドメインごとのライセンスキーが必要。
- Bunny / CF Stream — 同等に軽量なプレーヤーだが、ブランドカスタマイズの選択肢は少ない。
はじめる
最速の検証方法:フリーアカウントを作成、動画を1本アップロード、Player Settingsでアクセントカラーとロゴを設定、動画詳細ページからiframeをコピー、自分のサイトに貼る。5分以内にブランド対応プレイヤーが動きます。よくある導入例:LMS動画ホスティング、メンバーシップサイト動画、代理店のクライアント動画。