mixiボイスを投稿してみよう << mixi Developer Center (ミクシィデベロッパーセンター)

var params = {};
params[mixi.Status.Field.URL] =
        "http://mixi.jp/run_appli.pl?id=[アプリID]&appParams=...";
params[mixi.Status.Field.TOUCH_URL] =
        "http://mixi.jp/run_appli.pl?id=[アプリID]&appParams=...";
mixi.requestUpdateStatus("こんなに育ちました！", function(response) {
  if (response.hadError()) {
    var code = response.getErrorCode();
    var msg = response.getErrorMessage();
    // エラー時の処理
  } else {
    // 成功時の処理
  }
}, params);

requestUpdateStatus()関数を呼び出すことで、ユーザに発言の内容の入力を促すためのポップアップ画面が表示されます。そこで「つぶやく」ボタンを押下する、あるいは閉じるボタンなどの押下によりポップアップ画面が閉じられた際には、引数で渡したコールバック関数が呼び出されます。

第1引数には文字列を指定することで、発言の内容の初期値を設定することが可能です。ユーザからの発言となる文字列を指定してください。第1引数で指定可能な文字数は、URLを指定した場合は107文字まで、URLを指定しなかった場合は130文字までとなります。

コールバック関数に渡される引数のhadError()関数を呼び出すことで、投稿が正常に行われたかどうかを確認することが可能です。もしtrueが返却された際には、適切なエラー処理（ユーザに投稿できなかったことを表示するなど）を行ってください。getErrorCode()関数あるいは getErrorMessage()関数を呼び出すことで、その原因を得ることができます。

第3引数には、ボイスのつぶやきに含めたいURLを指定します。指定可能なURLは以下の通りです。この第3引数は、省略することも可能です。

URL: PC向けアプリの起動URL
TOUCH_URL: スマートフォン向けアプリの起動URL

各URLは、そのアプリを起動するためのURLのみが指定可能です。例えばPC向けアプリであれば「http://mixi.jp/run_appli.pl?id=12345」といったURLのみが記述可能となります。但し、そのURLの末尾は自由となりますので、appParamパラメータなどのクエリパラメータを記述することで、アプリ起動時にパラメータを渡すことができるようになります。これらのURLの指定により、投稿されたつぶやきには自動的にこれらを表す短縮URLが付与されます。

エラーコードおよびエラーメッセージは以下となります。

エラーコード	エラーメッセージ	発生する状況
401	Insufficient scope	mixi_apps2 スコープのユーザ認可を取得していない
403	Forbidden	ボイスの投稿が禁止されているとき
403	User canceled	ユーザが投稿をキャンセルしたとき
500	Internal server error	mixi側の内部エラー

このページの上部へ

mixi Developer Center (ミクシィ デベロッパーセンター)

mixiアプリ

mixiボイスを投稿してみよう

ボイス実装時の注意

mixiボイスAPI利用の事前準備

mixiボイスの投稿

mixi Developer Center (ミクシィデベロッパーセンター)