クエリ情報の取得

編集
この機能は実験的な機能であり、将来仕様が変更される可能性があります。予めご了承ください。

概要

ブラウザのロケーションバーに入力されたクエリパラメータを取得することができる機能です。 ただし、すべてのクエリパラメータが取得可能というわけではなく、あらかじめRPGアツマールで予約された、param1 ~ param9 までの固定パラメータのみ値を取得できます。

なにができるのか

クエリ情報の取得

スクリーンショットのように、ブラウザのロケーションバーに入力されたクエリパラメータを参照できます。

利用想定/利用例

以下のような利用を想定しています。

  • 秘密のURLからゲームを起動したときだけプレイできる隠し要素
  • 他のゲームから 外部リンク 経由で開いてもらうことによる、ゲーム間連携
  • スクリーンショット撮影時にクエリを付加しておき、Twitterからアクセスした時に特殊動作

例えば、次のサンプルゲームではツイート文章の変更機能を利用し、クエリパラメータに福笑いの状態を設定しています。

利用方法

クエリ情報の取得は次の方法で利用できます。

方法場所
公式プラグインGithub
ゲームAPI以下の「APIでの利用方法」を参考に、直接APIを呼び出してください

公式プラグインの利用方法

公式プラグインでクエリパラメータを取得するには以下のようにします。

  1. プロジェクトのプラグインフォルダに AtsumaruQueryExperimental.js を右クリックし「保存」して設置
  2. イベントに AtsumaruQueryExperimental プラグインを設定
  3. プラグインコマンドでクエリパラメータを取得

クエリ情報取得プラグイン利用例

プラグインコマンドは次のいずれかのように指定します。(どちらでも動作は同じです)

CopyQuery {id1} {id2} ...
クエリ取得 {id1} {id2} ...

それぞれの {id} には任意の変数idを指定できます。 指定した順番に、 param1 から param9 までのクエリパラメータの値が順番にコピーされます。

プラグインコマンド例

変数10番にparam1の値を、変数11番にparam2の値を、変数12番にparam3の値をコピーする
CopyQuery 10 11 12
クエリ取得 10 11 12

APIでの利用方法

APIを利用したquery情報取得方法

query情報取得API

メソッドwindow.RPGAtsumaru.experimental.query[key]
説明引数のkeyに指定した文字列のquery情報を取得します。
引数query名を表す文字列
戻り値query名に指定したqueryの値
リリース日2018/01/18
更新日2018/01/18