Skip to content

Latest commit

 

History

History
63 lines (47 loc) · 3.42 KB

README.md

File metadata and controls

63 lines (47 loc) · 3.42 KB
Raw

Running PollyDemo Sample

This sample demonstrates how to use Amazon Polly client library on Android. This application uses AWS Cognito for authentication with Amazon Polly.

Requirements

  • AndroidStudio
  • Android API 10 or greater

Using the Sample

  1. Import the PollyDemo project into Android Studio.

    • From the Welcome screen, click on "Import project".
    • Browse to the PollyDemo directory and press OK.
    • Accept the messages about adding Gradle to the project.
    • If the SDK reports some missing Android SDK packages (like Build Tools or the Android API package), follow the instructions to install them.

  2. Import the libraries :

    • Gradle will take care of downloading these dependencies for you.

  3. This sample requires Cognito to authorize to Amazon Polly in order to access device shadows. Use Amazon Cognito to create a new identity pool:

    1. In the Amazon Cognito Console, select Create Identity Pool.

    2. Ensure Enable access to unauthenticated identities is checked. This allows the sample application to assume the unauthenticated role associated with this identity pool.

      Important: see note below on unauthenticated user access.

    3. Obtain the PoolID constant. This will be used in the application.

    4. As part of creating the identity pool Cognito will setup two roles in Identity and Access Management (IAM). These will be named something similar to: Cognito_PoolNameAuth_Role and Cognito_PoolNameUnauth_Role.

    5. Now we will attach a policy to the unauthenticated role which has permissions to access the required Amazon Polly API. This is done by first creating an IAM Policy in the IAM Console and then attaching it to the unauthenticated role. Below is an example policy which can be used with the sample application. This policy allows the application to perform all operations on the Amazon Polly service.

      {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "polly:*"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

      More information on AWS IAM roles and policies can be found here. More information on Amazon Polly policies can be found here.

      Note: to keep this example simple it makes use of unauthenticated users in the identity pool. This can be used for getting started and prototypes but unauthenticated users should typically only be given read-only permissions in production applications. More information on Cognito identity pools including the Cognito developer guide can be found here.

  4. Open the PollyDemo project.

  5. Open MainActivity.java and update the following constants with the appropriate values:

    COGNITO_POOL_ID = "CHANGE_ME";
MY_REGION = Regions.US_EAST_1;

  6. Build and run the sample app.

  7. Select Amazon Polly voice, enter any text you want to read (or leave the text field blank to use the provided sample text) and press the "Play" button.