実装ガイド
Android 環境で Kollus SDK を使用して DRM コンテンツをデバイスにダウンロードし、ネットワーク接続がない環境でも安全に再生するまでの全プロセスを説明します。
このドキュメントのすべてのサンプルコードは、公式サンプルアプリ kollus_player_v2_android をもとに作成されています。
事前確認事項: SDK キーと認証
Kollus SDK は、カテノイドが発行する SDK キー(Key) と 有効期限 の情報をもとに認証を行います。
正しいキーが発行されていない場合や有効期限が切れたキーを使用している場合、ダ ウンロードおよびオフライン再生関連の API 呼び出し時に ERROR_INCORRECT_AUTH_KEY エラーが発生し、動作が失敗します。
| 項目 | 説明および確認方法 |
|---|---|
| SDK キー | 営業担当者を通じて発行された固有キー |
| 有効期限 | SDK キーとともに提供される認証有効期間（例: 2050/12/31） |
| パッケージ識別子 | context.getPackageName(): SDK 内部で自動的に識別され、認証に使用 |
SDK キーの発行
SDK キーはコンソールから直接発行することはできません。営業担当者(jp_sales@catenoid.net)にパッケージ名/Bundle ID とともに発行をリクエストしてください。
コンテンツダウンロード URL とセキュリティに関する注意事項
ダウンロード対象の URL は一般的に https://v.jp.kollus.com/s?jwt=... のような形式のワンタイム(One-time) URL 構造を持ちます。
- サーバー間連携必須: JWT 発行ロジックにはセキュリティキーが含まれるため、必ずお客様のバックエンドサーバーで実行する必要があります。セキュリティの脆弱性が生じる可能性があるため、モバイルアプリクライアントで、JWTを直接生成しないでください。
- SDK 処理方式: モバイルアプリはお客様のサーバーから受け取った URL を変更せずそのまま SDK の
load(url, ...)メソッドに渡して使用します。
実装ガイドの構成
- 1. ダウンロードの準備: SDK 初期化と認証、ストレージ権限の確認、デバイスの利用可能容量チェック
- 2. ストリーミング再生: JWT URL によるオンライン再生、メディア配信方式の特徴、バックグラウンド再生の制御
- 3. コンテンツダウンロード: 情報登録とダウンロード開始の 2 段階制御、キャンセル・再開プロセス
- 4. ダウンロードリスト管理: ダウンロードコンテンツリストの照会、状態別フラグの分岐、アプリ再起動後の復元
- 5. オフライン再生: ローカルファイル再生フロー、ネットワーク切断時の DRM 検証条件の処理
- 6. DRM ライセンス更新: ライセンス有効期限の確認、一括更新処理
- 7. ダウンロードコンテンツの削除: 単一・全体コンテンツの削除および DRM レスポンスに基づく期限切れファイルの整理
- 8. ダウンロードイベント/コールバック: ダウンロード状態変更の追跡および DRM 検証・更新結果を処理するリスナー
- 9. ダウンロードエラーコード: 主要エラーへの対応方法
- アンチパターン（よくある間違い）: 誤った実装事例とその正しい解決方法
参考資料
- 公式サンプルアプリ:
kollus_player_v2_android - コールバック詳細仕様: DRM Download Callback
- 技術的なお問い合わせ: jp_sales@catenoid.net