This sample demonstrates how to recognize speech with the Speech SDK for JavaScript on a web browser, like Microsoft Edge, or Chrome. See the accompanying article on the SDK documentation page which describes how to build this sample from scratch in your favourite editor.
- A subscription key for the Speech service. See Try the speech service for free.
- A PC or Mac, with a working microphone.
- A text editor.
- Optionally, a web server that supports hosting PHP scripts.
Note: more detailed step-by-step instructions are available here.
- By downloading the Microsoft Cognitive Services Speech SDK when building this sample, you acknowledge its license, see Speech SDK license agreement.
- Download the sample code to your development PC.
- From the Speech SDK for JavaScript .zip package extract the file
microsoft.cognitiveservices.speech.sdk.bundle.jsand place it into the folder that contains this quickstart.
If you want to host the sample on a web server:
- Edit the
token.phpsource:- Replace the string
YourServiceRegionwith the service region of your subscription. For example, replace withwestusif you are using the 30-day free trial subscription. - Replace the string
YourSubscriptionKeywith your own subscription key.
- Replace the string
- Edit the
index.htmlsource:- Replace the value for the variable
authorizationEndpointwith the full URL where you can access the token.php resource.
- Replace the value for the variable
- Deploy all files to your web server.
- In case you are running the sample from your local computer, open index.html from the location where you have downloaded this quickstart with a JavaScript capable browser. Use the input fields to set your subscription key and service region.
- In case you are hosting the sample on a web server, open a web browser and navigate to the full URL where you host the sample.
Note: On Safari, the sample web page needs to be hosted on a web server; Safari doesn't allow websites loaded from a local file to use the microphone.