buffer_async_group_end

Syntaxe:

buffer_async_group_end();


Retours: Real


La description

Cette fonction termine la définition d'un groupe de sauvegarde de tampon. Vous devez avoir préalablement appelé la fonction buffer_async_group_begin() pour lancer le groupe, appelez la fonction buffer_save_async() pour chaque fichier que vous souhaitez enregistrer. Enfin, vous appelez cette fonction, qui va commencer la sauvegarde des fichiers. La fonction renvoie une valeur d'ID unique pour la sauvegarde, qui peut ensuite être utilisée dans l'événement Asynchronous Save pour


Exemple:

le buffer_async_group_end() La fonction peut être appelée à partir de n'importe quel événement, et comme elle est asynchrone, le rappel peut être presque instantané ou prendre plusieurs secondes. Appeler la fonction est simple et ressemblerait à ceci:

buffer_async_group_begin("SaveGame");
save1 = buffer_save_async(buff1, "Player_Save1.sav", 0, 16384);
save2 = buffer_save_async(buff2, "Player_Save2.sav", 0, 16384);
save3 = buffer_save_async(buff3, "Player_Save3.sav", 0, 16384);
save4 = buffer_save_async(buff4, "Player_Save4.sav", 0, 16384);
save_id = buffer_async_group_end();

Le code ci-dessus démarre un groupe de tampons puis le définit pour enregistrer 4 fichiers de manière asynchrone. La définition de groupe est alors terminée (à quel point la sauvegarde commence), en stockant l'ID de l'appel de fonction dans la variable " save_id ". Lorsque l'enregistrement est terminé, l'événement Save / Load asynchrone est déclenché et vous pouvez analyser async_load carte pour l'ID correct de la fonction, comme ceci:

if ds_map_find_value(async_load, "id") == saveid
   {
   if ds_map_find_value(async_load, "status") == false
      {
      show_debug_message("Save failed!");
      }
   }

Le code ci-dessus vérifiera d'abord l'identifiant de la carte ds_map créée, puis vérifiera l'état du rappel, en publiant un message de débogage s'il y a eu des problèmes.