A client for AWS Polly < http://aws.amazon.com/documentation/polly>, a speech synthesis service.
aws.polly is a package for Polly, an Amazon Web Services speech synthesis (computer voice) web service.
To use the package, you will need an AWS account and enter your credentials into R. Your keypair can be generated on the IAM Management Console under the heading Access Keys. Note that you only have access to your secret key once. After it is generated, you need to save it in a secure location. New keypairs can be generated at any time if yours has been lost, stolen, or forgotten.
By default, all cloudyr packages look for the access key ID and secret access key in environment variables. You can also use this to specify a default region or a temporary "session token". For example:
Sys.setenv("AWS_ACCESS_KEY_ID" = "mykey","AWS_SECRET_ACCESS_KEY" = "mysecretkey","AWS_DEFAULT_REGION" = "us-east-1","AWS_SESSION_TOKEN" = "mytoken")
These can alternatively be set on the command line prior to starting R or via an
.Renviron file, which are used to set environment variables in R during startup (see
If you work with multiple AWS accounts, another option that is consistent with other Amazon SDKs is to create a centralized
~/.aws/credentials file, containing credentials for multiple accounts. You can then use credentials from this file on-the-fly by simply doing:
# use your 'default' account credentialsuse_credentials()# use an alternative credentials profileuse_credentials(profile = "bob")
Temporary session tokens are stored in environment variable
AWS_SESSION_TOKEN (and will be stored there by the
use_credentials() function). The aws.iam package provides an R interface to IAM roles and the generation of temporary session tokens via the security token service (STS).
The basic use of the package is super simple and revolves around the
synthesize() function, which takes a character string and a voice as input:
library("aws.polly")# list available voiceslist_voices()
## Gender Id LanguageCode LanguageName Name ## 1 Female Joanna en-US US English Joanna ## 2 Female Salli en-US US English Salli ## 3 Female Kimberly en-US US English Kimberly ## 4 Female Kendra en-US US English Kendra ## 5 Male Justin en-US US English Justin ## 6 Male Joey en-US US English Joey ## 7 Female Ivy en-US US English Ivy
# synthesize some textvec <- synthesize("Hello world!", voice = "Joanna")
The result is a "Wave" object (from the tuneR package), which can be played using
This might also be handy for setting up an audio error handler:
audio_error <- function() tuneR::play(aws.polly::synthesize(geterrmessage(), voice = "Joanna"))options(error = audio_error)stop("Everything went horribly wrong")options(error = NULL)
This package is not yet on CRAN. To install the latest development version you can install from the cloudyr drat repository:
# latest stable versioninstall.packages("aws.polly", repos = c(getOption("repos"), ""))
Or, to pull a potentially unstable version directly from GitHub:
get_synthesis()functions. The former as a convenience function wrapping the latter lower-level function.