プレイヤー呼び出しオプシ ョン (Query String)
お知らせ
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
このドキュメントでは、再生 URL の末尾に Query String パラメーターを追加して、プレイヤーの動作と UI を細かく制御する方法を説明します。
Query String の形式
再生 URL にパラメーターを追加するルールは以下の通りです。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?{KEY}={VALUE}&{KEY2}={VALUE2}
- 区切り文字: URL の末尾に
?を付けます。複数のオプションを連結する場合は&を 区切り文字として使用します。 - フラグ (Flag) 形式: 別途の値 (
VALUE) が不要なオプションは、キー (KEY) のみ入力します。（例:?autoplay&mute） - エンコーディング: パラメーター値に日本語・特殊文字・スペースが含まれる場合は、必ずその値を UTF-8 URL エンコーディング処理して渡してください。
Kollus プレイヤーの種類
| 表記 | プレイヤー名 | 特徴 |
|---|---|---|
| v3e | App Player for Windows | インストール型エージェント方式プレイヤー |
| v3h | HTML5 Player for PC | インストール型 HTML5 エージェント方式プレイヤー |
| v3 | HTML5 Player for PC (Hybrid) | Microsoft Edge または Chrome 45 以上で暗号化コンテンツを再生する際に適用されるハイブリッド HTML5 プレイヤー |
| v4 | HTML5 Player for All | 非暗号化コンテンツ専用の非インストール型 HTML5 プレイヤー |
| v5 | Web Player | インストール型と非インストール型の長所を組み合わせた次世代統合 Web プレイヤー |
| iOS | App Player for iOS | iOS 専用アプリプレイヤー |
| Android | App Player for Android | Android 専用アプリプレイヤー |
プレイヤーのご案内
Kollus プレイヤーの詳細については、以下のドキュメントを参照してください。
全オプション
再生
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
autoplay (a) | null | 全体 | 自動再生設定（モバイル環境ではデフォルトで有効） |
mute | null | 全体 | ミュート状態で再生開始 |
t | integer | 全体 | 指定した時点（秒）から再生し、続きから再生のポップアップを表示 |
s | integer | 全体 | 指定した時点（秒）から再生し、続きから再生のポップアップを表示しない |
title | string | 全体 | コンテンツタイトルを強制指定 |
pf | string | 全体 | エンコーディングプロファイル（画質）を強制指定 |
注意
- 再生オプションの例外:
tまたはsの値が動画の開始・終了 10 秒以内の場合、システムの安定性のため動画の先頭（0 秒）から再生されます。 - ブラウザーの自動再生ポリシー: Chrome および最新のブラウザーは、音声を含む動画の自動再生をデフォルトでブロックします。詳細は Chrome の自動再生ポリシー を参照してください。
ダウンロード
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
download | null | モバイル、v3e、v3h | ダウンロードモードの有効化 |
mobile_folder_download | string | モバイル | モバイルダウンロードフォルダーのパスを指定 |
pc_folder_download | string | v3e、v3h | PC ダウンロードフォルダーのパスを指定 |
filename | string | 全体 | R-link ・ SR-link 使用時に保存されるファイル名を指定 |
参考
- 前提条件:
downloadパラメーターが正常に動作するには、DRM Download Callback の設定が事前に必要です。 - フォルダーパスの設定:
/記号を使用してサブフォルダーを指定できます。- 例:
folder1/folder2/folder3
- 例:
- エンコーディング: フォルダー名に日本語・特殊文字・スペースが含まれる場合は、必ずその値を UTF-8 URL エンコーディング処理して渡してください。
- R-link の有効化: R-link はデフォルトで無効になっています。この機能を有効化するには、営業担当者(jp_sales@catenoid.net) までお問い合わせください。
プレイヤー
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
player_version (pv) | string | PC | プレイヤーを指定
|
force_exclusive_player | null | v3e、v3h | 非暗号化コンテンツの再生時も PC 用 Kollus セキュアプレイヤーを適用 |
force_independent_player | boolean | v3 | Kollus セキュアプレイヤーを強制適用 |
コントロールバー
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
controls_activation | string | v3、v4、v5 | コントロールバーの表示ポリシー
|
show_controls_paused | boolean | v4 | 一時停止状態でコントロールバーを維持するか（デフォルト値: false） |
set_controlbar_progress_only | boolean | v4、v5 | プログレスバー (Progress Bar) のみ表示 |
transparent_controlbar_layer | boolean | v4、v5 | コントロールバーの背景を透明化 |
hide_header_display | boolean | v4、v5 | ヘッダー領域を非表示 |
オーバーレイ / ポスター
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
overlay_button_position | string | v4 | オーバーレイボタンの位置
|
show_poster_ended | boolean | v4 | 再生終了後にポスターを表示するか（デフォルト値: false） |
enable_poster | boolean | v4、v5 | ポスターを有効化するか |
enable_spinner_activation | boolean | v4、v5 | ローディングアイコンを有効化するか |
サムネイル / タイムディスプレイ
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
enable_thumbnail | boolean | v4、v5 | プログレスバーのシーク時にサムネイルプレビュ ーを有効化 |
enable_mouse_time_display | boolean | v5 | マウスオーバー時にタイムディスプレイを表示 |
シーク (Seek) / 自動再生
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
autoplay_after_seek | string | v4、v5 | 再生位置の移動(Seek)後の再生ポリシー
|
disable_autoplay | boolean | v4、v5 | 自動再生が可能な状況でも当該機能を無効化 |
play_at | number | v3 | 続きから再生する時点を設定 |
バッファリング / ストリーミング
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
buffer | integer | v3e、v3h | バッファリング倍数を設定（2〜10 倍） |
frag_load_paused | boolean | v4、v5 | 一時停止状態で HLS Fragment を読み込むか |
force_custom_header | boolean | v4、v5 | HLS 同時接続確認ヘッダー (X-Kollus-SessionId) を強制追加 |
force_use_credentials | boolean | v4、v5 | HLS XHR リクエスト時に withCredentials を強制適用 |
画面制御
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
force_landscape_fullscreen | boolean | v4、v5 | モバイルの全画面再生時に画面の向きを横向きに固定 |
force_rotate_fullscreen | boolean | v4、v5 | モバイルデバイスを横向きに回転させた際に全画面モードを強制実行 |
enable_pip | boolean | v3、v4、v5 | PIP (Picture-in-Picture) モードを許可 |
pointcolor | number | v4、v5 | UI ポイントカラーを変更（HEX、# 除く） |
is_vr | boolean | v4、v5 | VR プレイヤーで再生 |
is_dvr | boolean | v4、v5 | DVR タイムシフトを有効化 |
入力 / アクセシビリティ
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
enable_hotkey | boolean | v4、v5 | ショートカットキーを有効化 |
enable_volume_scroll | boolean | v4、v5 | マウスホイールによる音量調整を有効化 |
enable_context_menu | boolean | v3、v4、v5 | マウス右クリックのコンテキストメニューの使用を許可 |
enable_accessibility | boolean | v3、v4、v5 | Web アクセシビリティ機能を有効化 |
enable_initialize_focus | boolean | v3、v4 | プレイヤーロード時にフォーカスを適用（デフォルト値: true） |
iOS 専用オプション
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
ios_player_type | string | iOS | iOS デコーダータイプ（App Player for iOS バージョン 2.2.14 以上への適用が必須）
|
mobile_return_url | string | iOS | 戻る・終了時に遷移する URL（Safari ブラウザーで起動） |
開発 / デバッグ
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
debug_mode | boolean | v3、v4、v5 | ブラウザーコンソールにデバッグログを出力 |
debug_mode2 | boolean | v4、v5 | 詳細なイベントログおよびデータ状態を出力 |
agent_mode | boolean | v3 | KollusAgent の検査を実行するか |
agent_url | string | v3 | KollusAgent の URL を設定（debug_mode=true 設定時に動作） |
loadcheck | integer | v3 | 0: Play Callback でメッセージを使用 |
media_key_src | string | v3 | メディアキーを直接指定 |
media_url | string | v3 | 再生 URL を直接指定 |
その他
| パラメーター | タイプ | 対象プレイヤー | 説明 |
|---|---|---|---|
uservalue{0~99} | mixed | 全体 | カスタム変数（uservalue0〜uservalue99）
|
使用例
参考文書
キー (Key/ID) 情報については、以下のドキュメントを参照してください。
視聴体験の最適化（再生制御）
自動再生と初期ミュートの設定
ブラウザーの自動再生ブロックポリシーを回避して、視聴への自動エントリーを実現するオプションの組み合わせです。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?autoplay&mute
10 秒地点からすぐに再生
続きから再生のポップアップを表示せず、指定した時点からすぐに再生を開始します。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?s=10
画質（プロファイル）の指定とタイトルの変更
特定の画質を選択したり、プレイヤーに表示されるタイトルを指定します。title の値に日本語やスペースが含まれる場合は、必ず UTF-8 URL エンコーディング処理を行ってください。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?pf={ENCODING_PROFILE_KEY}&title={TITLE}
UI 制御
プレイヤーの指定とデバッグログの有効化
特定のプレイヤー環境をテストしたり、ブラウザーの開発者ツール(Console)でログを確認する際に活用します。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?player_version=v4&debug_mode=true
モバイル全画面切り替え時に横向きを固定
モバイルユーザーが全画面ボタンを押した際に、デバイスの向きにかかわらず画面の向きを横向きに切り替えます。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?force_landscape_fullscreen=true
コントロールバーの常時表示とポイントカラーの変更
ユーザー操作がなくてもコントロールバーを常に表示し、ブランドテーマに合わせたポイントカラーを適用します。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?controls_activation=always&pointcolor=FF5500
ダウンロード
ダウンロードモードの実行とフォルダーパスの指定
コンテンツを保存するサブフォルダーのパスを指定します。特殊文字や日本語が含まれるパスは、必ず UTF-8 URL エンコーディング処理を行ってください。
https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?download&mobile_folder_download=movie/action