mixiアプリ » 技術仕様（RESTful API方式） » PC » 友人を招待しよう
友人を招待しよう
使っていてとても楽しいmixiアプリは、友人に勧めたくなります。そして、利用を勧められたユーザが同じことを思い、他の友人に利用を勧めます。この連鎖が起きれば起きるほど、mixiアプリの広がる速度が速くなります。
OpenSocialでは、他のユーザにアプリケーションを勧めるための招待機能を定めています。mixiアプリにおいても、友人にmixiアプリの利用を勧めるために、この招待機能を提供しています。
友人を招待する
mixiアプリから招待機能を利用するためには、opensocial.requestShareApp()関数を利用します。この関数を呼び出すことによって、このmixiアプリを利用していないユーザに対して利用を勧めることが可能です。
opensocial.requestShareApp("VIEWER_FRIENDS", null, function(response) {
if (response.hadError()) {
var errCode = response.getErrorCode();
// do something...
} else {
// do something...
}
});
requestShareApp()関数の引数は、以下となります。
- 第１引数は、”VIEWER_FRIENDS”を指定します。
- 第２引数は、nullを指定します（何を渡しても無視されます）。
- 第３引数は、招待が行われた後に呼び出されるコールバック関数を指定します。
requestShareApp()関数を呼び出すと、ユーザに以下のようなポップアップ画面が表示されます。
ユーザがこのポップアップ画面を利用して友人を選択し、メッセージを入力して[招待する]ボタンを押すことで、選択された友人にmixiアプリに利用を勧める招待が行われます。この段階では友人は対象のmixiアプリをインストールしている状態にはなりません。
ポップアップ画面が閉じた後に、第３引数で渡したコールバック関数が呼び出されます。このコールバック関数内で、招待に対する後処理を行うことが可能です。
requestShareApp()関数の利用制限
requestShareApp()関数は、mixiアプリがrun_appli.pl上で動作している場合にのみ利用することが可能です。その他の画面でrequestShareApp()関数を呼び出した場合は、何も処理が行われません（FORBIDDENを持つエラー情報がコールバック関数に渡されます）。
また、requestShareApp()関数は、mixiアプリを実行しているユーザ（Viewer）がそのアプリを所有している必要があります。もし所有していなかった場合は、何も処理が行われません（FORBIDDENを持つエラー情報がコールバック関数に渡されます）。
招待したユーザの取得について
mixiアプリによっては、ユーザが実際に誰を招待したのかを知りたくなることでしょう。requestShareApp()関数に指定したコールバック引数から、ユーザが選択し招待を行った友人のIDを知ることができます。
opensocial.requestShareApp("VIEWER_FRIENDS", null, function(response) {
var recipientIds = response.getData()["recipientIds"];
// do something...
});
コールバック関数に渡される引数から、getData()関数を呼び出し、その結果が持つ”recipientIds”プロパティ値を取得します。この値は、ユーザが選択し招待を行った友人のユーザIDの配列となります。