実装ガイド

お知らせ

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

iOS 環境で Kollus SDK を使用して DRM コンテンツをデバイスにダウンロードし、ネットワーク接続がない環境でも安全に再生するまでの全プロセスを扱います。このドキュメントのすべてのサンプルコードは、公式サンプルアプリ kollus_player_ios をもとに作成されています。

事前確認事項：SDK キーと認証

Kollus SDK は、カテノイドが発行する SDK キー(Key)と有効期限の情報をもとに認証を行います。正しいキーが発行されていない場合や有効期限が切れたキーを使用している場合、SDK の初期化および起動(start)段階でエラーが発生し、動作が失敗します。

項目	説明および場所
SDK キー	営業担当者を通じて発行された固有キー(`KollusStorage.applicationKey`)
有効期限	SDK キーとともに提供される認証有効期間(`KollusStorage.applicationExpireDate`)
Bundle ID	必須指定項目で `Info.plist` の内容と一致が必要(`KollusStorage.applicationBundleID`)

SDK キーの発行

SDK キーはコンソールから直接発行することはできません。営業担当者(jp_sales@catenoid.net)に Bundle ID とともに発行をリクエストしてください。

Multi DRM(FairPlay)連携ガイド

iOS 環境で FairPlay ベースの Multi DRM コンテンツを処理する場合、PallyConFPSSDK.framework が一緒に統合されて動作します。SDK キーの他に別途 site_id および FPS 証明書などが必要になる場合がありますので、該当コンテンツを扱う場合は営業担当者(jp_sales@catenoid.net)にお問い合わせください。

コンテンツダウンロード URL とセキュリティ上の注意事項

ダウンロード対象の URL は一般的に https://v.jp.kollus.com/s?jwt=... のような形式のワンタイム(One-time)URL 構造を持ちます。

サーバー間連携必須: JWT 発行ロジックにはセキュリティーキーが含まれるため、必ずお客様のバックエンドサーバーで実行する必要があります。セキュリティ上の脆弱性が生じる可能性があるため、モバイルアプリクライアントが JWT を直接生成してはなりません。
SDK 処理方式: モバイルアプリはお客様のサーバーから受け取った URL を変更せずにそのまま SDK 内部の連携メソッドに渡して使用します。