Videog Player 4.0 利用ガイド
動画の埋め込みから、共有・ダウンロード・字幕・目次の設定、開発者向けオプションまで。 3.0 系の使い方はそのまま動きます(後方互換)。
埋め込む — コピー&ペーストだけ
動画ごとの視聴ページがそのまま使えます。自社サイトへ埋め込む場合は、プレーヤー右下の共有ボタン → 埋め込みコードをコピーして、HTML に貼り付けるだけです。
<iframe src="https://console.videog.ai/player/あなたの動画ハッシュ/"
width="640" height="360" frameborder="0"
allow="autoplay; fullscreen; picture-in-picture; encrypted-media"
allowfullscreen></iframe>管理画面で設定した視聴制限(ID/パスワード・ドメイン・IP・視聴期限)はそのまま効きます。 埋め込み先を増やしても、守りの設定は動画側で一元管理されます。
再生開始位置を URL で指定する
視聴ページ・埋め込みどちらも、URL パラメータで開始位置を指定できます(YouTube と同じ書式)。 共有パネルの「開始位置から」にチェックを入れると、この形式のリンクを自動で作れます。
| 書き方 | 意味 |
|---|---|
?t=95 | 95秒地点から再生 |
?t=1m35s | 1分35秒地点から再生(h / m / s 表記に対応) |
?start=95 | 同上(t と両方あるときは start 優先) |
管理画面の設定が、そのままプレーヤーの機能になる
プレーヤーのボタンは、動画ごとの設定に連動して自動で出し分けられます。ページ側の作業は不要です。
| 機能 | 設定場所 | プレーヤーでの動き |
|---|---|---|
| 共有ボタン | 動画設定「共有」 | リンクコピー・開始位置つきリンク・LINE / X / Facebook / メール・埋め込みコードのモダンな共有パネルを表示 |
| 動画ダウンロード | 動画設定「ダウンロード」 | 最高画質の MP4 を安全にダウンロード。リンクは期限付き署名 URL で、プレーヤーを通さない直リンクは無効 |
| 資料ダウンロード | Eラーニング「配布資料」 | その動画に紐づけた資料(複数なら ZIP)をダウンロード。ボタンのラベル文言もカスタマイズ可能 |
| 字幕 | 動画設定「字幕」 | AI字幕・アップロードした VTT を表示。「デフォルト表示」を ON にすると最初から字幕つきで再生 |
| シーク禁止 | 動画設定「シーク禁止」 | シークバー操作と早送りを無効化(飛ばし見防止)。操作時のメッセージも指定可能 |
| 目次(チャプター) | 動画設定「チャプター」 | 「0:00 タイトル」形式の目次メニューから任意の位置へジャンプ |
| Eラーニング資料連動 | Eラーニング「スライド」 | 再生位置に合わせて資料を自動でページ送り。資料大+動画上 / 動画大+目次 など 7 パターンの配置を視聴者が切替可能 |
視聴者の操作(4.0 の標準機能)
| 操作 | 内容 |
|---|---|
| 倍速再生 | 0.5〜2.0倍。スマホは画面長押しで一時的に倍速(離すと戻る) |
| 10秒送り / 戻し | ボタンまたはスマホで画面の右側 / 左側をダブルタップ |
| 画質選択 | マルチビットレート配信のとき、1クリックで画質一覧から切替 |
| シークプレビュー | シークバーにマウスを重ねると、その位置のサムネイルを表示(サムネイルはアップロード時に自動生成) |
| ピクチャーインピクチャー | 小窓表示にして、別の作業をしながら再生 |
| 目次ジャンプ | 目次メニューから章の頭出し。時刻つきで一覧表示 |
| 全画面 / 音量 | 従来どおり。音量はホバーで縦スライダー表示 |
デザインは 10 種類のスキンから選べます(light 系 5・hard 系 3・スケルトン系 2)。 4.0 では全スキンで背景が透過になり、埋め込み先ページに自然に馴染みます。
開発者向け — JavaScript から直接使う
自社ページで JS から直接プレーヤーを組み立てることもできます。3.0 で使えたオプションは名前・型とも そのままです。4.0 の新オプションはすべて追加式で、指定しなければ従来どおり動きます。
<link rel="stylesheet" href="https://cf-rsc01.videog.jp/r/js/videog_player/4.0.0/videogplayer.css">
<script src="https://cf-rsc01.videog.jp/r/js/videog_player/4.0.0/videogplayer.js"></script>
<div id="player"></div>
<script>
videogplayer({
id: 'player',
skin: 'light_blue',
play_list: [{ file: 'https://…/master.m3u8', title: '動画タイトル' }],
btn_chapters: [{ start: 0, title: 'はじめに' }, { start: 95, title: '本編' }],
btn_share: { heading: '共有', sites: ['line', 'facebook', 'twitter', 'email'] },
});
</script>4.0 で追加された主なオプション
| オプション | 型 | 説明 |
|---|---|---|
btn_chapters | 配列 | 目次。[{start: 秒, title: '章名'}] を渡すと目次メニューと章バーを表示 |
double_tap_seek | 真偽 | スマホのダブルタップ10秒送り/戻し。false で無効化(既定: 有効) |
btn_seek_disable | オブジェクト | シーク禁止。{message: '表示文言'} で操作時メッセージを指定 |
play_list[].captions | オブジェクト | 字幕。{list: [{url, label, default}]} の VTT リスト。default: true で初期表示 |
seek_sprite | オブジェクト | シークプレビュー。{url, tile} でスプライト画像とコマ情報を指定 |
elearning | オブジェクト | 資料連動。{slides, cues, chapters, layout} を渡すと資料レイヤーを表示 |
play_list[].slides | 配列 | スライドキャスト。音声(MP3)+画像を時刻同期で再生 |
btn_share.sites | 配列 | 共有先。4.0 で 'line' を追加('facebook' / 'twitter' / 'email' は従来どおり) |
skin | 文字列 | skeleton_vidstack (スケルトンブラック) / skeleton_white を追加(従来 8 スキンも継続) |
3.0 から使える全オプション(autostart / mute / repeat / btn_video_download / btn_document_download / completed_jump / active_color ほか約30種)の一覧は プレーヤードキュメントを参照してください。
※ ボタンのラベル文言(btn_document_download.text 等)はテキストとして表示されます(HTML は解釈されません)。 3.0 でラベルに HTML タグを入れていた場合、4.0 ではタグがそのまま文字として表示されます(セキュリティ強化のための意図的な変更です)。
AI・MCP クライアント向け(機械可読版)
このページの全仕様(全オプションの型・既定値・API 契約・後方互換の保証)を 1 ファイルの Markdown にまとめた機械可読版を公開しています。AI にレビュー・実装させる際は、こちらの URL をそのまま渡してください。