iOS 開発ガイド

最終更新 v2.0 2021.03.12 iOS SDK Sequence Diagram_2024.08.28_Review

1 Kollus SDK 概要
- 1.1 Kollus SDKの構成
- 1.2 コンテンツ再生の手順
2 KollusStorage
3 KollusPlayerView

Kollus SDK 概要

iOSデバイス (iPhoneまたはiPad端末機器)でKollusPlayerを生成、使用するために提供しているソフトウェア開発キット(SDK)です。
このSDKはCocoa ApplicationのUIView形式に基づいて制作されています。そのためSDKを使用する際にはUIView形式のクラスに該当する"KollusPlayerView"を生成し、画面上のサブビュー形態で挿入する必要があります。
アプリケーションに"KollusPlayerView"のメソッドを使用して動画再生に関わる一連の作業を行うこと形になります。
この文書では作業の流れのみ説明しています。他のメソッドにつきましてはiOS SDK_Oldから確認してください。

Kollus SDKの構成

KollusStorageとKollusPlayerViewクラスで構成されています。

KollusStorage
- 以下の作業を行います。
  - Kollus SDKの認証処理
  - コンテンツ情報を取得
  - コンテンツをダウンロード
  - コンテンツを削除
  - キャッシュデータの管理
KollusPlayerView
- 再生に関わる作業を行います。
  - コンテンツ再生 (ストリーミング, ダウンロード)
  - ブックマーク情報取得
  - ブックマークの登録と削除

コンテンツ再生の手順

KollusStorageの生成及び起動
KollusPlayerViewの生成
生成されたKollusPlayerViewに1.のKollusStorageを設定

KollusStorage

ストレージ生成

KollusStorageオブジェクトの生成及び起動のプロセス

アプリケーション側でKollusStorageのinitメソッドを使用してKollusStorageを生成する。
KollusStorageは生成されたidをリターンする。
アプリケーション側でKollusStorageのsetApplicationKeyメソッドを使用して認証キーを設定する。
アプリケーション側でKollusStorageのsetApplicationBundleIDメソッドを使用してBundle IDを設定する。
アプリケーション側でKollusStorageのsetApplicationExpireDateメソッドを使用してキーの有効期間を設定する。
アプリケーション側でKollusStorageのstartStorageメソッドをリクエストする。
KollusStorageは3, 4, 5から設定された情報で認証プロセスを行い、認証が正常に処理された場合YESを、認証に失敗した場合NOをリターンする。

コンテンツダウンロード

KollusStorageでコンテンツをダウンロードするプロセスを説明します。

アプリケーション側でKollusStorageのsetDelegateメソッドを使用してダウンロード状態を取得するデリゲートを設定する。
アプリケーション側でKollusStorageのloadContentURLメソッドを使用してダウンロードするコンテンツのURLを設定する。
KollusStorageはリクエストされたURLに該当するmediaContentKeyをリターンする。
アプリケーション側でKollusStorageのdownloadContentメソッドを使用してコンテンツダウンロードを開始する。
KollusStorageはコンテンツダウンロードが開始してからダウンロード状態が変更される度に1で設定したデリゲートのkollusStorage:downloadContent:error: デリゲートメソッドをリクエストする。

コンテンツ削除 (ダウンロード)

ダウンロードされているコンテンツを削除するプロセスを説明します。

アプリケーション側でremoveContent:error:メソッドを使用してKollusStorageに指定したmediaContentKeyに該当するコンテンツの削除をリクエストします。ここで渡すパラメータはKollusContent.mediaContentKeyを使用します。
KollusStorageは該当するコンテンツの削除結果をアプリケーション側にリターンします。(YES or NO)

キャッシュデータ削除

ストリーミング再生に使用したキャッシュデータを削除するプロセスを説明します。

KollusStorageにremeoveCacheWithErrorメソッドを使用して現在保存されているキャッシュデータの削除をリクエストします。
KollusStorageはキャッシュデータ削除の結果をアプリケーション側にリターンします。(YES or NO)

KollusPlayerView

コンテンツ再生 (ストリーミングコンテンツ)

ストリーミングコンテンツを再生するプロセスを説明します。

アプリケーション側でinitWithContentURLメソッドを使用してKollusPlayerViewオブジェクトを生成する。
KollusPlayerViewが生成されたらオブジェクトのIDをリターンする。
アプリケーション側で画面出力に使用するUIViewオブジェクトにaddSubViewメソッドを使用して生成されたKollusPlayerViewオブジェクトを挿入する。
アプリケーション側で事前に生成されているKollusStorageオブジェクトをsetStorageメソッドを使用してKollusPlayerViewに設定する。
アプリケーション側でsetDelegateメソッドを使用してKollusPlayerViewにデリゲートを設定する。
アプリケーション側でprepareToPlayWithError: メソッドを使用して1で入力された情報に該当するコンテンツの再生準備作業をリクエストする。
KollusPlayerViewはコンテンツ準備作業に成功 (完了) または失敗 (エラー) を取得し、5で設定したデリゲートにprepareToPlayWithError: デリゲートメソッドをリクエストして再生準備結果を転送する。
コンテンツ再生準備作業が完了するとアプリケーション側でplayWithErrorメソッドを使用してコンテンツ再生をリクエストする。
KollusPlayerViewはコンテンツ再生を開始する作業が完了またはエラーになった場合、5で設定したデリゲートにplayWithError: デリゲートメソッドをリクエストしてコンテンツ再生開始結果を転送する。