iOS 開発ガイド

最終更新 v2.0 2021.03.12 iOS SDK Sequence Diagram

Kollus SDK 概要

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

Kollus SDKの構成

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

KollusStorage
- 以下の作業を行います。
  - Kollus SDKの認証処理
  - コンテンツ情報を取得
  - コンテンツをダウンロード
  - コンテンツを削除
  - キャッシュデータの管理
KollusPlayerView
- 再生に関わる作業を行います。

コンテンツ再生の手順

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

KollusStorage

ストレージ生成

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

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

KollusStorageはアプリlication key, BundleID, expire dateを使用して認証を行います。
全てが一致しないと認証に失敗するためSDKを使用することができません。

コンテンツダウンロード

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

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

コンテンツダウンロードはKollusStorageの認証が完了してから使用可能です。
ストレージ生成プロセスを正常に完了してからコンテンツダウンロードを試してください。

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

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

アプリケーション側でinitWithContentURLメソッドを使用してKollusPlayerViewオブジェクトを生成する。
KollusPlayerViewは生成されたオブジェクトのIDをリターンする。
アプリケーション側で画面出力に使用するUIViewオブジェクトにaddSubViewメソッドを使用して生成されたKollusPlayerViewオブジェクトを挿入する。
アプリケーション側で事前に生成されているKollusStorageオブジェクトをsetStorageメソッドを使用してKollusPlayerViewに設定する。
アプリケーション側でsetDelegateメソッドを使用してKollusPlayerViewにデリゲートを設定する。
アプリケーション側でprepareToPlayWithError: メソッドを使用して1で入力された情報に該当するコンテンツの再生準備作業をリクエストする。
KollusPlayerViewはコンテンツ準備作業に成功 (完了) または失敗 (エラー) を取得し、5で設定したデリゲートにprepareToPlayWithError: デリゲートメソッドをリクエストして再生準備結果を転送する。
コンテンツ再生準備作業が完了するとアプリケーション側でplayWithErrorメソッドを使用してコンテンツ再生をリクエストする。
KollusPlayerViewはコンテンツ再生を開始する作業が完了またはエラーになった場合、5で設定したデリゲートにplayWithError: デリゲートメソッドをリクエストしてコンテンツ再生開始結果を転送する。
prepareToPlayWithError, playWithError メソッドはasync typeで、プロセス完了された時点に結果をデリゲートに転送されます。そのためメソッドの作業結果を取得する場合にはデリゲートに設定されたオブジェクトに以下のデリゲートメソッドを事前に作成する必要があります。
- kollusPlayerView:prepareToPlayWithError:
- kollusPlayerView playWithError:
デリゲートメソッドの定義はKolluPlayerDelegate.hファイルを確認してください。

コンテンツ再生 (ダウンロードコンテンツ)

ダウンロードされたコンテンツを再生するプロセスを説明します。