From 9acf7a4c34a49f80c266c051371d1dd0c12854ce Mon Sep 17 00:00:00 2001
From: Anayeli Malvaez Colin <anayelim@google.com>
Date: Fri, 6 Nov 2026 00:24:43 +0000
Subject: [PATCH] feat(speech): add multi-language transcription samples for v1

---
 .../java/com/example/speech/Recognize.java    | 90 ++++++++++++++++++-
 .../java/com/example/speech/RecognizeIT.java  | 15 ++++
 2 files changed, 104 insertions(+), 1 deletion(-)

diff --git a/speech/src/main/java/com/example/speech/Recognize.java b/speech/src/main/java/com/example/speech/Recognize.java
index ab060e43ea0..9d92994e49c 100644
--- a/speech/src/main/java/com/example/speech/Recognize.java
+++ b/speech/src/main/java/com/example/speech/Recognize.java
@@ -67,7 +67,7 @@ public static void main(String... args) throws Exception {
               + "Commands:\n"
               + "\tsyncrecognize | asyncrecognize | streamrecognize | micstreamrecognize \n"
               + "\t| wordoffsets | auto-punctuation | stream-punctuation \n"
-              + "\t| enhanced-model | model-selection | multi-channel\n"
+              + "\t| enhanced-model | model-selection | multi-channel | multi-language\n"
               + "Path:\n\tA file path (ex: ./resources/audio.raw) or a URI "
               + "for a Cloud Storage resource (gs://...)\n",
           Recognize.class.getCanonicalName());
@@ -121,6 +121,12 @@ public static void main(String... args) throws Exception {
       } else {
         transcribeMultiChannel(path);
       }
+    } else if (command.equals("multi-language")) {
+      if (path.startsWith("gs://")) {
+        transcribeMultiLanguageGcs(path);
+      } else {
+        transcribeMultiLanguage(path);
+      }
     }
   }
 
@@ -938,4 +944,86 @@ public static void transcribeMultiChannelGcs(String gcsUri) throws Exception {
     }
   }
   // [END speech_transcribe_multichannel_gcs]
+
+  // [START speech_transcribe_multilanguage]
+  /**
+   * Transcribe a local audio file with multi-language recognition
+   *
+   * @param fileName the path to the audio file
+   */
+  public static void transcribeMultiLanguage(String fileName) throws Exception {
+    Path path = Paths.get(fileName);
+    byte[] content = Files.readAllBytes(path);
+
+    try (SpeechClient speechClient = SpeechClient.create()) {
+
+      RecognitionAudio recognitionAudio = RecognitionAudio.newBuilder()
+          .setContent(ByteString.copyFrom(content))
+          .build();
+      ArrayList<String> languageList = new ArrayList<>();
+      languageList.add("es-ES");
+      languageList.add("en-US");
+
+      RecognitionConfig config = RecognitionConfig.newBuilder()
+          .setEncoding(AudioEncoding.LINEAR16)
+          .setSampleRateHertz(16000)
+          .setLanguageCode("ja-JP")
+          .addAllAlternativeLanguageCodes(languageList)
+          .build();
+      RecognizeResponse recognizeResponse = speechClient.recognize(config, recognitionAudio);
+
+      for (SpeechRecognitionResult result : recognizeResponse.getResultsList()) {
+        // There can be several alternative transcripts for a given chunk of speech.
+        // Just use the first (most likely) one here.
+        SpeechRecognitionAlternative alternative = result.getAlternatives(0);
+        System.out.format("Transcript : %s\n\n", alternative.getTranscript());
+      }
+    }
+  }
+  // [END speech_transcribe_multilanguage]
+
+  // [START speech_transcribe_multilanguage_gcs]
+  /**
+   * Transcribe a remote audio file with multi-language recognition
+   *
+   * @param gcsUri the path to the remote audio file
+   */
+  public static void transcribeMultiLanguageGcs(String gcsUri) throws Exception {
+    try (SpeechClient speechClient = SpeechClient.create()) {
+
+      ArrayList<String> languageList = new ArrayList<>();
+      languageList.add("es-ES");
+      languageList.add("en-US");
+
+      RecognitionConfig config = RecognitionConfig.newBuilder()
+          .setEncoding(AudioEncoding.LINEAR16)
+          .setSampleRateHertz(16000)
+          .setLanguageCode("ja-JP")
+          .addAllAlternativeLanguageCodes(languageList)
+          .build();
+
+      RecognitionAudio audio = RecognitionAudio.newBuilder()
+          .setUri(gcsUri)
+          .build();
+
+      // Use non-blocking call for getting file transcription
+      OperationFuture<LongRunningRecognizeResponse, LongRunningRecognizeMetadata> response =
+          speechClient.longRunningRecognizeAsync(config, audio);
+
+      while (!response.isDone()) {
+        System.out.println("Waiting for response...");
+        Thread.sleep(10000);
+      }
+
+      for (SpeechRecognitionResult result : response.get().getResultsList()) {
+
+        // There can be several alternative transcripts for a given chunk of speech.
+        // Just use the first (most likely) one here.
+        SpeechRecognitionAlternative alternative = result.getAlternativesList().get(0);
+
+        System.out.printf("Transcript : %s\n\n", alternative.getTranscript());
+      }
+    }
+  }
+  // [END speech_transcribe_multilanguage_gcs]
 }
diff --git a/speech/src/test/java/com/example/speech/RecognizeIT.java b/speech/src/test/java/com/example/speech/RecognizeIT.java
index c84bce9882c..f7dc5edef90 100644
--- a/speech/src/test/java/com/example/speech/RecognizeIT.java
+++ b/speech/src/test/java/com/example/speech/RecognizeIT.java
@@ -166,4 +166,19 @@ public void testTranscribeMultiChannelGcs() throws Exception {
     String got = bout.toString();
     assertThat(got).contains("Channel Tag : 1");
   }
+
+  @Test
+  public void testTranscribeMultiLanguage() throws Exception {
+    Recognize.transcribeMultiLanguage(videoFileName);
+    String got = bout.toString();
+    assertThat(got.toLowerCase()).contains("google");
+  }
+
+  @Test
+  public void testTranscribeMultiLanguageGcs() throws Exception {
+    Recognize.transcribeMultiLanguageGcs(gcsVideoPath);
+    String got = bout.toString();
+    assertThat(got.toLowerCase()).contains("google");
+  }
 }
+