Speech samples

speech/cloud-client/README.md

@@ -57,3 +57,28 @@ Build your project with:
     java -cp target/speech-google-cloud-samples-1.0.0-jar-with-dependencies.jar \
     com.example.speech.Recognize wordoffsets gs://cloud-samples-tests/speech/vr.flac
 ```
+
+### Synchronously transcribe and punctuate a remote audio file
+```
+    java -cp target/speech-google-cloud-samples-1.0.0-jar-with-dependencies.jar \
+    com.example.speech.Recognize punctuation ./resources/audio.raw
+```
+
+### Asynchronously transcribe and punctuate an audio file hosted on GCS
+```
+    java -cp target/speech-google-cloud-samples-1.0.0-jar-with-dependencies.jar \
+    com.example.speech.Recognize punctuation gs://cloud-samples-tests/speech/brooklyn.flac
+```
+
+### Synchronously transcribe a video file
+```
+    java -cp target/speech-google-cloud-samples-1.0.0-jar-with-dependencies.jar \
+    com.example.speech.Recognize video ./resources/Google_Gnome.wav
+```
+
+### Asynchronously transcribe a video file hosted on GCS
+```
+    java -cp target/speech-google-cloud-samples-1.0.0-jar-with-dependencies.jar \
+    com.example.speech.Recognize video gs://cloud-samples-tests/speech/Google_Gnome.wav
+```
+

speech/cloud-client/pom.xml

@@ -34,11 +34,12 @@
   </properties>
 
   <dependencies>
+    <!-- TODO replace with release version -->
     <!-- [START dependencies] -->
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>google-cloud-speech</artifactId>
-      <version>0.21.1-alpha</version>
+      <version>0.22.1-alpha-SNAPSHOT</version>
     </dependency>
     <!-- [END dependencies] -->
 

speech/cloud-client/src/main/java/com/example/speech/QuickstartSample.java

@@ -18,13 +18,13 @@
 
 // [START speech_quickstart]
 // Imports the Google Cloud client library
-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_1beta1.SpeechClient;
+import com.google.cloud.speech.v1p1beta1.RecognitionAudio;
+import com.google.cloud.speech.v1p1beta1.RecognitionConfig;
+import com.google.cloud.speech.v1p1beta1.RecognitionConfig.AudioEncoding;
+import com.google.cloud.speech.v1p1beta1.RecognizeResponse;
+import com.google.cloud.speech.v1p1beta1.SpeechRecognitionAlternative;
+import com.google.cloud.speech.v1p1beta1.SpeechRecognitionResult;
 import com.google.protobuf.ByteString;
 
 import java.nio.file.Files;
@@ -33,39 +33,43 @@
 import java.util.List;
 
 public class QuickstartSample {
+
+  /**
+   * Demonstrates using the Speech API to transcribe an audio file.
+   */
   public static void main(String... args) throws Exception {
     // Instantiates a client
-    SpeechClient speech = SpeechClient.create();
+    try (SpeechClient speechClient = SpeechClient.create()) {
 
-    // The path to the audio file to transcribe
-    String fileName = "./resources/audio.raw";
+      // The path to the audio file to transcribe
+      String fileName = "./resources/audio.raw";
 
-    // Reads the audio file into memory
-    Path path = Paths.get(fileName);
-    byte[] data = Files.readAllBytes(path);
-    ByteString audioBytes = ByteString.copyFrom(data);
+      // Reads the audio file into memory
+      Path path = Paths.get(fileName);
+      byte[] data = Files.readAllBytes(path);
+      ByteString audioBytes = ByteString.copyFrom(data);
 
-    // Builds the sync recognize request
-    RecognitionConfig config = RecognitionConfig.newBuilder()
-        .setEncoding(AudioEncoding.LINEAR16)
-        .setSampleRateHertz(16000)
-        .setLanguageCode("en-US")
-        .build();
-    RecognitionAudio audio = RecognitionAudio.newBuilder()
-        .setContent(audioBytes)
-        .build();
+      // Builds the sync recognize request
+      RecognitionConfig config = RecognitionConfig.newBuilder()
+          .setEncoding(AudioEncoding.LINEAR16)
+          .setSampleRateHertz(16000)
+          .setLanguageCode("en-US")
+          .build();
+      RecognitionAudio audio = RecognitionAudio.newBuilder()
+          .setContent(audioBytes)
+          .build();
 
-    // Performs speech recognition on the audio file
-    RecognizeResponse response = speech.recognize(config, audio);
-    List<SpeechRecognitionResult> results = response.getResultsList();
+      // Performs speech recognition on the audio file
+      RecognizeResponse response = speechClient.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());
+      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());
+      }
     }
-    speech.close();
   }
 }
 // [END speech_quickstart]