URL Scheme 連携
お知らせ
このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特 性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。
モバイル Web ブラウザから Kollus モバイルアプリがインストールされたデバイスを対象に、カスタム URL Scheme(kollus://)を呼び出すことで、プレイヤーを直接起動したり特定の動作を実行したりすることができます。
このドキュメントでは、Android と iOS 環境で共通してサポートされている呼び出しオプションおよび規格について説明します。
事前確認事項
- 区切り文字のルール: Scheme の後に
?を付け、各パラメーターは&で区切って連結します。 - 再生 URL の構成: 呼び出し時に渡す
urlパラメーターの値は、プレイヤー呼び出し規格に沿って生成された URL である必要があります。- 参考文書: プレイヤー呼び出し ドキュメントを参照して再生 URL を構成してください。
- 必須エンコード: URL Scheme に含まれるすべてのパラメーターの値は、必ず URI エンコード(Percent-encoding)処理を行う必要があります。
呼び出し規格
再生
コンテンツを Kollus モバイルアプリで即時再生します。macOS 専用の Kollus Player も、モバイルアプリと同じ URL Scheme 規格を使用して呼び出すことができます。
Scheme
kollus://path
パラメーター
| パラメーター | タイプ | 説明 |
|---|---|---|
url | string | 再生 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
パラメーター
| パラメーター | タイプ | 説明 |
|---|---|---|
url | string | ダウンロードするコンテンツの再生 URL |
folder | string | （オプション）コンテンツが保存されるフォルダーパス。このフォルダーパスは実際の物理的なパスではなく、プレイヤーアプリ内の仮想構造であり、media/movie/video のように設定できます。 |
複数ダウンロードの呼び出し例
kollus://download?url={ENCODED_URL_1}&url={ENCODED_URL_2}&url={ENCODED_URL_3}
ダウンロード済みコンテンツの再生
デバイスにダウンロードされたコンテンツを Kollus モバイルアプリで再生します。 該当コンテンツファイルがデバイスから削除されているか存在しない場合、URL Scheme の呼び出しは自動的に無視され、プレイヤーは何も動作を行いません。
Scheme
kollus://download_play
パラメーター
| パラメーター | タイプ | 説明 |
|---|---|---|
url | string | ダウンロード済みコンテンツの再生 URL |
ダウンロード完了リストの表示
Kollus モバイルアプリを起動し、ダウンロード完了済みのコンテンツ一覧画面を即時表示します。
特定のフォルダーのコンテンツ一覧のみ表示したい場合は、folder パラメーターを指定してください。
Scheme
kollus://list
パラメーター
| パラメーター | タイプ | 説明 |
|---|---|---|
folder | string | 該当フォルダーに保存されたコンテンツ一覧のみ表示（未指定の場合は最上位フォルダーの一覧を表示） |