iOS SDK 修正履歴

Released date: 2026-01-26

Added APIs

• “KollusPlayerView.h” から
  /// Playback Limit Duration
  @property (nonatomic, unsafe_unretained, readonly) NSInteger nPlaybackLimitDuration;
  /// Playback Limit Message
  @property (nonatomic, copy) NSString *strPlaybackLimitMessage;
  変更理由: コンテンツ再生開始から一定時間経過後の再生ブロック
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-12-30

Added Features

• コンテンツダウンロードイベントデータの送信
  変更理由: QoEデータの収集
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-12-10

Added APIs

• “Chapter.h” 追加
  /// チャプター Dictionary
  @interface ChapterDict : NSObject
  /// チャプター言語
  @property (nonatomic, retain) NSString* strLanguage;
  /// チャプターリスト
  @property (nonatomic, retain) NSMutableArray* listChapter;

  /// チャプター内容
  @interface Chapter : NSObject
  /// チャプター位置
  @property (nonatomic, unsafe_unretained) NSTimeInterval position;
  /// 文字
  @property (nonatomic, retain) NSString *value;

  変更理由: チャプター情報を入れて映像を簡単に探索
  影響範囲: No
  アプリの変更有無: No

• "KollusPlayerView.h" から
  /// Chapter 情報リスト
  @property (nonatomic, readonly) NSMutableDictionary* chapterInfo;
  変更理由: チャプター情報を入れて映像を簡単に探索
  影響範囲: No
  アプリの変更有無: No

• Appからの例 :
  func kollusPlayerView(_ kollusPlayerView: KollusPlayerView!, prepareToPlayWithError error: Error!) 以後に適用
  関数 func setChapterInfo() 参照

• if let chapterInfo = playerView.chapterInfo as? [String: ChapterDict] { if chapterInfo.keys.contains("default_language_code") { NLog("チャプター言語に \(String(describing: "default")) 値が存在します。") chapterList = chapterInfo["default_language_code"]?.listChapter as! [Chapter] } else { NLog("チャプター言語にdefault値が存在しません。") } NLog("chapterList : \(chapterList)") for chapter in chapterList { let value = (Float(chapter.position))/Float(data!.duration) controlView.sliderView.addChapter(value: value) } }

Fixed

• Live再生時にplay callbackでtv out設定エラーを修正
  変更理由: Bug Fix
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-11-10

Added APIs

• "KollusPlayerView.h" から
  /// Content Provider Key
  @property (nonatomic) NSString *contentProviderKey;
  変更理由: ユーザー行動分析action statsにおけるデータ活用(KollusPlayer only)
  影響範囲: No
  アプリの変更有無: No

Added Features

• エッジサーバー接続時にkeep alive追加
  変更理由: サーバー ネットワーク リソースの効率性強化
  影響範囲: No
  アプリの変更有無: No

• network api新規フィールド追加及びtimestamp変更
  変更理由: 収集されたQoEデータ活用
  影響範囲: No
  アプリの変更有無: No

• ユーザー行動分析 action statsでデータの活用性を高める
  action stats apiにcpk追加(KollusPlayer only)
  変更理由: ユーザー行動分析 action statsでデータの活用性を高める
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-10-27

Added Features

• ユーザー行動分析データ転送、on/off (KollusPlayer only)
  変更理由: SDKをご利用でないお客様には影響ありません。
  顧客ごとにユーザー行動分析データの送信をON/OFFできるシナリオを追加。
  影響範囲: No
  アプリの変更有無: No

• UserAgentのdevice type 詳細区分
  変更理由: device別のhit情報
  影響範囲: No
  アプリの変更有無: No

Fixed

• ダウンロード要求時、DRMCallback応答内の顧客側で設定したメッセージの未表示を修正
  変更理由: ダウンロード要求時、DRM Callback Responseがfalseの場合は設定されたmessageで表示
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-08-12

Added Features

• PIPモード再生時のセキュリティ強化
  変更理由: PIPモード再生時のセキュリティ強化
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-08-06

Added Features

• ライブ再生中にブラックスクリーンが発生した場合のエラーコードおよびエラーレポート追加
  変更理由: ブラックスクリーン発生のモニタリングを強化
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-06-24

Added Features

• ネットワーク品質のモニタリングを追加(顧客向けのデータではありません)
  変更理由: ネットワーク品質データの収集
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-06-05

Added APIs

• “KollusStorage.h" から
  /// Kollus SDK ストレージフォルダ設定：サブフォルダとしてKollusを作成
  @property (nonatomic) BOOL isAISubtitles; @property (nonatomic, copy, readonly) NSString *storagePath;
  (BOOL)setKollusPath:(NSString *)path;
  変更理由: SDKストレージ指定フォルダ用APIの追加
  影響範囲: No
  アプリの変更有無: No

• Appからの例
  (BOOL)startStorage:(NSError**)error; 呼び出し前に使用
  storage = KollusStorage()
  let dateString = "2025/12/31"
  storage.applicationKey = "4172322ee271bxxxxxxxxxxx…..2880b2411"
  storage.applicationBundleID = "com.example.KollusPlayer"
  let paths = NSSearchPathForDirectoriesInDomains(.libraryDirectory, .userDomainMask, true)
  storage.setKollusPath(paths.first)
  try storage.start()
  
  警告：このメソッドは新規アプリでのみ使用してください。
  既存のダウンロード済みコンテンツは表示できなくなります。
  startStorage 関数を呼び出す前に使用する必要があります。
  default pathとして Document フォルダが使用されます。

Released date: 2025-05-15

Added APIs

• “SubTitleInfo.h" から
  /// AI AI字幕有無確認
  @property (nonatomic) BOOL isAISubtitles;
  変更理由: AI字幕有無を確認できるAPI追加
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-03-25

Added APIs

• "KollusPlayerView.h" に以下のプロパティを追加
  /// Content Provider Name
  @property (nonatomic) NSString *contentProviderName;
  変更理由: コーラスコンソールに設定された顧客名を取得するため
  影響範囲: No
  アプリの変更有無: No
  
  /// バックグラウンドオーディオ再生可否
  @property (nonatomic, unsafe_unretained, readonly) BOOL disableBackgroundAudio;
  変更理由: コンテンツ毎にバックグラウンド状態における再生可否を管理するため
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-02-25

Added Features

• KollusSDK エラー収集高度化
  変更理由: Player初期化前に発生するエラー収集目的
  影響範囲: No
  アプリの変更有無: No

Fixed

• HW Decoder使用時、Backgroundから一時停止状態でForegroundに切り替える時、current Playback Timeエラーを修正
  変更理由: エラー修正(Background転換後、Foreground転換時に時間情報抽出エラー)
  影響範囲: No (Background活性化未使用の場合、影響なし)
  アプリの変更有無: No

• HW Decoderで再生中に再生を終了する間、Background進入時にアプリ衝突現象を修正
  変更理由: エラー修正
  影響範囲: No
  アプリの変更有無: No

Released date: 2025-02-06

Added Features

• iOS KollusPlayer SDK 支援の最低 OS : iOS 15.0から支援
  変更理由: Xcode16のon-device debuggingはiOS15から支援
  影響範囲: YES (iOS15から支援)
  アプリの変更有無: YES (Xcode設定からMinmum Deploymentsを最低15.0に変更が必要

Fixed

• iOS HLSストリーミング再生時、m3u8 header部分にLast-modifiedを確認する部分を修正
  変更理由: On the fly方式でHLSをストリーミングする場合、ヘッダにLast-modified情報が含まれていないため
  再生不可の問題解決
  影響範囲: No (MultiDRMご利用の場合、影響なし)
  アプリの変更有無: No (MultiDRMご利用の場合、影響なし)

Released date: 2025-01-14

Added APIs

• KollusPlayerView.h に次の動画再生ボタンの表示/非表示機能を追加
  /// 次の動画再生 Show Button
  @property (nonatomic, unsafe_unretained, readonly) BOOL nextEpisodeShowButton;
  変更理由: 次の動画が自動再生される場合でも、media_info オプションに応じて「次の動画再生」ボタンの表示可否を選択できるようにするため
  影響範囲: No (次の動画機能を利用中の場合)
  アプリの変更有無: No (次の動画機能を利用中の場合)

Deleted APIs

• "KollusPlayerView.h" から
  /// Audio water mark
  @property (nonatomic, unsafe_unretained, readonly) BOOL isWaterMark;
  変更理由: AWT (Audio Watermark)機能のサポート終了(EOL)
  影響範囲: No
  アプリの変更有無: No

Added Features

• Debug SDK 利用の場合UI表示
  Debug 用 SDK を使用してアプリをビルドした場合、ユーザーが認識できるように、映像の上部に「Debug」文字を表示
  変更理由: Debug 用 SDK が誤って配布用アプリに適用されることを防ぐため
  影響範囲: No
  アプリの変更有無: No

• メディアインフォ復号化機能のセキュリティ強化
  変更理由: セキュリティ強化
  影響範囲: No
  アプリの変更有無: No

Released date: 2024-12-17

Changed APIs

• 変更前
  "KollusPlayerLMSDelegate.h" から
  // @param json リクエストで送ったJSONオブジェクト
  // @param error ネットワークエラー(nil: 成功)
  (void)kollusPlayerView:(KollusPlayerView *)kollusPlayerView json:(NSDictionary *)json error:(NSError *)error;
  変更後
  "KollusPlayerLMSDelegate.h" から
  // @param lmsData lms data 情報
  // @param resultJson lms result 情報
  (void)kollusPlayerView:(KollusPlayerView *)kollusPlayerView lmsData:(NSString *)lmsData resultJson:(NSDictionary *)resultJson;
  変更理由: LMS dataが送信されるURL情報が追加されるようにする
  影響範囲: Yes(ビルドエラーが発生するため、Appで変更されたAPIで適用する必要がある)
  アプリの変更有無: Yes(ビルドエラーが発生するため、Appで変更されたAPIで適用する必要がある)

Added Features

• 倍速設定時の自動再生防止
  一時停止状態で倍速イベント > SDKで設定値を保管した後、Playイベント時点で倍速値を適用
  変更理由: 一時停止状態で倍速設定すると再生される現象を防止する目的
  影響範囲: No
  アプリの変更有無:: No

• seeking中にPauseイベントがある場合、skip処理
  コンテンツ再生中にseekした場合、seekが完了前にpauseイベントがあった時pause結果の一貫性がないため
  変更理由: seek中にpauseイベント > seek動作に影響を与える可能性があるので無視するようにする
  影響範囲: No
  アプリの変更有無 : No

Released date: 2024-11-07

Added APIs

• "KollusPlayerView.h" に ignoreZero 追加
  /// 続き再生の仕様を無視して続き再生ができるように機能を追加
  @property (nonatomic, unsafe_unretained, readonly) BOOL ignoreZero;
  再生URLのQuery parameterとしてign_z flagの値を返還します。(default: false)
  変更理由: 動画を再生開始から10秒以内、または終了前の10秒以内に停止した場合でも、次回の再生時に「続き再生」が有効となる機能を追加しました。
  影響範囲: 追加機能を有効化するお客様
  アプリの変更有無: No, 追加機能を有効化する場合、再生URLのQuery parameterにign_z flagの値を追加

Released date: 2024-09-11

Added Features

• LMS Callback 転送項目を追加(Background <> Foreground切り替え時のタイムスタンプ
  変更理由: 新規APIの追加
  影響範囲: 新規APIなので利用しない場合、影響なし
  アプリの変更有無: No

Released date: 2024-08-29

Added Features
- on the fly DRM支援: コンテンツ別Kollus DRM支援
(MultiDRMご利用の場合、関係ありません)

1. PallyConFPSSDK.framework 2.3.0 更新
   PallyConFPSSDK.framework 2.3.0の更新方法
   　Appから交換が必要です。

   PallyConFPSSDK.framework 2.3.0は
   　添付ファイルのFolderにあります。
   　iOS SDK 2.3.15 > KollusPlayer > PallyConFPSSDK.framework

2. SRT字幕改行文字漏れに対する例外処理

3. StorageManager nilの場合ERROR_KOLLUS_STORAGE_IS_EMPTYエラー対応

1. PallyConFPSSDK.framework 2.1.0 更新
   PallyConFPSSDK.framework 2.1.0の更新方法
   　Appから交換が必要です。

   PallyConFPSSDK.framework 2.1.0は
   　添付ファイルのFolderにあります。
   　iOS SDK 2.3.14 > KollusPlayer > PallyConFPSSDK.framework

1. [KollusProxyPlayerView checkOutPut] 安定性を改善

1. AI倍速の安定性を改善

1. AI倍速コンテンツはios_player_typeによって再生

2. AI倍速コンテンツの情報N-screenに追加
   /// プレーヤー·タイプ : hw, sw, native
   @property (nonatomic, copy, readonly) NSString *iosPlayerType;

1. [KollusProxyPlayerView checkOutPut] 安定性を改善

2. H/W Decoder 再生する時、Background Sound 再生支援

3. 次回再生シナリオを適用

4. 次回再生 API追加
   /// 次回再生再生 Show Time
   @property (nonatomic, unsafe_unretained, readonly) NSInteger nextEpisodeShowTime;
   /// 次回再生再生 URL
   @property (nonatomic, copy, readonly) NSString *nextEpisodeCallbackURL;
   /// 次回再生再生 Params
   @property (nonatomic, readonly) NSMutableDictionary *nextEpisodeCallbackParams;

1. LMSコールバック内、AI倍速の再生時間追加:at_playtime

2. iOS 対応 : iOS12 以上

3. 連続にseek時、以前のタイミングの字幕が一時的に見える現象を修正

4. 2024.04.15: プライバシーマニフェスト対応

1. player ID変更されることを防止するためにbackup保存

2. Native PlayerでもAI倍速情報を配信

1. iOS Player swデコーダ設定時、h265映像Seek時に再生画面が非正常に出力される現象修正

2. AI倍速機能

3. 区間再生パラメータ追加

4. AI倍速関連API追加
   KollusPlayerView.hから
   /// AI倍速支援確認
   @property (nonatomic, unsafe_unretained) BOOL AIRateEnable;

   /// Repeat Start Time
   @property (nonatomic, unsafe_unretained, readonly) NSInteger nRepeatStartTime;
   /// Repeat End Time
   @property (nonatomic, unsafe_unretained, readonly) NSInteger nRepeatEndTime;

1. H265 Hardware Decoder機能追加

2. ブックマークタイトルにurlencodeを追加

3. 高倍速時に残像が残る現象を修正

1. Request Header追加

1. iOS SDK映像終了後、中央整列処理のためアプリでプレイヤーrelease処理

2. 有線イヤホン接続時、再生状態は従来のままに維持

3. Download DRM v2、支援

1. sdk-2108 エラー修正 (2024.08_Update)
   : 言語·地域/カレンダーから仏教歴を選択時
   Appに追加事項
   let dateFormatter = DateFormatter()
       dateFormatter.dateFormat = “yyyy/MM/dd”
       dateFormatter.calendar = Calendar(identifier: .gregorian)
       let expireDate = dateFormatter.date(from: dateString)

2. 有線イヤホン接続時のA/Vシンクイシュー修正

1. マイナーバグパッチパッチパッチ

1. Kollus Player(HW、SW)で再生すると講義再生開始後、他の講義再生時に黒い画面にサウンドだけが出る状況を修正

1. {PE} iOS モバイルプレーヤー8649エラー修正
   : jwt token にエパディングデータエラー処理

2. SDKによるUI反応なしの現象修正。
   : シンク関数 sendSynchronousRequest -> 非同期dataTaskWithRequestに変更

3. 再生開始前に終了時にcrash現象を修正
   : metal render 初期化中に終了時のエラー修正

1. player ID 獲得APIの追加
   /**
   KollusStorage スタート
   @param error エラー
   @return 成功時 YES, 失敗時 NOをリターン
   @warning このメソッドを呼び出さない場合、コンテンツ個数(contents Count)が0に返される
   @warning このメソッドは、キーチェーンからplayerID取得に失敗した場合
   最初の実行なら新しく作成後処理、最初の実行でなければ3回のリクエストすべて失敗時にエラー処理
   */
   - (BOOL)startStorageWithCheck:(NSError**)error;

   /**
   KollusStorage スタート
   @param error エラー
   @return 成功時 YES, 失敗時 NOをリターン
   @warning このメソッドを呼び出さない場合、コンテンツ個数(contents Count)が0に返される
   @warning このメソッドは、player IDを新たに生成してキーチェーンに登録してから使用
   */
   - (BOOL)startStorageWithNewPlayerID:(NSError**)error;

1. マルチ字幕機能の追加

2. 初期化中にキーチェーンにアクセスしてplayer IDが得られない場合、エラー処理

3. 追加されたAPI
   /**
   KollusStorage スタート
   @param first インストール後、最初の実行
   @param error エラー
   @return 成功時 YES, 失敗時 NOをリターン
   @warning このメソッドを呼び出さない場合、コンテンツ個数(contents Count)が0に返される
   */
   - (BOOL)startStorageWithFirst:(BOOL)first error:(NSError**)error;

   /**
   サブ字幕ファイル選択
   @param path 使用する字幕ファイルのPath
   @return bool true:成功 false:失敗
   */
   - (bool)setSubTitleSubPath:(char*)path;

   /// サブ字幕ファイルリスト
   @property (nonatomic, readonly) NSMutableArray* listSubTitleSub;

   /**
   コンテンツのサブ字幕転送
   @param kollusPlayerView KollusPlayerView ID
   @param charsetSub キャラクターセット
   @param captionSub 出力される字幕データ
   */
   - (void)kollusPlayerView:(KollusPlayerView*)kollusPlayerView charsetSub:(char*)charsetSub captionSub:(char* )captionSub;

1. H264ハードウェアデコーダの追加

2. IPHONEOS_DEPLOYMENT_TARGET : 9.0 -> 11.0 変更

1. LMS callback転送の際にPlayerのVolume, Playrate状態の値を追加

2. Multi DRM コンテンツの続き再生エラーを修正

1. 画質が変更された時にBandwidth情報をDelegateで転送するテスト用SDK
   : 
   /**
   HLS コンテンツのbitrate値を転送
   @param kollusPlayerView KollusPlayerView ID
   @param bitrate 情報
   */
   - (void)kollusPlayerView:(KollusPlayerView *)view bitrate:(int)bitrate;

1. play callback, drm callbackのレスポンスにdisable_tvout項目がない場合、default値がtrueに設定されて外部ディスプレイ出力許可をdefault NOにする
   : 外部ディスプレイ出力許可有無
   @property (nonatomic, unsafe_unretained, readonly) BOOL screenConnectEnabled;

2. downloadContent delegate リクエストを async -> sync に変更
   UI関連コードは以下のように非同期方式で使用する
   dispatch_async(dispatch_get_main_queue(), ^(void){
   // UI 関連コード
   });

1. disable_tvoutがfalseの場合、TV out, 画面ミラーリングを許可
   : 画面キャプチャー防止が解除

1. AVPlayerにてintro映像終了後、本番再生開始した場合に1番目のLMS Callbackが転送されたい現象: 修正

1. intro映像終了してから本番再生開始までにバッファリングイベント転送: 再生開始前にバッファリング

2. コンテンツダウンロードする際にforeground -> background -> foregroundになった場合ダウンロード進行率値が更新されない問題: 修正

3. AV Player使用する際にPause状態からSeekする際にPause処理