SC_MessageController

The SC_MessageController is used to post messages to a set of social networks or other receivers.

Posted messages usually refer to some Scoreloop-related event such as:

• Achieving a score

• Creating a challenge

• Winning a challenge

• Achieving an award

• Inviting someone to join Scoreloop.

NOTE:

1. Where applicable, the user has to be logged in to the social network to be able to post messages.

Basic use: To post a message to a social network:

1. First check that the user is already connected to a social network. To do this, use the SC_SocialController_IsConnectedToSocialNetwork() API.

2. If the user is not connected, connect by calling SC_SocialController_ConnectToSocialNetwork().

3. Once connected, create an instance of SC_MessageController by calling SC_Client_CreateMessageController() .

4. Use SC_MessageController to create an SC_Message instance of the desired type by calling one of the following create message methods:

   • SC_MessageController_CreateGameInvitationMessage()

   • SC_MessageController_CreateGameRecomendationMessage()

   • SC_MessageController_CreateMessageForAchievement()

   • SC_MessageController_CreateMessageForChallenge()

   • SC_MessageController_CreateMessageForGame()

   • SC_MessageController_CreateMessageForScore()

5. Add receivers to the message by calling one of the following add receiver APIs:

   • SC_Message_AddEmailReceiver()

   • SC_Message_AddSocialNetworkReceiver()

   • SC_Message_AddUserReceiver()

6. Call SC_MessageController_SubmitMessage() to post the message.

See also:

SC_SocialNetwork

SC_Message