Skip to main content

Channel Management

Overview​

Methods for managing channels are considered:

  • gp.channels.createChannel - channel creation +1 Request
  • gp.channels.updateChannel - channel update +1 Request
  • gp.channels.deleteChannel - deleting a channel +1 Request
  • gp.channels.fetchChannel - get channel information by ID +1 Request
  • gp.channels.fetchChannels - get channel list by id +1 Request
  • gp.channels.fetchMoreChannels - additionally load the list of channels +1 Request
info

In real time, you can track any actions of other players in the channel: they wrote a message, joined or invited to the channel, etc.

Create a Channel​

+1 Request

The player can create channels only from templates preinstalled by the developer. When creating a channel, the player automatically joins it.

The gp.channels.createChannel method is used to create a channel. As an example, we will show the creation of a channel - a group for passing the Demons Lord Castle dungeon for 5 people x5 in the heroic difficulty heroic.

tip

Channel fields are editable if editable in template

gp.channels.createChannel({
    // required ID or channel template tag
    template: 'DUNGEON_5',
    // optional tags by which you can find the channel
    tags: ['dungeon', 'x5', 'demons_lord_castle', 'heroic'],
    // maximum number of people in the channel
    capacity: 5,
    // channel name
    name: 'Dungeon Demons Lord Castle',
    // channel description
    description: 'fast, need all',
    // entrance by invitation only or free
    private: true,
    // the channel is visible in the search or is available only by direct request
    visible: true,
    // login password
    password: '',
    // channel owner access
    ownerAcl: {
        // can read messages
        canViewMessages: true,
        // can create messages
        canAddMessage: true,
        // can change messages
        canEditMessage: true,
        // can delete messages
        canDeleteMessage: true,
        // can view members
        canViewMembers: true,
        // can invite other players
        canInvitePlayer: true,
        // can remove players
        canKickPlayer: true,
        // can accept requests to join
        canAcceptJoinRequest: true,
        // can mute players
        canMutePlayer: true,
    },
    // channel member access
    memberAcl: {
        // can read messages
        canViewMessages: true,
        // can create messages
        canAddMessage: true,
        // can change messages
        canEditMessage: true,
        // can delete messages
        canDeleteMessage: true,
        // can view members
        canViewMembers: true,
        // can invite other players
        canInvitePlayer: false,
        // can remove players
        canKickPlayer: false,
        // can accept requests to join
        canAcceptJoinRequest: false,
        // can mute players
        canMutePlayer: false,
    },
    // channel guest access
    guestAcl: {
        // can read messages
        canViewMessages: false,
        // can create messages
        canAddMessage: false,
        // can change messages
        canEditMessage: false,
        // can delete messages
        canDeleteMessage: false,
        // can view members
        canViewMembers: false,
        // can invite other players
        canInvitePlayer: false,
        // can remove players
        canKickPlayer: false,
        // can accept requests to join
        canAcceptJoinRequest: false,
        // can mute players
        canMutePlayer: false,
    },
});

Install the password of the channel by passing the line with a password, for example, password: '123'. You can remove the password by passing the empty line password: ''.

info

Flexibly use the capabilities of the channels allow tags and templates channels.

All Fields of the Channel​

To get the result of the call of the method gp.channels.createChannel, you can subscribe to events:

gp.channels.on('createChannel', (channel) => {
    // all fields of the channel
    channel.id;
    channel.tags;
    channel.messageTags;
    channel.templateId;
    channel.capacity;
    channel.ownerId;
    channel.name;
    channel.description;
    channel.private;
    channel.visible;
    channel.permanent;
    channel.hasPassword;
    channel.isJoined;
    channel.isRequestSent;
    channel.isInvited;
    channel.isMuted;
    channel.password;
    channel.membersCount;
    channel.ownerAcl;
    channel.memberAcl;
    channel.guestAcl;
});

Example of execution with an error:

gp.channels.on('error:createChannel', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic ErrorsScenario Errors
player_not_foundempty_channel_template_id
project_not_foundchannel_template_not_found
origin_not_allowedchannel_tag_forbidden 💡
player_banned
internal_error
tip

channel_tag_forbidden 💡 - channel tags contain reserved system tags. System tags begin with @, for example @feed: 123456

Create a Channel from the Control Panel​

To create a channel from the GamePush control panel, go to the Channels and press the Add channel button:

The names of the fields available for editing in the channel are given in the table below:

Field NameComments
📝 Channel TemplateSee more in section Template
📝 TagsChannel tags are used to simplify the search player in the in-game events.For example, a group for going to a dungeon for 5 people can have dungeon and x5 tags.See more in the section Tags of Channels and Messages
📝 Tags of messagesMessages tags allow you to display logs or specified types of chat messages.For example, all messages with log tags can return information about the level of level. See more in the section Tags of Channels and Messages
📝 Channel nameClicking on the Edit translations button opens the entire list of languages available for translation
📝 Channel descriptionClicking on the Edit translations button opens the entire list of languages available for translation
📝 The maximum number of membersInteger, maximum number of channel members is unlimited
📝 PasswordBy default, the channel is created without a password
🔘 PrivateAllows you to join the channel only through Request or Invites
🔘 Keep historyAllows you to store your message history (only available on subscription plans). By default, messages are stored for 24 hours
🔘 Visible in searchShows the channel in the search results
🔘 Visible only in test version 💡The channel is not visible to players in the production version
🔘 Leave the channel when he leaves the game
🔘 Delete channel when last member leaves
🔘 Limit Message Sending FrequencyIf you want to prevent spam or control the number of requests, you can set a frequency limit in seconds for sending messages, for example, no more than once every 10 seconds.
🔘 Mute Player Upon Reaching Message Count in Time PeriodIf you want to prevent spam, you can automatically mute players when they reach the message limit over a period. For example, no more than 5 messages in 10 seconds.
🔘 Censorship SettingsYou can prohibit bad words in chat, spam, links, and insults. More about settings: Data Censorship.
🔘 Permissions for the player - owner to edit channel optionsBy default, channel owner can edit: title, description, tags, change owner, channel capacity, privacy, visibility, owner ACL, guest ACL
🔘 Owner, member, guest accessFor a complete list of permissions and their default values, see table
info

If you leave the default settings, then the created channel can be used as a player chat

Access of Roles in Channel​

MethodAllow toownerAcl ownermemberAcl memberguestAcl guest
canViewMessagesread messagestrue 🔘true 🔘false ⚪
canAddMessagecreate messagestrue 🔘true 🔘false ⚪
canEditMessagechange messagestrue 🔘true 🔘false ⚪
canDeleteMessagedelete messagestrue 🔘true 🔘false ⚪
canViewMembersview participantstrue 🔘true 🔘false ⚪
canInvitePlayerinvite other playerstrue 🔘false ⚪false ⚪
canKickPlayerdelete playerstrue 🔘false ⚪false ⚪
canAcceptJoinRequestaccept join requeststrue 🔘false ⚪false ⚪
canMutePlayermute playerstrue 🔘false ⚪false ⚪

To manage the rights of players in the channel, select the control panels Channels - Change - Accesses of the player - owner / member / guest:

Channel Update​

+1 Request

To update the channel with the channelId: 123 using the method gp.channels.updateChannel:

gp.channels.updateChannel({ channelId: 123, visible: false });

Transfer the channel to another player:

gp.channels.updateChannel({ channelId: 123, ownerId: 123456 });

Full list of options:

gp.channels.updateChannel({
    // required channel ID to update
    channelId: 123,
    // tags by which you can find the channel
    tags: ['dungeon', 'x5', 'demons_lord_castle', 'heroic'],
    // maximum number of people in the channel
    capacity: 5,
    // channel name
    name: 'Dungeon Demons Lord Castle',
    // channel description
    description: 'fast, need all',
    // entrance by invitation only or free
    private: true,
    // the channel is visible in the search or is available only by direct request
    visible: true,
    // login password
    password: '',
    // new owner ID
    ownerId: 123456,
    // channel owner access
    ownerAcl: {
        // can read messages
        canViewMessages: true,
        // can create messages
        canAddMessage: true,
        // can change messages
        canEditMessage: true,
        // can delete messages
        canDeleteMessage: true,
        // can view members
        canViewMembers: true,
        // can invite other players
        canInvitePlayer: true,
        // can remove players
        canKickPlayer: true,
        // can accept requests to join
        canAcceptJoinRequest: true,
        // can mute players
        canMutePlayer: true,
    },
    // channel member access
    memberAcl: {
        // can read messages
        canViewMessages: true,
        // can create messages
        canAddMessage: true,
        // can change messages
        canEditMessage: true,
        // can delete messages
        canDeleteMessage: true,
        // can view members
        canViewMembers: true,
        // can invite other players
        canInvitePlayer: false,
        // can remove players
        canKickPlayer: false,
        // can accept requests to join
        canAcceptJoinRequest: false,
        // can mute players
        canMutePlayer: false,
    },
    // channel guest access
    guestAcl: {
        // can read messages
        canViewMessages: false,
        // can create messages
        canAddMessage: false,
        // can change messages
        canEditMessage: false,
        // can delete messages
        canDeleteMessage: false,
        // can view members
        canViewMembers: false,
        // can invite other players
        canInvitePlayer: false,
        // can remove players
        canKickPlayer: false,
        // can accept requests to join
        canAcceptJoinRequest: false,
        // can mute players
        canMutePlayer: false,
    },
});

To get the result of the method call, you can subscribe to events:

gp.channels.on('updateChannel', (channel) => {
    // all fields of the channel
    channel.id;
    channel.tags;
    channel.messageTags;
    channel.channelId;
    channel.capacity;
    channel.ownerId;
    channel.name;
    channel.description;
    channel.private;
    channel.visible;
    channel.permanent;
    channel.hasPassword;
    channel.isJoined;
    channel.isRequestSent;
    channel.isInvited;
    channel.isMuted;
    channel.password;
    channel.membersCount;
    channel.ownerAcl;
    channel.memberAcl;
    channel.guestAcl;
});

Execution with an error:

gp.channels.on('error:updateChannel', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic ErrorsScenario Errors
player_not_foundempty_channel_id
project_not_foundchannel_not_found
origin_not_allowedaccess_denied 💡
player_bannedchannel_tag_forbidden 💡
internal_error
info

access_denied 💡 - the player is not the owner, so he has no editing rights. channel_tag_forbidden 💡 - Channel tags contain reserved system tags. System tags begin with @, for example @feed:123456

When updating the channel , all players in the channel come a notification of its change:

gp.channels.on('event:updateChannel', (channel) => {
    // Channel ID
    channel.id;
    // Channel tags
    channel.tags;
    // Channel tags
    channel.messageTags;
    // The maximum number of participants
    channel.capacity;
    // The owner of the channel
    channel.ownerId;
    // Channel name
    channel.name;
    // Channel description
    channel.description;
    // Channel privacy
    channel.private;
    // Visibility of the channel
    channel.visible;
    // The channel has a password
    channel.hasPassword;
    // Access of the owner of the channel
    channel.ownerAcl;
    // Access of the channel member
    channel.memberAcl;
    // Access of the guest of the channel
    channel.guestAcl;
});

Delete the Channel​

+1 Request
caution

When removing the channel, the same ones are deleted: all messages, channel participants, invites and requests for joining the channel

To delete the channel with the identifier ChannelId: 123, use the method gp.channels.deleteChannel:

gp.channels.deleteChannel({ channelId: 123 });

To get the result of the method call, you can subscribe to events:

gp.channels.on('deleteChannel', () => {
    // The channel is deleted
});

Execution with an error:

gp.channels.on('error:deleteChannel', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic ErrorsScenario Errors
player_not_foundempty_channel_id
project_not_foundchannel_not_found
origin_not_allowedaccess_denied 💡
player_banned
internal_error
info

access_denied 💡 - the player is not the owner, so he has no rights to remove the channel

When removing the channel, all players in the channel come a notification about this event:

gp.channels.on('event:deleteChannel', (channel) => {
    // Channel ID
    channel.id;
});

Get Channel Information by ID​

+1 Request

To get information about a channel by ID, use the method gp.channels.fetchChannel:

const response = await gp.channels.fetchChannel({
    // Channel ID
    channelId: 123,
});

To get the result of the method call, you can subscribe to events:

gp.channels.on('fetchChannel', (result) => {
    // Channel fields
    channel.id;
    channel.tags;
    channel.templateId;
    channel.capacity;
    channel.ownerId;
    channel.name;
    channel.description;
    channel.private;
    channel.visible;
    channel.hasPassword;
    channel.membersCount;
});

Execution with an error:

gp.channels.on('error:fetchChannel', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic ErrorsScenario Errors
player_not_foundempty_channel_id
project_not_foundchannel_not_found
origin_not_allowed
player_banned
internal_error

Fetch List of Channel​

+1 Request

To get a list of channels, you can use the method gp.channels.fetchChannels:

const response = await gp.channels.fetchChannels({
    // List of channel identifiers
    ids: [123, 124, 125],
    // Tags of channels for filtering, through (&)
    tags: ['chat', 'trade'],
    // Search by ID or channel name
    search: '',
    // Search for channels only in which there is my player
    onlyJoined: true,
    // Search for channels only in which my player is the owner of the channel
    onlyOwned: true,
    // How much to request at a time, Max.100
    limit: 100,
    // How many records can be missed, Max.10,000, used for page navigation or "load more"
    offset: 0,
});

To get the result of the method call, you can subscribe to events:

gp.channels.on('fetchChannels', (result) => {
    result.items; // An array of the list of channels
    result.canLoadMore; // Is it possible to load more channels

    result.items.forEach((channel) => {
        // Channel fields
        channel.id;
        channel.tags;
        channel.templateId;
        channel.capacity;
        channel.ownerId;
        channel.name;
        channel.description;
        channel.private;
        channel.visible;
        channel.hasPassword;
        channel.membersCount;
    });
});

Execution with an error:

gp.channels.on('error:fetchChannels', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic Errors
player_not_found
project_not_found
origin_not_allowed
player_banned
internal_error

To additionally load list of channels by the same request, there is a convenient method gp.channels.fetchMoreChannels:

const response = await gp.channels.fetchMoreChannels({
    // Channel ID
    channelId: 123,
    // Tags of messages for filtering, through (&)
    tags: ['chat', 'trade'],
    // How much to request at a time, Max.100
    limit: 100,
});

To get the result of the method call, you can subscribe to events:

gp.channels.on('fetchMoreChannels', (result) => {
    result.items; // An array of the list of channels
    result.canLoadMore; // Is it possible to load more channels
});

Execution with an error:

gp.channels.on('error:fetchMoreChannels', (err) => {
    // Completed with an error
});

Possible errors are given in the table below:

Basic Errors
player_not_found
project_not_found
origin_not_allowed
player_banned
internal_error

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!