Quickstart: Run the Speech Devices SDK sample app on Android
In this quickstart, you'll learn how to use the Speech Devices SDK for Android to build a speech-enabled product.
The source code for the sample application is included with the Speech Devices SDK. It's also available on GitHub.
Before you start using the Speech Devices SDK, you'll need to:
Follow the instructions provided with your development kit to power on the device.
Download the latest version of the Speech Devices SDK, and extract the .zip to your working directory.
The .zip file includes the Android sample app.
If you plan to use the Speech Services to identify intents (or actions) from user utterances, you'll need a Language Understanding Service (LUIS) subscription. To learn more about LUIS and intent recognition, see Recognize speech intents with LUIS, C#.
You can create a simple LUIS model or use the sample LUIS model, LUIS-example.json. The sample LUIS model is available from the Speech Devices SDK download site. To upload your model's JSON file to the LUIS portal, select Import new app, and then select the JSON file.
Set up the device
Start Vysor on your computer.
Your device should be listed under Choose a device. Select the View button next to the device.
Connect to your wireless network by selecting the folder icon, and then select Settings > WLAN.
If your company has policies about connecting devices to its Wi-Fi system, you need to obtain the MAC address and contact your IT department about how to connect it to your company's Wi-Fi.
To find the MAC address of the dev kit, select the file folder icon on the desktop of the dev kit.
Select Settings. Search for "mac address", and then select Mac address > Advanced WLAN. Write down the MAC address that appears near the bottom of the dialog box.
Some companies might have a time limit on how long a device can be connected to their Wi-Fi system. You might need to extend the dev kit's registration with your Wi-Fi system after a specific number of days.
Run the sample application
To validate your development kit setup, build and install the sample application:
Start Android Studio.
Select Open an existing Android Studio project.
Go to C:\SDSDK\Android-Sample-Release\example. Select OK to open the example project.
Add your Speech subscription key to the source code. If you want to try intent recognition, also add your Language Understanding service subscription key and application ID.
Your keys and application information go in the following lines in the source file MainActivity.java:
// Subscription private static final String SpeechSubscriptionKey = "[your speech key]"; private static final String SpeechRegion = "westus"; private static final String LuisSubscriptionKey = "[your LUIS key]"; private static final String LuisRegion = "westus2.api.cognitive.microsoft.com"; private static final String LuisAppId = "[your LUIS app ID]"
The default wake word (keyword) is "Computer". You can also try one of the other provided wake words, like "Machine" or "Assistant". The resource files for these alternate wake words are in the Speech Devices SDK, in the keyword folder. For example, C:\SDSDK\Android-Sample-Release\keyword\Computer contains the files used for the wake word "Computer".
You can also create a custom wake word.
To use a new wake word, update the following two lines in
MainActivity.java, and copy the wake word package to your app. For example, to use the wake word 'Machine' from the wake word package kws-machine.zip:
Copy the wake word package into the folder “C:\SDSDK\Android-Sample-Release\example\app\src\main\assets\”.
MainActivity.javawith the keyword and the package name:
private static final String Keyword = "Machine"; private static final String KeywordModel = "kws-machine.zip" // set your own keyword package name.
Update the following lines, which contain the microphone array geometry settings:
private static final String DeviceGeometry = "Circular6+1"; private static final String SelectedGeometry = "Circular6+1";
This table lists supported values:
Variable Meaning Available values
Physical mic configuration For a circular dev kit:
For a linear dev kit:
Software mic configuration For a circular dev kit that uses all mics:
For a circular dev kit that uses four mics:
For a linear dev kit that uses all mics:
For a linear dev kit that uses two mics:
To build the application, on the Run menu, select Run 'app'. The Select Deployment Target dialog box appears.
Select your device, and then select OK to deploy the application to the device.
The Speech Devices SDK example application starts and displays the following options:
If you cannot connect to the Speech Device. Type the following command in a Command Prompt window. It will return a list of devices:
This command uses the Android Debug Bridge,
adb.exe, which is part of the Android Studio installation. This tool is located in C:\Users[user name]\AppData\Local\Android\Sdk\platform-tools. You can add this directory to your path to make it more convenient to invoke
adb. Otherwise, you must specify the full path to your installation of adb.exe in every command that invokes
If you see an error
no devices/emulators found then check your USB cable is connected and ensure a high quality cable is used.
Send feedback about: