Manual Message Retrieval
When you want full control on when and where in your application to display a ReachOut message to your users, you can define ReachOut messages of the type plain text or URL. From within the application call one of the below functions to check with the Usage Intelligence server whether there are any pending messages (of this type) waiting to be delivered.
You may choose to display plain text messages anywhere in the application such as in a status bar or information box. URL type messages can either be opened in a browser or else rendered it in a HTML previewer embedded within the application.
The difference between ruiCheckForReachOut() and ruiCheckForReachOutOfType() is that ruiCheckForReachOut() takes an ‘empty’ messageType parameter and fills it with the type of message that is sent by the server. In the case of ruiCheckForReachOutOfType(), the message type is specified by the developer and the server would then only send messages of that type.
The message type can be one of the following constants:
RUI_MESSAGE_TYPE_ANY (0)
RUI_MESSAGE_TYPE_TEXT (1)
RUI_MESSAGE_TYPE_URL (2)
For more information, see the following:
| • | Checking for Manual ReachOut Messages of Any Type |
| • | Checking for Manual ReachOut Messages of a Specified Type |
| • | Freeing the Memory Allocated by the SDK |