Preparing for Internationalization

The Alexa Voice Service (AVS) is now available for developers in the UK and Germany. In the following sections, we’ll review the actions you must take to prepare for internationalization.

What’s New?

  • LWA Mobile SDK: The Login with Amazon (LWA) Mobile SDKs for Android and iOS were updated in November 2016. If you are using a companion app or authorizing directly from a product, you’ll need to integrate the latest version of the LWA Mobile SDK to support AVS’ international features.
  • EU Endpoint: A new AVS endpoint for Europe is available that provides customers in the UK and Germany with access to their personal data and country specific content.
  • SetEndpoint Directive: The SetEndpoint directive instructs your client to switch endpoints if a user’s settings are not supported on the endpoint your product is connected to.
  • Settings Interface: The new SettingsUpdated event allows a client to adjust Alexa settings, such as locale, using on-product controls or a companion app.
  • AVS Java Sample App: The AVS Java Sample App now support the SetEndpoint directive and the Settings interface. Additionally, a locale toggle has been added to the client interface to allow testing in US English, UK English, and German.

Migration Steps

Perform the following tasks to prepare your product for internationalization:

  1. If your product’s security profile was created before Q3 2016, an update is required to validate it for use with the AVS EU endpoint. Click here for step-by-step instructions.

    If your security profile was created in or after Q3 2016 skip to the next step.

  2. Integrate the latest version of the LWA Mobile SDK for Android or iOS. Our guides have been updated and provide instructions to get you started:

  3. Update your client code to support the SetEndpoint directive.

    The SetEndpoint directive instructs a client to change endpoints when the following conditions are met:

    • A user’s country settings are not supported by the endpoint they have connected to. For example, if a user’s current country is set to the United Kingdom (UK) in Manage Your Content and Devices and the client connects to the United States (US) endpoint, a SetEndpoint directive will be sent instructing the client to connect to the endpoint that supports the UK.
    • A user changes their country settings (or address). For example, if a user connected to the US endpoint changes their current country from the US to the UK, a SetEndpoint directive will be sent instructing the client to connect to the endpoint that supports the UK.

    See Sample Code »
    Read the Docs »

  4. Update your client code to support the Settings interface.

    The Settings interface is used to manage Alexa settings on your product, such as locale (US, UK, DE). This is required to support language switching on AVS products.

    See Sample Code »
    Read the Docs »

How To Update Your Security Profile

If your security profile was created before Q3 2016, follow these instructions to update it for use with the AVS EU endpoint.

  1. Login to the Amazon Developer Console.
  2. Navigate to the AVS Dashboard. Locate your product that requires access to the AVS EU endpoint, and click Edit.
  3. From the left navigation, select Security Profile.
  4. Make sure the security profile you would like to validate for use with the AVS EU endpoint is selected, then click Edit.
  5. Append International to your Security Profile Description and click Save.
  6. Allow up to 5 minutes for the update to propagate. Now your security profile is valid for use with the AVS EU endpoint.

Frequently Asked Questions

Q: Will I need to update my code each time a new endpoint is made available?
No, we expect this to be a one-time change. After you’ve updated your client code to handle the SetEndpoint directive your client will be prepared to support additional endpoints that may be added in the future.
Q: Are languages restricted by endpoint?
No. US English, UK English, and German are available on both US and EU AVS endpoints.

Resources