# V/G Query String

### 使用方法 <a href="#vgquerystring-shi-yong-fang-fa" id="vgquerystring-shi-yong-fang-fa"></a>

```
http://v.jp.kollus.com/[MEDIA_CONTENT_KEY]?key=value&...
```

query stringの場合、urlの後ろに”?”を付けてkeyとvalueを=で結びます。data typeがnullの場合、keyのみ付けます。keyとvalueの組を複数結ぶ場合には&で区別します。

### プレイヤー区分 <a href="#vgquerystringplayer-shi-fen" id="vgquerystringplayer-shi-fen"></a>

Playerは以下の名称で統一します。

* モバイル : Mobile
  * iOS player app : iOS
  * Android player app : Android
* PC : Desktop
  * Flash Player : Flash
  * V2 Player (ActiveX, NPAPI Player) : V2
  * V3 Security Player (インストール型・AgentタイプのPlayer) : V3e
  * V3 Security Player (HTML5 AgentタイプのPlayer) : V3h
  * V4 Player (HTML5 Player, ブラウザ対応標準Player) : V4

### パラメータ <a href="#vgquerystring-paramta" id="vgquerystring-paramta"></a>

| key                       | DataType | 対応Player         | 説明                                                                                                                                                                                                                       |
| ------------------------- | -------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| pf                        | string   | All              | プロファイルの自動設定に関係なく指定されたプロファイルキーに該当するトランスコーディングファイルをServing。存在しない場合には自動設定。 例> ?pf=mixnut-pc-high1 (mixnut-pc-high1に該当するトランスコーディングファイルをServing)                                                                              |
| autoplay (a)              | null     | All              | 自動で再生を開始。但し、モバイルPlayerアプリはデフォルト値が自動開始となります。 (オプションに影響されない)                                                                                                                                                               |
| mute                      | null     | All              | ミュート状態で再生を開始。Mobile HTML5 Playerは対応不可。                                                                                                                                                                                   |
| download                  | null     | Mobile, V3e, V3h | コンテンツダウンロード機能。download optionを追加するとVideo gatewayがダウンロードモードで動作します。チャンネルからモバイル又はPC ダウンロードオプションを使用しない設定にした場合、 ダウンロードを試してもPlayer側でダウンロードをさせない。                                                                               |
| title                     | string   | All              | 元タイトルを表示する代わりに強制指定したタイトルに変更する。Mobile HTML5 Playerは対応不可                                                                                                                                                                   |
| t                         | integer  | All              | <p>指定された時点から自動再生。Nscreenデータに関係なくここで指定された時点から再生されます。(続き再生のポップアップが表示されます。) 例> ?t=10 (10秒から再生)<br>（参考）次のような時間設定では、パラメータは適用されません。<br>動画開始から10秒未満の場合、「最初から再生」されます。 <br>動画終了まで10秒未満の時に「最初から再生」されます。</p>                        |
| s                         | integer  | All              | <p>指定した時点から自動再生。tオプションと異なってs オプションは続き再生ポップアップが表示されません。<br>（参考）次のような時間設定では、パラメータは適用されません。<br>動画開始から10秒未満の場合、「最初から再生」されます。 <br>動画終了まで10秒未満の時に「最初から再生」されます。</p>                                                             |
| autoplay=false (a=false)  | null     | All              | t, s パラメータを適用した際に、自動再生を止めます。                                                                                                                                                                                             |
| force\_exclusive\_player  | null     | V2, V3e, V3h     | 非暗号化コンテンツをPC専用Playerで再生されるように強制指定。(モバイルは対応不可)                                                                                                                                                                            |
| uservalue0\~99            | mixed    | All              | uservalue0\~99までの値を設定                                                                                                                                                                                                    |
| brightness                | integer  | V2               | 明るさレベルを設定。設定範囲は -50 <= brightness <= 50 となります。 Defaultは0                                                                                                                                                                 |
| contrast                  | integer  | V2               | コントラストレベルを設定。設定範囲は -50 <= contrast <= 50となります。Defaultは0                                                                                                                                                                  |
| saturation                | integer  | V2               | カーラートーンを設定。設定範囲は -50 <= saturation <= 50となります。Defaultは0                                                                                                                                                                  |
| mobile\_return\_url       | string   | iOS              | 再生中バックキーを押すかまたは再生終了した場合に指定したURLをsafari web browserで開く                                                                                                                                                                    |
| mobile\_folder\_download  | string   | Mobile           | モバイルダウンロードのフォルダを指定 例> フォルダ1/フォルダ2/フォルダ3                                                                                                                                                                                  |
| wmode                     | string   | Flash            | PCの場合Flash playerのwmodeを強制指定する。指定してない場合には‘direct’になる。wmodeは以下の中で一つを指定します。 例> direct, transparent, window, opaque, gpu                                                                                                    |
| pc\_player\_version       | string   | Desktop          | PCでPlayer2.0又は3.0の中で使用するバージョンを指定。指定してない場合2.0が再生不可能な環境(3.0では再生できる前提として) の場合には自動で3.0が立ち上がる。以下の中で一つを指定します。 選択可能オプション> v2, v3, v3e \* v3eに指定した場合にはv3 専用Playerが呼出されます。 \* 互換性の問題で維持中。新規使用の場合、下のplayer\_versionオプションを使用するように推奨 |
| player\_version           | string   | Desktop          | PCで Player2.0 \~ 4.0の中で使用するバージョンを指定。指定しない場合、視聴環境に適合するPlayerが自動で起動します。以下の中で一つを指定します。 選択可能オプション> v2, v3, v3e, html5\* v3eに指定した場合にはv3 専用Playerが呼出されます。                                                                      |
| pc\_folder\_download      | string   | V2, V3e, V3h     | PCダウンロードのフォルダ名を指定 例> フォルダ1/フォルダ2/フォルダ3                                                                                                                                                                                   |
| play\_downloaded\_file    | null     | V3e, V3h         | ダウンロードされたファイルを再生する。                                                                                                                                                                                                      |
| buffer                    | integer  | V2, V3e, V3h     | バッファリング時間を指定。2 <= buffer <= 10 の中で定数のみ指定可能。基本値の倍数として適用されます。 例> 2 → 基本値の2倍                                                                                                                                                |
| show\_controls\_paused    | boolean  | Flash, V4        | Trueの場合、一時停止状態からinactive 状態に変わったときcontrolbarとoverlay buttonをそのまま表示する。(Default : false)                                                                                                                                   |
| show\_poster\_ended       | boolean  | Flash, V4        | Trueの場合、再生が終了した後ポスターイメージを表示する。(Default : false)                                                                                                                                                                          |
| overlay\_button\_position | string   | Flash, V4        | Overlay buttonの場所を設定する。 - TR : Top & Right - TL : Top & Left - BR : Bottom & Right - BL : Bottom & Left 設定されてない場合、又は上記以外の値を入れた場合には真ん中に整列されて表示されます。                                                                       |
| loadcheck                 | integer  | V3               | 0: play callback でメッセージを使用する。                                                                                                                                                                                            |
| enable\_initialize\_focus | boolean  | V3, V4           | ディフォルトはtrueですfalseで設定時プレイヤーローディング時フォーカスが適用ｓあれないです。                                                                                                                                                                       |
| ios\_player\_type         | string   | iOS              | <p>iOSのデコーダータイプを設定します。</p><ul><li>native：ネイティブデコーダーに設定します。</li><li>hw：ハードウェアデコーダーに設定します。</li><li>sw：ソフトウェアデコーダーに設定します。</li><li><strong>この設定はiOS Kollus Player 2.2.14以上で動作します。</strong></li></ul>                         |

### **サービスサポート**

> サンプルコードについてのお問い合わせは担当までご連絡ください。
>
> E-mail お問い合わせ > jp\_team@catenoid.net
>
> 電話番号 > 03-4405-8462
