183 lines
5.8 KiB
C
183 lines
5.8 KiB
C
#ifndef RC_API_INFO_H
|
|
#define RC_API_INFO_H
|
|
|
|
#include "rc_api_request.h"
|
|
|
|
#include <time.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* --- Fetch Achievement Info --- */
|
|
|
|
/**
|
|
* API parameters for a fetch achievement info request.
|
|
*/
|
|
typedef struct rc_api_fetch_achievement_info_request_t {
|
|
/* The username of the player */
|
|
const char* username;
|
|
/* The API token from the login request */
|
|
const char* api_token;
|
|
/* The unique identifier of the achievement */
|
|
unsigned achievement_id;
|
|
/* The 1-based index of the first entry to retrieve */
|
|
unsigned first_entry;
|
|
/* The number of entries to retrieve */
|
|
unsigned count;
|
|
/* Non-zero to only return unlocks earned by the user's friends */
|
|
unsigned friends_only;
|
|
}
|
|
rc_api_fetch_achievement_info_request_t;
|
|
|
|
/* An achievement awarded entry */
|
|
typedef struct rc_api_achievement_awarded_entry_t {
|
|
/* The user associated to the entry */
|
|
const char* username;
|
|
/* When the achievement was awarded */
|
|
time_t awarded;
|
|
}
|
|
rc_api_achievement_awarded_entry_t;
|
|
|
|
/**
|
|
* Response data for a fetch achievement info request.
|
|
*/
|
|
typedef struct rc_api_fetch_achievement_info_response_t {
|
|
/* The unique identifier of the achievement */
|
|
unsigned id;
|
|
/* The unique identifier of the game to which the leaderboard is associated */
|
|
unsigned game_id;
|
|
/* The number of times the achievement has been awarded */
|
|
unsigned num_awarded;
|
|
/* The number of players that have earned at least one achievement for the game */
|
|
unsigned num_players;
|
|
|
|
/* An array of recently rewarded entries */
|
|
rc_api_achievement_awarded_entry_t* recently_awarded;
|
|
/* The number of items in the recently_awarded array */
|
|
unsigned num_recently_awarded;
|
|
|
|
/* Common server-provided response information */
|
|
rc_api_response_t response;
|
|
}
|
|
rc_api_fetch_achievement_info_response_t;
|
|
|
|
int rc_api_init_fetch_achievement_info_request(rc_api_request_t* request, const rc_api_fetch_achievement_info_request_t* api_params);
|
|
int rc_api_process_fetch_achievement_info_response(rc_api_fetch_achievement_info_response_t* response, const char* server_response);
|
|
void rc_api_destroy_fetch_achievement_info_response(rc_api_fetch_achievement_info_response_t* response);
|
|
|
|
/* --- Fetch Leaderboard Info --- */
|
|
|
|
/**
|
|
* API parameters for a fetch leaderboard info request.
|
|
*/
|
|
typedef struct rc_api_fetch_leaderboard_info_request_t {
|
|
/* The unique identifier of the leaderboard */
|
|
unsigned leaderboard_id;
|
|
/* The number of entries to retrieve */
|
|
unsigned count;
|
|
/* The 1-based index of the first entry to retrieve */
|
|
unsigned first_entry;
|
|
/* The username of the player around whom the entries should be returned */
|
|
const char* username;
|
|
}
|
|
rc_api_fetch_leaderboard_info_request_t;
|
|
|
|
/* A leaderboard info entry */
|
|
typedef struct rc_api_lboard_info_entry_t {
|
|
/* The user associated to the entry */
|
|
const char* username;
|
|
/* The rank of the entry */
|
|
unsigned rank;
|
|
/* The index of the entry */
|
|
unsigned index;
|
|
/* The value of the entry */
|
|
int score;
|
|
/* When the entry was submitted */
|
|
time_t submitted;
|
|
}
|
|
rc_api_lboard_info_entry_t;
|
|
|
|
/**
|
|
* Response data for a fetch leaderboard info request.
|
|
*/
|
|
typedef struct rc_api_fetch_leaderboard_info_response_t {
|
|
/* The unique identifier of the leaderboard */
|
|
unsigned id;
|
|
/* The format to pass to rc_format_value to format the leaderboard value */
|
|
int format;
|
|
/* If non-zero, indicates that lower scores appear first */
|
|
int lower_is_better;
|
|
/* The title of the leaderboard */
|
|
const char* title;
|
|
/* The description of the leaderboard */
|
|
const char* description;
|
|
/* The definition of the leaderboard to be passed to rc_runtime_activate_lboard */
|
|
const char* definition;
|
|
/* The unique identifier of the game to which the leaderboard is associated */
|
|
unsigned game_id;
|
|
/* The author of the leaderboard */
|
|
const char* author;
|
|
/* When the leaderboard was first uploaded to the server */
|
|
time_t created;
|
|
/* When the leaderboard was last modified on the server */
|
|
time_t updated;
|
|
|
|
/* An array of requested entries */
|
|
rc_api_lboard_info_entry_t* entries;
|
|
/* The number of items in the entries array */
|
|
unsigned num_entries;
|
|
|
|
/* Common server-provided response information */
|
|
rc_api_response_t response;
|
|
}
|
|
rc_api_fetch_leaderboard_info_response_t;
|
|
|
|
int rc_api_init_fetch_leaderboard_info_request(rc_api_request_t* request, const rc_api_fetch_leaderboard_info_request_t* api_params);
|
|
int rc_api_process_fetch_leaderboard_info_response(rc_api_fetch_leaderboard_info_response_t* response, const char* server_response);
|
|
void rc_api_destroy_fetch_leaderboard_info_response(rc_api_fetch_leaderboard_info_response_t* response);
|
|
|
|
/* --- Fetch Games List --- */
|
|
|
|
/**
|
|
* API parameters for a fetch games list request.
|
|
*/
|
|
typedef struct rc_api_fetch_games_list_request_t {
|
|
/* The unique identifier of the console to query */
|
|
unsigned console_id;
|
|
}
|
|
rc_api_fetch_games_list_request_t;
|
|
|
|
/* A game list entry */
|
|
typedef struct rc_api_game_list_entry_t {
|
|
/* The unique identifier of the game */
|
|
unsigned id;
|
|
/* The name of the game */
|
|
const char* name;
|
|
}
|
|
rc_api_game_list_entry_t;
|
|
|
|
/**
|
|
* Response data for a fetch games list request.
|
|
*/
|
|
typedef struct rc_api_fetch_games_list_response_t {
|
|
/* An array of requested entries */
|
|
rc_api_game_list_entry_t* entries;
|
|
/* The number of items in the entries array */
|
|
unsigned num_entries;
|
|
|
|
/* Common server-provided response information */
|
|
rc_api_response_t response;
|
|
}
|
|
rc_api_fetch_games_list_response_t;
|
|
|
|
int rc_api_init_fetch_games_list_request(rc_api_request_t* request, const rc_api_fetch_games_list_request_t* api_params);
|
|
int rc_api_process_fetch_games_list_response(rc_api_fetch_games_list_response_t* response, const char* server_response);
|
|
void rc_api_destroy_fetch_games_list_response(rc_api_fetch_games_list_response_t* response);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* RC_API_INFO_H */
|