環境変数リファレンス
環境変数について
O₂ KAG からは、各種の環境変数を参照することができます。
変数の利用方法については「変数について」を参照してください。
環境変数一覧
変数名 | 型 | 値の意味 |
ev.ua | string | ユーザエージェント情報。 【例】Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_1) AppleWebKit/536.25 (KHTML, like Gecko) Version/6.0 Safari/536.25 |
ev.hostname | string | 現在接続しているホスト名。 【例】www.adsphere.jp |
ev.lang | string | ユーザのブラウザのサポート言語。 【例】ja-jp |
ev.query | object | コンテンツの HTML を開くときに渡された URL クエリパラメータ。 パラメータ名を添え字、パラメータの値を値とする連想配列オブジェクトの形となっています。 URL クエリパラメータが渡されていない場合は undefined となります。 【実例】 http://www.novelsphere.jp/gametitle/?hoge=abc というリクエストでコンテンツを開いている場合、 ev.query["hoge"] の値は "abc" である。 |
ev.req | object | 最後に行ったリクエストの返り値。 このオブジェクトの内部構造は、「ev.req オブジェクトについて」のとおりとなっています。 |
ev.geo | object | 最後に取得した位置情報。 このオブジェクトの内部構造は、「ev.geo オブジェクトについて」のとおりとなっています。 |
ev.req オブジェクトについて
環境変数のうち、ev.req オブジェクトは以下の構造を持ちます。
なお、[o2_request]タグによるリクエストを一度も行っていない場合には ev.req オブジェクトそのものが undefined となります。
変数名 | 型 | 値の意味 |
ev.req.stat | string | リクエストの返り値(ステータス行)。 【例】HTTP/1.0 200 OK |
ev.req.head | string | リクエストの返り値(ヘッダ)。 【例】 Cache-Control: private Content-Type: text/xml Server: Apache/1.3.42 (Unix) mod_ssl/2.8.31 OpenSSL/0.9.8e Date: Sun, 10 Apr 2005 11:34:23 GMT Connection: Close |
ev.req.body | string | リクエストの返り値(本体)。 【例】 <?xml version="1.0" encoding="utf-8" ?> <content>hoge</content> |
ev.geo オブジェクトについて
環境変数のうち、ev.geo オブジェクトは以下の構造を持ちます。
なお、以下の場合には ev.geo オブジェクトそのものが undefined となります。
- [o2_geo_get]タグや[o2_geo_watch]タグによるユーザの現在位置情報の取得を一度も行っていない場合
- ユーザのデバイスやブラウザが位置情報を取得する機能を持っていない場合
- O₂ Engine コンテンツが位置情報を取得することを、ユーザが拒否した場合
変数名 | 型 | 値の意味 |
ev.geo.coords | object | 位置情報を格納するオブジェクト。 以下の要素を持ちます。 |
ev.geo.coords.latitude | number | 最後に取得した緯度(単位:度)。 |
ev.geo.coords.longitude | number | 最後に取得した経度(単位:度)。 |
ev.geo.coords.altitude | number | 最後に取得した高度(単位:メートル)。 |
ev.geo.coords.accuracy | number | 最後に取得した緯度・経度の誤差(単位:メートル)。 |
ev.geo.coords.altitudeAccuracy | number | 最後に取得した高度の誤差(単位:メートル)。 |
ev.geo.coords.heading | number | 最後に取得した進行方向(単位:真北を0度、真南を180度とし、時計回りに加算していく角度)。 |
ev.geo.coords.speed | number | 最後に取得した速度(単位:メートル毎秒)。 |
ev.geo.timestamp | number | 最後に位置情報を取得した時刻(単位:1970年1月1日0時0分0秒0ミリ秒からの通算ミリ秒)。 |