The SC_UsersController requests lists of SC_User objects from the server based on different citeria.
User email address
The local address book
A social provider
Some of the basic Use Cases are listed below:
Set the match limit for the controller by using SC_UsersController_SetSearchLimit(). The search request stops returning user objects once this limit has been reached and will return only the number of matches instead. This number is limited to 999.
Set the flag that indicates whether the search should extend beyond users of the current game by calling SC_UsersController_SetSearchesGlobal().
Wait for a successful server response via delegate callbacks.
Call SC_UsersController_GetUsers() to access the list of users that is retrieved from the server.
Matched users will not be accessible.
Only the number of matched users will be accessible by using SC_UsersController_GetUsersCount().
Create an instance of UsersController, or re-use an existing instance.
Call SC_UsersController_LoadBuddies() to make the server request.
All the other search criteria are then ignored.
Wait for notification via delegate callbacks.
After a successful request, access the retrieved buddy list by using SC_User's SC_UsersController_GetUsers().
Last modified: 2014-05-14