Ready-made chats

Overview

Implementing a chat with all the nuances taken into account is very difficult. We offer using the chat embedded in the overlay.

Open the chat window

+2-3 Request

Open the main chat:

JavaScript

gp.channels.openChat();

Unity

GP_Channels.OpenChat();

Open any chat by channel ID:

JavaScript

gp.channels.openChat({ id: 123 });

Unity

GP_Channels.OpenChat(channel_ID: 123);

Open chat, filtering messages by tags:

JavaScript

gp.channels.openChat({ tags: ['trade'] });
gp.channels.openChat({ tags: ['location', 'underworld'] });

Unity

GP_Channels.OpenChat(tags: "trade");
GP_Channels.OpenChat(tags: "location, underworld");

Messages in the chat will be sent including these tags automatically.

Chat opening options:

JavaScript

gp.channels.openChat({
    // channel id
    id: 123,
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: ['location', 'underworld']
});

Unity

GP_Channels.OpenChat(  
    // channel id
    channel_ID: 123, 
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: "location, underworld",
    // On open callback
    OnOpen, 
    // On close callback
    OnClose, 
    // On open error callback
    OnOpenError
);
    

info

The player automatically joins the channel upon opening. Make sure that everyone can join the channel and it is not password protected.

Events for tracking opening and closing of the window:

JavaScript

// Chat opened
gp.channels.on('openChat', () => {});
// Chat closed
gp.channels.on('closeChat', () => {});
// Failed to open chat
gp.channels.on('error:openChat', (err) => {
    // errors can be related to access or chat retrieval
});

Unity

GP_Channels.OpenChat(OnOpen, OnClose, OnOpenError);

private void OnOpen() => Debug.Log("ON OPEN CHAT");
private void OnClose() => Debug.Log("ON CLOSE CHAT");
private void OnOpenError() => Debug.Log("ON OPEN CHAT: ERROR");

Check if the main chat can be displayed:

JavaScript

if (gp.channels.isMainChatEnabled) {
    // The chat is enabled, you can show the chat button
}

Unity

if (GP_Channels.IsMainChatEnabled()) {
    // The chat is enabled, you can show the chat button
}

Get the ID of the main chat:

JavaScript

gp.channels.mainChatId;

Unity

int id = GP_Channels.MainChatId();
Debug.Log(id);

Possible errors are listed in the table below:

Basic errors	Scenario errors
player_not_found	empty_channel_id
project_not_found	channel_not_found
origin_not_allowed	access_denied
player_banned
internal_error

Selecting the main chat

1. Go to the control panel to the Channels section
2. Select the main chat or create a new one immediately in the chat selection. A basic chat with all settings for quick start will be created.
3. Enable the main chat.

Open Personal Chat

+2-3 Request

You can give players the ability to communicate with each other through private messages.

JavaScript

gp.channels.openPersonalChat({
    // player id
    playerId: 5499172001,
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: ['location', 'underworld']
});

Unity

GP_Channels.OpenPersonalChat(  
    // player id
    player_ID: 5499172001,
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: "location, underworld"
);

Open Player Feed

+2-3 Request

You can allow players to view a player's feed and leave messages there.

JavaScript

gp.channels.openFeed({
    // player id
    playerId: 5499172001,
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: ['location', 'underworld']
});

Unity

GP_Channels.OpenFeed(  
    // player id
    player_ID: 5499172001,
    // message tags,
    // only messages with both tags: location and underworld will be shown
    tags: "location, underworld"
);

Detect a New Message

FREE

To save the player from constantly having to check the chat or personal messages, one can subscribe to messages in the chat.

When sending a message, all players in the channel get a notification of a new message:

JavaScript

gp.channels.on('event:message', (message) => {
    // Channel ID
    message.channelId;
    // Message ID
    message.id;
    // Author ID of the message
    message.authorId;
    // Author fields (avatar, name, custom fields)
    message.player;
    // Message text
    message.text;
    // Message tags
    message.tags;
    // Date the message was sent
    message.createdAt;
    // Message target: 'CHANNEL' | 'PERSONAL' | 'FEED'
    message.target;
});

Unity

// subscribe to event
private void OnEnable()
{
  GP_Channels.OnMessage += OnMessage;
}

// unsubscribe from event
private void OnDisable()
{
  GP_Channels.OnMessage -= OnMessage;
}

private void OnMessage(GP_Data data)
{
    var messageData = data.Get<Message_Data>();

    Debug.Log("ON MESSAGE EVENT: CHANNEL ID: " + messageData.channelId);
    Debug.Log("ON MESSAGE EVENT: AUTHOR ID: " + messageData.authorId);
    Debug.Log("ON MESSAGE EVENT: ID: " + messageData.id);
    Debug.Log("ON MESSAGE EVENT: TEXT: " + messageData.text);
    for (int i = 0; i < messageData.tags.Length; i++)
    {
        Debug.Log("ON MESSAGE EVENT: TAGS: " + messageData.tags[i]);
    }
    Debug.Log("ON MESSAGE EVENT: CREATED AT: " + messageData.createdAt);

    Debug.Log("ON MESSAGE EVENT: PLAYER: AVATAR: " + messageData.player.avatar);
    Debug.Log("ON MESSAGE EVENT: PLAYER: CREDITIALS: " + messageData.player.credentials);
    Debug.Log("ON MESSAGE EVENT: PLAYER: ID: " + messageData.player.id);
    Debug.Log("ON MESSAGE EVENT: PLAYER: NAME: " + messageData.player.name);
    Debug.Log("ON MESSAGE EVENT: PLAYER: PLATFORM TYPE: " + messageData.player.platformType);
    Debug.Log("ON MESSAGE EVENT: PLAYER: PROJECT ID: " + messageData.player.projectId);
    Debug.Log("ON MESSAGE EVENT: PLAYER: SCORE: " + messageData.player.score);
    
}

You can pay attention to message.target:

• CHANNEL: a new message appeared in the chat
• PERSONAL: someone wrote a private message to the player
• FEED: someone wrote a message in the player's feed

Stay in Touch

Other documents of this chapter available Here. To get started, welcome to the Tutorials chapter.

GamePush Community Telegram: @gs_community.

For your suggestions e-mail: [email protected]

We Wish you Success!