feat: Add Video API snippets

.env-example

@@ -144,11 +144,19 @@ VERIFY_TEMPLATE_NAME="verify"
 VERIFY_TEMPLATE_ID="bcdef09-8765-4321-8cde-0123456789ab"
 VERIFY_TEMPLATE_FRAGMENT_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
 
+# Video
+VIDEO_SESSION_ID="flR1ZSBPY3QgMjkgMTI6MTM6MjMgUERUIDIwMTN"
+VIDEO_TOKEN="eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcHBsaWNhdGlvbl9pZCI6ImFhYWFhYWFhLWJiYmItNGNjYy04ZGRkLTAxMjM0NTY3ODlhYiJ9.o3U506EejsS8D5Tob90FG1NC1cR69fh3pFOpxnyTHVFfgqI6NWuuN8lEwrS3Zb8bGxE_A9LyyUZ2y4uqLpyXRw"
+VIDEO_CONNECTION_ID="bcdef09-8765-4321-8cde-0123456789ab"
+VIDEO_STREAM_ID="bcdef09-8765-4321-8cde-0123456789ab"
+VIDEO_ARCHIVE_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
+VIDEO_BROADCAST_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
+
 # Voice
 VOICE_CALL_ID="aaaaaaaa-bbbb-4ccc-8ddd-0123456789ab"
 VOICE_TO_NUMBER="447700900000"
 VOICE_TEXT="Hello from Vonage! Would you like to learn more?"
-VOICE_LANGUAGE="en-US"
+VOICE_LANGUAGE="AMERICAN_ENGLISH"
 VOICE_DTMF_DIGITS="2468#"
 VOICE_CONFERENCE_NAME="My conference call room"
 VOICE_NCCO_URL="https://nexmo-community.github.io/ncco-examples/talk.json"

src/main/java/com/vonage/quickstart/EnvironmentVariables.java

@@ -150,6 +150,12 @@ public static String envVar(String key) {
        VERIFY_FROM_EMAIL = envVar("VERIFY_FROM_EMAIL"),
        VERIFY_WHATSAPP_NUMBER = envVar("VERIFY_WHATSAPP_NUMBER"),
        VERIFY_TEMPLATE_NAME = envVar("VERIFY_TEMPLATE_NAME"),
+       VIDEO_STREAM_ID = envVar("VIDEO_STREAM_ID"),
+       VIDEO_ARCHIVE_ID = envVar("VIDEO_ARCHIVE_ID"),
+       VIDEO_BROADCAST_ID = envVar("VIDEO_BROADCAST_ID"),
+       VIDEO_CONNECTION_ID = envVar("VIDEO_CONNECTION_ID"),
+       VIDEO_SESSION_ID = envVar("VIDEO_SESSION_ID"),
+       VIDEO_TOKEN = envVar("VIDEO_TOKEN"),
        VOICE_CALL_ID = envVar("VOICE_CALL_ID"),
        VOICE_TO_NUMBER = envVar("VOICE_TO_NUMBER"),
        VOICE_TEXT = envVar("VOICE_TEXT"),
@@ -189,10 +195,10 @@ public static String envVar(String key) {
    public static final Type
        NUMBER_TYPE = Type.fromString(envVar("NUMBER_TYPE"));
 
-   public static final Feature[]
+   public static final com.vonage.client.numbers.Feature[]
        NUMBER_FEATURES = Arrays.stream(envVar("NUMBER_FEATURES").split(","))
-           .map(Feature::fromString)
-           .toArray(Feature[]::new);
+           .map(com.vonage.client.numbers.Feature::fromString)
+           .toArray(com.vonage.client.numbers.Feature[]::new);
 
    public static final SearchPattern
        NUMBER_SEARCH_PATTERN = SearchPattern.values()[Integer.parseInt(envVar("NUMBER_SEARCH_PATTERN"))];

src/main/java/com/vonage/quickstart/video/AddArchiveStream.java

@@ -0,0 +1,34 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class AddArchiveStream {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        videoClient.addArchiveStream(VIDEO_ARCHIVE_ID, VIDEO_STREAM_ID);
+
+        System.out.println("Added archive stream");
+    }
+}

src/main/java/com/vonage/quickstart/video/AddBroadcastStream.java

@@ -0,0 +1,34 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class AddBroadcastStream {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        videoClient.addBroadcastStream(VIDEO_BROADCAST_ID, VIDEO_STREAM_ID);
+
+        System.out.println("Added broadcast stream");
+    }
+}

src/main/java/com/vonage/quickstart/video/CreateArchive.java

@@ -0,0 +1,42 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class CreateArchive {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        Archive archive = videoClient.createArchive(
+                Archive.builder(VIDEO_SESSION_ID)
+                        .streamMode(StreamMode.AUTO)
+                        .hasVideo(true)
+                        .hasAudio(true)
+                        .resolution(Resolution.HD_LANDSCAPE)
+                        .outputMode(OutputMode.COMPOSED).name("My recording")
+                        .build()
+        );
+
+        System.out.println("Started archive: " + archive.toJson());
+    }
+}

src/main/java/com/vonage/quickstart/video/CreateBroadcast.java

@@ -0,0 +1,42 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+import java.time.Duration;
+
+public class CreateBroadcast {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        Broadcast broadcast = videoClient.createBroadcast(
+                Broadcast.builder(VIDEO_SESSION_ID)
+                        .hls(Hls.builder().lowLatency(true).build())
+                        .resolution(Resolution.HD_LANDSCAPE)
+                        .streamMode(StreamMode.AUTO)
+                        .maxDuration(Duration.ofMinutes(45))
+                        .build()
+        );
+
+        System.out.println("Started broadcast: " + broadcast.toJson());
+    }
+}

src/main/java/com/vonage/quickstart/video/CreateSession.java

@@ -0,0 +1,39 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class CreateSession {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        CreateSessionResponse session = videoClient.createSession(
+                CreateSessionRequest.builder()
+                        .mediaMode(MediaMode.ROUTED)
+                        .archiveMode(ArchiveMode.MANUAL)
+                        .build()
+        );
+
+        System.out.println("Created session: " + session.toJson());
+    }
+}

src/main/java/com/vonage/quickstart/video/DeleteArchive.java

@@ -0,0 +1,19 @@
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class DeleteArchive {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        videoClient.deleteArchive(VIDEO_ARCHIVE_ID);
+
+        System.out.println("Deleted archive");
+    }
+}

src/main/java/com/vonage/quickstart/video/ForceDisconnect.java

@@ -0,0 +1,19 @@
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class ForceDisconnect {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        videoClient.forceDisconnect(VIDEO_SESSION_ID, VIDEO_CONNECTION_ID);
+
+        System.out.println("Force disconnected");
+    }
+}

src/main/java/com/vonage/quickstart/video/ForceMute.java

@@ -0,0 +1,19 @@
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class ForceMute {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        videoClient.muteStream(VIDEO_SESSION_ID, VIDEO_STREAM_ID);
+
+        System.out.println("Force muted");
+    }
+}

src/main/java/com/vonage/quickstart/video/GenerateToken.java

@@ -0,0 +1,27 @@
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+import java.time.Duration;
+
+public class GenerateToken {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        TokenOptions tokenOptions = TokenOptions.builder()
+                .role(Role.MODERATOR)
+                .expiryLength(Duration.ofHours(6))
+                .data("name=John,id=123")
+                .build();
+
+        String jwt = videoClient.generateToken(VIDEO_SESSION_ID, tokenOptions);
+
+        System.out.println("Generated token: " + jwt);
+    }
+}

src/main/java/com/vonage/quickstart/video/GetArchive.java

@@ -0,0 +1,34 @@
+/*
+ *   Copyright 2025 Vonage
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+package com.vonage.quickstart.video;
+
+import com.vonage.client.VonageClient;
+import com.vonage.client.video.*;
+import static com.vonage.quickstart.EnvironmentVariables.*;
+
+public class GetArchive {
+    public static void main(String[] args) throws Exception {
+
+        VideoClient videoClient = VonageClient.builder()
+                .applicationId(VONAGE_APPLICATION_ID)
+                .privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
+                .build().getVideoClient();
+
+        Archive archive = videoClient.getArchive(VIDEO_ARCHIVE_ID);
+
+        System.out.println("Retrieved archive: " + archive.toJson());
+    }
+}