migrate code from googleapis/java-texttospeech

texttospeech/snippets/pom.xml

@@ -0,0 +1,69 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>com.example.texttospeech</groupId>
+  <artifactId>texttospeech-snippets</artifactId>
+  <packaging>jar</packaging>
+  <name>Google Cloud Text-to-Speech Snippets</name>
+  <url>https://github.com/GoogleCloudPlatform/java-docs-samples/tree/main/texttospeech</url>
+
+  <!--
+    The parent pom defines common style checks and testing strategies for our samples.
+    Removing or replacing it should not affect the execution of the samples in anyway.
+  -->
+  <parent>
+    <groupId>com.google.cloud.samples</groupId>
+    <artifactId>shared-configuration</artifactId>
+    <version>1.2.0</version>
+  </parent>
+
+  <properties>
+    <maven.compiler.target>1.8</maven.compiler.target>
+    <maven.compiler.source>1.8</maven.compiler.source>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <!-- [START tts_java_dependencies] -->
+  <!-- [START tts_install_with_bom] -->
+  <dependencyManagement>
+    <dependencies>
+      <dependency>
+        <groupId>com.google.cloud</groupId>
+        <artifactId>libraries-bom</artifactId>
+        <version>26.1.4</version>
+        <type>pom</type>
+        <scope>import</scope>
+      </dependency>
+    </dependencies>
+  </dependencyManagement>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.google.cloud</groupId>
+      <artifactId>google-cloud-texttospeech</artifactId>
+    </dependency>
+    <!-- [END tts_java_dependencies] -->
+    <!-- [START_EXCLUDE] -->
+    <dependency>
+      <groupId>net.sourceforge.argparse4j</groupId>
+      <artifactId>argparse4j</artifactId>
+      <version>0.9.0</version>
+    </dependency>
+    <dependency>
+      <groupId>junit</groupId>
+      <artifactId>junit</artifactId>
+      <version>4.13.2</version>
+      <scope>test</scope>
+    </dependency>
+    <dependency>
+      <groupId>com.google.truth</groupId>
+      <artifactId>truth</artifactId>
+      <version>1.1.3</version>
+      <scope>test</scope>
+    </dependency>
+    <!-- [END_EXCLUDE] -->
+  <!-- [START tts_java_dependencies] -->
+  </dependencies>
+  <!-- [END tts_java_dependencies] -->
+  <!-- [END tts_install_with_bom] -->
+</project>

texttospeech/snippets/resources/example.ssml

@@ -0,0 +1,4 @@
+<speak>123 Street Ln, Small Town, IL 12345 USA
+<break time='2s'/>1 Jenny St &amp; Number St, Tutone City, CA 86753
+<break time='2s'/>1 Piazza del Fibonacci, 12358 Pisa, Italy
+<break time='2s'/></speak>

texttospeech/snippets/resources/example.txt

@@ -0,0 +1,3 @@
+123 Street Ln, Small Town, IL 12345 USA
+1 Jenny St & Number St, Tutone City, CA 86753
+1 Piazza del Fibonacci, 12358 Pisa, Italy

texttospeech/snippets/resources/hello.ssml

@@ -0,0 +1 @@
+<speak>Hello there.</speak>

texttospeech/snippets/resources/hello.txt

@@ -0,0 +1 @@
+Hello there!

texttospeech/snippets/src/main/java/com/example/texttospeech/ListAllSupportedVoices.java

@@ -0,0 +1,69 @@
+/*
+ * Copyright 2018 Google Inc.
+ *
+ * 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.texttospeech;
+
+// Imports the Google Cloud client library
+import com.google.cloud.texttospeech.v1.ListVoicesRequest;
+import com.google.cloud.texttospeech.v1.ListVoicesResponse;
+import com.google.cloud.texttospeech.v1.TextToSpeechClient;
+import com.google.cloud.texttospeech.v1.Voice;
+import com.google.protobuf.ByteString;
+import java.util.List;
+
+/**
+ * Google Cloud TextToSpeech API sample application. Example usage: mvn package exec:java
+ * -Dexec.mainClass='com.example.texttospeech.ListAllSupportedVoices'
+ */
+public class ListAllSupportedVoices {
+
+  // [START tts_list_voices]
+  /**
+   * Demonstrates using the Text to Speech client to list the client's supported voices.
+   *
+   * @throws Exception on TextToSpeechClient Errors.
+   */
+  public static List<Voice> listAllSupportedVoices() throws Exception {
+    // Instantiates a client
+    try (TextToSpeechClient textToSpeechClient = TextToSpeechClient.create()) {
+      // Builds the text to speech list voices request
+      ListVoicesRequest request = ListVoicesRequest.getDefaultInstance();
+
+      // Performs the list voices request
+      ListVoicesResponse response = textToSpeechClient.listVoices(request);
+      List<Voice> voices = response.getVoicesList();
+
+      for (Voice voice : voices) {
+        // Display the voice's name. Example: tpc-vocoded
+        System.out.format("Name: %s\n", voice.getName());
+
+        // Display the supported language codes for this voice. Example: "en-us"
+        List<ByteString> languageCodes = voice.getLanguageCodesList().asByteStringList();
+        for (ByteString languageCode : languageCodes) {
+          System.out.format("Supported Language: %s\n", languageCode.toStringUtf8());
+        }
+
+        // Display the SSML Voice Gender
+        System.out.format("SSML Voice Gender: %s\n", voice.getSsmlGender());
+
+        // Display the natural sample rate hertz for this voice. Example: 24000
+        System.out.format("Natural Sample Rate Hertz: %s\n\n", voice.getNaturalSampleRateHertz());
+      }
+      return voices;
+    }
+  }
+  // [END tts_list_voices]
+}

texttospeech/snippets/src/main/java/com/example/texttospeech/ListAllSupportedVoicesBeta.java

@@ -0,0 +1,72 @@
+/*
+ * Copyright 2018 Google Inc.
+ *
+ * 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.texttospeech;
+
+// Imports the Google Cloud client library
+import com.google.cloud.texttospeech.v1beta1.ListVoicesRequest;
+import com.google.cloud.texttospeech.v1beta1.ListVoicesResponse;
+import com.google.cloud.texttospeech.v1beta1.TextToSpeechClient;
+import com.google.cloud.texttospeech.v1beta1.Voice;
+import com.google.protobuf.ByteString;
+import java.util.List;
+
+/**
+ * Google Cloud TextToSpeech API sample application. Example usage: mvn package exec:java
+ * -Dexec.mainClass='com.example.texttospeech.ListAllSupportedVoicesBeta'
+ */
+public class ListAllSupportedVoicesBeta {
+
+  // [START tts_list_voices]
+  /**
+   * Demonstrates using the Text to Speech client to list the client's supported voices.
+   *
+   * @throws Exception on TextToSpeechClient Errors.
+   */
+  public static void listAllSupportedVoices() throws Exception {
+    // Instantiates a client
+    try (TextToSpeechClient textToSpeechClient = TextToSpeechClient.create()) {
+      // Builds the text to speech list voices request
+      ListVoicesRequest request = ListVoicesRequest.getDefaultInstance();
+
+      // Performs the list voices request
+      ListVoicesResponse response = textToSpeechClient.listVoices(request);
+      List<Voice> voices = response.getVoicesList();
+
+      for (Voice voice : voices) {
+        // Display the voice's name. Example: tpc-vocoded
+        System.out.format("Name: %s\n", voice.getName());
+
+        // Display the supported language codes for this voice. Example: "en-us"
+        List<ByteString> languageCodes = voice.getLanguageCodesList().asByteStringList();
+        for (ByteString languageCode : languageCodes) {
+          System.out.format("Supported Language: %s\n", languageCode.toStringUtf8());
+        }
+
+        // Display the SSML Voice Gender
+        System.out.format("SSML Voice Gender: %s\n", voice.getSsmlGender());
+
+        // Display the natural sample rate hertz for this voice. Example: 24000
+        System.out.format("Natural Sample Rate Hertz: %s\n\n", voice.getNaturalSampleRateHertz());
+      }
+    }
+  }
+  // [END tts_list_voices]
+
+  public static void main(String[] args) throws Exception {
+    listAllSupportedVoices();
+  }
+}

texttospeech/snippets/src/main/java/com/example/texttospeech/QuickstartSample.java

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2018 Google Inc.
+ *
+ * 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.texttospeech;
+
+// [START tts_quickstart]
+// Imports the Google Cloud client library
+import com.google.cloud.texttospeech.v1.AudioConfig;
+import com.google.cloud.texttospeech.v1.AudioEncoding;
+import com.google.cloud.texttospeech.v1.SsmlVoiceGender;
+import com.google.cloud.texttospeech.v1.SynthesisInput;
+import com.google.cloud.texttospeech.v1.SynthesizeSpeechResponse;
+import com.google.cloud.texttospeech.v1.TextToSpeechClient;
+import com.google.cloud.texttospeech.v1.VoiceSelectionParams;
+import com.google.protobuf.ByteString;
+import java.io.FileOutputStream;
+import java.io.OutputStream;
+
+/**
+ * Google Cloud TextToSpeech API sample application. Example usage: mvn package exec:java
+ * -Dexec.mainClass='com.example.texttospeech.QuickstartSample'
+ */
+public class QuickstartSample {
+
+  /** Demonstrates using the Text-to-Speech API. */
+  public static void main(String... args) throws Exception {
+    // Instantiates a client
+    try (TextToSpeechClient textToSpeechClient = TextToSpeechClient.create()) {
+      // Set the text input to be synthesized
+      SynthesisInput input = SynthesisInput.newBuilder().setText("Hello, World!").build();
+
+      // Build the voice request, select the language code ("en-US") and the ssml voice gender
+      // ("neutral")
+      VoiceSelectionParams voice =
+          VoiceSelectionParams.newBuilder()
+              .setLanguageCode("en-US")
+              .setSsmlGender(SsmlVoiceGender.NEUTRAL)
+              .build();
+
+      // Select the type of audio file you want returned
+      AudioConfig audioConfig =
+          AudioConfig.newBuilder().setAudioEncoding(AudioEncoding.MP3).build();
+
+      // Perform the text-to-speech request on the text input with the selected voice parameters and
+      // audio file type
+      SynthesizeSpeechResponse response =
+          textToSpeechClient.synthesizeSpeech(input, voice, audioConfig);
+
+      // Get the audio contents from the response
+      ByteString audioContents = response.getAudioContent();
+
+      // Write the response to the output file.
+      try (OutputStream out = new FileOutputStream("output.mp3")) {
+        out.write(audioContents.toByteArray());
+        System.out.println("Audio content written to file \"output.mp3\"");
+      }
+    }
+  }
+}
+// [END tts_quickstart]

texttospeech/snippets/src/main/java/com/example/texttospeech/QuickstartSampleBeta.java

@@ -0,0 +1,73 @@
+/*
+ * Copyright 2018 Google Inc.
+ *
+ * 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.texttospeech;
+
+// [START tts_quickstart]
+// Imports the Google Cloud client library
+import com.google.cloud.texttospeech.v1beta1.AudioConfig;
+import com.google.cloud.texttospeech.v1beta1.AudioEncoding;
+import com.google.cloud.texttospeech.v1beta1.SsmlVoiceGender;
+import com.google.cloud.texttospeech.v1beta1.SynthesisInput;
+import com.google.cloud.texttospeech.v1beta1.SynthesizeSpeechResponse;
+import com.google.cloud.texttospeech.v1beta1.TextToSpeechClient;
+import com.google.cloud.texttospeech.v1beta1.VoiceSelectionParams;
+import com.google.protobuf.ByteString;
+import java.io.FileOutputStream;
+import java.io.OutputStream;
+
+/**
+ * Google Cloud TextToSpeech API sample application. Example usage: mvn package exec:java
+ * -Dexec.mainClass='com.example.texttospeech.QuickstartSampleBeta'
+ */
+public class QuickstartSampleBeta {
+
+  /** Demonstrates using the Text-to-Speech API. */
+  public static void main(String... args) throws Exception {
+    // Instantiates a client
+    try (TextToSpeechClient textToSpeechClient = TextToSpeechClient.create()) {
+      // Set the text input to be synthesized
+      SynthesisInput input = SynthesisInput.newBuilder().setText("Hello, World!").build();
+
+      // Build the voice request, select the language code ("en-US") and the ssml voice gender
+      // ("neutral")
+      VoiceSelectionParams voice =
+          VoiceSelectionParams.newBuilder()
+              .setLanguageCode("en-US")
+              .setSsmlGender(SsmlVoiceGender.NEUTRAL)
+              .build();
+
+      // Select the type of audio file you want returned
+      AudioConfig audioConfig =
+          AudioConfig.newBuilder().setAudioEncoding(AudioEncoding.MP3).build();
+
+      // Perform the text-to-speech request on the text input with the selected voice parameters and
+      // audio file type
+      SynthesizeSpeechResponse response =
+          textToSpeechClient.synthesizeSpeech(input, voice, audioConfig);
+
+      // Get the audio contents from the response
+      ByteString audioContents = response.getAudioContent();
+
+      // Write the response to the output file.
+      try (OutputStream out = new FileOutputStream("output.mp3")) {
+        out.write(audioContents.toByteArray());
+        System.out.println("Audio content written to file \"output.mp3\"");
+      }
+    }
+  }
+}
+// [END tts_quickstart]