メディアコンテンツキー拡張

備考

メディアキーコンテンツ拡張機能は非暗号化コンテンツにのみ適用されます。DRM が適用されたコンテンツではサポートされません。

Kollus VOD は既存のメディアコンテンツキーにお客様が定義した Custom ID を組み合わせる機能をサポートしています。 この機能を活用すると、物理的な原本ファイルは 1 つですが、システム上では複数の独立したコンテンツであるかのように制御できます。

基本原理

• 論理的分離: ダウンロード、続きから再生などの特定のパーソナライズ機能では、拡張されたキーを異なるコンテンツとして認識します。
• 物理的統合: 基本的なコンテンツ情報は原本メディアコンテンツキーを基準に共通管理されます。
• 例: Gmail のエイリアス機能に似ています。拡張アドレスにメールを送信すると、基本アドレス(support@kollus.com)が受信します。
  • 基本アドレス: support@kollus.com
  • 拡張アドレス: support-cid1@kollus.com, support-cid2@kollus.com

リクエスト仕様

非暗号化コンテンツを呼び出す際、原本メディアコンテンツキーと Custom ID をハイフン(-)で連結して使用します。

リクエスト URL 構造

メディアコンテンツキー自体にはハイフンが含まれないため、最初のハイフンを基準に Custom ID を区別します。

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

JWTペイロードへの適用

JWT（JSON Web Token）方式を使用して認証する場合、mc配列内のmckeyの値に拡張キーをそのまま入力します。

{
  "cuid": "user01",
  "expt": 1703980800,
  "mc": [
    {
      "mckey": "{MEDIA_CONTENT_KEY}-{CUSTOM_ID}"
    }
  ]
}

制約事項

• 長さ制限: 64 bytes 以内
• 使用可能文字: 英文字、数字、ハイフン(-)のみ許可
• エンコーディングの注意事項: 日本語などのマルチバイト文字の使用は推奨しません（UTF-8 エンコーディング時に 64 bytes を超えないよう注意）

拡張キーの適用対象機能

拡張キーを通じて呼び出した場合、Kolluss システムは以下の項目について Custom ID ごとにデータを個別に生成・管理します。

• DRM Download Callback
• LMS Callback
• 続きから再生
• 重複再生遮断
• ブックマーク

コールバックデータの受信

拡張キーが適用されたコンテンツでコールバック（LMS、DRMダウンロードなど）が発生した場合、受信データ内のmedia_content_keyパラメータにも拡張された形式のキーがそのまま渡されます。 これにより、お客様のシステム側でどの Custom ID から発生したイベントかを正確に判別し、後続処理を行うことができます。

media_content_key="{MEDIA_CONTENT_KEY}-{CUSTOM_ID}"