Channel: Add getters for new unique IDs and channel banner modes

Author: rogermb

src/main/java/com/github/theholywaffle/teamspeak3/api/ChannelBannerMode.java

@@ -0,0 +1,57 @@
+package com.github.theholywaffle.teamspeak3.api;
+
+/*
+ * #%L
+ * TeamSpeak 3 Java API
+ * %%
+ * Copyright (C) 2021 Bert De Geyter, Roger Baumgartner
+ * %%
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ * #L%
+ */
+
+/**
+ * The values in this enum are <b>speculative</b>.
+ * There does not appear to be any documentation on channel banner modes.
+ */
+public enum ChannelBannerMode {
+
+NO_ADJUST(0),
+IGNORE_ASPECT(1),
+KEEP_ASPECT(2),
+
+/**
+ * An unknown channel banner mode.
+ * <p>
+ * If you ever encounter an unknown banner mode, please tell us!
+ * We may have to update the API.
+ * </p>
+ */
+UNKNOWN(-1);
+
+private final int i;
+
+ChannelBannerMode(int i) {
+this.i = i;
+}
+
+public int getIndex() {
+return i;
+}
+}

src/main/java/com/github/theholywaffle/teamspeak3/api/wrapper/ChannelBase.java

@@ -26,6 +26,7 @@
  * #L%
  */
 
+import com.github.theholywaffle.teamspeak3.api.ChannelBannerMode;
 import com.github.theholywaffle.teamspeak3.api.ChannelProperty;
 import com.github.theholywaffle.teamspeak3.api.Codec;
 
@@ -71,6 +72,20 @@ public boolean isSemiPermanent() {
 return getBoolean(ChannelProperty.CHANNEL_FLAG_SEMI_PERMANENT);
 }
 
+public ChannelBannerMode getBannerMode() {
+final int mode = getInt(ChannelProperty.CHANNEL_BANNER_MODE);
+for (final ChannelBannerMode m : ChannelBannerMode.values()) {
+if (m.getIndex() == mode) {
+return m;
+}
+}
+return ChannelBannerMode.UNKNOWN;
+}
+
+public String getBannerGraphicsUrl() {
+return get(ChannelProperty.CHANNEL_BANNER_GFX_URL);
+}
+
 public Codec getCodec() {
 final int codec = getInt(ChannelProperty.CHANNEL_CODEC);
 for (final Codec c : Codec.values()) {

src/main/java/com/github/theholywaffle/teamspeak3/api/wrapper/ChannelInfo.java

@@ -27,6 +27,7 @@
  */
 
 import java.util.Map;
+import java.util.UUID;
 
 import com.github.theholywaffle.teamspeak3.api.ChannelProperty;
 
@@ -56,6 +57,10 @@ public int getCodecLatencyFactor() {
 return getInt(ChannelProperty.CHANNEL_CODEC_LATENCY_FACTOR);
 }
 
+public UUID getUniqueIdentifier() {
+return UUID.fromString(get(ChannelProperty.CHANNEL_UNIQUE_IDENTIFIER));
+}
+
 public boolean isEncrypted() {
 return !getBoolean(ChannelProperty.CHANNEL_CODEC_IS_UNENCRYPTED);
 }

src/main/java/com/github/theholywaffle/teamspeak3/commands/ChannelCommands.java

@@ -76,13 +76,14 @@ public static Command channelInfo(int channelId) {
 }
 
 public static Command channelList() {
-CommandBuilder builder = new CommandBuilder("channellist", 6);
+CommandBuilder builder = new CommandBuilder("channellist", 7);
 builder.add(new OptionParam("topic"));
 builder.add(new OptionParam("flags"));
 builder.add(new OptionParam("voice"));
 builder.add(new OptionParam("limits"));
 builder.add(new OptionParam("icon"));
 builder.add(new OptionParam("secondsempty"));
+builder.add(new OptionParam("banners"));
 return builder.build();
 }