跳到主要内容

日記を書く

事前準備​

Mobageではユーザーが日記を書いて他のユーザーに公開することができます。Mobageオープンプラットフォームではこの機能をアプリケーションから使うためのAPIを提供しています。APIを使うと日記を作成するためのポップアップ画面がユーザーに表示されます。

このAPIを利用するには Gadget XMLで Require 要素で mbga feature の仕様を宣言する必要があります。

<?xml version="1.0" encoding="UTF-8"?>
<Module>
<ModulePrefs title="Hello, world!">
<Require feature="opensocial-0.8" />
<Require feature="mbga" />
...

日記の作成​

日記を作成するサンプルは以下のようになります。

var params = {};
var diary = mbga.newCreateDiary(params);

mbga.requestCreateDiary( diary, function(response) {
if (response.hadError()) {
// error
} else {
var diary = response.getData();
var url = diary.getEntryURL();
}
});
  • mbga.newCreateDiary() メソッドで Diary オブジェクトを作成します。
  • mbga.requestCreateDiary() メソッドで日記の作成を要求します。
  • リクエストが成功すると DataResponse に mbga.Diaryオブジェクトが格納されて返ってきます。

デフォルトのタイトルやコンテンツ、画像を指定する場合のサンプルは以下になります。

var mediaItem = opensocial.newMediaItem('image/png', 'http://example.com/kaizoku.png');
mediaItem.setField(opensocial.MediaItem.Field.TYPE, opensocial.MediaItem.Type.IMAGE);
var params = {};
params[mbga.Diary.Field.TITLE] = '海賊船を撃破した!';
params[mbga.Diary.Field.CONTENT] = '海賊船を撃破した記念写真です';
params[mbga.Diary.Field.MEDIA_ITEMS] = [ mediaItem ];
var diary = mbga.newCreateDiary(params);

mbga.requestCreateDiary( diary, function(response) {
if (response.hadError()) {
// error
} else {
var diary = response.getData();
var url = diary.getEntryURL();
}
});

コールバック処理について​

ユーザが日記を投稿した後、またはダイヤログの閉じるボタンを押した後にコールバック関数が呼び出されます。
サンプルでは日記投稿が成功すると エントリーされた投稿文のURLを取得しています。閉じるボタンで終了された場合の diary.getEntryURL() は undefined を返します。

mbga.requestCreateDiary( diary, function(response) {
if (response.hadError()) {
// error
} else {
var diary = response.getData();
var url = diary.getEntryURL();
if (url) {
// 日記投稿が行われた処理
} else {
// ダイヤログを閉じてキャンセルされた処理
}
}
});

更新履歴​

  • 2012/12/10
    • コールバック処理に関する記述を追加