v1.12.1 released 04/02/2019:

Bug Fixes

Fixed a bug where the same URL was being requested twice when streaming iHeartRadio. Now, a single request is sent.
Corrected pause/resume handling in ProgressTimer so that extra ProgressReportDelayElapsed events are not sent to AVS.

Known Issues

Music playback history isn't being displayed in the Alexa app for certain account and device types.
On GCC 8+, issues related to -Wclass-memaccess will trigger warnings. However, this won't cause the build to fail and these warnings can be ignored.
Android error ("libDefaultClient.so" not found) can be resolved by upgrading to ADB version 1.0.40
When network connection is lost, lost connection status is not returned via local TTS.
ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
make integration is currently not available for Android. In order to run integration tests on Android, you'll need to manually upload the test binary file along with any input file. At that point, the adb can be used to run the integration tests.
On Raspberry Pi running Android Things with HDMI output audio, beginning of speech is truncated when Alexa responds to user text-to-speech (TTS).
When the sample app is restarted and the network connection is lost, the Reminder TTS message does not play. Instead, the default alarm tone will play twice.

v1.12.0 released 02/25/2019:

Enhancements

Support was added for the fr_CA locale.
The Executor has been optimized to run a single thread when there are active job in the queue, and to remain idle when there are not active jobs.
An additional parameter of alertType has been added to the Alerts capability agent. This will allow observers of alerts to know the type of alert being delivered.
Support for programmatic unload and load of PulseAudio Bluetooth modules was added. To enable this feature, there is a new CMake option: BLUETOOTH_BLUEZ_PULSEAUDIO_OVERRIDE_ENDPOINTS. Note that libpulse-dev is a required dependency of this feature.
An observer interface was added for when an active Bluetooth device connects and disconnects.
The BluetoothDeviceManagerInterface instantiation was moved from DefaultClient to SampleApp to allow applications to override it.
The MediaPlayerInterface now supports repeating playback of URL sources.
The Kitt.AI wake word engine (WWE) is now compatible with GCC5+.

Bug Fixes

Issue 953 - The MediaPlayerInterface requirement that callbacks not be made upon a callers thread has been removed.
Issue 1136 - Added a missing default virtual destructor.
Issue 1140 - Fixed an issue where DND states were not synchronized to the AVS cloud after device reset.
Issue 1143 - Fixed an issue in which the SpeechSynthesizer couldn't enter a sleeping state.
Issue 1183 - Fixed an issue where alarm is not sounding for certain timezones
Changing an alert's volume from the Alexa app now works when an alert is playing.
Added missing shutdown handling for ContentDecrypter to prevent the Stop command from triggering a crash when SAMPLE-AES encrypted content was streaming.
Fixed a bug where if the Notifications database is empty, due to a crash or corruption, the SDK initialization process enters an infinite loop when it retries to get context from the Notifications capability agent.
Fixed a race condition that caused AlertsRenderer observers to miss notification that an alert has been completed.
Fixed logging for adding/removing BluetoothDeviceObserver in the DefaultClient.

Known Issues

PlaylistParser and IterativePlaylistParser generate two HTTP requests (one to fetch the content type, and one to fetch the audio data) for each audio stream played.
Music playback history isn't being displayed in the Alexa app for certain account and device types.
On GCC 8+, issues related to -Wclass-memaccess will trigger warnings. However, this won't cause the build to fail and these warnings can be ignored.
Android error ("libDefaultClient.so" not found) can be resolved by upgrading to ADB version 1.0.40
When network connection is lost, lost connection status is not returned via local TTS.
ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
make integration is currently not available for Android. In order to run integration tests on Android, you'll need to manually upload the test binary file along with any input file. At that point, the adb can be used to run the integration tests.
On Raspberry Pi running Android Things with HDMI output audio, beginning of speech is truncated when Alexa responds to user text-to-speech (TTS).
When the sample app is restarted and the network connection is lost, the Reminder TTS message does not play. Instead, the default alarm tone will play twice.

v1.11.0 released 12/19/2018:

Enhancements

Added support for the new Alexa DoNotDisturb interface, which enables users to toggle the do not disturb (DND) function on their Alexa built-in products.
The SDK now supports Opus encoding, which is optional. To enable Opus, you must set the CMake flag to -DOPUS=ON, and include the libopus library dependency in your build.
The MediaPlayer reference implementation has been expanded to support the SAMPLE-AES and AES-128 encryption methods for HLS streaming.
- AES-128 encryption is dependent on libcrypto, which is part of the required openSSL library, and is enabled by default.
- To enable SAMPLE-AES encryption, you must set the -DSAMPLE_AES=ON in your CMake command, and include the FFMPEG library dependency in your build.
A new configuration for deviceSettings has been added.This configuration allows you to specify the location of the device settings database.
Added locale support for es-MX.

Bug Fixes

Fixed an issue where music wouldn't resume playback in the Android app.
Now all equalizer capabilities are fully disabled when equalizer is turned off in configuration file. Previously, devices were unconditionally required to provide support for equalizer in order to run the SDK.
Issue 1106 - Fixed an issue in which the CBLAuthDelegate wasn't using the correct timeout during request refresh.
Issue 1128 - Fixed an issue in which the AudioPlayer instance persisted at shutdown, due to a shared dependency with the ProgressTimer.
Fixed in issue that occurred when a connection to streaming content was interrupted, the SDK did not attempt to resume the connection, and appeared to assume that the content had been fully downloaded. This triggered the next track to be played, assuming it was a playlist.
Issue 1040 - Fixed an issue where alarms would continue to play after user barge-in.

Known Issues

PlaylistParser and IterativePlaylistParser generate two HTTP requests (one to fetch the content type, and one to fetch the audio data) for each audio stream played.
Music playback history isn't being displayed in the Alexa app for certain account and device types.
On GCC 8+, issues related to -Wclass-memaccess will trigger warnings. However, this won't cause the build to fail, and these warnings can be ignored.
In order to use Bluetooth source and sink PulseAudio, you must manually load and unload PulseAudio modules after the SDK starts.
The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
make integration is currently not available for Android. In order to run integration tests on Android, you'll need to manually upload the test binary file along with any input file. At that point, the adb can be used to run the integration tests.
On Raspberry Pi running Android Things with HDMI output audio, beginning of speech is truncated when Alexa responds to user TTS.
When the sample app is restarted and network connection is lost, alerts don't play.
When network connection is lost, lost connection status is not returned via local Text-to Speech (TTS).

v1.10.0 released 10/24/2018:

Enhancements

New optional configuration for EqualizerController. The EqualizerController interface allows you to adjust equalizer settings on your product, such as decibel (dB) levels and modes.
Added reference implementation of the EqualizerController for GStreamer-based (MacOS, Linux, and Raspberry Pi) and OpenSL ES-based (Android) MediaPlayers. Note: In order to use with Android, it must support OpenSL ES.
New optional configuration for the TemplateRuntime display card value.
A configuration file generator script, genConfig.sh is now included with the SDK in the tools/Install directory. genConfig.sh and it's associated arguments populate AlexaClientSDKConfig.json with the data required to authorize with LWA.
Added Bluetooth A2DP source and AVRCP target support for Linux.
Added Alexa for Business (A4B) support, which includes support for handling the new RevokeAuthorization directive in the Settings interface. A new CMake option has been added to enable A4B within the SDK, -DA4B.
Added locale support for IT and ES.
The Alexa Communication Library (ACL), CBLAUthDelegate, and sample app have been enhanced to detect de-authorization using the new z command.
Added ExternalMediaPlayerObserver, which receives notification of player state, track, and username changes.
HTTP2ConnectionInterface was factored out of HTTP2Transport to enable unit testing of HTTP2Transport and re-use of HTTP2Connection logic.

Bug Fixes

Fixed a bug in which ExternalMediaPlayer adapter playback wasn't being recognized by AVS.
Issue 973 - Fixed issues related to AudioPlayer where progress reports were being sent out of order or with incorrect offsets.
An EXPECTING, state has been added to DialogUXState in order to handle EXPECT_SPEECH state for hold-to-talk devices.
Issue 948 - Fixed a bug in which the sample app was stuck in a listening state.
Fixed a bug where there was a delay between receiving a DeleteAlert directive, and deleting the alert.
Issue 839 - Fixed an issue where speech was being truncated due to the DialogUXStateAggregator transitioning between a THINKING and IDLE state.
Fixed a bug in which the AudioPlayer attempted to play when it wasn't in the FOREGROUND focus.
CapabilitiesDelegateTest now works on Android.
Issue 950 - Improved Android Media Player audio quality.
Issue 908 - Fixed compile error on g++ 7.x in which includes were missing.

Known Issues

On GCC 8+, issues related to -Wclass-memaccess will trigger warnings. However, this won't cause the build to fail, and these warnings can be ignored.
In order to use Bluetooth source and sink PulseAudio, you must manually load and unload PulseAudio modules after the SDK starts.
When connecting a new device to AVS, currently connected devices must be manually disconnected. For example, if a user says "Alexa, connect my phone", and an Alexa Built-in speaker is already connected, there is no indication to the user a device is already connected.
The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
make integration is currently not available for Android. In order to run integration tests on Android, you'll need to manually upload the test binary file along with any input file. At that point, the adb can be used to run the integration tests.
On Raspberry Pi running Android Things with HDMI output audio, beginning of speech is truncated when Alexa responds to user TTS.
When the sample app is restarted and network connection is lost, Alerts don't play.
When network connection is lost, lost connection status is not returned via local TTS.

v1.9.0 released 08/28/2018:

Enhancements

Added Android SDK support, which includes new implementations of the MediaPlayer, audio recorder, and logger.
Added the InteractionModel interface, which enables Alexa Routines.
Optional configuration changes have been introduced. Now a network interface can be specified to connect to the SDK via curl.
Cmake parameters can be configured to support Android.
Added GUI 1.1 support. The PlaybackController has been extended to support new control functionality, and the System interface has been updated to support SoftwareInfo.

Bug Fixes

Installation script execution time has been reduced. Now a single branch clone is used, such as the master branch.
Issue 846 - Fixed a bug where audio stuttered on slow network connections.
Removed the SpeakerManager constructor check for non-zero speakers.
Issue 891 - Resolved incorrect offset in the PlaybackFinished event.
Issue 727 - Fixed an issue where the sample app behaved erratically upon network disconnection/reconnection.
Issue 910 - Fixed a GCC 8+ compilation issue. Note: issues related to -Wclass-memaccess will still trigger warnings, but won't fail compilation.
Issue 871 Issue 880 - Fixed compiler warnings.
Fixed an issue where PlaybackStutterStarted and PlaybackStutterFinished events were not being sent due to a missing Gstreamer queue element.
Fixed a bug where the CapabilitiesDelegate database was not being cleared upon logout.
Fixed in issue that caused the following compiler warning “class has virtual functions but non-virtual destructor”.
Fixed a bug where BlueZDeviceManager was not properly destroyed.
Fixed a bug that occurred when the initializer list was converted to std::unordered_set.
Fixed a build error that occurred when building with BUILD_TESTING=Off.

Known Issues

If a device is not connected to the Internet at the time that an alarm or reminder is scheduled to sound, the SDK will not play any sound for the alarm or reminder at that scheduled time.
The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa companion app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
On Raspberry Pi, when streaming audio via Bluetooth, sometimes the audio stream stutters.
These CapabilitiesDelegateTest tests have been temporarily disabled to prevent build errors for the Android build: CapabilitiesDelegateTest.withCapabilitiesHappyCase, CapabilitiesDelegateTest.republish, CapabilitiesDelegateTest.testClearData.
make integration is currently not available for Android. In order to run integration tests on Android, you'll need to manually upload the test binary file along with any input file. At that point, the adb can be used to run the integration tests.
On Raspberry Pi running Android Things with HDMI output audio, beginning of speech is truncated when Alexa responds to user TTS.
When the sample app is restarted and network connection is lost, Alerts don't play.
When network connection is lost, lost connection status is not returned via local TTS.

v1.8.1 released 07/09/2018:

Enhancements

Added support for adjustment of alert volume.
Added support for deletion of multiple alerts.
The following SpeakerInterface::Type enumeration values have changed:
- AVS_SYNCED is now AVS_SPEAKER_VOLUME.
- LOCAL is now AVS_ALERTS_VOLUME.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa companion app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
On Raspberry Pi, when streaming audio via Bluetooth, sometimes the audio stream stutters.

v1.8.0 released 06/27/2018:

Enhancements

Added local stop functionality. This allows a user to stop an active function, such as an alert or timer, by uttering "Alexa, stop" when an Alexa-enabled product is offline.
Alerts in the background now stream in 10 sec intervals, rather than continuously.
Added support for France to the sample app.
Updated the ACL MIME type for sending JSON to AVS from "text/json" to "application/json".
friendlyName can now be updated for BlueZ implementations of BlueZBluetoothDevice and BlueZHostController.

Bug Fixes

Fixed an issue where the Bluetooth agent didn't clear user data upon reset, including paired devices and the uuidMapping table.
Fixed MediaPlayer threading issues. Now each instance has it's own glib main loop thread, rather than utilizing the default main context worker thread.
Fixed segmentation fault issues that occurred when certain static initializers needed to be initialized in a certain order, but the order wasn't defined.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When a source device is streaming silence via Bluetooth, the Alexa companion app indicates that audio content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
On Raspberry Pi, when streaming audio via Bluetooth, sometimes the audio stream stutters.
On Raspberry Pi, BlueALSA must be terminated each time the device boots. See Raspberry Pi Quick Start Guide for more information.

v1.7.1 released 05/04/2018:

Enhancements

Added the Bluetooth interface, which manages the Bluetooth connection between Alexa-enabled products and peer devices. This release supports A2DP-SINK and AVRCP profiles. Note: Bluetooth is optional and is currently limited to Raspberry Pi and Linux platforms.
Added new Bluetooth dependencies for Linux and Raspberry Pi.
Device Capability Framework (DCF) renamed to Capabilities.
Updated the non-CBL client ID error message to be more specific.
Updated the sample app to enter a limited interaction mode after an unrecoverable error.

Bug Fixes

Issue 597 - Fixed a bug where the sample app did not respond to locale change settings.
Fixed issue where GStreamer 1.14 MediaPlayerTest failed on Windows.
Fixed an issue where a segmentation fault was triggered after unrecoverable error handling.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
The Alexa app doesn't always indicate when a device is successfully connected via Bluetooth.
Connecting a product to streaming media via Bluetooth will sometimes stop media playback within the source application. Resuming playback through the source application or toggling next/previous will correct playback.
When streaming silence via Bluetooth, the Alexa companion app will sometimes indicate that media content is streaming.
The Bluetooth agent assumes that the Bluetooth adapter is always connected to a power source. Disconnecting from a power source during operation is not yet supported.
On some products, interrupted Bluetooth playback may not resume if other content is locally streamed.
When streaming content via Bluetooth, under certain conditions playback will fail to resume and the sample app hangs on exit. This is due to a conflict between the GStreamer pipeline and the Bluetooth agent.
On Raspberry Pi, when streaming audio via Bluetooth, sometimes the audio stream stutters.
On Raspberry Pi, BlueALSA must be terminated each time the device boots. See Raspberry Pi Quick Start Guide for more information.

v1.7.0 released 04/18/2018:

Enhancements

AuthDelegate and AuthServer.py have been replaced by CBLAUthDelegate, which uses Code Based Linking for authorization.
Added new properties to AlexaClientSDKConfig:
- cblAuthDelegate - This object specifies parameters for CBLAuthDelegate.
- miscDatabase - A generic key/value database to be used by various components.
- dcfDelegate - This object specifies parameters for DCFDelegate. Within this object, values were added for endpoint and overridenDcfPublishMessageBody. endpoint is the endpoint for the Capabilities API. overridenDcfPublishMessageBodyis the message that is sent to the Capabilities API. Note: Values in the dcfDelegate object will only work in DEBUG builds.
- deviceInfo - Specifies device-identifying information for use by the Capabilities API and CBLAuthDelegate.
Updated Directive Sequencer to support wildcard directive handlers. This allows a handler for a given AVS interface to register at the namespace level, rather than specifying the names of all directives within a given namespace.
Updated the Raspberry Pi installation script to include alsasink in AlexaClientSDKConfig.
Added audioSink as a configuration option. This allows users to override the audio sink element used in Gstreamer.
Added an interface for monitoring internet connection status: InternetConnectionMonitorInterface.h.
The Alexa Communications Library (ACL) is no longer required to wait until authorization has succeeded before attempting to connect to AVS. Instead, HTTP2Transport handles waiting for authorization to complete.
Device capabilities can now be sent for each capability interface using the Capabilities API.
The sample app has been updated to send Capabilities API messages, which are automatically sent when the sample app starts. Note: A successful call to the Capabilities API must occur before a connection with AVS is established.
The SDK now supports HTTP PUT messages.
Added support for opt-arg style arguments and multiple configuration files. Now, the sample app can be invoked by either of these commands: SampleApp <configfile> <debuglevel> OR SampleApp -C file1 -C file2 ... -L loglevel.

Bug Fixes

Fixed Issues 447 and 553.
Fixed the AttachmentRenderSource's handling of BLOCKING AttachmentReaders.
Updated the Logger implementation to be more resilient to nullptr string inputs.
Fixed a TimeUtils utility-related compile issue.
Fixed a bug in which alerts failed to activate if the system was restarted without network connection.
Fixed Android 64-bit build failure issue.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
Some ERROR messages may be printed during start-up even if initialization proceeds normally and successfully.
If an unrecoverable authorization error is encountered the sample app may crash on shutdown.
If a non-CBL clientId is included in the deviceInfo section of AlexaClientSDKConfig.json, the error will be reported as an unrecoverable authorization error, rather than a more specific error.

[1.6.0] - 2018-03-08

Enhancements

rapidJson is now included with "make install".
Updated the TemplateRuntimeObserverInterface to support clearing of displayCards.
Added Windows SDK support, along with an installation script (MinGW-w64).
Updated ContextManager to ignore context reported by a state provider.
The SharedDataStream object is now associated by playlist, rather than by URL.
Added the RegistrationManager component. Now, when a user logs out all persistent user-specific data is cleared from the SDK. The log out functionality can be exercised in the sample app with the new command: k.

Bug Fixes

Issue 400 Fixed a bug where the alert reminder did not iterate as intended after loss of network connection.
Issue 477 Fixed a bug in which Alexa's weather response was being truncated.
Fixed an issue in which there were reports of instability related to the Sensory engine. To correct this, the portAudio suggestedLatency value can now be configured.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
Music playback doesn't immediately stop when a user barges-in on iHeartRadio.
The Windows sample app hangs on exit.
GDB receives a SIGTRAP when troubleshooting the Windows sample app.
make integration doesn't work on Windows. Integration tests will need to be run individually.

[1.5.0] - 2018-02-12

Enhancements

Added the ExternalMediaPlayer Capability Agent. This allows playback from music providers that control their own playback queue. Example: Spotify.
Added support for AU and NZ to the SampleApp.
Firmware version can now be sent to Alexa via the SoftwareInfo event. The firmware version is specified in the config file under the sampleApp object as an integer value named firmwareVersion.
The new f command was added to the SampleApp which allows the firmware version to be updated at run-time.
Optional configuration changes have been introduced. Now a default log level can be set for ACSDK_LOG_MODULE components, globally or individually. This value is specified under a new root level configuration object called logger, and the value itself is named logLevel. This allows you to limit the degree of logging to that default value, such as ERRORor INFO.

Bug Fixes

Fixed bug where AudioPlayer progress reports were not being sent, or were being sent incorrectly.
Issue 408 - Irrelevant code related to UrlSource was removed from the GStreamer-based MediaPlayer implementation.
The TZ variable no longer needs to be set to UTC when building the SampleApp.
Fixed a bug where CurlEasyHandleWrapper logged unwanted data on failure conditions.
Fixed a bug to improve SIGPIPE handling.
Fixed a bug where the filename and classname were mismatched. Changed UrlToAttachmentConverter.h to UrlContentToAttachmentConverter.h,and UrlToAttachmentConverter.cpp to UrlContentToAttachmentConverter.cpp.
Fixed a bug where after muting and then un-muting the GStreamer-based MediaPlayer implementation, the next item in queue would play instead of continuing playback of the originally muted item.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
Display Cards for Kindle don't render.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
Music playback doesn't immediately stop when a user barges-in on iHeartRadio.

[1.4.0] - 2018-01-12

Enhancements

Added the Notifications Capability Agent. This allows a client to receive notification indicators from Alexa.
Added support for the SoftwareInfo event. This code is triggered in the SampleApp by providing a positive decimal integer as the "firmwareVersion" value in "sampleApp" object of the AlexaClientSDKConfig.json. The reported firmware version can be updated after starting the SampleApp by calling SoftwareInfoSender::setFirmwareVersion(). This code path can be exercised in the SampleApp with the new command: f.
Added unit tests for Alerts.
The GStreamer-based pipeline allows for the configuration of MediaPlayer output based on information provided in Config.
Playlist streaming now uses a BLOCKING writer, which improves streaming efficiency.

Bug Fixes

Fixed bug where SpeechSynthesizer would not stop playback when a state change timeout was encountered.
Fixed the SampleApplication destructor to avoid segfaults if the object is not constructed correctly.
Fixed bug where AudioPlayer would erroneously call executeStop() in cancelDirective().
Issue 396 - Fixed bug for compilation error with GCC7 in AVSCommon/SDKInterfaces/include/AVSCommon/SDKInterfaces/Audio/AlertsAudioFactoryInterface.h
Issue 384 - Fixed bug that caused AuthServer.py to crash.
Fixed bug where a long delay was encountered after pausing and resuming a large Audible chapter.
Fixed bug that caused named timers and reminders to loop for an additional loopCount .
Fixed memory corruption bug in MessageInterpreter.
Fixed illegal memory accesses in MediaPlayer logging.

Known Issues

The ACL may encounter issues if audio attachments are received but not consumed.
Display Cards for Kindle don't render.
If using the GStreamer-based MediaPlayer implementation, after muting and un-muting an audio item, the next item in the queue will begin playing rather than continuing playback of the originally muted audio item.
SpeechSynthesizerState currently uses GAINING_FOCUS and LOSING_FOCUS as a workaround for handling intermediate state. These states may be removed in a future release.
Music playback doesn't immediately stop when a user barges-in on iHeartRadio.

[1.3.0] - 2017-12-08

Enhancements
- ContextManager now passes the namespace/name of the desired state to StateProviderInterface::provideState(). This is helpful when a single StateProvider object provides multiple states, and needs to know which one ContextManager is asking for.
- The mime parser was hardened against duplicate boundaries.
- Added functionality to add and remove AudioPlayer observers to the DefaultClient.
- Unit tests for Alerts were added.
- Added en-IN, en-CA and ja-JP to the SampleApp locale selection menu.
- Added default alert and timer audio data to the SDK SampleApp. There is no longer a requirement to download these audio files and configure them in the json configuration file.
- Added support in SDS Reader and AttachmentReader for seeking into the future. This allows a reader to move to an index which has not yet arrived in the SDS and poll/block until it arrives.
- Added support for blocking Writers in the SharedDataStream class.
- Changed the default status code sent by MessageRequestObserverInterface::onSendCompleted() to SERVER_OTHER_ERROR, and mapped HTTP code 500 to SERVER_INTERNAL_ERROR_V2.
- Added support for parsing stream duration out of playlists.
- Added a configuration option ("sampleApp":"displayCardsSupported") that allows the displaying of display cards to be enabled or disabled.
- Named Timers and Reminders have been updated to fall back to the on-device background audio sound when cloud urls cannot be accessed or rendered.
Bug Fixes
- Removed floating point dependencies from core SDK libraries.
- Fixed bug in SpeechSynthesizer where it's erroneously calling stop more than once.
- Fixed an issue in ContentFetcher where it could hang during destruction until an active GET request completed.
- Fixed a couple of parsing bugs in LibCurlHttpContentFetcher related to case-sensitivity and mime-type handling.
- Fixed a bug where MediaPlayerObserverInterface::onPlaybackResumed() wasn't being called after resuming from a pause with a pending play/resume.
- Fixed a bug in LibCurlContentFetcher where it could error out if data is written to the SDS faster than it is consumed.
- The GStreamer-based MediaPlayer reference implementation now uses the ACL HTTP configured client.
  - An API change has been made to MediaPlayerInterface::setSource(). This method now takes in an optional offset as well to allow for immediately streaming to the offset if possible.
  - Next and Previous buttons now work with Audible.
  - Pandora resume stuttering is addressed.
  - Pausing and resuming Amazon music no longer seeks back to the beginning of the song.
- libcurl CURLOPT_NOSIGNAL option is set to 1 (https://curl.haxx.se/libcurl/c/CURLOPT_NOSIGNAL.html) to avoid crashes observed in SampleApp.
- Fixed the timing of the PlaybackReportIntervalEvent and PlaybackReportDelayEvent as specified in the directives.
- Fixed potential deadlocks in MediaPlayer during shutdown related to queued callbacks.
- Fixed a crash in MediaPlayer that could occur if the network is disconnected during playback.
- Fixed a bug where music could keep playing while Alexa is speaking.
- Fixed a bug which was causing problems with pause/resume and next/previous with Amazon Music.
- Fixed a bug where music could briefly start playing between speaks.
- Fixed a bug where HLS playlists would stop streaming after the initial playlist had been played to completion.
- Fixed a bug where Audible playback could not advance to the next chapter.
- Fixed some occurrences of SDK entering the IDLE state during the transition between Listening and Speaking states.
- Fixed a bug where PlaybackFinished events were not reporting the correct offset.
  - An API change has been made to MediaPlayerInterface::getOffset(). This method is now required to return the final offset when called after playback has stopped.
- Fixed a problem where AIP was erroneously resetting its state upon getting a cancelDirective() callback.
Known Issues
- Capability agent for Notifications is not included in this release.
- ACL's asynchronous receipt of audio attachments may manage resources poorly in scenarios where attachments are received but not consumed.
- GUI cards don't show for Kindle.
- The new SpeechSynthesizerState state values GAINING_FOCUS and LOSING_FOCUS were added as part of a work-around. The will likely be removed in subsequent releases.
- With the gstreamer-based MediaPlayer, after muting and unmuting, the next item starts playing rather than continuing with the current item.

[1.2.1] - 2017-11-16

Enhancements
- Added comments to AlexaClientSDKConfig.json. These descriptions provide additional guidance for what is expected for each field.
- Enabled pause and resume controls for Pandora.
Bug Fixes
- Bug fix for issue #329 - HTTP2Transport instances no longer leak when SERVER_SIDE_DISCONNECT is encountered.
- Bug fix for issue #189 - Fixed a race condition in the Timer class that sometimes caused SpeechSynthesizer to get stuck in the "Speaking" state.
- Bug fix for a race condition that caused SpeechSynthesizer to ignore subsequent Speak directives.
- Bug fix for corrupted mime attachments.

[1.2.0] - 2017-10-27

Enhancements
- Updated MediaPlayer to solve stability issues
- All capability agents were refined to work with the updated MediaPlayer
- Added the TemplateRuntime capability agent
- Added the SpeakerManager capability agent
- Added a configuration option ("sampleApp":"endpoint") that allows the endpoint that SampleApp connects to to be specified without changing code or rebuilding
- Added very verbose capture of libcurl debug information
- Added an observer interface to observer audio state changes from AudioPlayer
- Added support for StreamMetadataExtracted Event. Stream tags found in the stream are represented in JSON and sent to AVS
- Added to the SampleApp a simple GuiRenderer as an observer to the TemplateRuntime Capability Agent
- Moved shared libcurl functionality to AVSCommon/Utils
- Added a CMake option to exclude tests from the "make all" build. Use "cmake <absolute-path-to-source> -DACSDK_EXCLUDE_TEST_FROM_ALL=ON" to enable it. When this option is enabled "make unit" and "make integration" still could be used to build and run the tests
Bug fixes:
- Previously scheduled alerts now play following a restart
- General stability fixes
- Bug fix for CertifiedSender blocking forever if the network goes down while it's trying to send a message to AVS
- Fixes for known issue of Alerts integration tests fail: AlertsTest.UserLongUnrelatedBargeInOnActiveTimer and AlertsTest.handleOneTimerWithVocalStop
- Attempting to end a tap-to-talk interaction with the tap-to-talk button wouldn't work
- SharedDataStream could encounter a race condition due to a combination of a blocking Reader and a Writer closing before writing any data
- Bug-fix for the ordering of notifications within alerts scheduling. This fixes the issue where a local-stop on an alert would also stop a subsequent alert if it were to begin without delay
Known Issues
Capability agent for Notifications is not included in this release
Inconsistent playback behavior when resuming content ("Alexa, pause." / "Alexa, resume."). Specifically, handling playback offsets, which causes the content to play from the start. This behavior is also occasionally seen with "Next" / "Previous".
ACL's asynchronous receipt of audio attachments may manage resources poorly in scenarios where attachments are received but not consumed.
Music playback failures may result in an error Text to Speech being rendered repeatedly
Reminders and named timers don't sound when there is no connection
GUI cards don't show for Kindle

[1.1.0] - 2017-10-02

Enhancements
- Better GStreamer error reporting. MediaPlayer used to only report MEDIA_ERROR_UNKNOWN, now reports more specific errors as defined in ErrorType.h.
- Codebase has been formatted for easier reading.
- DirectiveRouter::removeDirectiveHandler() signature changed and now returns a bool indicating if given handler should be successfully removed or not.
- Cleanup of raw and shared pointers in the creation of Transport objects.
- HTTP2Streams now have IDs assigned as they are acquired as opposed to created, making associated logs easier to interpret.
- AlertsCapabilityAgent has been refactored.
  - Alert management has been factored out into an AlertScheduler class.
- Creation of Reminder (implements Alert) class.
- Added new capability agent for PlaybackController with unit tests.
- Added Settings interface with unit tests.
- Return type of getOffsetInMilliseconds() changed from int64_t to std::chronology::milliseconds.
- Added AudioPlayer unit tests.
- Added teardown for all Integration tests except Alerts.
- Implemented PlaylistParser.
Bug fixes:
- AIP getting stuck in LISTENING or THINKING and refusing user input on network outage.
- SampleApp crashing if running for 5 minutes after network disconnect.
- Issue where on repeated user barge-ins, AudioPlayer would not pause. Specifically, the third attempt to “Play iHeartRadio” would not result in currently-playing music pausing.
- Utterances being ignored after particularly long TTS.
- GStreamer errors cropping up on SampleApp exit as a result of accessing the pipeline before it’s been setup.
- Crashing when playing one URL after another.
- Buffer overrun in Alerts Renderer.
- SampleApp crashing when issuing "Alexa skip" command with iHeartRadio.
- HTTP2Transport network thread triggering a join on itself.
- HTTP2Stream request handling truncating exception messages.
- AudioPlayer was attempting an incorrect state transition from STOPPED to PLAYING through a playbackResumed.
Known Issues
Native components for the following capability agents are not included in this release: Speaker, TemplateRuntime, and Notifications
ACL's asynchronous receipt of audio attachments may manage resources poorly in scenarios where attachments are received but not consumed.
When an AttachmentReader does not deliver data for prolonged periods, MediaPlayer may not resume playing the delayed audio.
Without the refresh token in the JSON file, the sample app crashes on start up.
Alerts do not play after restarting the device.
Alexa's responses are cut off by about half a second when asking "What's up" or barging into an active alarm to ask the time.
Switching from Kindle to Amazon Music after pausing and resuming Kindle doesn't work.
Pause/resume on Amazon Music causes entire song to start over.
Stuck in listening state if ExpectSpeech comes in when the microphone has been turned off.
Pausing and resuming Pandora causes stuttering, looped audio.
Audible features are not fully supported.
Recognize event after regaining network connection and during an alarm going off can cause client to get stuck in Recognizing state.
Three Alerts integration tests fail: handleMultipleTimersWithLocalStop, AlertsTest.UserLongUnrelatedBargeInOnActiveTimer, AlertsTest.handleOneTimerWithVocalStop
MediaPlayerTest.testSetOffsetSeekableSource unit test fails intermittently on Linux.

[1.0.3] - 2017-09-19

Enhancements
- Implemented setOffSet in MediaPlayer.
- Updated LoggerUtils.cpp.
Bug Fixes
- Bug fix to address incorrect stop behavior caused when Audio Focus is set to NONE and released.
- Bug fix for intermittent failure in handleMultipleConsecutiveSpeaks.
- Bug fix for jsonArrayExist incorrectly parsing JSON when trying to locate array children.
- Bug fix for ADSL test failures with sendDirectiveWithoutADialogRequestId.
- Bug fix for SpeechSynthesizer showing the wrong UX state when a burst of Speak directives are received.
- Bug fix for recursive loop in AudioPlayer.Stop.

[1.0.2] - 2017-08-23

Removed code from AIP which propagates ExpectSpeech initiator strings to subsequent Recognize events. This code will be re-introduced when AVS starts sending initiator strings.

[1.0.1] - 2017-08-17

Added a fix to the sample app so that the StateSynchronization event is the first that gets sent to AVS.
Added a POST_CONNECTED enum to ConnectionStatusObserver.
StateSychronizer now automatically sends a StateSynchronization event when it receives a notification that ACL is CONNECTED.
Added make install for installing the AVS Device SDK.
Added an optional make networkIntegration for integration tests for slow network (only on Linux platforms).
Added shutdown management which fully cleans up SDK objects during teardown.
Fixed an issue with AudioPlayer barge-in which was preventing subsequent audio from playing.
Changed Mediaplayer buffering to reduce stuttering.
Known Issues:
- Connection loss during listening keeps the app in that state even after connection is regained. Pressing ‘s’ unsticks the state.
- Play/Pause media restarts it from the beginning.
- SpeechSynthesizer shows wrong UX state during a burst of Speaks.
- Quitting the sample app while AudioPlayer is playing something causes a segmentation fault.
- AudioPlayer sending PlaybackPaused during flash briefing.
- Long Delay playing live stations on iHeartRadio.
- Teardown warnings at the end of integration tests.

[1.0.0] - 2017-08-07

Added AudioPlayer capability agent.
- Supports iHeartRadio.
StateSynchronizer has been updated to better enforce that System.SynchronizeState is the first Event sent on a connection to AVS.
Additional tests have been added to ACL.
The Sample App has been updated with several small fixes and improvements.
ADSL was updated such that all directives are now blocked while the handling of previous SpeechSynthesizer.Speak directives complete. Because any directive may now be blocked, the preHandleDirective() / handleDirective() path is now used for handling all directives.
Fixes for the following GitHub issues:
- EXPECTING_SPEECH + SPEAK directive simultaneously on multi-turn conversation.
A bug causing ACL to not send a ping to AVS every 5 minutes, leading to periodic server disconnects, was fixed.
Subtle race condition issues were addressed in the Executor class, resolving some intermittent crashes.
Known Issues
- Native components for the following capability agents are not included in this release: PlaybackController, Speaker, Settings, TemplateRuntime, and Notifications.
- MediaPlayer
  - Long periods of buffer underrun can cause an error related with seeking and subsequent stopped playback.
  - Long periods of buffer underrun can cause flip flopping between buffer_underrun and playing states.
  - Playlist parsing is not supported unless -DTOTEM_PLPARSER=ON is specified.
- AudioPlayer
  - Amazon Music, TuneIn, and SiriusXM are not supported in this release.
  - Our parsing of urls currently depends upon GNOME/totem-pl-parser which only works on some Linux platforms.
- AlertsCapabilityAgent
  - Satisfies the AVS specification except for sending retrospective Events. For example, sending AlertStarted Event for an Alert which rendered when there was no internet connection.
- Sample App:
  - Any connection loss during the Listening state keeps the app stuck in that state, unless the ongoing interaction is manually stopped by the user.
  - The user must wait several seconds after starting up the sample app before the sample app is properly usable.
- Tests:
  - SpeechSynthesizer unit tests hang on some older versions of GCC due to a tear down issue in the test suite
  - Intermittent Alerts integration test failures caused by rigidness in expected behavior in the tests

[0.6.0] - 2017-07-14

Added a sample app that leverages the SDK.
Added Alerts capability agent.
Added the DefaultClient class.
Added the following classes to support directives and events in the System interface: StateSynchronizer, EndpointHandler, and ExceptionEncounteredSender.
Added unit tests for ACL.
Updated MediaPlayer to play local files given an std::istream.
Changed build configuration from Debug to Release.
Removed DeprecatedLogger class.
Known Issues:
- MediaPlayer: Our GStreamer based implementation of MediaPlayer is not fully robust, and may result in fatal runtime errors, under the following conditions:
  - Attempting to play multiple simultaneous audio streams
  - Calling MediaPlayer::play() and MediaPlayer::stop() when the MediaPlayer is already playing or stopped, respectively.
  - Other miscellaneous issues, which will be addressed in the near future
- AlertsCapabilityAgent:
  - This component has been temporarily simplified to work around the known MediaPlayer issues mentioned above
  - Fully satisfies the AVS specification except for sending retrospective Events, for example, sending AlertStarted for an Alert which rendered when there was no Internet connection
  - This component is not fully thread-safe, however, this will be addressed shortly
  - Alerts currently run indefinitely until stopped manually by the user. This will be addressed shortly by having a timeout value for an alert to stop playing.
  - Alerts do not play in the background when Alexa is speaking, but will continue playing after Alexa stops speaking.
- Sample App:
  - Without the refresh token being filled out in the JSON file, the sample app crashes on start up.
  - Any connection loss during the Listening state keeps the app stuck in that state, unless the ongoing interaction is manually stopped by the user.
  - At the end of a shopping list with more than 5 items, the interaction in which Alexa asks the user if he/she would like to hear more does not finish properly.

Tests:

SpeechSynthesizer unit tests hang on some older versions of GCC due to a tear down issue in the test suite
Intermittent Alerts integration test failures caused by rigidness in expected behavior in the tests

[0.5.0] - 2017-06-23

Updated most SDK components to use new logging abstraction.
Added a getConfiguration() method to DirectiveHandlerInterface to register capability agents with Directive Sequencer.
Added ACL stream processing with pause and redrive.
Removed the dependency of ACL library on Authdelegate.
Added an interface to allow ACL to add/remove ConnectionStatusObserverInterface.
Fixed compile errors in KITT.ai, DirectiveHandler and compiler warnings in AIP tests.
Corrected formatting of code in many files.
Fixes for the following GitHub issues:
- MessageRequest callbacks never triggered if disconnected
- AttachmentReader::read() returns ReadStatus::CLOSED if an AttachmentWriter has not been created yet

[0.4.1] - 2017-06-09

Implemented Sensory wake word detector functionality.
Removed the need for a std::recursive_mutex in MessageRouter.
Added AIP unit tests.
Added handleDirectiveImmediately functionality to SpeechSynthesizer.
Added memory profiles for:
- AIP
- SpeechSynthesizer
- ContextManager
- AVSUtils
- AVSCommon
Bug fix for MessageRouterTest aborting intermittently.
Bug fix for MultipartParser.h compiler warning.
Suppression of sensitive log data even in debug builds. Use CMake parameter -DACSDK_EMIT_SENSITIVE_LOGS=ON to allow logging of sensitive information in DEBUG builds.
Fixed crash in ACL when attempting to use more than 10 streams.
Updated MediaPlayer to use autoaudiosink instead of requiring pulseaudio.
Updated MediaPlayer build to suppport local builds of GStreamer.
Fixes for the following GitHub issues:

[0.4.0] - 2017-05-31 (patch)

Added AuthServer, an authorization server implementation used to retrieve refresh tokens from LWA.

[0.4.0] - 2017-05-24

Added SpeechSynthesizer, an implementation of the SpeechRecognizer capability agent.
Implemented a reference MediaPlayer based on GStreamer for audio playback.
Added MediaPlayerInterface that allows you to implement your own media player.
Updated ACL to support asynchronous receipt of audio attachments from AVS.
Bug Fixes:
- Some intermittent unit test failures were fixed.
Known Issues:
- ACL's asynchronous receipt of audio attachments may manage resources poorly in scenarios where attachments are received but not consumed.
- When an AttachmentReader does not deliver data for prolonged periods MediaPlayer may not resume playing the delayed audio.

[0.3.0] - 2017-05-17

Added the CapabilityAgent base class that is used to build capability agent implementations.
Added ContextManager, a component that allows multiple capability agents to store and access state. These Events include Context, which is used to communicate the state of each capability agent to AVS in the following Events:
Added SharedDataStream (SDS) to asynchronously communicate data between a local reader and writer.
Added AudioInputProcessor (AIP), an implementation of a SpeechRecognizer capability agent.
Added WakeWord Detector (WWD), which recognizes keywords in audio streams. [0.3.0] implements a wrapper for KITT.ai.
Added a new implementation of AttachmentManager and associated classes for use with SDS.
Updated ACL to support asynchronously sending audio to AVS.

[0.2.1] - 2017-05-03

Replaced the configuration file AuthDelegate.config with AlexaClientSDKConfig.json.
Added the ability to specify a CURLOPT_CAPATH value to be used when libcurl is used by ACL and AuthDelegate. See See Appendix C in the README for details.
Changes to ADSL interfaces:
- The [0.2.0] interface for registering directive handlers (DirectiveSequencer::setDirectiveHandlers()) was problematic because it canceled the ongoing processing of directives and dropped further directives until it completed. The revised API makes the operation immediate without canceling or dropping any handling. However, it does create the possibility that DirectiveHandlerInterface methods preHandleDirective() and handleDirective() may be called on different handlers for the same directive.
- DirectiveSequencerInterface::setDirectiveHandlers() was replaced by addDirectiveHandlers() and removeDirectiveHandlers().
- DirectiveHandlerInterface::shutdown() was replaced with onDeregistered().
- DirectiveHandlerInterface::preHandleDirective() now takes a std::unique_ptr instead of a std::shared_ptr to DirectiveHandlerResultInterface.
- DirectiveHandlerInterface::handleDirective() now returns a bool indicating if the handler recognizes the messageId.
Bug fixes:
- ACL and AuthDelegate now require TLSv1.2.
- onDirective() now sends ExceptionEncountered for unhandled directives.
- DirectiveSequencer::shutdown() no longer sends ExceptionEncountered() for queued directives.

[0.2.0] - 2017-03-27 (patch)

Added memory profiling for ACL and ADSL. See Appendix A in the README.
Added a command to build the API documentation.

[0.2.0] - 2017-03-09

Added Alexa Directive Sequencer Library (ADSL) and Alexa Focus Manager Library (AMFL).
CMake build types and options have been updated.
Documentation for libcurl optimization included.

[0.1.0] - 2017-02-10

Initial release of the Alexa Communications Library (ACL), a component which manages network connectivity with AVS, and AuthDelegate, a component which handles user authorization with AVS.