samples: add multi region transcribe sample (#394)

shows how to change default endpoint

Author: b-loved-dreamer

speech/snippets/src/main/java/com/example/speech/SpeechTranscribeMultiRegion.java

@@ -0,0 +1,79 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * 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.example.speech;
+
+// [START speech_transcribe_with_multi_region_gcs]
+
+import com.google.cloud.speech.v1.RecognitionAudio;
+import com.google.cloud.speech.v1.RecognitionConfig;
+import com.google.cloud.speech.v1.RecognitionConfig.AudioEncoding;
+import com.google.cloud.speech.v1.RecognizeResponse;
+import com.google.cloud.speech.v1.SpeechClient;
+import com.google.cloud.speech.v1.SpeechRecognitionAlternative;
+import com.google.cloud.speech.v1.SpeechRecognitionResult;
+import com.google.cloud.speech.v1.SpeechSettings;
+import java.io.IOException;
+import java.util.List;
+
+public class SpeechTranscribeMultiRegion {
+
+  public void speechTranscribeMultiRegion() throws Exception {
+    String uriPath = "gs://cloud-samples-tests/speech/brooklyn.flac";
+    speechTranscribeMultiRegion(uriPath);
+  }
+
+  /**
+   * Transcribe a remote audio file with multi-channel recognition
+   *
+   * @param gcsUri the path to the audio file
+   */
+  public static void speechTranscribeMultiRegion(String gcsUri) throws Exception {
+    // Use the SpeechSettings to initialize the SpeechClient with the new endpoint.
+    String endPoint = "eu-speech.googleapis.com:443";
+    SpeechSettings speechSettings =
+            SpeechSettings.newBuilder()
+              .setEndpoint(endPoint)
+              .build();
+
+    // Instantiates a client with GOOGLE_APPLICATION_CREDENTIALS
+    try (SpeechClient speech = SpeechClient.create(speechSettings)) {
+
+      // Configure remote file request 
+      RecognitionConfig config =
+          RecognitionConfig.newBuilder()
+            .setEncoding(AudioEncoding.FLAC)
+            .setLanguageCode("en-US")
+            .setSampleRateHertz(16000)
+            .build();
+
+      // Set the remote path for the audio file
+      RecognitionAudio audio = RecognitionAudio.newBuilder().setUri(gcsUri).build();
+
+      // Use blocking call to get audio transcript
+      RecognizeResponse response = speech.recognize(config, audio);
+      List<SpeechRecognitionResult> results = response.getResultsList();
+
+      for (SpeechRecognitionResult result : results) {
+        // 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("Transcription: %s\n", alternative.getTranscript());
+      }
+    }
+  }
+}
+// [END speech_transcribe_with_multi_region_gcs]

speech/snippets/src/test/java/com/example/speech/SpeechTranscribeMultiRegionTest.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * 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.example.speech;
+
+import static com.google.common.truth.Truth.assertThat;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.io.PrintStream;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.junit.runners.JUnit4;
+
+@RunWith(JUnit4.class)
+@SuppressWarnings("checkstyle:abbreviationaswordinname")
+public class SpeechTranscribeMultiRegionTest {
+  private static final String AUDIO_FILE = "gs://cloud-samples-tests/speech/brooklyn.flac";
+  private ByteArrayOutputStream bout;
+  private PrintStream stdout;
+  private PrintStream out;
+
+  @Before
+  public void setUp() {
+    bout = new ByteArrayOutputStream();
+    out = new PrintStream(bout);
+    stdout = System.out;
+    System.setOut(out);
+  }
+
+  @After
+  public void tearDown() {
+    System.setOut(stdout);
+  }
+
+  @Test
+  public void testSpeechTranscribeMultiRegion() throws Exception {
+    SpeechTranscribeMultiRegion.speechTranscribeMultiRegion(AUDIO_FILE);
+    String got = bout.toString();
+    assertThat(got).contains("how old is the Brooklyn Bridge");
+  }
+}