-1007 (プレイヤーストリームエラー)

• エラーコード: -1007
• タイプ: ERROR_MALFORMED
• 概要: SDK 内部の再生ストリーム URL 仕様エラー、または HTTP データ受信失敗

原因（4 種類）

プレイヤーの再生準備段階および初期化処理において、ストリームデータの仕様が合わない場合や通信に失敗した場合に発生します。主な原因は以下のように分類されます。

原因 A: setDevice() の引数に null を渡した場合（Android）

KollusStorage.setDevice(deviceInfo) の引数が null の場合、再生準備段階でこのエラーが発生します。

誤った例

mStorage.setDevice(null);

正しい例

mStorage.setDevice(Build.MANUFACTURER + "/" + Build.MODEL);

注意

特定の環境でデバイス情報を取得できない場合でも、空文字列や null の代わりにフォールバック（代替）文字列を入力する必要があります。

原因 B: KollusStorage の初期化が完了していない状態で再生を試みた場合

setCertification() または start() メソッドが完了していない、あるいは初期化プロセスが失敗した状態で再生を試みた場合です。

Android（初期化完了の確認）

int errorCode = mStorage.getErrorCode();
if (errorCode != ErrorCodes.ERROR_OK) {
    // Initialization has failed; do not attempt playback.
    return;
}

iOS（start() 失敗時の例外処理）

do {
    try storage.start()
} catch {
    // Handle the error and do not attempt playback.
    return
}

原因 C: 再生 URL パスに /i または /si プレフィックスがない場合

Kollus の再生 URL には、一般リンク（/i）またはセキュアリンク（/si）のプレフィックスが必要です。 プレフィックスなしで元の URL を直接渡した場合、またはパスが誤って入力された場合、ストリームの認識ができずエラーが発生します。

一般リンクの例

https://v.jp.kollus.com/i?mc=...

セキュアリンク（JWT）の例

https://v.jp.kollus.com/si?jwt=...

原因 D: ブックマーク確認レスポンスの JSON パースエラーまたは error フィールドの異常

再生開始時、Kollus SDKがサーバーとブックマーク情報を同期し検証する過程で、Webサーバーの応答例外が発生した状態です。

主な発生原因

• 連携設定エラー: ブックマーク連携サーバーのURLが誤って設定されているか、お客様側の受信Webサーバーが異常な応答パケットを返している場合。
• JSON解析の失敗: サーバーが返した応答データが有効なJSONフォーマットではなく、解析（パース）に失敗した場合。
• error フィールドの例外: JSON応答データ内の error フィールド値が 0（正常）以外のコードで返された場合。

応答データの例

// Normal response example
{ "error": 0, "data": [...] }

// Abnormal response example (may trigger -1007 error)
{ "error": 1, "message": "..." }

診断

1. 初期化状態の確認: KollusStorage.getErrorCode()（Android）または start() の成否（iOS）を先に確認してください。
2. デバイス識別子の確認: setDevice() メソッド実行時に渡されるパラメーターのログを出力し、null データが渡されていないか確認してください。
3. 再生 URL 仕様の確認: 再生 URL が /i? または /si? で始まっているか確認してください。
4. ブックマークデータ形式の確認: ブックマーク連携 URL が設定されている場合、該当サーバーにクエリを送信して返される JSON データの形式を直接確認してください（curl 呼び出し）。

解決方法

• 診断ステップで確認された各原因に対応するソースコードおよび URL ガイドを参照して、連携ロジックを修正してください。
• 上記 4 つの診断項目をすべて確認・対処しても問題が解決しない場合は、エラーが観察された実際の再生 URL とエラー発生前後のログデータを添付して、営業担当者(jp_sales@catenoid.net)までお問い合わせください。