-
Notifications
You must be signed in to change notification settings - Fork 25
Troubleshooting Guide
Having trouble with the Alexa Smart Screen SDK? Here's a list of resolutions for common issues reported by AVS developers.
Let us know what we can do to help you by creating a new issue when you run into a problem.
Microphone fails to pick up sound. Speaker or headset fails to play sound.
See the AVS Device SDK Troubleshooting Guide.
The sample app fails.
Make sure that the AlexaClientSDKConfig.json
file exists and that the path to the database files is valid (even if the db
folder is empty). Here is a sample AlexaClientSDKConfig.json
file (note: <pathto>
is a placeholder for the path to the ~/sdk_folder/db
directory):
{
"cblAuthDelegate":{
"databaseFilePath":"<pathto>/cblAuthDelegateMMSDK.db"
},
"deviceInfo":{
"deviceSerialNumber":"<serialNumber>",
"clientId":"<clientId>",
"productId":"<productId>"
},
"deviceSettings":{
"databaseFilePath":"<pathto>/deviceSettings.db",
"locales":["en-US","en-GB","de-DE","en-IN","en-CA","ja-JP","en-AU","fr-FR","it-IT","es-ES","es-MX","fr-CA",
"es-US", "hi-IN", "pt-BR"],
"defaultLocale":"en-US",
"localeCombinations":[
["en-CA", "fr-CA"],
["fr-CA", "en-CA"]
],
"defaultTimezone":"America/Vancouver"
},
"miscDatabase":{
"databaseFilePath":"<pathto>/miscDatabase.db"
},
"alertsCapabilityAgent":{
"databaseFilePath":"<pathto>/alerts.db"
},
"settings":{
"databaseFilePath":"<pathto>/settings.db",
"defaultAVSClientSettings":{
"locale":"en-US"
}
},
"certifiedSender":{
"databaseFilePath":"<pathto>/certifiedSender.db"
},
"notifications":{
"databaseFilePath":"<pathto>/notifications.db"
},
"capabilitiesDelegate":{
}
}
You see the following error when you try to run the Alexa Smart Screen SDK sample app on a new device (that you have registered as a product in the Alexa console):
RequiresShutdown:~RequiresShutdownFailed:reason=notShutdown,name=FocusBridge
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CapabilitiesDelegate:getCapabilityConfigsStringFromJsonFailed::Interface configurations not available
CBLAuthDelegate:receiveTokenResponseFailed:result=UNAUTHORIZED_CLIENT
Go to the ~/sdk_folder/db
folder and delete its contents.
Copy the credentials (clientID
and productID
) from the new product's config.json
file into the AlexaClientSDKConfig.json
file.
Run the sample again enter the code provided on the screen in the web page at amazon.com/us/code to authorize the new product. For more information, see Get a Refresh Token in the AVS Device SDK documentation.
You see this output:
dyld: Library not loaded: /usr/local/opt/icu4c/lib/libicui18n.63.dylib
Referenced from: /usr/local/bin/node
Reason: image not found
/bin/sh: line 1: 91419 Abort trap: 6 npm install
make[2]: *** [modules/GUI/CMakeFiles/GUIClient] Error 134
make[1]: *** [modules/GUI/CMakeFiles/GUIClient.dir/all] Error 2
make: *** [all] Error 2
brew reinstall node
If brew reinstall node
doesn’t fix the error, uninstall and reinstall the node manually from the node.js
website:
brew uninstall —ignore-dependencies node
In your web browser, go to https://nodejs.org/en/download/. Download the LTS version for Mac, and follow the prompts to install node.js. Re-run your cmake and make commands.
You see this output when trying to run the Alexa Smart Screen SDK Sample App:
dyld: Library not loaded: @rpath/libAVSCommon.dylib
Referenced from: ~/sdk_folder/ss-build/./modules/Alexa/SampleApp/src/SampleApp
Reason: image not found
Abort trap: 6
Run:
export DYLD_LIBRARY_PATH=$HOME/sdk_folder/sdk-install/lib:$DYLD_LIBRARY_PATH
Alexa Smart Screen SDK build fails.
None. The Alexa Smart Screen SDK is currently supported only on Raspbian Stretch, not Raspbian Buster.
To see what version of Raspbian you’re running, use this command:
cat /etc/debian_version
or this one:
cat /etc/os-release
If the output is 9.XX, you’re running Stretch. If it’s 10.XX, it’s Buster.
AVS Device SDK cmake
build command fails with "can't find libcrypto
" error - or an error reporting another library as missing. Note that if you have the wrong version of a given library, the library will be reported as missing.
Install the required version of the missing library. For example, the AVS Device SDK requires libcrypto
version 1.1. To install it, use this command:
sudo apt install libcurl4-openssl-dev libssl-dev
When you click the Alexa logo in your web browser and speak into the microphone on my Pi, you see "Listening..."
and "Thinking..."
, but then nothing happens.
Your microphone may be turned off. If so, you'll need to turn it on as follows:
- In the upper right corner of the Raspberry Pi screen, right-click the speaker icon and choose USB Device Settings.
- In the dialog box, set the Sound card to USB PnP Sound Device (Alsa mixer).
- Under the Microphone level setting, you'll see a dot that's either black or red. If it's black, that means the microphone is turned off. Click the dot, and it should turn red to indicate that the microphone is turned on.
If you are using a USB microphone and earbuds, try this:
- Replace the contents of your
~/.asoundrc
with the following:
pcm.!default {
type hw
card 0
}
ctl.!default {
type hw
card 0
}
}
- In the upper right corner of the Raspberry Pi screen, right-click the speaker icon and choose Analog.
- Right-click the speaker icon again and choose USB Device Settings.
- In the dialog box, set the Sound card to USB PnP Sound Device (Alsa mixer).
- Under the Microphone level setting, you'll see a dot that's either black or red. If it's black, that means the microphone is turned off. Click the dot, and it should turn red to indicate that the microphone is turned on.
Alexa Smart Screen SDK
Quick Start Guides
APIs and Reference
Resources