svvlcrkt / helloworld

Quickstart: Synthesize speech in C# under .NET Framework for Windows

This sample demonstrates how to synthesize speech with C# under the .NET Framework (version 4.6.1 or above) using the Speech SDK for Windows. See the accompanying article on the SDK documentation page which describes how to build this sample from scratch in Visual Studio 2017.

Prerequisites

• A subscription key for the Speech service. See Try the speech service for free.
• A Windows PC with a working speaker or headset.
• Microsoft Visual Studio 2017, Community Edition or higher.
• The .NET desktop development workload in Visual Studio. You can enable it in Tools > Get Tools and Features.

Build the sample

• By building this sample you will download the Microsoft Cognitive Services Speech SDK. By downloading you acknowledge its license, see Speech SDK license agreement.
• Download the sample code to your development PC.
• Start Microsoft Visual Studio 2017 and select File > Open > Project/Solution.
• Navigate to the folder containing this sample, and select the solution file contained within it.
• Edit the Program.cs source:
  • Replace the string YourSubscriptionKey with your own subscription key.
  • Replace the string YourServiceRegion with the service region of your subscription. For example, replace with westus if you are using the 30-day free trial subscription. Make sure the region in your Azure resource matches the region you put into the sample, otherwise you'll get a 401 unauthorized access error.
• Set the active solution configuration and platform to the desired values under Build > Configuration Manager:
  • On a 64-bit Windows installation, choose x64 as active solution platform.
  • On a 32-bit Windows installation, choose x86 as active solution platform.
• Press Ctrl+Shift+B, or select Build > Build Solution.

Run the sample

To debug the app and then run it, press F5 or use Debug > Start Debugging. To run the app without debugging, press Ctrl+F5 or use Debug > Start Without Debugging.

References

• Quickstart article on the SDK documentation site
• Speech SDK API reference for C#