Syntaxe:

steam_upload_score(lb_name, score);

Retours: Real

La description

Cette fonction enverra un score au classement donné. Le score à télécharger est un nombre réel, et le nom du classement est une chaîne qui a été définie lorsque vous avez créé le classement en utilisant la fonction steam_create_leaderboard. Si la fonction échoue, elle renvoie une valeur de -1, alors qu'un post réussi renvoie un identifiant unique pour le téléchargement et déclenche un événement Steam asynchrone. Cet événement va créer un ds_map dans la variable intégrée async_load avec les paires clé / valeur suivantes:

• " event_type " - Cette clé contiendra la valeur " leaderboard_upload " lorsqu'elle est déclenchée par cette fonction
• 
  
• " lb_name " - Cette clé contient le nom du leaderboard qui a été posté sur
• 
  
• " succès " - Sera 1 si le poste a réussi, 0 a échoué
• 
  
• " updated " - Sera 1 si le score du classement a été réellement mis à jour (ie: le nouveau score était meilleur) ou 0 sinon
• 
  
• " post_id " - Cette clé doit correspondre à la valeur d'ID renvoyée par l'appel de téléchargement
• 
  
• " score " - Cette clé contient le score qui a été posté
• 
  

Exemple étendu:

Dans cet exemple, nous importons d'abord une partition, puis analysons la async_load carte retournée en cas de succès. Le code ci-dessous montre un exemple typique de téléchargement:

if (hp <= 0)
   {
   upload_ID = steam_upload_score("Game Scores", score);
   if (!upload_ID)
      {
      alarm[0] = room_speed;
      }
   }

Notez que nous avons défini une alarme si l'appel échoue. Cela sera utilisé pour essayer le téléchargement plus tard et vous pouvez ajouter du code supplémentaire pour réessayer le téléchargement ou enregistrer le score dans un fichier texte s'il continue à échouer, etc... Nous ajoutons maintenant ce qui suit dans le Evénement asynchrone Steam pour l'instance contrôlant les scores:

var type = ds_map_find_value(async_load, "event_type");
if (type == "leaderboard_upload")
   {
   var lb_ID = ds_map_find_value(async_load, "post_id");
   if lb_ID == upload_ID
      {
      var lb_name = ds_map_find_value(async_load, "lb_name");
      var lb_done = ds_map_find_value(async_load, "success");
      var lb_score = ds_map_find_value(async_load, "score");
      var lb_updated = ds_map_find_value(async_load, "updated");
      show_debug_message("leaderboard post id:" + string(lb_ID) + " to lb:" + string(lb_name) + " with score:" + string(lb_score) + " updated=" + string(lb_updated));
      if (lb_done)
         {
         show_debug_message("- Succeeded");
         }
      else
         {
         show_debug_message("- Failed");
         }
      }
   }

Dans l'exemple, nous publions simplement les valeurs de retour dans la fenêtre du compilateur en tant que messages de débogage, mais vous pouvez utiliser cet événement pour traiter les informations de la manière que vous choisissez.