Cloud Text-to-Speech API C++ Client Library
An idiomatic C++ client library for the Cloud Text-to-Speech API, a service to synthesize natural-sounding speech by applying powerful neural network models.
While this library is GA, please note Google Cloud C++ client libraries do not follow Semantic Versioning.
Quickstart
The following shows the code that you'll run in the google/cloud/texttospeech/quickstart/
directory, which should give you a taste of the Cloud Text-to-Speech API C++ client library API.
#include "google/cloud/texttospeech/v1/text_to_speech_client.h" #include <iostream> auto constexpr kText = R"""( Four score and seven years ago our fathers brought forth on this continent, a new nation, conceived in Liberty, and dedicated to the proposition that all men are created equal.)"""; int main(int argc, char* argv[]) try { if (argc != 1) { std::cerr << "Usage: " << argv[0] << "\n"; return 1; } namespace texttospeech = ::google::cloud::texttospeech_v1; auto client = texttospeech::TextToSpeechClient( texttospeech::MakeTextToSpeechConnection()); google::cloud::texttospeech::v1::SynthesisInput input; input.set_text(kText); google::cloud::texttospeech::v1::VoiceSelectionParams voice; voice.set_language_code("en-US"); google::cloud::texttospeech::v1::AudioConfig audio; audio.set_audio_encoding(google::cloud::texttospeech::v1::LINEAR16); auto response = client.SynthesizeSpeech(input, voice, audio); if (!response) throw std::move(response).status(); // Normally one would play the results (response->audio_content()) over some // audio device. For this quickstart, we just print some information. auto constexpr kWavHeaderSize = 48; auto constexpr kBytesPerSample = 2; // we asked for LINEAR16 auto const sample_count = (response->audio_content().size() - kWavHeaderSize) / kBytesPerSample; std::cout << "The audio has " << sample_count << " samples\n"; return 0; } catch (google::cloud::Status const& status) { std::cerr << "google::cloud::Status thrown: " << status << "\n"; return 1; }
Main classes
The main class in this library is texttospeech_v1::TextToSpeechClient
. All RPCs are exposed as member functions of this class. Other classes provide helpers, configuration parameters, and infrastructure to mock texttospeech_v1::TextToSpeechClient
when testing your application.
More Information
- Error Handling - describes how the library reports errors.
- How to Override the Default Endpoint - describes how to override the default endpoint.
- How to Override the Authentication Credentials - describes how to change the authentication credentials used by the library.
- Override Retry, Backoff, and Idempotency Policies - describes how to change the default retry policies.
- Environment Variables - describes environment variables that can configure the behavior of the library.