achievement_load_progress()

ソーシャルゲーミング

achievement_load_progress †

サービスプロバイダからアチーブメントの達成状況を取得します

構文 †

achievement_load_progress()

戻り値 †

N/A

なし

説明 †

この関数はすべての利用可能なアチーブメントの情報をサーバーから取得するようリクエストを送信します。これによりソーシャル非同期イベントをトリガして、特別な変数"async_load"にds_map形式で値を格納します。このds_mapの"id"キーは定数"achievement_achievement_info"と一致している必要があります。キーと値についての詳細な説明は以下のとおりです

• id - この関数は"achievement_achievement_info"と一致しなければなりません
• numentries - アチーブメントのリストのサイズ
• AchN - アチーブメント名。"N"はエントリ番号を表す整数値
• AchCompN - アチーブメント達成状況。0〜100の数値文字列。"N"はエントリ番号を表す整数値

注意 †

この関数はiOSのみ有効です

例 †

iOSデバイスにてアチーブメントの達成状況の取得を要求するには以下のように記述します

if os_type == os_ios
{
  achievement_load_progress();
}

これによりアチーブメント情報の取得を要求し、非同期コールバックを生成して"async_load"変数にds_mapを格納します

var ident = ds_map_find_value(async_load, "id");
if ident == achievement_achievement_info
{
  var numentries = ds_map_find_value(async_load, "numentries");
  for(var i = 0; i < numentries; i++;)
  {
    ach_id[i] = ds_map_find_value(async_load, "Ach" + string(i));
    comp[i] = ds_map_find_value(async_load, "AchComp" + string(i));
  }
}

上記コードはds_mapの"id"キーが定数"achievement_achievement_info"と一致しているかどうかチェックし、一致していればエントリ数で名前と達成率を変数に格納しています