mixiアプリ作成入門（16） – アクティビティにつけたパラメータを解説してみた -
お久しぶりです！（うん、ほんとうにね。。）
マイキーです。
前回はアクティビティにパラメータを付与し、アクティビティのリンクから遷移されたときにパラメータの読み込みを行いましたので、今回はその内容を説明してみたいと思います。
まずは前回のサンプルをご覧ください。
<?xml version=”1.0″ encoding=”UTF-8″?>
<Module>
<ModulePrefs title=”test” description=”サンプル”>
<Require feature=”opensocial-0.8″ />
<Require feature=”dynamic-height” />
<Require feature=”views” />
</ModulePrefs>
<Content type=”html”><![CDATA[<script type="text/javascript">
function postActivity(activity_msg) {
var params = {};
params[opensocial.Activity.Field.TITLE] = activity_msg;var media = opensocial.newMediaItem(“image/gif”, “http://mixiap.info/image.gif”);
params[opensocial.Activity.Field.MEDIA_ITEMS] = [media];// 起動時に渡したいパラメータを準備する
var values = {
test: “true”,
action: “1″
};
var escaped = gadgets.io.encodeValues({
appParams: gadgets.json.stringify(values)
});// パラメータを付与する
params[opensocial.Activity.Field.URL] = “http://mixi.jp/run_appli.pl?id=アプリID” + “&” + escaped;
var activity = opensocial.newActivity(params);
opensocial.requestCreateActivity(
activity, opensocial.CreateActivityPriority.HIGH, activityResultCallback
);
}function activityResultCallback(status) {
if (status.hadError()) {
alert(“Error Creating activity.”);
}else{
var body = document.getElementById(“activity_area”);
body.innerHTML = ‘お知らせしました。’;
}
}// 起動時にパラメータチェック
window.onload = function(){
var params = gadgets.views.getParams();
var action = params["action"];
if(action == “1″){
alert(“アクティビティからのリンクです。”);
}
}
</script><div id=”activity_area”>
みんなにお知らせする？<br />
<div>
<input type=”button” name=”button” id=”send_activity” value=”知らせる” onclick=”postActivity(‘アクティビティテスト！’)” />
</div>
</div>]]></Content>
</Module>
アクティビティのリンクには、ひとつといわず複数のパラメータを付与することができます。
サンプルでは、「起動時に渡したいパラメータを準備する」の部分で values オブジェクトにすべてのパラメータを記述しています。
パラメータは「パラメータ名: 値」の形式で、複数設定したい場合はカンマ区切りで記述します。
values オブジェクトに記述したパラメータたちは gadgets.json.stringify() で文字列に変換し、appParams という名前のパラメータとしてひとまとめにします。
appParams: gadgets.json.stringify(values)
この部分ですね。
そしてそれをさらに、 gadgets.io.encodeValues を使ってURLのパラメータとして適切なフォーマットに変換します。
変換されたパラメータはいよいよ「パラメータを付与する」の段階に入ることができます。
必須のアプリIDのパラメータとは、アンパサンド (&) で連結してあげましょう。
このようにして送信されたアクティビティのリンクは、下記のようになります。
http://mixi.jp/run_appli.pl?id=xxxxx&appParams=%7B%22test%22%3A%22true%22%2C%22action%22%3A%221%22%7D&owner_id=xxxxx
ユーザーがこのリンクを通じてアプリにアクセスしてきたかどうかは、「起動時にパラメータチェック」のような例でチェックすることができます。
window.onload ではページの読み込みが完了した時に発生するイベントを指定できますが、サンプルではここでパラメータを受け取ってチェックしています。
パラメータを受け取るには、gadgets.views.getParams() という便利な関数があるのでこれを使います。
これを使ってサンプルのように params にパラメータを受け取った場合、action という名前のパラメータであれば
params["action"]
とすることで取り出すことができます。
サンプルでは、action というパラメータに「1」が入っていた場合にのみ特別なアクションを起こすように記述しています。
いかがでしたでしょうか？
アクティビティのリンクのURLに関してはすべてPC版で進めてしまいましたが、長々と続いたアクティビティシリーズも今回で一旦おしまいです。
mixiアプリ入門シリーズは今後も不定期に更新予定なので、次回テーマもお楽しみに！ 
Post Footer automatically generated by Add Post Footer Plugin for wordpress.
関連するmixiアプリ情報:
- mixiアプリ作成入門（15） – アクティビティにパラメータをつけてみる - こんにちは。 またもや久しぶりになってりまいました・・・マイキーです。失礼します ＞＜ 前回はアクティビティのリンク先を、通常「run_appli.pl」となっているところを「view_appli.pl」に変えてみました [...]...
- mixiアプリ入門（10） – アクティビティを送信してみる - ハロー！ パンプキンビスコのかぼちゃの味がけっこうリアルでびっくりしたマイキーです。 かぼちゃが好物です。 前回の入門で、アクティビティって何！という疑問を解決できたかたのために… 今回は、実際にアクティビテ [...]...
- mixiアプリ作成入門（14） – アクティビティのリンク先を変えてみる - こんにちは。 風邪なう。なマイキーです。。ゴホゴホ 前回はアクティビティのリンク先の基本情報についてご紹介しましたので、今回は予告通り、アクティビティのリンク先を実際に変えてみようと思います！ 「mixiアプリ入門（12 [...]...
- mixiアプリ入門（11） – 画像つきのアクティビティ - Hi! マイキーです。 シルバーウィーク中にひいた風邪がなかなか治りません 前回はアクティビティの送信のしかたについてご紹介しましたが、今回も引き続きアクティビティの送信についてのご紹介です 今度は画像つきのアクテ [...]...
- mixiアプリ入門（12） – 宛先指定のアクティビティ - こんにちは。 筋肉痛のせいでいつものバランスボールに乗って仕事ができないマイキーです 前回は画像付きのアクティビティの送信のしかたについてご紹介しました。 今回もアクティビティの送信シリーズで、宛先指定のアクティビテ [...]...
