The EnxRoom.sendMessage()
method is used to exchange messages between Session participants. It allows you to exchange the following types of messages:
- Public Messaging: To send messages to all connected users.
- Private Messaging: To send messages to a specific user.
- Group Messaging: To send messages to more than one user.
The Messaging feature does not require the sender to publish Local Stream or the receiver to subscribe to Remote Stream.
Method: EnxRoom.sendMessage(Message, IsBroadcast, RecipientIDs, Callback)
Parameters:
Message
– String. Text message to be sent.IsBroadcast
– Boolean. Set to true for Public Messaging, false for Private Messaging.RecipientIDs
– Array of Client IDs to receive messages. Applicable for Group and Private Messaging.
Notification Event:
message-received
– Receives event.message
JSON Object at the Recipient Endpoint.
{ "type": "message-received", "message": { "broadcast": false, "sender": "SENDER_NAME", "senderId": "XX", "type": "chat", "message": "TEXT MESSAGE", "timestamp": 99999, "receipients": [ "XOXO", "XOXOXO" ] } }
To send & receive message
// To send message to all (Public Messaging) room.sendMessage("Text Message", true, [], function(data){ // Message sent }); // To send to selected Participant (Private Messaging) room.sendMessage("Text Message", false, ["XXXX"], function(data){ // Message sent }); // To receive message notification room.addEventListener("message-received", function (event) { var InMsg = event.message; if (InMsg.broadcast === true) { // Handle Public Message } else { // Handle Message from InMsg.sender } });