feat:Add ALAW support on client library. And improve the ListVoiceRequest message's documentation

Google APIs · copybara-github · commit 45445f476c39 · 2021-03-29T10:36:13.000-07:00
PiperOrigin-RevId: 365608171
diff --git a/google/cloud/texttospeech/v1beta1/cloud_tts.proto b/google/cloud/texttospeech/v1beta1/cloud_tts.proto
@@ -1,4 +1,4 @@
-// Copyright 2019 Google LLC.
+// Copyright 2021 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -56,13 +56,14 @@ service TextToSpeech {
 // The top-level message sent by the client for the `ListVoices` method.
 message ListVoicesRequest {
   // Optional. Recommended.
-  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
-  // specified, the ListVoices call will only return voices that can be used to
-  // synthesize this language_code. E.g. when specifying "en-NZ", you will get
-  // supported "en-\*" voices; when specifying "no", you will get supported
+  // [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag.
+  // If not specified, the API will return all supported voices.
+  // If specified, the ListVoices call will only return voices that can be used
+  // to synthesize this language_code. E.g. when specifying "en-NZ", you will
+  // get supported "en-NZ" voices; when specifying "no", you will get supported
   // "no-\*" (Norwegian) and "nb-\*" (Norwegian Bokmal) voices; specifying "zh"
   // will also get supported "cmn-\*" voices; specifying "zh-hk" will also get
-  // supported "yue-\*" voices.
+  // supported "yue-hk" voices.
   string language_code = 1 [(google.api.field_behavior) = OPTIONAL];
 }
 
@@ -111,6 +112,10 @@ enum AudioEncoding {
   // 8-bit samples that compand 14-bit audio samples using G.711 PCMU/mu-law.
   // Audio content returned as MULAW also contains a WAV header.
   MULAW = 5;
+
+  // 8-bit samples that compand 14-bit audio samples using G.711 PCMU/A-law.
+  // Audio content returned as ALAW also contains a WAV header.
+  ALAW = 6;
 }
 
 // The message returned to the client by the `ListVoices` method.
@@ -156,7 +161,7 @@ message SynthesizeSpeechRequest {
   // Required. The configuration of the synthesized audio.
   AudioConfig audio_config = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Whether and what timepoints should be returned in the response.
+  // Whether and what timepoints are returned in the response.
   repeated TimepointType enable_time_pointing = 4;
 }
 
