Syntaxe:

steam_ugc_send_query(ugc_query_handle);

Renvoie: Boolean

La description

Cette fonction peut être utilisée pour envoyer une requête. Vous définissez d'abord la requête en utilisant le steam_ugc_create_query_*() fonctions qui retourneront un "handle de requête". Cette poignée est ensuite utilisée pour définir les filtres etc.... avant d'être utilisée dans cette fonction pour envoyer la requête. La fonction renvoie une valeur d'ID asynchrone unique qui peut être utilisée pour vérifier correctement les détails dans l'événement Steam Async. Cet événement aura le async_load Carte DS qui sera remplie avec les paires clé / valeur suivantes:

1. " id " - L'identifiant asynchrone renvoyé par la fonction qui a déclenché l'événement
2. 
   
3. " résultat " - Le résultat de l'opération (une valeur réelle). Ce sera soit la constante GML ugc_result_success ou un autre nombre réel. Vous devriez donc vérifier cette constante pour vous assurer que l'appel a réussi et, dans le cas contraire, que quelque chose n'a pas fonctionné correctement. Le reste des valeurs possibles renvoyées sont affichées comme le résultat de la valeur Steam "EResult" et vous devriez voir steamclientpublic.h dans les en-têtes SDK pour toutes les 89 valeurs possibles.
4. 
   
5. " event_type " - La chaîne " ugc_query "
6. 
   
7. " num_results " - Le nombre de résultats renvoyés (max 50)
8. 
   
9. " total_matching " - Le nombre total de résultats correspondants
10. 
    
11. " cached_data " - Indique si ces données ont été extraites du cache local sur le disque ou non (seront soit true ou false )
12. 
    
13. " results_list " - Index d'index de liste DS, où chaque entrée de liste est un index de DS Map contenant les détails de l'élément particulier

Lorsque vous obtenez le type d'événement asynchrone "ugc_query", vous pouvez ensuite analyser la liste des résultats et extraire les informations suivantes de chacune des cartes DS (une carte par élément dans la liste):

1. " published_file_id" "-Faites l'id unique du fichier publié pour l'article
2. 
   
3. " file_type " - Le type de fichier utilisé
4. 
   
5. " creator_app_id " - L'identifiant Steam du créateur de l'objet
6. 
   
7. " consumer_app_id " - L'identifiant Steam du consommateur de l'article
8. 
   
9. " title " - Le titre de l'article
10. 
    
11. " description " - La description de l'article
12. 
    
13. " steam _id_owner " - L'identifiant Steam du propriétaire de l'objet
14. 
    
15. " time_created " - L'heure à laquelle l'élément a été créé
16. 
    
17. " time_updated " - La dernière fois que l'élément a été mis à jour
18. 
    
19. " time_added_to_user_list " - Heure à laquelle l'élément a été abonné
20. 
    
21. " visibility " - La visibilité de l'article (voir steam_ugc_set_item_visibility() pour les constantes renvoyées)
22. 
    
23. " banni " - Si l'objet a été banni ( true ) ou pas ( false )
24. 
    
25. " accepted_for_use " - Si l'article a été accepté pour utilisation ( true ) ou pas ( false )
26. 
    
27. " tags_truncated " - Version courte des tags en tant que tableau
28. 
    
29. " tags " - Une chaîne contenant les tags de l'article, séparés par une virgule
30. 
    
31. " handle_file " - Le handle de fichier unique pour l'élément
32. 
    
33. " handle_preview_file " - Le handle unique pour l'aperçu de l'image pour l'élément (peut être utilisé comme argument avec steam_ugc_download() télécharger une image d'aperçu)
34. 
    
35. " filename " - Le nom du fichier d'élément
36. 
    
37. " file_size " - La taille du fichier d'article
38. 
    
39. " preview_file_size " - La taille de l'image d'aperçu
40. 
    
41. " url " - L'URL complète de l'élément
42. 
    
43. " votes_up " - Le nombre de votes reçus
44. 
    
45. " votes_down " - Le nombre de votes négatifs reçus
46. 
    
47. " score " - Le score global de l'objet
48. 
    
49. " account_id_owner " - L'identifiant de compte du propriétaire de l'identifiant Steam (ceci peut être utilisé dans la fonction steam_ugc_create_query_user_ex() )
50. 
    

Exemple:

var query_handle = steam_ugc_create_query_all(ugc_query_RankedByTrend, ugc_match_Items, 1);
steam_ugc_query_add_required_tag(query_handle, "RPG");
steam_ugc_query_set_return_long_description(query_handle, true);
steam_ugc_query_set_allow_cached_response(query_handle, true);
query_ID = steam_ugc_send_query(query_handle);

Le code ci-dessus crée une demande de requête et stocke son handle dans une variable locale pour une utilisation future dans le reste des fonctions qui définissent davantage la requête de requête avant d'envoyer la requête.