メインコンテンツまでスキップ

URL Scheme 連携

モバイル Web ブラウザから Kollus モバイルアプリがインストールされたデバイスを対象に、カスタム URL Scheme(kollus://)を呼び出すことで、プレイヤーを直接起動したり特定の動作を実行したりすることができます。 このドキュメントでは、Android と iOS 環境で共通してサポートされている呼び出しオプションおよび規格について説明します。

事前確認事項​

  • 区切り文字のルール: Scheme の後に ? を付け、各パラメーターは & で区切って連結します。
  • 再生 URL の構成: 呼び出し時に渡す url パラメーターの値は、プレイヤー呼び出し規格に沿って生成された URL である必要があります。
  • 必須エンコード: URL Scheme に含まれるすべてのパラメーターの値は、必ず URI エンコード(Percent-encoding)処理を行う必要があります。

呼び出し規格​

再生​

コンテンツを Kollus モバイルアプリで即時再生します。macOS 専用の Kollus Player も、モバイルアプリと同じ URL Scheme 規格を使用して呼び出すことができます。

Scheme​

kollus://path

パラメーター​

パラメータータイプ説明
urlstring再生 URL

呼び出し例​

kollus://path?url=https%3A%2F%2Fv.jp.kollus.com%2Fsi%3Fjwt%3D{JWT}%26custom_key%3D{CUSTOM_KEY}%26title%3D{CUSTOM_TITLE}

ダウンロード​

機能の有効化

ダウンロード機能を使用するには、該当コンテンツが登録されているチャンネルの設定でダウンロード機能を有効化する必要があります。

コンテンツファイルを Kollus モバイルアプリ内のストレージにダウンロードします。

Scheme​

kollus://download

パラメーター​

パラメータータイプ説明
urlstringダウンロードするコンテンツの再生 URL
folderstring（オプション）コンテンツが保存されるフォルダーパス。このフォルダーパスは実際の物理的なパスではなく、プレイヤーアプリ内の仮想構造であり、media/movie/video のように設定できます。

複数ダウンロードの呼び出し例​

kollus://download?url={ENCODED_URL_1}&url={ENCODED_URL_2}&url={ENCODED_URL_3}

ダウンロード済みコンテンツの再生​

デバイスにダウンロードされたコンテンツを Kollus モバイルアプリで再生します。 該当コンテンツファイルがデバイスから削除されているか存在しない場合、URL Scheme の呼び出しは自動的に無視され、プレイヤーは何も動作を行いません。

Scheme​

kollus://download_play

パラメーター​

パラメータータイプ説明
urlstringダウンロード済みコンテンツの再生 URL

ダウンロード完了リストの表示​

Kollus モバイルアプリを起動し、ダウンロード完了済みのコンテンツ一覧画面を即時表示します。 特定のフォルダーのコンテンツ一覧のみ表示したい場合は、folder パラメーターを指定してください。

Scheme​

kollus://list

パラメーター​

パラメータータイプ説明
folderstring該当フォルダーに保存されたコンテンツ一覧のみ表示（未指定の場合は最上位フォルダーの一覧を表示）