Directed Text

Learn how to send and receive direct text messages to other users.

Read time 1 minute

Last updated 8 months ago

Vivox provides directed text by using a similar process to what is used for group text. You can add players to existing text sessions, and you can send text messages directly to any user who is signed in, independent of being in a channel with them.

Use directed text for short user-to-user messages (sometimes called whispers or private/direct messages), or to implement invite to channel capabilities.

Note

To receive directed text messages, a user must be signed in with

enable_buddies_and_presence = 1

. For more information about Buddies and Presence, see Presence capabilities.

Use the

vx_req_account_send_msg

request to send a text message to another user.

Note

login_state_logged_in

indicates that a user is signed in and can issue further requests, but it does not guarantee that the user can receive direct text messages. A best practice is using the

vx_evt_presence_updated

event to indicate when the local participant is available to receive direct text messages.

Using

vx_evt_presence_updated

is not mandatory. However, in testing scenarios where there could be more than one user signed into the local SDK messaging each other,

vx_evt_presence_updated

guarantees the availability of receiving a directed message.

The following code displays an example of this process:


. . .vx_req_account_send_msg *req;vx_req_account_send_msg_create(&req);req->connector_handle = vx_strdup("c1");req->account_handle = vx_strdup(".issuer-w-dev.mytestaccountname.");req->user_uri = vx_strdup("sip:theotheruser@vd1.vivox.com");req->message_body = vx_strdup("Hey there buddy!");vx_issue_request3(&req->base, &request_count);. . .

When a user-to-user text message is available, the

vx_evt_user_to_user_message

event is sent to the game.

The following code displays an example of this action:


void HandleUserToUserMessageEvent(vx_evt_user_to_user_message *evt){    printf("Message from %s: %s\n", evt->from_uri, evt->message_body);}

Documentation

Development

User Acquisition

Monetization

Industry