Class TemplateChannel
- java.lang.Object
-
- net.dv8tion.jda.api.entities.templates.TemplateChannel
-
- All Implemented Interfaces:
ISnowflake
public class TemplateChannel extends java.lang.Object implements ISnowflake
POJO for the channels information provided by a template.- See Also:
TemplateGuild.getChannels()
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
TemplateChannel.PermissionOverride
Represents the specificRole
permission overrides that can be set for channels.
-
Constructor Summary
Constructors Constructor Description TemplateChannel(long id, ChannelType channelType, java.lang.String name, java.lang.String topic, int rawPosition, long parentId, boolean news, java.util.List<TemplateChannel.PermissionOverride> permissionOverrides, boolean nsfw, int slowmode, int bitrate, int userLimit)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
getBitrate()
The audio bitrate of the voice audio that is transmitted in this channel.long
getIdLong()
The ids of channels are their position as stored by Discord so this will not look like a typical snowflake.java.lang.String
getName()
The human readable name of the GuildChannel.long
getParentId()
Parent Category id of this TemplateChannel.java.util.List<TemplateChannel.PermissionOverride>
getPermissionOverrides()
Gets all of thePermissionOverrides
that are part of thisTemplateChannel
.int
getPositionRaw()
The actual position of theTemplateChannel
as stored and given by Discord.int
getSlowmode()
The slowmode set for this TemplateChannel.java.time.OffsetDateTime
getTimeCreated()
As the ids of channels are their position, the date of creation cannot be calculated.java.lang.String
getTopic()
The topic set for this TemplateChannel.ChannelType
getType()
TheChannelType
for this TemplateChannelint
getUserLimit()
The maximum amount ofMembers
that can be in this voice channel at once.boolean
isNews()
Whether or not this channel is considered an Announcement-/News-Channel.boolean
isNSFW()
Whether or not this channel is considered as "NSFW" (Not-Safe-For-Work).-
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface net.dv8tion.jda.api.entities.ISnowflake
getId
-
-
-
-
Constructor Detail
-
TemplateChannel
public TemplateChannel(long id, ChannelType channelType, java.lang.String name, java.lang.String topic, int rawPosition, long parentId, boolean news, java.util.List<TemplateChannel.PermissionOverride> permissionOverrides, boolean nsfw, int slowmode, int bitrate, int userLimit)
-
-
Method Detail
-
getIdLong
public long getIdLong()
The ids of channels are their position as stored by Discord so this will not look like a typical snowflake.- Specified by:
getIdLong
in interfaceISnowflake
- Returns:
- The id of the channel as stored by Discord
-
getTimeCreated
public java.time.OffsetDateTime getTimeCreated()
As the ids of channels are their position, the date of creation cannot be calculated.- Specified by:
getTimeCreated
in interfaceISnowflake
- Returns:
- OffsetDateTime - Time this entity was created at.
- Throws:
java.lang.UnsupportedOperationException
- The date of creation cannot be calculated.- See Also:
TimeUtil.getTimeCreated(long)
-
getType
@Nonnull public ChannelType getType()
TheChannelType
for this TemplateChannel- Returns:
- The channel type
-
getName
@Nonnull public java.lang.String getName()
The human readable name of the GuildChannel.
If no name has been set, this returns null.- Returns:
- The name of this GuildChannel
-
getTopic
@Nullable public java.lang.String getTopic()
The topic set for this TemplateChannel.
If no topic has been set or theChannelType
is notTEXT
, this returnsnull
.- Returns:
- Possibly-null String containing the topic of this TemplateChannel.
-
getPositionRaw
public int getPositionRaw()
The actual position of theTemplateChannel
as stored and given by Discord. Channel positions are actually based on a pairing of the creation time (as stored in the snowflake id) and the position. If 2 or more channels share the same position then they are sorted based on their creation date. The more recent a channel was created, the lower it is in the hierarchy.- Returns:
- The true, Discord stored, position of the
TemplateChannel
.
-
getParentId
public long getParentId()
Parent Category id of this TemplateChannel. Channels don't need to have a parent Category.
Note that a Category channel will always return-1
for this method as nested categories are not supported.- Returns:
- The id of the parent Category or
-1
if the channel doesn't have a parent Category
-
isNSFW
public boolean isNSFW()
Whether or not this channel is considered as "NSFW" (Not-Safe-For-Work).
If theChannelType
is notTEXT
, this returnsfalse
.- Returns:
- Whether this TextChannel is considered NSFW or
false
if the channel is not a text channel
-
getSlowmode
public int getSlowmode()
The slowmode set for this TemplateChannel.
If slowmode is set this returns anint
between 1 andTextChannel.MAX_SLOWMODE
.
If not set this returns0
.Note bots are unaffected by this.
HavingMESSAGE_MANAGE
orMANAGE_CHANNEL
permission also grants immunity to slowmode.- Returns:
- The slowmode for this TextChannel, between 1 and
TextChannel.MAX_SLOWMODE
,0
if no slowmode is set.
-
getBitrate
public int getBitrate()
The audio bitrate of the voice audio that is transmitted in this channel. While higher bitrates can be sent to this channel, it will be scaled down by the client.
Default and recommended value is 64000- Returns:
- The audio bitrate of this voice channel
-
getUserLimit
public int getUserLimit()
The maximum amount ofMembers
that can be in this voice channel at once.
0 - No limit- Returns:
- The maximum amount of members allowed in this channel at once.
-
isNews
public boolean isNews()
Whether or not this channel is considered an Announcement-/News-Channel.
These channels can be used to crosspost messages to other guilds by using a follower type webhook.- Returns:
- True, if this is considered a news channel
-
getPermissionOverrides
@Nonnull public java.util.List<TemplateChannel.PermissionOverride> getPermissionOverrides()
Gets all of thePermissionOverrides
that are part of thisTemplateChannel
.
This will only containRole
overrides.- Returns:
- Immutable list of all
PermissionOverrides
for thisTemplateChannel
.
-
-