SC_ScoresController

Instances of SC_ScoresController retrieve lists of scores from the server.

Basic use:

1. Get an instance of SC_Client .

2. Use the client instance to call SC_Client_CreateScoresController() .

3. Search criteria can be set as follows: Specify the search list for the controller by calling SC_ScoresController_SetSearchList() . You can specify the following search lists: SC_SCORES_SEARCH_LIST_ALL, SC_SCORES_SEARCH_LIST_24H, or SC_SCORES_SEARCH_LIST_USER_COUNTRY.

4. Set the mode for the controller by calling SC_ScoresController_SetMode() .

5. Request the scores by using one of the following loadScores methods:

   • SC_ScoresController_LoadScores()

   • SC_ScoresController_LoadScoresAroundScore()

   • SC_ScoresController_LoadScoresAroundUser()

6. Wait for a successful server response via delegate callbacks.

7. Once the request is complete, access the scores that were returned by calling SC_ScoresController_GetScores() .

To page through additional scores:

1. Call SC_ScoresController_HasNextRange() and SC_ScoresController_HasPreviousRange() to determine if it is possible to page.

2. Use SC_ScoresController_LoadNextRange() or SC_ScoresController_LoadPreviousRange() to request the next or previous list of scores from the server.

3. After a successful server response, access the SC_Scores_list that was returned, by calling SC_ScoresController_GetScores() .