9. ダウンロードエラーコード
お知らせ
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
SDK エラーコード
com.kollus.sdk.media.util.ErrorCodes クラスに定義されたコアエラーコードの仕様と、具体的な発生（トリガー）タイミングです。
| 定数 | 説明 | トリガー |
|---|---|---|
ERROR_OK | 正常完了 | — |
ERROR_INCORRECT_AUTH_KEY | SDK キーの有効期限切れ/エラー | 初期化(initialize)または認証メソッド(setCertification)の呼び出し時 |
ERROR_UNSUPPORTED_DEVICE | サポートされていないデバイス | デバイス情報の登録(setDevice)または DRM 互換性検証の失敗時 |
ERROR_STORAGE_FULL | ストレージ容量不足 | メタ情報の読み込み(load)およびファイルダウンロード(download)の開始時 |
ERROR_WRITE_FILE | ファイル書き込みエラー | ダウンロード中にディスク I/O エラーが発生した場合 |
ERROR_ALREADY_DOWNLOADING | 重複ダウンロードリクエスト | 同一コンテンツに対して download(mck) を呼び出した場合 |
ERROR_ALREADY_DOWNLOADED | すでにダウンロード完了済みのコンテンツ | ダウンロード完了済みコンテンツに対して download(mck) を呼び出した場合 |
ERROR_NOT_EXIST_DOWNLOADED_CONTENTS | ローカルにダウンロードされたファイルなし | getDownloadKollusContent(path) の呼び出し時またはオフライン再生時 |
ERROR_EXPIRATION_DATE | 有効期限超過 | オフライン再生の試行時 |
ERROR_EXPIRATION_PLAY_TIME | 許可再生時間の超過 | オフライン再生の試行時 |
ERROR_EXPIRATION_COUNT | 許可再生回数の超過 | オフライン再生の試行時 |
ERROR_FORCE_DELETE | DRM Callback kind2 または kind3 の応答によるコンテンツの強制削除 | onDRMInfo Callback 内で DCB_INFO_DELETE シグナルを検知した場合 |
SDK 外部エラー
SDK の内部ロジック以外で、モバイル OS のポリシーやネットワークエラーにより発生する可能性があるエラー状況への対応パターンです。
- ストレージ権限の拒否: アプリレイヤーで
SecurityExceptionまたはIOExceptionの例外処理を構成する必要があります。マニフェスト内の権限宣言状態と、ランタイム権限の取得フローを確認してください。 - ネットワーク接続失敗: SDK が自動的に再試行を実行します。自動再試行の閾値は
storage.setNetworkTimeout(timeout, retryCount)で調整でき、setNetworkTimeout(30, 3)（30 秒、3 回）の設定を推奨します。 - バックグラウンド強制終了: フォアグラウンドサービスを適用しない場合、OS がダウンロードプロセスを任意に終了します。
FOREGROUND_SERVICE_TYPE_DATA_SYNC属性を併用する必要があります。（参考文書: 1. ダウンロードの準備）
エラーコード別推奨ユーザーメッセージ
| エラーコード | ユーザーメッセージ例 |
|---|---|
ERROR_INCORRECT_AUTH_KEY | "アプリの認証に問題が発生しました。アプリを最新バージョンにアップデートしてください。" |
ERROR_STORAGE_FULL | "デバイスのストレージ容量が不足しています。視聴済みのダウンロードファイルを削除するか、ストレージ容量を確保してください。" |
ERROR_WRITE_FILE | "ファイルの保存に失敗しました。しばらくしてからもう一度お試しください。" |
ERROR_EXPIRATION_* | "コンテンツの視聴期間が失効しました。ネットワークに接続してライセンスを更新してください。" |
ERROR_UNSUPPORTED_DEVICE | "このデバイスではコンテンツをダウンロードまたは再生できません。" |