Add initial support for media channels

src/main/java/net/dv8tion/jda/api/audit/AuditLogKey.java

@@ -321,13 +321,13 @@ public enum AuditLogKey
      */
     CHANNEL_ID("channel_id"),
 
-//    /**
-//     * The {@link ForumChannel#getDefaultSortOrder()} value.
-//     * <br>Only for {@link ChannelType#FORUM}.
-//     *
-//     * <p>Expected type: <b>Integer</b>
-//     */
-//    CHANNEL_DEFAULT_SORT_ORDER("default_sort_order"),
+    /**
+     * The {@link ForumChannel#getDefaultSortOrder()} value.
+     * <br>Only for {@link ChannelType#FORUM} and {@link ChannelType#MEDIA}.
+     *
+     * <p>Expected type: <b>Integer</b>
+     */
+    CHANNEL_DEFAULT_SORT_ORDER("default_sort_order"),
 
     /**
      * The {@link ForumChannel#getDefaultLayout()} value.

src/main/java/net/dv8tion/jda/api/entities/Guild.java

@@ -4539,6 +4539,70 @@ default ChannelAction<ForumChannel> createForumChannel(@Nonnull String name)
     @CheckReturnValue
     ChannelAction<ForumChannel> createForumChannel(@Nonnull String name, @Nullable Category parent);
 
+    /**
+     * Creates a new {@link MediaChannel} in this Guild.
+     * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.
+     *
+     * <p>Possible {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} caused by
+     * the returned {@link RestAction RestAction} include the following:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The channel could not be created due to a permission discrepancy</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MAX_CHANNELS MAX_CHANNELS}
+     *     <br>The maximum number of channels were exceeded</li>
+     * </ul>
+     *
+     * @param  name
+     *         The name of the MediaChannel to create (up to {@value Channel#MAX_NAME_LENGTH} characters)
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If the logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL} permission
+     * @throws IllegalArgumentException
+     *         If the provided name is {@code null}, blank, or longer than {@value Channel#MAX_NAME_LENGTH} characters
+     *
+     * @return A specific {@link ChannelAction ChannelAction}
+     *         <br>This action allows to set fields for the new MediaChannel before creating it
+     */
+    @Nonnull
+    @CheckReturnValue
+    default ChannelAction<MediaChannel> createMediaChannel(@Nonnull String name)
+    {
+        return createMediaChannel(name, null);
+    }
+
+    /**
+     * Creates a new {@link MediaChannel} in this Guild.
+     * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.
+     *
+     * <p>Possible {@link net.dv8tion.jda.api.requests.ErrorResponse ErrorResponses} caused by
+     * the returned {@link RestAction RestAction} include the following:
+     * <ul>
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MISSING_PERMISSIONS MISSING_PERMISSIONS}
+     *     <br>The channel could not be created due to a permission discrepancy</li>
+     *
+     *     <li>{@link net.dv8tion.jda.api.requests.ErrorResponse#MAX_CHANNELS MAX_CHANNELS}
+     *     <br>The maximum number of channels were exceeded</li>
+     * </ul>
+     *
+     * @param  name
+     *         The name of the MediaChannel to create (up to {@value Channel#MAX_NAME_LENGTH} characters)
+     * @param  parent
+     *         The optional parent category for this channel, or null
+     *
+     * @throws net.dv8tion.jda.api.exceptions.InsufficientPermissionException
+     *         If the logged in account does not have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL} permission
+     * @throws IllegalArgumentException
+     *         If the provided name is {@code null}, blank, or longer than {@value Channel#MAX_NAME_LENGTH} characters;
+     *         or the provided parent is not in the same guild.
+     *
+     * @return A specific {@link ChannelAction ChannelAction}
+     *         <br>This action allows to set fields for the new MediaChannel before creating it
+     */
+    @Nonnull
+    @CheckReturnValue
+    ChannelAction<MediaChannel> createMediaChannel(@Nonnull String name, @Nullable Category parent);
+
     /**
      * Creates a new {@link Category Category} in this Guild.
      * For this to be successful, the logged in account has to have the {@link net.dv8tion.jda.api.Permission#MANAGE_CHANNEL MANAGE_CHANNEL} Permission.

src/main/java/net/dv8tion/jda/api/entities/channel/ChannelField.java

@@ -255,14 +255,14 @@ public enum ChannelField
      */
     DEFAULT_FORUM_LAYOUT("default_forum_layout", AuditLogKey.DEFAULT_FORUM_LAYOUT),
 
-//    /**
-//     * The default sort order of a forum channel.
-//     *
-//     * <p>Limited to {@link ForumChannel Forum Channels}.
-//     *
-//     * @see ForumChannel#getDefaultSortOrder()
-//     */
-//    DEFAULT_SORT_ORDER("default_sort_order", AuditLogKey.CHANNEL_DEFAULT_SORT_ORDER)
+    /**
+     * The default sort order of a forum channel.
+     *
+     * <p>Limited to {@link ForumChannel Forum Channels} and {@link MediaChannel Media Channels}.
+     *
+     * @see ForumChannel#getDefaultSortOrder()
+     */
+    DEFAULT_SORT_ORDER("default_sort_order", AuditLogKey.CHANNEL_DEFAULT_SORT_ORDER)
     ;
 
     private final String fieldName;

src/main/java/net/dv8tion/jda/api/entities/channel/ChannelFlag.java

@@ -36,7 +36,12 @@ public enum ChannelFlag
     /**
      * This is a {@link ForumChannel} which requires all new post threads to have at least one applied tag.
      */
-    REQUIRE_TAG(1 << 4);
+    REQUIRE_TAG(1 << 4),
+
+    /**
+     * This is a {@link net.dv8tion.jda.api.entities.channel.concrete.MediaChannel MediaChannel} which hides the copy embed option.
+     */
+    HIDE_MEDIA_DOWNLOAD_OPTIONS(1 << 15);
 
     private final int value;
 

src/main/java/net/dv8tion/jda/api/entities/channel/ChannelType.java

@@ -63,6 +63,11 @@ public enum ChannelType
      */
     FORUM(15, 0, true),
 
+    /**
+     * A {@link MediaChannel}, Guild-Only.
+     */
+    MEDIA(16, 0, true),
+
     /**
      * Unknown Discord channel type. Should never happen and would only possibly happen if Discord implemented a new
      * channel type and JDA had yet to implement support for it.

src/main/java/net/dv8tion/jda/api/entities/channel/attribute/IGuildChannelContainer.java

@@ -178,6 +178,8 @@ default GuildChannel getGuildChannelById(long id)
             channel = getThreadChannelById(id);
         if (channel == null)
             channel = getForumChannelById(id);
+        if (channel == null)
+            channel = getMediaChannelById(id);
 
         return channel;
     }
@@ -273,6 +275,8 @@ default GuildChannel getGuildChannelById(@Nonnull ChannelType type, long id)
             return getCategoryById(id);
         case FORUM:
             return getForumChannelById(id);
+        case MEDIA:
+            return getMediaChannelById(id);
         }
 
         if (type.isThread())
@@ -1101,4 +1105,118 @@ default List<ForumChannel> getForumChannels()
     {
         return getForumChannelCache().asList();
     }
+
+
+    // MediaChannels
+
+
+    /**
+     * {@link SnowflakeCacheView SnowflakeCacheView} of {@link MediaChannel}.
+     *
+     * <p>This getter exists on any instance of {@link IGuildChannelContainer} and only checks the caches with the relevant scoping.
+     * For {@link Guild}, {@link JDA}, or {@link ShardManager},
+     * this returns the relevant channel with respect to the cache within each of those objects.
+     * For a guild, this would mean it only returns channels within the same guild.
+     * <br>If this is called on {@link JDA} or {@link ShardManager}, this may return null immediately after building, because the cache isn't initialized yet.
+     * To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
+     *
+     * @return {@link SnowflakeCacheView SnowflakeCacheView}
+     */
+    @Nonnull
+    SnowflakeCacheView<MediaChannel> getMediaChannelCache();
+
+    /**
+     * Gets a list of all {@link MediaChannel MediaChannels}
+     * in this Guild that have the same name as the one provided.
+     * <br>If there are no channels with the provided name, then this returns an empty list.
+     *
+     * <p>This getter exists on any instance of {@link IGuildChannelContainer} and only checks the caches with the relevant scoping.
+     * For {@link Guild}, {@link JDA}, or {@link ShardManager},
+     * this returns the relevant channel with respect to the cache within each of those objects.
+     * For a guild, this would mean it only returns channels within the same guild.
+     * <br>If this is called on {@link JDA} or {@link ShardManager}, this may return null immediately after building, because the cache isn't initialized yet.
+     * To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
+     *
+     * @param  name
+     *         The name used to filter the returned {@link MediaChannel MediaChannels}.
+     * @param  ignoreCase
+     *         Determines if the comparison ignores case when comparing. True - case insensitive.
+     *
+     * @return Possibly-empty immutable list of all ForumChannel names that match the provided name.
+     */
+    @Nonnull
+    default List<MediaChannel> getMediaChannelsByName(@Nonnull String name, boolean ignoreCase)
+    {
+        return getMediaChannelCache().getElementsByName(name, ignoreCase);
+    }
+
+    /**
+     * Gets a {@link MediaChannel} that has the same id as the one provided.
+     * <br>If there is no channel with an id that matches the provided one, then this returns {@code null}.
+     *
+     * <p>This getter exists on any instance of {@link IGuildChannelContainer} and only checks the caches with the relevant scoping.
+     * For {@link Guild}, {@link JDA}, or {@link ShardManager},
+     * this returns the relevant channel with respect to the cache within each of those objects.
+     * For a guild, this would mean it only returns channels within the same guild.
+     * <br>If this is called on {@link JDA} or {@link ShardManager}, this may return null immediately after building, because the cache isn't initialized yet.
+     * To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
+     *
+     * @param  id
+     *         The id of the {@link MediaChannel}.
+     *
+     * @throws java.lang.NumberFormatException
+     *         If the provided {@code id} cannot be parsed by {@link Long#parseLong(String)}
+     *
+     * @return Possibly-null {@link MediaChannel} with matching id.
+     */
+    @Nullable
+    default MediaChannel getMediaChannelById(@Nonnull String id)
+    {
+        return getMediaChannelCache().getElementById(id);
+    }
+
+    /**
+     * Gets a {@link MediaChannel} that has the same id as the one provided.
+     * <br>If there is no channel with an id that matches the provided one, then this returns {@code null}.
+     *
+     * <p>This getter exists on any instance of {@link IGuildChannelContainer} and only checks the caches with the relevant scoping.
+     * For {@link Guild}, {@link JDA}, or {@link ShardManager},
+     * this returns the relevant channel with respect to the cache within each of those objects.
+     * For a guild, this would mean it only returns channels within the same guild.
+     * <br>If this is called on {@link JDA} or {@link ShardManager}, this may return null immediately after building, because the cache isn't initialized yet.
+     * To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
+     *
+     * @param  id
+     *         The id of the {@link MediaChannel}.
+     *
+     * @return Possibly-null {@link MediaChannel} with matching id.
+     */
+    @Nullable
+    default MediaChannel getMediaChannelById(long id)
+    {
+        return getMediaChannelCache().getElementById(id);
+    }
+
+    /**
+     * Gets all {@link MediaChannel} in the cache.
+     *
+     * <p>This copies the backing store into a list. This means every call
+     * creates a new list with O(n) complexity. It is recommended to store this into
+     * a local variable or use {@link #getForumChannelCache()} and use its more efficient
+     * versions of handling these values.
+     *
+     * <p>This getter exists on any instance of {@link IGuildChannelContainer} and only checks the caches with the relevant scoping.
+     * For {@link Guild}, {@link JDA}, or {@link ShardManager},
+     * this returns the relevant channel with respect to the cache within each of those objects.
+     * For a guild, this would mean it only returns channels within the same guild.
+     * <br>If this is called on {@link JDA} or {@link ShardManager}, this may return null immediately after building, because the cache isn't initialized yet.
+     * To make sure the cache is initialized after building your {@link JDA} instance, you can use {@link JDA#awaitReady()}.
+     *
+     * @return An immutable List of {@link MediaChannel}.
+     */
+    @Nonnull
+    default List<MediaChannel> getMediaChannels()
+    {
+        return getMediaChannelCache().asList();
+    }
 }