プレイヤー呼び出し

お知らせ

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

ライブ配信をお客様の Web サイトなどに埋め込むためのプレイヤー呼び出し方式について説明します。 各方式はチャンネル設定とセキュリティ要件に違いがあるため、サービス環境に適した方式を選択してください。

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

• Kollus プレイヤー呼び出し: 別途プレイヤーを開発せずに、Kollus Live が提供する標準 UI と機能をすぐに使用したい場合に推奨します。
• 直接ストリーム(Direct Stream)呼び出し: 独自のカスタム UI を実装したり、外部プレイヤーを連携して使用する場合に適用します。

参考文書

キー(Key/ID)情報は以下のドキュメントを参照してください。

• 認証と主要キー

---

一般呼び出し方式（パブリックチャンネル）

一般呼び出しは、別途セキュリティ認証(JWT)なしにチャンネルキーのみでプレイヤーを呼び出す非セキュリティ方式です。

注意

一般呼び出し方式は、チャンネル設定が公開状態の場合にのみ正常に動作します。プライベートチャンネルの場合はセキュリティ呼び出し方式を使用してください。

基本呼び出し（共有 URL）

既存の Web サイトのロジックを変更せずに、最も簡単に視聴 URL を配信する際に使用します。 該当 URL はチャンネル詳細ページの[VideoGateway リンク]と同一です。 ユーザーがブラウザのアドレスバーに該当 URL を入力すると、Kollus Player が読み込まれ、即座に再生が開始されます。

https://v-live-jp.kollus.com/{CHANNEL_KEY}

Web ページへの Embedding

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

<iframe
  width="#"
  height="#"
  src="https://v-live-jp.kollus.com/{CHANNEL_KEY}"
  frameborder="0"
  allowfullscreen
  webkitallowfullscreen
  mozallowfullscreen
  allow="local-network-access">
</iframe>

実装ガイド

• アスペクト比: widthとheightはコンテンツの解像度比率に合わせて設定することで、黒帯(Letterbox)なしで表示されます。
• フルスクリーン: フルスクリーン機能をサポートするには、allowfullscreen、webkitallowfullscreen、mozallowfullscreen属性を必ず明示する必要があります。
• Chrome ポリシー対応: allow="local-network-access"は、Chrome ブラウザー J ャー(142.X 以上)で Kollus DRM が適用されたコンテンツを<iframe>で呼び出す際の必須オプションです。

R-link 呼び出し（非セキュリティストリーム URL）

機能の有効化

R-link はデフォルトで無効になっています。この機能を有効化するには、営業担当者(jp_sales@catenoid.net)までお問い合わせください。

R-link は、Kollus Player ではなく、お客様が直接開発した独自プレイヤーを活用する際に使用します。 R-link 使用時は、Kollus Player の基本機能および Kollus Live コンソール内の統計機能を使用できません。

該当 URL を呼び出すと、Kollus システムが再生可能なストリームアドレスへ HTTP 302 リダイレクトを実行します。

https://v-live-jp.kollus.com/r/{CHANNEL_KEY}

---

セキュリティ呼び出し方式

セキュリティ呼び出しは、JWT(JSON Web Token)に基づいて権限が確認されたユーザーにのみライブ配信を許可する方式です。 単純なリンク共有による無断視聴を防止し、重複再生遮断やアクセス失効日の設定など、きめ細かな制御が可能です。 セキュリティ呼び出し方式は、チャンネルの公開/非公開設定に関わらず適用できます。

S-link 呼び出し（セキュリティ URL）

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

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

主な機能

S-link 使用時に以下の機能を制御できます。

• 重複再生遮断: 同一アカウントによる複数デバイスへのアクセスをリアルタイムで検知し遮断します。
• 失効日設定: トークン(JWT)内に失効日を設定し、特定の時点以降のアクセスを遮断します。
• LMS Callback 連携: ユーザーごとの視聴履歴および再生進行率のデータを学習管理システム(LMS)へ転送します。

Web ページへの Embedding

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

<iframe
  width="#"
  height="#"
  src="https://v-live-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 呼び出し（セキュリティストリーム URL）

SR-link は、お客様が直接開発したプレイヤーを使用しながらセキュリティおよび付加機能を適用する際に使用します。 SR-link 使用時は、Kollus Player の基本機能および Kollus Live コンソール内の統計機能を使用できません。

該当 URL を呼び出すと、Kollus システムが JWT の有効性を検証した後、再生可能なストリームアドレスへ HTTP 302 リダイレクトを実行します。

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