Channel Management

Overview

Methods for managing channels are considered:

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

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

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 Errors	Scenario Errors
player_not_found	empty_channel_template_id
project_not_found	channel_template_not_found
origin_not_allowed	channel_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 Name	Comments
📝 Channel Template	See more in section Template
📝 Tags	Channel 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 messages	Messages 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 name	Clicking on the `Edit translations` button opens the entire list of languages available for translation
📝 Channel description	Clicking on the `Edit translations` button opens the entire list of languages available for translation
📝 The maximum number of members	Integer, maximum number of channel members is unlimited
📝 Password	By default, the channel is created without a password
🔘 Private	Allows you to join the channel only through Request or Invites
🔘 Keep history	Allows you to store your message history (only available on subscription plans). By default, messages are stored for 24 hours
🔘 Visible in search	Shows 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
🔘 Permissions for the player - owner to edit channel options	By default, channel owner can edit: title, description, tags, change owner, channel capacity, privacy, visibility, owner ACL, guest ACL
🔘 Owner, member, guest access	For 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

Method	Allow to	`ownerAcl` owner	`memberAcl` member	`guestAcl` guest
canViewMessages	read messages	true 🔘	true 🔘	false ⚪
canAddMessage	create messages	true 🔘	true 🔘	false ⚪
canEditMessage	change messages	true 🔘	true 🔘	false ⚪
canDeleteMessage	delete messages	true 🔘	true 🔘	false ⚪
canViewMembers	view participants	true 🔘	true 🔘	false ⚪
canInvitePlayer	invite other players	true 🔘	false ⚪	false ⚪
canKickPlayer	delete players	true 🔘	false ⚪	false ⚪
canAcceptJoinRequest	accept join requests	true 🔘	false ⚪	false ⚪
canMutePlayer	mute players	true 🔘	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

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 Errors	Scenario Errors
player_not_found	empty_channel_id
project_not_found	channel_not_found
origin_not_allowed	access_denied 💡
player_banned	channel_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

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 Errors	Scenario Errors
player_not_found	empty_channel_id
project_not_found	channel_not_found
origin_not_allowed	access_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

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 Errors	Scenario Errors
player_not_found	empty_channel_id
project_not_found	channel_not_found
origin_not_allowed
player_banned
internal_error

Fetch List of Channel

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!

Channel Management

Overview​

Create a Channel​

All Fields of the Channel​

Create a Channel from the Control Panel​

Access of Roles in Channel​

Channel Update​

Delete the Channel​

Get Channel Information by ID​

Fetch List of Channel​

Stay in Touch​

Overview

Create a Channel

All Fields of the Channel

Create a Channel from the Control Panel

Access of Roles in Channel

Channel Update

Delete the Channel

Get Channel Information by ID

Fetch List of Channel

Stay in Touch