google-cloud-text_to_speech 0.4.1 → 0.5.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (18) hide show
  1. checksums.yaml +4 -4
  2. data/AUTHENTICATION.md +6 -28
  3. data/README.md +2 -18
  4. data/lib/google/cloud/text_to_speech.rb +0 -15
  5. data/lib/google/cloud/text_to_speech/v1.rb +0 -15
  6. data/lib/google/cloud/text_to_speech/v1/doc/google/cloud/texttospeech/v1/cloud_tts.rb +37 -37
  7. data/lib/google/cloud/text_to_speech/v1/text_to_speech_client.rb +1 -1
  8. data/lib/google/cloud/text_to_speech/v1/text_to_speech_client_config.json +2 -2
  9. data/lib/google/cloud/text_to_speech/v1beta1.rb +0 -15
  10. data/lib/google/cloud/text_to_speech/v1beta1/doc/google/cloud/texttospeech/v1beta1/cloud_tts.rb +37 -32
  11. data/lib/google/cloud/text_to_speech/v1beta1/text_to_speech_client.rb +2 -3
  12. data/lib/google/cloud/text_to_speech/v1beta1/text_to_speech_client_config.json +2 -2
  13. data/lib/google/cloud/text_to_speech/version.rb +1 -1
  14. data/lib/google/cloud/texttospeech/v1/cloud_tts_pb.rb +2 -0
  15. data/lib/google/cloud/texttospeech/v1/cloud_tts_services_pb.rb +1 -1
  16. data/lib/google/cloud/texttospeech/v1beta1/cloud_tts_pb.rb +2 -0
  17. data/lib/google/cloud/texttospeech/v1beta1/cloud_tts_services_pb.rb +3 -3
  18. metadata +9 -9
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7d26319e6cbddb3c3c1b8330bb29ef454619abc3bafc02054ba27aea47c0ff8c
4
- data.tar.gz: 4637ef8734edca4be1da313a97d2f7df175dffab2ac3c64db15991cf8a8f4b31
3
+ metadata.gz: ff768450acb9846fcba0971026c077b429f21096008995cd6187416eaf7900e8
4
+ data.tar.gz: 166483fb17cc369bb2271c2cc78299d4b26fd5f2501f42c6a3fa463e2ddc05bb
5
5
  SHA512:
6
- metadata.gz: be9f0006dc6780cb95a463d79f03ae918661625eaa9d8233d8515e45eddbe28c87bb0f4f1aa478852fa896168c588c01cc8c5d0271e91aac37d3e903a932859e
7
- data.tar.gz: b17069b72a3efb56b093ae2c7ecc5c4d6f1c6fd5c213fe58fd53bb0d8d0317a32db2202e28f35455d0fa12a08c020715a3b4d9bb1b9d7a187afba283d1f11301
6
+ metadata.gz: e0b6ce7321d1649744d01e6ccb7778db8cfb1d2ea23a734287aa5e96df5b59079ccf52c1665eb29483587773326a4c1454e8c86304a15d8f09f0d15e4823cfc6
7
+ data.tar.gz: be950a68699571386b77bc3db72fbece5e7670a84516b4e8dbbc36b92a8f91334c2a5af42e620aa135c167adeaebddae0d11ca62bac3c192479d9de3ef1084f4
data/AUTHENTICATION.md CHANGED
@@ -41,7 +41,7 @@ code.
41
41
  1. Specify project ID in method arguments
42
42
  2. Specify project ID in configuration
43
43
  3. Discover project ID in environment variables
44
- 4. Discover GCE project ID
44
+ 4. Discover GCP project ID
45
45
  5. Discover project ID in credentials JSON
46
46
 
47
47
  **Credentials** are discovered in the following order:
@@ -51,36 +51,14 @@ code.
51
51
  3. Discover credentials path in environment variables
52
52
  4. Discover credentials JSON in environment variables
53
53
  5. Discover credentials file in the Cloud SDK's path
54
- 6. Discover GCE credentials
54
+ 6. Discover GCP credentials
55
55
 
56
56
  ### Google Cloud Platform environments
57
57
 
58
- While running on Google Cloud Platform environments such as Google Compute
59
- Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
60
- The **Project ID** and **Credentials** and are discovered automatically. Code
61
- should be written as if already authenticated. Just be sure when you [set up the
62
- GCE instance][gce-how-to], you add the correct scopes for the APIs you want to
63
- access. For example:
64
-
65
- * **All APIs**
66
- * `https://www.googleapis.com/auth/cloud-platform`
67
- * `https://www.googleapis.com/auth/cloud-platform.read-only`
68
- * **BigQuery**
69
- * `https://www.googleapis.com/auth/bigquery`
70
- * `https://www.googleapis.com/auth/bigquery.insertdata`
71
- * **Compute Engine**
72
- * `https://www.googleapis.com/auth/compute`
73
- * **Datastore**
74
- * `https://www.googleapis.com/auth/datastore`
75
- * `https://www.googleapis.com/auth/userinfo.email`
76
- * **DNS**
77
- * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`
78
- * **Pub/Sub**
79
- * `https://www.googleapis.com/auth/pubsub`
80
- * **Storage**
81
- * `https://www.googleapis.com/auth/devstorage.full_control`
82
- * `https://www.googleapis.com/auth/devstorage.read_only`
83
- * `https://www.googleapis.com/auth/devstorage.read_write`
58
+ When running on Google Cloud Platform (GCP), including Google Compute Engine (GCE),
59
+ Google Kubernetes Engine (GKE), Google App Engine (GAE), Google Cloud Functions
60
+ (GCF) and Cloud Run, the **Project ID** and **Credentials** and are discovered
61
+ automatically. Code should be written as if already authenticated.
84
62
 
85
63
  ### Environment Variables
86
64
 
data/README.md CHANGED
@@ -20,22 +20,6 @@ steps:
20
20
  $ gem install google-cloud-text_to_speech
21
21
  ```
22
22
 
23
- ### Preview
24
- #### TextToSpeechClient
25
- ```rb
26
- require "google/cloud/text_to_speech"
27
-
28
- text_to_speech_client = Google::Cloud::TextToSpeech.new
29
- text = "test"
30
- input = { text: text }
31
- language_code = "en-US"
32
- voice = { language_code: language_code }
33
- audio_encoding = :MP3
34
- audio_config = { audio_encoding: audio_encoding }
35
- response = text_to_speech_client.synthesize_speech(input, voice, audio_config)
36
- File.write("example.mp3", response.audio_content, mode: "wb")
37
- ```
38
-
39
23
  ### Next Steps
40
24
  - Read the [Client Library Documentation][] for Cloud Text-to-Speech API
41
25
  to see other available methods on the client.
@@ -75,11 +59,11 @@ end
75
59
 
76
60
  ## Supported Ruby Versions
77
61
 
78
- This library is supported on Ruby 2.3+.
62
+ This library is supported on Ruby 2.4+.
79
63
 
80
64
  Google provides official support for Ruby versions that are actively supported
81
65
  by Ruby Core—that is, Ruby versions that are either in normal maintenance or
82
- in security maintenance, and not end of life. Currently, this means Ruby 2.3
66
+ in security maintenance, and not end of life. Currently, this means Ruby 2.4
83
67
  and later. Older versions of Ruby _may_ still work, but are unsupported and not
84
68
  recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
85
69
  about the Ruby support schedule.
data/lib/google/cloud/text_to_speech.rb CHANGED
@@ -42,21 +42,6 @@ module Google
42
42
  # $ gem install google-cloud-text_to_speech
43
43
  # ```
44
44
  #
45
- # ### Preview
46
- # #### TextToSpeechClient
47
- # ```rb
48
- # require "google/cloud/text_to_speech"
49
- #
50
- # text_to_speech_client = Google::Cloud::TextToSpeech.new
51
- # text = "test"
52
- # input = { text: text }
53
- # language_code = "en-US"
54
- # voice = { language_code: language_code }
55
- # audio_encoding = :MP3
56
- # audio_config = { audio_encoding: audio_encoding }
57
- # response = text_to_speech_client.synthesize_speech(input, voice, audio_config)
58
- # ```
59
- #
60
45
  # ### Next Steps
61
46
  # - Read the [Cloud Text-to-Speech API Product documentation][Product Documentation]
62
47
  # to learn more about the product and see How-to Guides.
data/lib/google/cloud/text_to_speech/v1.rb CHANGED
@@ -42,21 +42,6 @@ module Google
42
42
  # $ gem install google-cloud-text_to_speech
43
43
  # ```
44
44
  #
45
- # ### Preview
46
- # #### TextToSpeechClient
47
- # ```rb
48
- # require "google/cloud/text_to_speech"
49
- #
50
- # text_to_speech_client = Google::Cloud::TextToSpeech.new(version: :v1)
51
- # text = "test"
52
- # input = { text: text }
53
- # language_code = "en-US"
54
- # voice = { language_code: language_code }
55
- # audio_encoding = :MP3
56
- # audio_config = { audio_encoding: audio_encoding }
57
- # response = text_to_speech_client.synthesize_speech(input, voice, audio_config)
58
- # ```
59
- #
60
45
  # ### Next Steps
61
46
  # - Read the [Cloud Text-to-Speech API Product documentation][Product Documentation]
62
47
  # to learn more about the product and see How-to Guides.
data/lib/google/cloud/text_to_speech/v1/doc/google/cloud/texttospeech/v1/cloud_tts.rb CHANGED
@@ -20,7 +20,7 @@ module Google
20
20
  # The top-level message sent by the client for the `ListVoices` method.
21
21
  # @!attribute [rw] language_code
22
22
  # @return [String]
23
- # Optional (but recommended)
23
+ # Optional. Recommended.
24
24
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
25
25
  # specified, the ListVoices call will only return voices that can be used to
26
26
  # synthesize this language_code. E.g. when specifying "en-NZ", you will get
@@ -83,9 +83,9 @@ module Google
83
83
  # Description of which voice to use for a synthesis request.
84
84
  # @!attribute [rw] language_code
85
85
  # @return [String]
86
- # The language (and optionally also the region) of the voice expressed as a
86
+ # Required. The language (and potentially also the region) of the voice expressed as a
87
87
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g.
88
- # "en-US". Required. This should not include a script tag (e.g. use
88
+ # "en-US". This should not include a script tag (e.g. use
89
89
  # "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred
90
90
  # from the input provided in the SynthesisInput. The TTS service
91
91
  # will use this parameter to help choose an appropriate voice. Note that
@@ -96,11 +96,11 @@ module Google
96
96
  # Bokmal) instead of "no" (Norwegian)".
97
97
  # @!attribute [rw] name
98
98
  # @return [String]
99
- # The name of the voice. Optional; if not set, the service will choose a
99
+ # The name of the voice. If not set, the service will choose a
100
100
  # voice based on the other parameters such as language_code and gender.
101
101
  # @!attribute [rw] ssml_gender
102
102
  # @return [Google::Cloud::Texttospeech::V1::SsmlVoiceGender]
103
- # The preferred gender of the voice. Optional; if not set, the service will
103
+ # The preferred gender of the voice. If not set, the service will
104
104
  # choose a voice based on the other parameters such as language_code and
105
105
  # name. Note that this is only a preference, not requirement; if a
106
106
  # voice of the appropriate gender is not available, the synthesizer should
@@ -110,53 +110,53 @@ module Google
110
110
  # Description of audio data to be synthesized.
111
111
  # @!attribute [rw] audio_encoding
112
112
  # @return [Google::Cloud::Texttospeech::V1::AudioEncoding]
113
- # Required. The format of the requested audio byte stream.
113
+ # Required. The format of the audio byte stream.
114
114
  # @!attribute [rw] speaking_rate
115
115
  # @return [Float]
116
- # Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal
117
- # native speed supported by the specific voice. 2.0 is twice as fast, and
118
- # 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any
119
- # other values < 0.25 or > 4.0 will return an error.
116
+ # Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is
117
+ # the normal native speed supported by the specific voice. 2.0 is twice as
118
+ # fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0
119
+ # speed. Any other values < 0.25 or > 4.0 will return an error.
120
120
  # @!attribute [rw] pitch
121
121
  # @return [Float]
122
- # Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20
123
- # semitones from the original pitch. -20 means decrease 20 semitones from the
124
- # original pitch.
122
+ # Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means
123
+ # increase 20 semitones from the original pitch. -20 means decrease 20
124
+ # semitones from the original pitch.
125
125
  # @!attribute [rw] volume_gain_db
126
126
  # @return [Float]
127
- # Optional volume gain (in dB) of the normal native volume supported by the
128
- # specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of
129
- # 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)
130
- # will play at approximately half the amplitude of the normal native signal
131
- # amplitude. A value of +6.0 (dB) will play at approximately twice the
132
- # amplitude of the normal native signal amplitude. Strongly recommend not to
133
- # exceed +10 (dB) as there's usually no effective increase in loudness for
134
- # any value greater than that.
127
+ # Optional. Input only. Volume gain (in dB) of the normal native volume
128
+ # supported by the specific voice, in the range [-96.0, 16.0]. If unset, or
129
+ # set to a value of 0.0 (dB), will play at normal native signal amplitude. A
130
+ # value of -6.0 (dB) will play at approximately half the amplitude of the
131
+ # normal native signal amplitude. A value of +6.0 (dB) will play at
132
+ # approximately twice the amplitude of the normal native signal amplitude.
133
+ # Strongly recommend not to exceed +10 (dB) as there's usually no effective
134
+ # increase in loudness for any value greater than that.
135
135
  # @!attribute [rw] sample_rate_hertz
136
136
  # @return [Integer]
137
- # The synthesis sample rate (in hertz) for this audio. Optional. If this is
138
- # different from the voice's natural sample rate, then the synthesizer will
139
- # honor this request by converting to the desired sample rate (which might
140
- # result in worse audio quality), unless the specified sample rate is not
141
- # supported for the encoding chosen, in which case it will fail the request
142
- # and return {Google::Rpc::Code::INVALID_ARGUMENT}.
137
+ # Optional. The synthesis sample rate (in hertz) for this audio. When this is
138
+ # specified in SynthesizeSpeechRequest, if this is different from the voice's
139
+ # natural sample rate, then the synthesizer will honor this request by
140
+ # converting to the desired sample rate (which might result in worse audio
141
+ # quality), unless the specified sample rate is not supported for the
142
+ # encoding chosen, in which case it will fail the request and return
143
+ # {Google::Rpc::Code::INVALID_ARGUMENT}.
143
144
  # @!attribute [rw] effects_profile_id
144
145
  # @return [Array<String>]
145
- # An identifier which selects 'audio effects' profiles that are applied on
146
- # (post synthesized) text to speech.
147
- # Effects are applied on top of each other in the order they are given.
148
- # See
149
- #
150
- # [audio-profiles](https:
151
- # //cloud.google.com/text-to-speech/docs/audio-profiles)
152
- # for current supported profile ids.
146
+ # Optional. Input only. An identifier which selects 'audio effects' profiles
147
+ # that are applied on (post synthesized) text to speech. Effects are applied
148
+ # on top of each other in the order they are given. See
149
+ # [audio
150
+ # profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for
151
+ # current supported profile ids.
153
152
  class AudioConfig; end
154
153
 
155
154
  # The message returned to the client by the `SynthesizeSpeech` method.
156
155
  # @!attribute [rw] audio_content
157
156
  # @return [String]
158
157
  # The audio data bytes encoded as specified in the request, including the
159
- # header (For LINEAR16 audio, we include the WAV header). Note: as
158
+ # header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS).
159
+ # For LINEAR16 audio, we include the WAV header. Note: as
160
160
  # with all bytes fields, protobuffers use a pure binary representation,
161
161
  # whereas JSON representations use base64.
162
162
  class SynthesizeSpeechResponse; end
@@ -171,7 +171,7 @@ module Google
171
171
  # Audio content returned as LINEAR16 also contains a WAV header.
172
172
  LINEAR16 = 1
173
173
 
174
- # MP3 audio.
174
+ # MP3 audio at 32kbps.
175
175
  MP3 = 2
176
176
 
177
177
  # Opus encoded audio wrapped in an ogg container. The result will be a
data/lib/google/cloud/text_to_speech/v1/text_to_speech_client.rb CHANGED
@@ -184,7 +184,7 @@ module Google
184
184
  # Returns a list of Voice supported for synthesis.
185
185
  #
186
186
  # @param language_code [String]
187
- # Optional (but recommended)
187
+ # Optional. Recommended.
188
188
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
189
189
  # specified, the ListVoices call will only return voices that can be used to
190
190
  # synthesize this language_code. E.g. when specifying "en-NZ", you will get
data/lib/google/cloud/text_to_speech/v1/text_to_speech_client_config.json CHANGED
@@ -21,13 +21,13 @@
21
21
  },
22
22
  "methods": {
23
23
  "ListVoices": {
24
- "timeout_millis": 30000,
24
+ "timeout_millis": 60000,
25
25
  "retry_codes_name": "idempotent",
26
26
  "retry_params_name": "default"
27
27
  },
28
28
  "SynthesizeSpeech": {
29
29
  "timeout_millis": 60000,
30
- "retry_codes_name": "idempotent",
30
+ "retry_codes_name": "non_idempotent",
31
31
  "retry_params_name": "default"
32
32
  }
33
33
  }
data/lib/google/cloud/text_to_speech/v1beta1.rb CHANGED
@@ -42,21 +42,6 @@ module Google
42
42
  # $ gem install google-cloud-text_to_speech
43
43
  # ```
44
44
  #
45
- # ### Preview
46
- # #### TextToSpeechClient
47
- # ```rb
48
- # require "google/cloud/text_to_speech"
49
- #
50
- # text_to_speech_client = Google::Cloud::TextToSpeech.new(version: :v1beta1)
51
- # text = "test"
52
- # input = { text: text }
53
- # language_code = "en-US"
54
- # voice = { language_code: language_code }
55
- # audio_encoding = :MP3
56
- # audio_config = { audio_encoding: audio_encoding }
57
- # response = text_to_speech_client.synthesize_speech(input, voice, audio_config)
58
- # ```
59
- #
60
45
  # ### Next Steps
61
46
  # - Read the [Cloud Text-to-Speech API Product documentation][Product Documentation]
62
47
  # to learn more about the product and see How-to Guides.
data/lib/google/cloud/text_to_speech/v1beta1/doc/google/cloud/texttospeech/v1beta1/cloud_tts.rb CHANGED
@@ -20,7 +20,7 @@ module Google
20
20
  # The top-level message sent by the client for the `ListVoices` method.
21
21
  # @!attribute [rw] language_code
22
22
  # @return [String]
23
- # Optional (but recommended)
23
+ # Optional. Recommended.
24
24
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
25
25
  # specified, the ListVoices call will only return voices that can be used to
26
26
  # synthesize this language_code. E.g. when specifying "en-NZ", you will get
@@ -83,9 +83,9 @@ module Google
83
83
  # Description of which voice to use for a synthesis request.
84
84
  # @!attribute [rw] language_code
85
85
  # @return [String]
86
- # The language (and optionally also the region) of the voice expressed as a
86
+ # Required. The language (and potentially also the region) of the voice expressed as a
87
87
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g.
88
- # "en-US". Required. This should not include a script tag (e.g. use
88
+ # "en-US". This should not include a script tag (e.g. use
89
89
  # "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred
90
90
  # from the input provided in the SynthesisInput. The TTS service
91
91
  # will use this parameter to help choose an appropriate voice. Note that
@@ -96,11 +96,11 @@ module Google
96
96
  # Bokmal) instead of "no" (Norwegian)".
97
97
  # @!attribute [rw] name
98
98
  # @return [String]
99
- # The name of the voice. Optional; if not set, the service will choose a
99
+ # The name of the voice. If not set, the service will choose a
100
100
  # voice based on the other parameters such as language_code and gender.
101
101
  # @!attribute [rw] ssml_gender
102
102
  # @return [Google::Cloud::Texttospeech::V1beta1::SsmlVoiceGender]
103
- # The preferred gender of the voice. Optional; if not set, the service will
103
+ # The preferred gender of the voice. If not set, the service will
104
104
  # choose a voice based on the other parameters such as language_code and
105
105
  # name. Note that this is only a preference, not requirement; if a
106
106
  # voice of the appropriate gender is not available, the synthesizer should
@@ -110,48 +110,53 @@ module Google
110
110
  # Description of audio data to be synthesized.
111
111
  # @!attribute [rw] audio_encoding
112
112
  # @return [Google::Cloud::Texttospeech::V1beta1::AudioEncoding]
113
- # Required. The format of the requested audio byte stream.
113
+ # Required. The format of the audio byte stream.
114
114
  # @!attribute [rw] speaking_rate
115
115
  # @return [Float]
116
- # Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal
117
- # native speed supported by the specific voice. 2.0 is twice as fast, and
118
- # 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any
119
- # other values < 0.25 or > 4.0 will return an error.
116
+ # Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is
117
+ # the normal native speed supported by the specific voice. 2.0 is twice as
118
+ # fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0
119
+ # speed. Any other values < 0.25 or > 4.0 will return an error.
120
120
  # @!attribute [rw] pitch
121
121
  # @return [Float]
122
- # Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20
123
- # semitones from the original pitch. -20 means decrease 20 semitones from the
124
- # original pitch.
122
+ # Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means
123
+ # increase 20 semitones from the original pitch. -20 means decrease 20
124
+ # semitones from the original pitch.
125
125
  # @!attribute [rw] volume_gain_db
126
126
  # @return [Float]
127
- # Optional volume gain (in dB) of the normal native volume supported by the
128
- # specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of
129
- # 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB)
130
- # will play at approximately half the amplitude of the normal native signal
131
- # amplitude. A value of +6.0 (dB) will play at approximately twice the
132
- # amplitude of the normal native signal amplitude. Strongly recommend not to
133
- # exceed +10 (dB) as there's usually no effective increase in loudness for
134
- # any value greater than that.
127
+ # Optional. Input only. Volume gain (in dB) of the normal native volume
128
+ # supported by the specific voice, in the range [-96.0, 16.0]. If unset, or
129
+ # set to a value of 0.0 (dB), will play at normal native signal amplitude. A
130
+ # value of -6.0 (dB) will play at approximately half the amplitude of the
131
+ # normal native signal amplitude. A value of +6.0 (dB) will play at
132
+ # approximately twice the amplitude of the normal native signal amplitude.
133
+ # Strongly recommend not to exceed +10 (dB) as there's usually no effective
134
+ # increase in loudness for any value greater than that.
135
135
  # @!attribute [rw] sample_rate_hertz
136
136
  # @return [Integer]
137
- # The synthesis sample rate (in hertz) for this audio. Optional. If this is
138
- # different from the voice's natural sample rate, then the synthesizer will
139
- # honor this request by converting to the desired sample rate (which might
140
- # result in worse audio quality), unless the specified sample rate is not
141
- # supported for the encoding chosen, in which case it will fail the request
142
- # and return {Google::Rpc::Code::INVALID_ARGUMENT}.
137
+ # Optional. The synthesis sample rate (in hertz) for this audio. When this is
138
+ # specified in SynthesizeSpeechRequest, if this is different from the voice's
139
+ # natural sample rate, then the synthesizer will honor this request by
140
+ # converting to the desired sample rate (which might result in worse audio
141
+ # quality), unless the specified sample rate is not supported for the
142
+ # encoding chosen, in which case it will fail the request and return
143
+ # {Google::Rpc::Code::INVALID_ARGUMENT}.
143
144
  # @!attribute [rw] effects_profile_id
144
145
  # @return [Array<String>]
145
- # An identifier which selects 'audio effects' profiles that are applied on
146
- # (post synthesized) text to speech.
147
- # Effects are applied on top of each other in the order they are given.
146
+ # Optional. Input only. An identifier which selects 'audio effects' profiles
147
+ # that are applied on (post synthesized) text to speech. Effects are applied
148
+ # on top of each other in the order they are given. See
149
+ # [audio
150
+ # profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for
151
+ # current supported profile ids.
148
152
  class AudioConfig; end
149
153
 
150
154
  # The message returned to the client by the `SynthesizeSpeech` method.
151
155
  # @!attribute [rw] audio_content
152
156
  # @return [String]
153
157
  # The audio data bytes encoded as specified in the request, including the
154
- # header (For LINEAR16 audio, we include the WAV header). Note: as
158
+ # header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS).
159
+ # For LINEAR16 audio, we include the WAV header. Note: as
155
160
  # with all bytes fields, protobuffers use a pure binary representation,
156
161
  # whereas JSON representations use base64.
157
162
  class SynthesizeSpeechResponse; end
@@ -166,7 +171,7 @@ module Google
166
171
  # Audio content returned as LINEAR16 also contains a WAV header.
167
172
  LINEAR16 = 1
168
173
 
169
- # MP3 audio.
174
+ # MP3 audio at 32kbps.
170
175
  MP3 = 2
171
176
 
172
177
  # Opus encoded audio wrapped in an ogg container. The result will be a
data/lib/google/cloud/text_to_speech/v1beta1/text_to_speech_client.rb CHANGED
@@ -181,11 +181,10 @@ module Google
181
181
 
182
182
  # Service calls
183
183
 
184
- # Returns a list of {Google::Cloud::Texttospeech::V1beta1::Voice Voice}
185
- # supported for synthesis.
184
+ # Returns a list of Voice supported for synthesis.
186
185
  #
187
186
  # @param language_code [String]
188
- # Optional (but recommended)
187
+ # Optional. Recommended.
189
188
  # [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag. If
190
189
  # specified, the ListVoices call will only return voices that can be used to
191
190
  # synthesize this language_code. E.g. when specifying "en-NZ", you will get
data/lib/google/cloud/text_to_speech/v1beta1/text_to_speech_client_config.json CHANGED
@@ -21,13 +21,13 @@
21
21
  },
22
22
  "methods": {
23
23
  "ListVoices": {
24
- "timeout_millis": 30000,
24
+ "timeout_millis": 60000,
25
25
  "retry_codes_name": "idempotent",
26
26
  "retry_params_name": "default"
27
27
  },
28
28
  "SynthesizeSpeech": {
29
29
  "timeout_millis": 60000,
30
- "retry_codes_name": "idempotent",
30
+ "retry_codes_name": "non_idempotent",
31
31
  "retry_params_name": "default"
32
32
  }
33
33
  }
data/lib/google/cloud/text_to_speech/version.rb CHANGED
@@ -16,7 +16,7 @@
16
16
  module Google
17
17
  module Cloud
18
18
  module TextToSpeech
19
- VERSION = "0.4.1".freeze
19
+ VERSION = "0.5.0".freeze
20
20
  end
21
21
  end
22
22
  end
data/lib/google/cloud/texttospeech/v1/cloud_tts_pb.rb CHANGED
@@ -5,6 +5,8 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
8
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
11
  add_message "google.cloud.texttospeech.v1.ListVoicesRequest" do
10
12
  optional :language_code, :string, 1
data/lib/google/cloud/texttospeech/v1/cloud_tts_services_pb.rb CHANGED
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/cloud/texttospeech/v1/cloud_tts.proto for package 'google.cloud.texttospeech.v1'
3
3
  # Original file comments:
4
- # Copyright 2018 Google LLC.
4
+ # Copyright 2019 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
data/lib/google/cloud/texttospeech/v1beta1/cloud_tts_pb.rb CHANGED
@@ -5,6 +5,8 @@
5
5
  require 'google/protobuf'
6
6
 
7
7
  require 'google/api/annotations_pb'
8
+ require 'google/api/client_pb'
9
+ require 'google/api/field_behavior_pb'
8
10
  Google::Protobuf::DescriptorPool.generated_pool.build do
9
11
  add_message "google.cloud.texttospeech.v1beta1.ListVoicesRequest" do
10
12
  optional :language_code, :string, 1
data/lib/google/cloud/texttospeech/v1beta1/cloud_tts_services_pb.rb CHANGED
@@ -1,7 +1,7 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # Source: google/cloud/texttospeech/v1beta1/cloud_tts.proto for package 'google.cloud.texttospeech.v1beta1'
3
3
  # Original file comments:
4
- # Copyright 2018 Google Inc.
4
+ # Copyright 2019 Google LLC.
5
5
  #
6
6
  # Licensed under the Apache License, Version 2.0 (the "License");
7
7
  # you may not use this file except in compliance with the License.
@@ -15,6 +15,7 @@
15
15
  # See the License for the specific language governing permissions and
16
16
  # limitations under the License.
17
17
  #
18
+ #
18
19
 
19
20
 
20
21
  require 'grpc'
@@ -34,8 +35,7 @@ module Google
34
35
  self.unmarshal_class_method = :decode
35
36
  self.service_name = 'google.cloud.texttospeech.v1beta1.TextToSpeech'
36
37
 
37
- # Returns a list of [Voice][google.cloud.texttospeech.v1beta1.Voice]
38
- # supported for synthesis.
38
+ # Returns a list of Voice supported for synthesis.
39
39
  rpc :ListVoices, ListVoicesRequest, ListVoicesResponse
40
40
  # Synthesizes speech synchronously: receive results after all text input
41
41
  # has been processed.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-text_to_speech
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.1
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-08-23 00:00:00.000000000 Z
11
+ date: 2019-10-30 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-gax
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '1.7'
19
+ version: '1.8'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '1.7'
26
+ version: '1.8'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: minitest
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -53,19 +53,19 @@ dependencies:
53
53
  - !ruby/object:Gem::Version
54
54
  version: '3.0'
55
55
  - !ruby/object:Gem::Dependency
56
- name: rubocop
56
+ name: google-style
57
57
  requirement: !ruby/object:Gem::Requirement
58
58
  requirements:
59
59
  - - "~>"
60
60
  - !ruby/object:Gem::Version
61
- version: 0.64.0
61
+ version: 1.24.0
62
62
  type: :development
63
63
  prerelease: false
64
64
  version_requirements: !ruby/object:Gem::Requirement
65
65
  requirements:
66
66
  - - "~>"
67
67
  - !ruby/object:Gem::Version
68
- version: 0.64.0
68
+ version: 1.24.0
69
69
  - !ruby/object:Gem::Dependency
70
70
  name: simplecov
71
71
  requirement: !ruby/object:Gem::Requirement
@@ -133,14 +133,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
133
133
  requirements:
134
134
  - - ">="
135
135
  - !ruby/object:Gem::Version
136
- version: 2.0.0
136
+ version: '2.4'
137
137
  required_rubygems_version: !ruby/object:Gem::Requirement
138
138
  requirements:
139
139
  - - ">="
140
140
  - !ruby/object:Gem::Version
141
141
  version: '0'
142
142
  requirements: []
143
- rubygems_version: 3.0.4
143
+ rubygems_version: 3.0.6
144
144
  signing_key:
145
145
  specification_version: 4
146
146
  summary: API Client library for Cloud Text-to-Speech API