diff --git a/TextToSpeech/metadata/V1/CloudTts.php b/TextToSpeech/metadata/V1/CloudTts.php index 1dc5f6914ca9..3bb79c88dd0a 100644 --- a/TextToSpeech/metadata/V1/CloudTts.php +++ b/TextToSpeech/metadata/V1/CloudTts.php @@ -15,65 +15,75 @@ public static function initOnce() { return; } \GPBMetadata\Google\Api\Annotations::initOnce(); + \GPBMetadata\Google\Api\Client::initOnce(); + \GPBMetadata\Google\Api\FieldBehavior::initOnce(); $pool->internalAddGeneratedFile(hex2bin( - "0aae0d0a2c676f6f676c652f636c6f75642f74657874746f737065656368" . + "0aa80f0a2c676f6f676c652f636c6f75642f74657874746f737065656368" . "2f76312f636c6f75645f7474732e70726f746f121c676f6f676c652e636c" . - "6f75642e74657874746f7370656563682e7631222a0a114c697374566f69" . - "6365735265717565737412150a0d6c616e67756167655f636f6465180120" . - "01280922490a124c697374566f69636573526573706f6e736512330a0676" . - "6f6963657318012003280b32232e676f6f676c652e636c6f75642e746578" . - "74746f7370656563682e76312e566f6963652294010a05566f6963651216" . - "0a0e6c616e67756167655f636f646573180120032809120c0a046e616d65" . - "18022001280912420a0b73736d6c5f67656e64657218032001280e322d2e" . - "676f6f676c652e636c6f75642e74657874746f7370656563682e76312e53" . - "736d6c566f69636547656e64657212210a196e61747572616c5f73616d70" . - "6c655f726174655f686572747a18042001280522da010a1753796e746865" . - "73697a6553706565636852657175657374123b0a05696e70757418012001" . - "280b322c2e676f6f676c652e636c6f75642e74657874746f737065656368" . - "2e76312e53796e746865736973496e70757412410a05766f696365180220" . - "01280b32322e676f6f676c652e636c6f75642e74657874746f7370656563" . - "682e76312e566f69636553656c656374696f6e506172616d73123f0a0c61" . - "7564696f5f636f6e66696718032001280b32292e676f6f676c652e636c6f" . - "75642e74657874746f7370656563682e76312e417564696f436f6e666967" . - "22400a0e53796e746865736973496e707574120e0a047465787418012001" . - "28094800120e0a0473736d6c1802200128094800420e0a0c696e7075745f" . - "736f75726365227f0a14566f69636553656c656374696f6e506172616d73" . - "12150a0d6c616e67756167655f636f6465180120012809120c0a046e616d" . - "6518022001280912420a0b73736d6c5f67656e64657218032001280e322d" . - "2e676f6f676c652e636c6f75642e74657874746f7370656563682e76312e" . - "53736d6c566f69636547656e64657222c7010a0b417564696f436f6e6669" . - "6712430a0e617564696f5f656e636f64696e6718012001280e322b2e676f" . - "6f676c652e636c6f75642e74657874746f7370656563682e76312e417564" . - "696f456e636f64696e6712150a0d737065616b696e675f72617465180220" . - "012801120d0a05706974636818032001280112160a0e766f6c756d655f67" . - "61696e5f646218042001280112190a1173616d706c655f726174655f6865" . - "72747a180520012805121a0a12656666656374735f70726f66696c655f69" . - "6418062003280922310a1853796e74686573697a65537065656368526573" . - "706f6e736512150a0d617564696f5f636f6e74656e7418012001280c2a57" . - "0a0f53736d6c566f69636547656e64657212210a1d53534d4c5f564f4943" . - "455f47454e4445525f554e535045434946494544100012080a044d414c45" . - "1001120a0a0646454d414c451002120b0a074e45555452414c10032a540a" . - "0d417564696f456e636f64696e67121e0a1a415544494f5f454e434f4449" . - "4e475f554e5350454349464945441000120c0a084c494e45415231361001" . - "12070a034d50331002120c0a084f47475f4f505553100332b8020a0c5465" . - "7874546f5370656563681283010a0a4c697374566f69636573122f2e676f" . - "6f676c652e636c6f75642e74657874746f7370656563682e76312e4c6973" . - "74566f69636573526571756573741a302e676f6f676c652e636c6f75642e" . - "74657874746f7370656563682e76312e4c697374566f6963657352657370" . - "6f6e7365221282d3e493020c120a2f76312f766f6963657312a1010a1053" . - "796e74686573697a6553706565636812352e676f6f676c652e636c6f7564" . - "2e74657874746f7370656563682e76312e53796e74686573697a65537065" . - "656368526571756573741a362e676f6f676c652e636c6f75642e74657874" . - "746f7370656563682e76312e53796e74686573697a655370656563685265" . - "73706f6e7365221e82d3e493021822132f76312f746578743a73796e7468" . - "6573697a653a012a42c2010a20636f6d2e676f6f676c652e636c6f75642e" . - "74657874746f7370656563682e7631421154657874546f53706565636850" . - "726f746f50015a48676f6f676c652e676f6c616e672e6f72672f67656e70" . - "726f746f2f676f6f676c65617069732f636c6f75642f74657874746f7370" . - "656563682f76313b74657874746f737065656368f80101aa021c476f6f67" . - "6c652e436c6f75642e54657874546f5370656563682e5631ca021c476f6f" . - "676c655c436c6f75645c54657874546f5370656563685c5631620670726f" . - "746f33" + "6f75642e74657874746f7370656563682e76311a17676f6f676c652f6170" . + "692f636c69656e742e70726f746f1a1f676f6f676c652f6170692f666965" . + "6c645f6265686176696f722e70726f746f222f0a114c697374566f696365" . + "7352657175657374121a0a0d6c616e67756167655f636f64651801200128" . + "094203e0410122490a124c697374566f69636573526573706f6e73651233" . + "0a06766f6963657318012003280b32232e676f6f676c652e636c6f75642e" . + "74657874746f7370656563682e76312e566f6963652294010a05566f6963" . + "6512160a0e6c616e67756167655f636f646573180120032809120c0a046e" . + "616d6518022001280912420a0b73736d6c5f67656e64657218032001280e" . + "322d2e676f6f676c652e636c6f75642e74657874746f7370656563682e76" . + "312e53736d6c566f69636547656e64657212210a196e61747572616c5f73" . + "616d706c655f726174655f686572747a18042001280522e9010a1753796e" . + "74686573697a655370656563685265717565737412400a05696e70757418" . + "012001280b322c2e676f6f676c652e636c6f75642e74657874746f737065" . + "6563682e76312e53796e746865736973496e7075744203e0410212460a05" . + "766f69636518022001280b32322e676f6f676c652e636c6f75642e746578" . + "74746f7370656563682e76312e566f69636553656c656374696f6e506172" . + "616d734203e0410212440a0c617564696f5f636f6e66696718032001280b" . + "32292e676f6f676c652e636c6f75642e74657874746f7370656563682e76" . + "312e417564696f436f6e6669674203e0410222400a0e53796e7468657369" . + "73496e707574120e0a04746578741801200128094800120e0a0473736d6c" . + "1802200128094800420e0a0c696e7075745f736f757263652284010a1456" . + "6f69636553656c656374696f6e506172616d73121a0a0d6c616e67756167" . + "655f636f64651801200128094203e04102120c0a046e616d651802200128" . + "0912420a0b73736d6c5f67656e64657218032001280e322d2e676f6f676c" . + "652e636c6f75642e74657874746f7370656563682e76312e53736d6c566f" . + "69636547656e64657222f1010a0b417564696f436f6e66696712480a0e61" . + "7564696f5f656e636f64696e6718012001280e322b2e676f6f676c652e63" . + "6c6f75642e74657874746f7370656563682e76312e417564696f456e636f" . + "64696e674203e04102121d0a0d737065616b696e675f7261746518022001" . + "28014206e04104e0410112150a0570697463681803200128014206e04104" . + "e04101121e0a0e766f6c756d655f6761696e5f64621804200128014206e0" . + "4104e04101121e0a1173616d706c655f726174655f686572747a18052001" . + "28054203e0410112220a12656666656374735f70726f66696c655f696418" . + "06200328094206e04104e0410122310a1853796e74686573697a65537065" . + "656368526573706f6e736512150a0d617564696f5f636f6e74656e741801" . + "2001280c2a570a0f53736d6c566f69636547656e64657212210a1d53534d" . + "4c5f564f4943455f47454e4445525f554e53504543494649454410001208" . + "0a044d414c451001120a0a0646454d414c451002120b0a074e4555545241" . + "4c10032a540a0d417564696f456e636f64696e67121e0a1a415544494f5f" . + "454e434f44494e475f554e5350454349464945441000120c0a084c494e45" . + "41523136100112070a034d50331002120c0a084f47475f4f505553100332" . + "b4030a0c54657874546f5370656563681293010a0a4c697374566f696365" . + "73122f2e676f6f676c652e636c6f75642e74657874746f7370656563682e" . + "76312e4c697374566f69636573526571756573741a302e676f6f676c652e" . + "636c6f75642e74657874746f7370656563682e76312e4c697374566f6963" . + "6573526573706f6e7365222282d3e493020c120a2f76312f766f69636573" . + "da410d6c616e67756167655f636f646512bc010a1053796e74686573697a" . + "6553706565636812352e676f6f676c652e636c6f75642e74657874746f73" . + "70656563682e76312e53796e74686573697a655370656563685265717565" . + "73741a362e676f6f676c652e636c6f75642e74657874746f737065656368" . + "2e76312e53796e74686573697a65537065656368526573706f6e73652239" . + "82d3e493021822132f76312f746578743a73796e74686573697a653a012a" . + "da4118696e7075742c766f6963652c617564696f5f636f6e6669671a4fca" . + "411b74657874746f7370656563682e676f6f676c65617069732e636f6dd2" . + "412e68747470733a2f2f7777772e676f6f676c65617069732e636f6d2f61" . + "7574682f636c6f75642d706c6174666f726d42c2010a20636f6d2e676f6f" . + "676c652e636c6f75642e74657874746f7370656563682e76314211546578" . + "74546f53706565636850726f746f50015a48676f6f676c652e676f6c616e" . + "672e6f72672f67656e70726f746f2f676f6f676c65617069732f636c6f75" . + "642f74657874746f7370656563682f76313b74657874746f737065656368" . + "f80101aa021c476f6f676c652e436c6f75642e54657874546f5370656563" . + "682e5631ca021c476f6f676c655c436c6f75645c54657874546f53706565" . + "63685c5631620670726f746f33" ), true); static::$is_initialized = true; diff --git a/TextToSpeech/src/V1/AudioConfig.php b/TextToSpeech/src/V1/AudioConfig.php index 643239783488..e37037de2b5f 100644 --- a/TextToSpeech/src/V1/AudioConfig.php +++ b/TextToSpeech/src/V1/AudioConfig.php @@ -16,62 +16,62 @@ class AudioConfig extends \Google\Protobuf\Internal\Message { /** - * Required. The format of the requested audio byte stream. + * Required. The format of the audio byte stream. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1 [(.google.api.field_behavior) = REQUIRED]; */ private $audio_encoding = 0; /** - * Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal - * native speed supported by the specific voice. 2.0 is twice as fast, and - * 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any - * other values < 0.25 or > 4.0 will return an error. + * Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is + * the normal native speed supported by the specific voice. 2.0 is twice as + * fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 + * speed. Any other values < 0.25 or > 4.0 will return an error. * - * Generated from protobuf field double speaking_rate = 2; + * Generated from protobuf field double speaking_rate = 2 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; */ private $speaking_rate = 0.0; /** - * Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 - * semitones from the original pitch. -20 means decrease 20 semitones from the - * original pitch. + * Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means + * increase 20 semitones from the original pitch. -20 means decrease 20 + * semitones from the original pitch. * - * Generated from protobuf field double pitch = 3; + * Generated from protobuf field double pitch = 3 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; */ private $pitch = 0.0; /** - * Optional volume gain (in dB) of the normal native volume supported by the - * specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of - * 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) - * will play at approximately half the amplitude of the normal native signal - * amplitude. A value of +6.0 (dB) will play at approximately twice the - * amplitude of the normal native signal amplitude. Strongly recommend not to - * exceed +10 (dB) as there's usually no effective increase in loudness for - * any value greater than that. + * Optional. Input only. Volume gain (in dB) of the normal native volume + * supported by the specific voice, in the range [-96.0, 16.0]. If unset, or + * set to a value of 0.0 (dB), will play at normal native signal amplitude. A + * value of -6.0 (dB) will play at approximately half the amplitude of the + * normal native signal amplitude. A value of +6.0 (dB) will play at + * approximately twice the amplitude of the normal native signal amplitude. + * Strongly recommend not to exceed +10 (dB) as there's usually no effective + * increase in loudness for any value greater than that. * - * Generated from protobuf field double volume_gain_db = 4; + * Generated from protobuf field double volume_gain_db = 4 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; */ private $volume_gain_db = 0.0; /** - * The synthesis sample rate (in hertz) for this audio. Optional. If this is - * different from the voice's natural sample rate, then the synthesizer will - * honor this request by converting to the desired sample rate (which might - * result in worse audio quality), unless the specified sample rate is not - * supported for the encoding chosen, in which case it will fail the request - * and return [google.rpc.Code.INVALID_ARGUMENT][]. + * Optional. The synthesis sample rate (in hertz) for this audio. When this is + * specified in SynthesizeSpeechRequest, if this is different from the voice's + * natural sample rate, then the synthesizer will honor this request by + * converting to the desired sample rate (which might result in worse audio + * quality), unless the specified sample rate is not supported for the + * encoding chosen, in which case it will fail the request and return + * [google.rpc.Code.INVALID_ARGUMENT][]. * - * Generated from protobuf field int32 sample_rate_hertz = 5; + * Generated from protobuf field int32 sample_rate_hertz = 5 [(.google.api.field_behavior) = OPTIONAL]; */ private $sample_rate_hertz = 0; /** - * An identifier which selects 'audio effects' profiles that are applied on - * (post synthesized) text to speech. - * Effects are applied on top of each other in the order they are given. - * See - * [audio-profiles](https: - * //cloud.google.com/text-to-speech/docs/audio-profiles) - * for current supported profile ids. + * Optional. Input only. An identifier which selects 'audio effects' profiles + * that are applied on (post synthesized) text to speech. Effects are applied + * on top of each other in the order they are given. See + * [audio + * profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for + * current supported profile ids. * - * Generated from protobuf field repeated string effects_profile_id = 6; + * Generated from protobuf field repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; */ private $effects_profile_id; @@ -82,40 +82,40 @@ class AudioConfig extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type int $audio_encoding - * Required. The format of the requested audio byte stream. + * Required. The format of the audio byte stream. * @type float $speaking_rate - * Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal - * native speed supported by the specific voice. 2.0 is twice as fast, and - * 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any - * other values < 0.25 or > 4.0 will return an error. + * Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is + * the normal native speed supported by the specific voice. 2.0 is twice as + * fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 + * speed. Any other values < 0.25 or > 4.0 will return an error. * @type float $pitch - * Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 - * semitones from the original pitch. -20 means decrease 20 semitones from the - * original pitch. + * Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means + * increase 20 semitones from the original pitch. -20 means decrease 20 + * semitones from the original pitch. * @type float $volume_gain_db - * Optional volume gain (in dB) of the normal native volume supported by the - * specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of - * 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) - * will play at approximately half the amplitude of the normal native signal - * amplitude. A value of +6.0 (dB) will play at approximately twice the - * amplitude of the normal native signal amplitude. Strongly recommend not to - * exceed +10 (dB) as there's usually no effective increase in loudness for - * any value greater than that. + * Optional. Input only. Volume gain (in dB) of the normal native volume + * supported by the specific voice, in the range [-96.0, 16.0]. If unset, or + * set to a value of 0.0 (dB), will play at normal native signal amplitude. A + * value of -6.0 (dB) will play at approximately half the amplitude of the + * normal native signal amplitude. A value of +6.0 (dB) will play at + * approximately twice the amplitude of the normal native signal amplitude. + * Strongly recommend not to exceed +10 (dB) as there's usually no effective + * increase in loudness for any value greater than that. * @type int $sample_rate_hertz - * The synthesis sample rate (in hertz) for this audio. Optional. If this is - * different from the voice's natural sample rate, then the synthesizer will - * honor this request by converting to the desired sample rate (which might - * result in worse audio quality), unless the specified sample rate is not - * supported for the encoding chosen, in which case it will fail the request - * and return [google.rpc.Code.INVALID_ARGUMENT][]. + * Optional. The synthesis sample rate (in hertz) for this audio. When this is + * specified in SynthesizeSpeechRequest, if this is different from the voice's + * natural sample rate, then the synthesizer will honor this request by + * converting to the desired sample rate (which might result in worse audio + * quality), unless the specified sample rate is not supported for the + * encoding chosen, in which case it will fail the request and return + * [google.rpc.Code.INVALID_ARGUMENT][]. * @type string[]|\Google\Protobuf\Internal\RepeatedField $effects_profile_id - * An identifier which selects 'audio effects' profiles that are applied on - * (post synthesized) text to speech. - * Effects are applied on top of each other in the order they are given. - * See - * [audio-profiles](https: - * //cloud.google.com/text-to-speech/docs/audio-profiles) - * for current supported profile ids. + * Optional. Input only. An identifier which selects 'audio effects' profiles + * that are applied on (post synthesized) text to speech. Effects are applied + * on top of each other in the order they are given. See + * [audio + * profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for + * current supported profile ids. * } */ public function __construct($data = NULL) { @@ -124,9 +124,9 @@ public function __construct($data = NULL) { } /** - * Required. The format of the requested audio byte stream. + * Required. The format of the audio byte stream. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1 [(.google.api.field_behavior) = REQUIRED]; * @return int */ public function getAudioEncoding() @@ -135,9 +135,9 @@ public function getAudioEncoding() } /** - * Required. The format of the requested audio byte stream. + * Required. The format of the audio byte stream. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioEncoding audio_encoding = 1 [(.google.api.field_behavior) = REQUIRED]; * @param int $var * @return $this */ @@ -150,12 +150,12 @@ public function setAudioEncoding($var) } /** - * Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal - * native speed supported by the specific voice. 2.0 is twice as fast, and - * 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any - * other values < 0.25 or > 4.0 will return an error. + * Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is + * the normal native speed supported by the specific voice. 2.0 is twice as + * fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 + * speed. Any other values < 0.25 or > 4.0 will return an error. * - * Generated from protobuf field double speaking_rate = 2; + * Generated from protobuf field double speaking_rate = 2 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @return float */ public function getSpeakingRate() @@ -164,12 +164,12 @@ public function getSpeakingRate() } /** - * Optional speaking rate/speed, in the range [0.25, 4.0]. 1.0 is the normal - * native speed supported by the specific voice. 2.0 is twice as fast, and - * 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 speed. Any - * other values < 0.25 or > 4.0 will return an error. + * Optional. Input only. Speaking rate/speed, in the range [0.25, 4.0]. 1.0 is + * the normal native speed supported by the specific voice. 2.0 is twice as + * fast, and 0.5 is half as fast. If unset(0.0), defaults to the native 1.0 + * speed. Any other values < 0.25 or > 4.0 will return an error. * - * Generated from protobuf field double speaking_rate = 2; + * Generated from protobuf field double speaking_rate = 2 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @param float $var * @return $this */ @@ -182,11 +182,11 @@ public function setSpeakingRate($var) } /** - * Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 - * semitones from the original pitch. -20 means decrease 20 semitones from the - * original pitch. + * Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means + * increase 20 semitones from the original pitch. -20 means decrease 20 + * semitones from the original pitch. * - * Generated from protobuf field double pitch = 3; + * Generated from protobuf field double pitch = 3 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @return float */ public function getPitch() @@ -195,11 +195,11 @@ public function getPitch() } /** - * Optional speaking pitch, in the range [-20.0, 20.0]. 20 means increase 20 - * semitones from the original pitch. -20 means decrease 20 semitones from the - * original pitch. + * Optional. Input only. Speaking pitch, in the range [-20.0, 20.0]. 20 means + * increase 20 semitones from the original pitch. -20 means decrease 20 + * semitones from the original pitch. * - * Generated from protobuf field double pitch = 3; + * Generated from protobuf field double pitch = 3 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @param float $var * @return $this */ @@ -212,16 +212,16 @@ public function setPitch($var) } /** - * Optional volume gain (in dB) of the normal native volume supported by the - * specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of - * 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) - * will play at approximately half the amplitude of the normal native signal - * amplitude. A value of +6.0 (dB) will play at approximately twice the - * amplitude of the normal native signal amplitude. Strongly recommend not to - * exceed +10 (dB) as there's usually no effective increase in loudness for - * any value greater than that. + * Optional. Input only. Volume gain (in dB) of the normal native volume + * supported by the specific voice, in the range [-96.0, 16.0]. If unset, or + * set to a value of 0.0 (dB), will play at normal native signal amplitude. A + * value of -6.0 (dB) will play at approximately half the amplitude of the + * normal native signal amplitude. A value of +6.0 (dB) will play at + * approximately twice the amplitude of the normal native signal amplitude. + * Strongly recommend not to exceed +10 (dB) as there's usually no effective + * increase in loudness for any value greater than that. * - * Generated from protobuf field double volume_gain_db = 4; + * Generated from protobuf field double volume_gain_db = 4 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @return float */ public function getVolumeGainDb() @@ -230,16 +230,16 @@ public function getVolumeGainDb() } /** - * Optional volume gain (in dB) of the normal native volume supported by the - * specific voice, in the range [-96.0, 16.0]. If unset, or set to a value of - * 0.0 (dB), will play at normal native signal amplitude. A value of -6.0 (dB) - * will play at approximately half the amplitude of the normal native signal - * amplitude. A value of +6.0 (dB) will play at approximately twice the - * amplitude of the normal native signal amplitude. Strongly recommend not to - * exceed +10 (dB) as there's usually no effective increase in loudness for - * any value greater than that. + * Optional. Input only. Volume gain (in dB) of the normal native volume + * supported by the specific voice, in the range [-96.0, 16.0]. If unset, or + * set to a value of 0.0 (dB), will play at normal native signal amplitude. A + * value of -6.0 (dB) will play at approximately half the amplitude of the + * normal native signal amplitude. A value of +6.0 (dB) will play at + * approximately twice the amplitude of the normal native signal amplitude. + * Strongly recommend not to exceed +10 (dB) as there's usually no effective + * increase in loudness for any value greater than that. * - * Generated from protobuf field double volume_gain_db = 4; + * Generated from protobuf field double volume_gain_db = 4 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @param float $var * @return $this */ @@ -252,14 +252,15 @@ public function setVolumeGainDb($var) } /** - * The synthesis sample rate (in hertz) for this audio. Optional. If this is - * different from the voice's natural sample rate, then the synthesizer will - * honor this request by converting to the desired sample rate (which might - * result in worse audio quality), unless the specified sample rate is not - * supported for the encoding chosen, in which case it will fail the request - * and return [google.rpc.Code.INVALID_ARGUMENT][]. + * Optional. The synthesis sample rate (in hertz) for this audio. When this is + * specified in SynthesizeSpeechRequest, if this is different from the voice's + * natural sample rate, then the synthesizer will honor this request by + * converting to the desired sample rate (which might result in worse audio + * quality), unless the specified sample rate is not supported for the + * encoding chosen, in which case it will fail the request and return + * [google.rpc.Code.INVALID_ARGUMENT][]. * - * Generated from protobuf field int32 sample_rate_hertz = 5; + * Generated from protobuf field int32 sample_rate_hertz = 5 [(.google.api.field_behavior) = OPTIONAL]; * @return int */ public function getSampleRateHertz() @@ -268,14 +269,15 @@ public function getSampleRateHertz() } /** - * The synthesis sample rate (in hertz) for this audio. Optional. If this is - * different from the voice's natural sample rate, then the synthesizer will - * honor this request by converting to the desired sample rate (which might - * result in worse audio quality), unless the specified sample rate is not - * supported for the encoding chosen, in which case it will fail the request - * and return [google.rpc.Code.INVALID_ARGUMENT][]. + * Optional. The synthesis sample rate (in hertz) for this audio. When this is + * specified in SynthesizeSpeechRequest, if this is different from the voice's + * natural sample rate, then the synthesizer will honor this request by + * converting to the desired sample rate (which might result in worse audio + * quality), unless the specified sample rate is not supported for the + * encoding chosen, in which case it will fail the request and return + * [google.rpc.Code.INVALID_ARGUMENT][]. * - * Generated from protobuf field int32 sample_rate_hertz = 5; + * Generated from protobuf field int32 sample_rate_hertz = 5 [(.google.api.field_behavior) = OPTIONAL]; * @param int $var * @return $this */ @@ -288,15 +290,14 @@ public function setSampleRateHertz($var) } /** - * An identifier which selects 'audio effects' profiles that are applied on - * (post synthesized) text to speech. - * Effects are applied on top of each other in the order they are given. - * See - * [audio-profiles](https: - * //cloud.google.com/text-to-speech/docs/audio-profiles) - * for current supported profile ids. + * Optional. Input only. An identifier which selects 'audio effects' profiles + * that are applied on (post synthesized) text to speech. Effects are applied + * on top of each other in the order they are given. See + * [audio + * profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for + * current supported profile ids. * - * Generated from protobuf field repeated string effects_profile_id = 6; + * Generated from protobuf field repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @return \Google\Protobuf\Internal\RepeatedField */ public function getEffectsProfileId() @@ -305,15 +306,14 @@ public function getEffectsProfileId() } /** - * An identifier which selects 'audio effects' profiles that are applied on - * (post synthesized) text to speech. - * Effects are applied on top of each other in the order they are given. - * See - * [audio-profiles](https: - * //cloud.google.com/text-to-speech/docs/audio-profiles) - * for current supported profile ids. + * Optional. Input only. An identifier which selects 'audio effects' profiles + * that are applied on (post synthesized) text to speech. Effects are applied + * on top of each other in the order they are given. See + * [audio + * profiles](https://cloud.google.com/text-to-speech/docs/audio-profiles) for + * current supported profile ids. * - * Generated from protobuf field repeated string effects_profile_id = 6; + * Generated from protobuf field repeated string effects_profile_id = 6 [(.google.api.field_behavior) = INPUT_ONLY, (.google.api.field_behavior) = OPTIONAL]; * @param string[]|\Google\Protobuf\Internal\RepeatedField $var * @return $this */ diff --git a/TextToSpeech/src/V1/AudioEncoding.php b/TextToSpeech/src/V1/AudioEncoding.php index 558c59a880f8..a5f88f04bc36 100644 --- a/TextToSpeech/src/V1/AudioEncoding.php +++ b/TextToSpeech/src/V1/AudioEncoding.php @@ -28,7 +28,7 @@ class AudioEncoding */ const LINEAR16 = 1; /** - * MP3 audio. + * MP3 audio at 32kbps. * * Generated from protobuf enum MP3 = 2; */ diff --git a/TextToSpeech/src/V1/Gapic/TextToSpeechGapicClient.php b/TextToSpeech/src/V1/Gapic/TextToSpeechGapicClient.php index fd69e2877ad0..2ce9a5defa1a 100644 --- a/TextToSpeech/src/V1/Gapic/TextToSpeechGapicClient.php +++ b/TextToSpeech/src/V1/Gapic/TextToSpeechGapicClient.php @@ -186,7 +186,7 @@ public function __construct(array $options = []) * Optional. * * @type string $languageCode - * Optional (but recommended) + * 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 diff --git a/TextToSpeech/src/V1/ListVoicesRequest.php b/TextToSpeech/src/V1/ListVoicesRequest.php index 61b02292e9d2..b8712ae75114 100644 --- a/TextToSpeech/src/V1/ListVoicesRequest.php +++ b/TextToSpeech/src/V1/ListVoicesRequest.php @@ -16,7 +16,7 @@ class ListVoicesRequest extends \Google\Protobuf\Internal\Message { /** - * Optional (but recommended) + * 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 @@ -25,7 +25,7 @@ class ListVoicesRequest extends \Google\Protobuf\Internal\Message * will also get supported "cmn-*" voices; specifying "zh-hk" will also get * supported "yue-*" voices. * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = OPTIONAL]; */ private $language_code = ''; @@ -36,7 +36,7 @@ class ListVoicesRequest extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $language_code - * Optional (but recommended) + * 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 @@ -52,7 +52,7 @@ public function __construct($data = NULL) { } /** - * Optional (but recommended) + * 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 @@ -61,7 +61,7 @@ public function __construct($data = NULL) { * will also get supported "cmn-*" voices; specifying "zh-hk" will also get * supported "yue-*" voices. * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = OPTIONAL]; * @return string */ public function getLanguageCode() @@ -70,7 +70,7 @@ public function getLanguageCode() } /** - * Optional (but recommended) + * 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 @@ -79,7 +79,7 @@ public function getLanguageCode() * will also get supported "cmn-*" voices; specifying "zh-hk" will also get * supported "yue-*" voices. * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = OPTIONAL]; * @param string $var * @return $this */ diff --git a/TextToSpeech/src/V1/SynthesizeSpeechRequest.php b/TextToSpeech/src/V1/SynthesizeSpeechRequest.php index e11ccd8ca379..2e0423461ee7 100644 --- a/TextToSpeech/src/V1/SynthesizeSpeechRequest.php +++ b/TextToSpeech/src/V1/SynthesizeSpeechRequest.php @@ -18,19 +18,19 @@ class SynthesizeSpeechRequest extends \Google\Protobuf\Internal\Message /** * Required. The Synthesizer requires either plain text or SSML as input. * - * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1 [(.google.api.field_behavior) = REQUIRED]; */ private $input = null; /** * Required. The desired voice of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2; + * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2 [(.google.api.field_behavior) = REQUIRED]; */ private $voice = null; /** * Required. The configuration of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3 [(.google.api.field_behavior) = REQUIRED]; */ private $audio_config = null; @@ -56,7 +56,7 @@ public function __construct($data = NULL) { /** * Required. The Synthesizer requires either plain text or SSML as input. * - * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\TextToSpeech\V1\SynthesisInput */ public function getInput() @@ -67,7 +67,7 @@ public function getInput() /** * Required. The Synthesizer requires either plain text or SSML as input. * - * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1; + * Generated from protobuf field .google.cloud.texttospeech.v1.SynthesisInput input = 1 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\TextToSpeech\V1\SynthesisInput $var * @return $this */ @@ -82,7 +82,7 @@ public function setInput($var) /** * Required. The desired voice of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2; + * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\TextToSpeech\V1\VoiceSelectionParams */ public function getVoice() @@ -93,7 +93,7 @@ public function getVoice() /** * Required. The desired voice of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2; + * Generated from protobuf field .google.cloud.texttospeech.v1.VoiceSelectionParams voice = 2 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\TextToSpeech\V1\VoiceSelectionParams $var * @return $this */ @@ -108,7 +108,7 @@ public function setVoice($var) /** * Required. The configuration of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3 [(.google.api.field_behavior) = REQUIRED]; * @return \Google\Cloud\TextToSpeech\V1\AudioConfig */ public function getAudioConfig() @@ -119,7 +119,7 @@ public function getAudioConfig() /** * Required. The configuration of the synthesized audio. * - * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3; + * Generated from protobuf field .google.cloud.texttospeech.v1.AudioConfig audio_config = 3 [(.google.api.field_behavior) = REQUIRED]; * @param \Google\Cloud\TextToSpeech\V1\AudioConfig $var * @return $this */ diff --git a/TextToSpeech/src/V1/SynthesizeSpeechResponse.php b/TextToSpeech/src/V1/SynthesizeSpeechResponse.php index 25334e0ae566..b53a96aa3a18 100644 --- a/TextToSpeech/src/V1/SynthesizeSpeechResponse.php +++ b/TextToSpeech/src/V1/SynthesizeSpeechResponse.php @@ -17,7 +17,8 @@ class SynthesizeSpeechResponse extends \Google\Protobuf\Internal\Message { /** * The audio data bytes encoded as specified in the request, including the - * header (For LINEAR16 audio, we include the WAV header). Note: as + * header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS). + * For LINEAR16 audio, we include the WAV header. Note: as * with all bytes fields, protobuffers use a pure binary representation, * whereas JSON representations use base64. * @@ -33,7 +34,8 @@ class SynthesizeSpeechResponse extends \Google\Protobuf\Internal\Message * * @type string $audio_content * The audio data bytes encoded as specified in the request, including the - * header (For LINEAR16 audio, we include the WAV header). Note: as + * header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS). + * For LINEAR16 audio, we include the WAV header. Note: as * with all bytes fields, protobuffers use a pure binary representation, * whereas JSON representations use base64. * } @@ -45,7 +47,8 @@ public function __construct($data = NULL) { /** * The audio data bytes encoded as specified in the request, including the - * header (For LINEAR16 audio, we include the WAV header). Note: as + * header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS). + * For LINEAR16 audio, we include the WAV header. Note: as * with all bytes fields, protobuffers use a pure binary representation, * whereas JSON representations use base64. * @@ -59,7 +62,8 @@ public function getAudioContent() /** * The audio data bytes encoded as specified in the request, including the - * header (For LINEAR16 audio, we include the WAV header). Note: as + * header for encodings that are wrapped in containers (e.g. MP3, OGG_OPUS). + * For LINEAR16 audio, we include the WAV header. Note: as * with all bytes fields, protobuffers use a pure binary representation, * whereas JSON representations use base64. * diff --git a/TextToSpeech/src/V1/VoiceSelectionParams.php b/TextToSpeech/src/V1/VoiceSelectionParams.php index 616490a8ec72..5617ba74fbef 100644 --- a/TextToSpeech/src/V1/VoiceSelectionParams.php +++ b/TextToSpeech/src/V1/VoiceSelectionParams.php @@ -16,9 +16,9 @@ class VoiceSelectionParams extends \Google\Protobuf\Internal\Message { /** - * The language (and optionally also the region) of the voice expressed as a + * Required. The language (and potentially also the region) of the voice expressed as a * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. - * "en-US". Required. This should not include a script tag (e.g. use + * "en-US". This should not include a script tag (e.g. use * "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred * from the input provided in the SynthesisInput. The TTS service * will use this parameter to help choose an appropriate voice. Note that @@ -28,18 +28,18 @@ class VoiceSelectionParams extends \Google\Protobuf\Internal\Message * available), or even a different language, e.g. using "nb" (Norwegian * Bokmal) instead of "no" (Norwegian)". * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = REQUIRED]; */ private $language_code = ''; /** - * The name of the voice. Optional; if not set, the service will choose a + * The name of the voice. If not set, the service will choose a * voice based on the other parameters such as language_code and gender. * * Generated from protobuf field string name = 2; */ private $name = ''; /** - * The preferred gender of the voice. Optional; if not set, the service will + * The preferred gender of the voice. If not set, the service will * choose a voice based on the other parameters such as language_code and * name. Note that this is only a preference, not requirement; if a * voice of the appropriate gender is not available, the synthesizer should @@ -56,9 +56,9 @@ class VoiceSelectionParams extends \Google\Protobuf\Internal\Message * Optional. Data for populating the Message object. * * @type string $language_code - * The language (and optionally also the region) of the voice expressed as a + * Required. The language (and potentially also the region) of the voice expressed as a * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. - * "en-US". Required. This should not include a script tag (e.g. use + * "en-US". This should not include a script tag (e.g. use * "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred * from the input provided in the SynthesisInput. The TTS service * will use this parameter to help choose an appropriate voice. Note that @@ -68,10 +68,10 @@ class VoiceSelectionParams extends \Google\Protobuf\Internal\Message * available), or even a different language, e.g. using "nb" (Norwegian * Bokmal) instead of "no" (Norwegian)". * @type string $name - * The name of the voice. Optional; if not set, the service will choose a + * The name of the voice. If not set, the service will choose a * voice based on the other parameters such as language_code and gender. * @type int $ssml_gender - * The preferred gender of the voice. Optional; if not set, the service will + * The preferred gender of the voice. If not set, the service will * choose a voice based on the other parameters such as language_code and * name. Note that this is only a preference, not requirement; if a * voice of the appropriate gender is not available, the synthesizer should @@ -84,9 +84,9 @@ public function __construct($data = NULL) { } /** - * The language (and optionally also the region) of the voice expressed as a + * Required. The language (and potentially also the region) of the voice expressed as a * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. - * "en-US". Required. This should not include a script tag (e.g. use + * "en-US". This should not include a script tag (e.g. use * "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred * from the input provided in the SynthesisInput. The TTS service * will use this parameter to help choose an appropriate voice. Note that @@ -96,7 +96,7 @@ public function __construct($data = NULL) { * available), or even a different language, e.g. using "nb" (Norwegian * Bokmal) instead of "no" (Norwegian)". * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = REQUIRED]; * @return string */ public function getLanguageCode() @@ -105,9 +105,9 @@ public function getLanguageCode() } /** - * The language (and optionally also the region) of the voice expressed as a + * Required. The language (and potentially also the region) of the voice expressed as a * [BCP-47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt) language tag, e.g. - * "en-US". Required. This should not include a script tag (e.g. use + * "en-US". This should not include a script tag (e.g. use * "cmn-cn" rather than "cmn-Hant-cn"), because the script will be inferred * from the input provided in the SynthesisInput. The TTS service * will use this parameter to help choose an appropriate voice. Note that @@ -117,7 +117,7 @@ public function getLanguageCode() * available), or even a different language, e.g. using "nb" (Norwegian * Bokmal) instead of "no" (Norwegian)". * - * Generated from protobuf field string language_code = 1; + * Generated from protobuf field string language_code = 1 [(.google.api.field_behavior) = REQUIRED]; * @param string $var * @return $this */ @@ -130,7 +130,7 @@ public function setLanguageCode($var) } /** - * The name of the voice. Optional; if not set, the service will choose a + * The name of the voice. If not set, the service will choose a * voice based on the other parameters such as language_code and gender. * * Generated from protobuf field string name = 2; @@ -142,7 +142,7 @@ public function getName() } /** - * The name of the voice. Optional; if not set, the service will choose a + * The name of the voice. If not set, the service will choose a * voice based on the other parameters such as language_code and gender. * * Generated from protobuf field string name = 2; @@ -158,7 +158,7 @@ public function setName($var) } /** - * The preferred gender of the voice. Optional; if not set, the service will + * The preferred gender of the voice. If not set, the service will * choose a voice based on the other parameters such as language_code and * name. Note that this is only a preference, not requirement; if a * voice of the appropriate gender is not available, the synthesizer should @@ -173,7 +173,7 @@ public function getSsmlGender() } /** - * The preferred gender of the voice. Optional; if not set, the service will + * The preferred gender of the voice. If not set, the service will * choose a voice based on the other parameters such as language_code and * name. Note that this is only a preference, not requirement; if a * voice of the appropriate gender is not available, the synthesizer should diff --git a/TextToSpeech/src/V1/resources/text_to_speech_client_config.json b/TextToSpeech/src/V1/resources/text_to_speech_client_config.json index 330c9e4866d1..499d40ce6b37 100644 --- a/TextToSpeech/src/V1/resources/text_to_speech_client_config.json +++ b/TextToSpeech/src/V1/resources/text_to_speech_client_config.json @@ -21,13 +21,13 @@ }, "methods": { "ListVoices": { - "timeout_millis": 30000, + "timeout_millis": 60000, "retry_codes_name": "idempotent", "retry_params_name": "default" }, "SynthesizeSpeech": { "timeout_millis": 60000, - "retry_codes_name": "idempotent", + "retry_codes_name": "non_idempotent", "retry_params_name": "default" } } diff --git a/TextToSpeech/synth.metadata b/TextToSpeech/synth.metadata index b1cc2c523253..d15943e070ef 100644 --- a/TextToSpeech/synth.metadata +++ b/TextToSpeech/synth.metadata @@ -1,19 +1,18 @@ { - "updateTime": "2019-08-07T18:05:59.134499Z", + "updateTime": "2019-09-10T10:04:05.654913Z", "sources": [ { "generator": { "name": "artman", - "version": "0.29.1", - "dockerImage": "googleapis/artman@sha256:b2a73f4dda03ef8fcaa973e3ba26d0cf34091f6c22c70add663af325931aef4d" + "version": "0.36.2", + "dockerImage": "googleapis/artman@sha256:0e6f3a668cd68afc768ecbe08817cf6e56a0e64fcbdb1c58c3b97492d12418a1" } }, { "git": { "name": "googleapis", "remote": "https://github.com/googleapis/googleapis.git", - "sha": "3a1b46a6668194a527e532a2c355b404c79b0e6a", - "internalRef": "262167956" + "sha": "26e189ad03ba63591fb26eecb6aaade7ad39f57a" } } ],