メインコンテンツまでスキップ

プレイヤー呼び出し

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

コンテンツ再生のための各種プレイヤー呼び出し方式を説明します。 各方式は連携目的とセキュリティ要件によって異なるため、サービス環境に最も適した方式を選択してください。

Kollus VOD は大きく 2 つの連携メカニズムをサポートしています。

  • Kollus プレイヤー呼び出し: 別途プレイヤーを開発することなく、Kollus VOD が提供する標準 UI と機能をすぐに利用したい場合に推奨します。
  • Direct Stream 呼び出し: 独自のカスタム UI を実装する場合や、外部プレイヤーと連携して使用する場合に適用します。
参考文書

プレイヤー呼び出しのための識別情報については、下記のドキュメントを参照してください。

一般呼び出し方式​

一般呼び出しは、別途セキュリティ認証(JWT)なしにコンテンツ固有識別子であるメディアコンテンツキー(Media Content Key)のみでプレイヤーを呼び出す非セキュア方式です。

基本呼び出し（共有 URL）​

既存のウェブサイトロジックを変更せずに、最も簡単に再生 URL を配布する際に使用します。 ユーザーがブラウザのアドレスバーにその URL を入力すると、Kollus プレイヤーがロードされ、即座に再生が開始されます。

https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}

ウェブページへの埋め込み​

お客様のウェブページ内にプレイヤーを埋め込むには、<iframe>タグのsrc属性に該当 URL を設定してください。

<iframe
  width="#"
  height="#"
  src="https://v.jp.kollus.com/{MEDIA_CONTENT_KEY}?"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
実装ガイド
  • アスペクト比: widthとheightはコンテンツの解像度比率に合わせて設定することで、黒帯(Letterbox)なしに表示されます。
  • フルスクリーン: フルスクリーン機能をサポートするには、allowfullscreen、webkitallowfullscreen、mozallowfullscreen属性を必ず明示してください。
  • Chrome ポリシー対応: allow="local-network-access"は、Chrome ブラウザ(142.X 以上)で Kollus DRM が適用されたコンテンツを<iframe>で呼び出す際の必須オプションです。
注意
  • 機能の有効化: R-link はデフォルトで無効になっています。この機能を有効にするには、営業担当者(jp_sales@catenoid.net)までお問い合わせください。
  • 制限事項: R-link を使用すると、Kollus プレイヤーの基本機能および Kollus VOD コンソール内の分析(インサイトメニュー)データを利用できません。

R-link は、Kollus プレイヤーではなく、お客様が直接開発したプレイヤーを通じて非暗号化コンテンツを再生する際に使用します。該当 URL を呼び出すと、Kollus システムが HTTP 302 リダイレクトにより再生可能なストリームアドレスに転送します。

https://v.jp.kollus.com/r/{MEDIA_CONTENT_KEY}

I-link は、Kollus モバイル SDK を使用して開発されたアプリ環境で非暗号化コンテンツをロードする際に使用します。 該当 URL を SDK 初期化コード内のメディアソースアドレスとして設定してください。

https://v.jp.kollus.com/i/{MEDIA_CONTENT_KEY}

セキュア呼び出し方式​

セキュア呼び出しは、JWT(JSON Web Token)に基づいて権限が確認されたユーザーのみ再生を許可する方式です。 単純なリンク共有による不正視聴を防止し、重複再生遮断や再生有効期限の設定など、きめ細かな制御が可能です。 セキュア呼び出し方式はチャンネル設定（非暗号化コンテンツ/暗号化コンテンツ専用）に関係なく適用できます。

S-link は、Kollus プレイヤーを使用しながらセキュリティおよび付加機能を適用する際に使用します。 ユーザーが該当 URL にアクセスすると、セキュリティ検証後に Kollus プレイヤーがロードされます。

https://v.jp.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}
主な機能

S-link を使用する際、以下の機能を制御できます。

  • 重複再生遮断: 同一アカウントの複数デバイスからの同時アクセスをリアルタイムで検知・遮断します。
  • 有効期限の設定: トークン(JWT)内に有効期限を設定することで、特定の時点以降のアクセスを遮断します。
  • シーク(Seek)遮断: ユーザーが任意に動画の再生位置をスキップできないよう制御します。
  • 再生速度変更の制限: 再生速度機能を無効化するか、特定の再生速度に固定します。
  • 続きから再生: ユーザーが視聴を中断した時点から自動的に再生を再開します。
  • LMS Callback 連携: ユーザーごとの視聴履歴および再生進行率データを学習管理システム(LMS)に送信します。

ウェブページへの埋め込み​

お客様のウェブページ内にプレイヤーを埋め込むには、<iframe>タグのsrc属性に該当 URL を設定してください。

<iframe
  width="#"
  height="#"
  src="https://v.jp.kollus.com/s?jwt={JWT}&custom_key={CUSTOM_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>
実装ガイド
  • アスペクト比: widthとheightはコンテンツの解像度比率に合わせて設定することで、黒帯(Letterbox)なしに表示されます。
  • フルスクリーン: フルスクリーン機能をサポートするには、allowfullscreen、webkitallowfullscreen、mozallowfullscreen属性を必ず明示してください。
  • Chrome ポリシー対応: allow="local-network-access"は、Chrome ブラウザ(142.X 以上)で Kollus DRM が適用されたコンテンツを<iframe>で呼び出す際の必須オプションです。
注意

SR-link を使用すると、Kollus プレイヤーの基本機能および Kollus VOD コンソール内の分析(インサイトメニュー)データを利用できません。

SR-link は、お客様が直接開発したプレイヤーを使用しながらセキュリティおよび付加機能を適用する際に使用します。 該当 URL を呼び出すと、Kollus システムが JWT の有効性を検証した後、再生可能なストリームアドレスに HTTP 302 リダイレクトを行います。

https://v.jp.kollus.com/sr?jwt={JWT}&custom_key={CUSTOM_KEY}

SI-link は、Kollus モバイル SDK を使用して開発されたアプリ環境で暗号化コンテンツをロードする際に使用します。一般的なウェブブラウザ環境では S-link を使用してください。 該当 URL を SDK 初期化コード内のメディアソースアドレスとして設定してください。

https://v.jp.kollus.com/si?jwt={JWT}&custom_key={CUSTOM_KEY}
主な機能

SI-link を使用する際、以下の機能を制御できます。

  • 重複再生遮断: 同一アカウントの複数デバイスからの同時アクセスをリアルタイムで検知・遮断します。
  • 有効期限の設定: トークン(JWT)内に有効期限を設定することで、特定の時点以降のアクセスを遮断します。
  • シーク(Seek)遮断: ユーザーが任意に動画の再生位置をスキップできないよう制御します。
  • 再生速度変更の制限: 再生速度機能を無効化するか、特定の再生速度に固定します。
  • 続きから再生: ユーザーが視聴を中断した時点から自動的に再生を再開します。
  • LMS Callback 連携: ユーザーごとの視聴履歴および再生進行率データを学習管理システム(LMS)に送信します。