google-cloud-text_to_speech 0.4.1 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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