快速入门：安装开发环境Quickstart: Setup development environment

本指南介绍如何安装用于 .NET Framework (Windows) 的语音 SDK。This guide shows how to install the Speech SDK for .NET Framework (Windows). 如果只是需要包名称以便自行开始，请在 NuGet 控制台中运行 Install-Package Microsoft.CognitiveServices.Speech。If you just want the package name to get started on your own, run Install-Package Microsoft.CognitiveServices.Speech in the NuGet console.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• Visual Studio 2019Visual Studio 2019
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

创建 Visual Studio 项目并安装语音 SDKCreate a Visual Studio project and install the Speech SDK

需安装语音 SDK NuGet 包，以便在代码中引用它。You'll need to install the Speech SDK NuGet package so you can reference it in your code. 为此，可能首先需要创建 helloworld 项目。To do that, you may first need to create a helloworld project. 如果已经有一个可以使用“.NET 桌面开发”工作负荷的项目，则可使用该项目并跳到使用 NuGet 包管理器安装语音 SDK。If you already have a project with the .NET desktop development workload available, you can use that project and skip to Use NuGet Package Manager to install the Speech SDK.

创建 helloworld 项目Create helloworld project

1. 打开 Visual Studio 2019。Open Visual Studio 2019.

2. 在“开始”窗口中，选择“创建新项目”。In the Start window, select Create a new project.

3. 在“创建新项目”窗口中，选择“控制台应用(.NET Framework)”，然后选择“下一步”。 In the Create a new project window, choose Console App (.NET Framework), and then select Next.

4. 在“配置新项目”窗口中的“项目名称”内输入 helloworld，在“位置”中选择或创建目录路径，然后选择“创建”。 In the Configure your new project window, enter helloworld in Project name, choose or create the directory path in Location, and then select Create.

5. 在 Visual Studio 菜单栏中，选择“工具” > “获取工具和功能”打开 Visual Studio 安装程序并显示“修改”对话框。 From the Visual Studio menu bar, select Tools > Get Tools and Features, which opens Visual Studio Installer and displays the Modifying dialog box.

6. 检查“.NET 桌面开发”工作负荷是否可用。Check whether the .NET desktop development workload is available. 如果尚未安装该工作负荷，请选中它旁边的复选框，然后选择“修改”以启动安装。If the workload hasn't been installed, select the check box next to it, and then select Modify to start the installation. 下载和安装过程可能需要几分钟。It may take a few minutes to download and install.

   如果已选中“.NET 桌面开发”旁边的复选框，请选择“关闭”退出对话框。 If the check box next to .NET desktop development is already selected, select Close to exit the dialog box.

   

7. 关闭 Visual Studio 安装程序。Close Visual Studio Installer.

使用 NuGet 包管理器安装语音 SDKUse NuGet Package Manager to install the Speech SDK

1. 在解决方案资源管理器中右键单击“helloworld”项目，然后选择“管理 NuGet 包”显示 NuGet 包管理器。 In the Solution Explorer, right-click the helloworld project, and then select Manage NuGet Packages to show the NuGet Package Manager.

   

2. 在右上角找到“包源”下拉框，确保选择了 nuget.org 。In the upper-right corner, find the Package Source drop-down box, and make sure that nuget.org is selected.

3. 在左上角，选择“浏览”。In the upper-left corner, select Browse.

4. 在搜索框中，键入 Microsoft.CognitiveServices.Speech 并按 Enter。In the search box, type Microsoft.CognitiveServices.Speech and select Enter.

5. 在搜索结果中选择“Microsoft.CognitiveServices.Speech”包，然后选择“安装”以安装最新稳定版本。 From the search results, select the Microsoft.CognitiveServices.Speech package, and then select Install to install the latest stable version.

   

6. 接受所有协议和许可证，开始安装。Accept all agreements and licenses to start the installation.

   安装此包后，“包管理器控制台”窗口中将显示一条确认消息。After the package is installed, a confirmation appears in the Package Manager Console window.

选择目标体系结构Choose target architecture

若要生成并运行控制台应用程序，请创建与计算机体系结构匹配的平台配置。To build and run the console application, create a platform configuration matching your computer's architecture.

1. 在菜单栏中，选择“生成” > “配置管理器” 。From the menu bar, select Build > Configuration Manager. 此时将显示“配置管理器”对话框。The Configuration Manager dialog box appears.

   

2. 在“活动解决方案平台”下拉框中，选择“新建” 。In the Active solution platform drop-down box, select New. 此时将显示“新建解决方案平台”对话框。The New Solution Platform dialog box appears.

3. 在“键入或选择新平台”下拉框中：In the Type or select the new platform drop-down box:

   • 如果运行的是 64 位 Windows，请选择 x64。If you're running 64-bit Windows, select x64.
   • 如果运行的是 32 位 Windows，请选择 x86。If you're running 32-bit Windows, select x86.

4. 选择“确定”，然后选择“关闭”。 Select OK and then Close.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 C# .NET Core 的语音 SDK。This guide shows how to install the Speech SDK for C# .NET Core. 如果只是需要包名称以便自行开始，请在 NuGet 控制台中运行 Install-Package Microsoft.CognitiveServices.Speech。If you just want the package name to get started on your own, run Install-Package Microsoft.CognitiveServices.Speech in the NuGet console.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• .NET Core SDK.NET Core SDK
• Visual Studio 2017 或更高版本Visual Studio 2017 or later
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

创建 Visual Studio 项目并安装语音 SDKCreate a Visual Studio project and install the Speech SDK

1. 启动 Visual Studio 2019。Start Visual Studio 2019.

2. 确保“.NET 跨平台开发” 工作负荷可用。Make sure the .NET cross-platform development workload is available. 在 Visual Studio 菜单栏中选择“工具” > “获取工具和功能”，以打开 Visual Studio 安装程序。Choose Tools > Get Tools and Features from the Visual Studio menu bar to open the Visual Studio installer. 如果此工作负荷已启用，请关闭对话框。If this workload is already enabled, close the dialog box.

   

   否则，请选择“.NET Core 跨平台开发”旁边的框， 然后选择对话框右下角的“修改”。 Otherwise, select the box next to .NET Core cross-platform development, and select Modify at the lower right corner of the dialog box. 安装新功能将花费一些时间。Installation of the new feature will take a moment.

3. 创建新的 Visual C# .NET Core 控制台应用。Create a new Visual C# .NET Core Console App. 在“新建项目”对话框中，从左侧窗格中展开“已安装” > “Visual C#” > “.NET Core”。 In the New Project dialog box, from the left pane, expand Installed > Visual C# > .NET Core. 然后，选择“控制台应用(.NET Core)” 。Then select Console App (.NET Core). 在项目名称处，输入 helloworld 。For the project name, enter helloworld.

   

4. 安装并引用语音 SDK NuGet 包。Install and reference the Speech SDK NuGet package. 在解决方案资源管理器中，右键单击该解决方案，并选择“为解决方案管理 NuGet 包” 。In Solution Explorer, right-click the solution and select Manage NuGet Packages for Solution.

   

5. 在右上角的“包源”字段中，选择“nuget.org” 。搜索 Microsoft.CognitiveServices.Speech 包，并将其安装到“helloworld”项目中 。In the upper-right corner, in the Package Source field, select nuget.org. Search for the Microsoft.CognitiveServices.Speech package, and install it into the helloworld project.

   

6. 接受显示的许可证即可开始安装 NuGet 包。Accept the displayed license to begin installation of the NuGet package.

   

安装此包后，在包管理器控制台中会显示一条确认消息。After the package is installed, a confirmation appears in the Package Manager console.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 Unity 的语音 SDK。This guide shows how to install the Speech SDK for Unity.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• Unity 2018.3 或更高版本，以及支持 UWP ARM64 的 Unity 2019.1。Unity 2018.3 or later with Unity 2019.1 adding support for UWP ARM64.
• Visual Studio 2019。Visual Studio 2019. 也可以使用 Visual Studio 2017 版本 15.9 或更高版本。Version 15.9 or higher of Visual Studio 2017 is also acceptable.
• 为了支持 Windows ARM64，请安装适用于 ARM64 的可选版本工具，以及适用于 ARM64 的 Windows 10 SDKFor Windows ARM64 support, install the optional build tools for ARM64, and the Windows 10 SDK for ARM64.
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

安装语音 SDKInstall the Speech SDK

若要安装适用于 Unity 的语音 SDK，请执行以下步骤：To install the Speech SDK for Unity, follow these steps:

1. 下载并打开适用于 Unity 的语音 SDK，该程序打包为 Unity 资产包 (.unitypackage)，应该已经与 Unity 关联。Download and open the Speech SDK for Unity, which is packaged as a Unity asset package (.unitypackage), and should already be associated with Unity. 打开资产包后，会显示“导入 Unity 包”对话框。When the asset package is opened, the Import Unity Package dialog box appears. 可能需要创建并打开一个空项目才能使用此步骤。You may need to create and open an empty project for this step to work.

   

2. 确保选择所有文件，然后选择“导入”。Ensure that all files are selected, and select Import. 片刻之后，Unity 资产包即会导入到项目中。After a few moments, the Unity asset package is imported into your project.

有关将资产包导入 Unity 的详细信息，请参阅 Unity 文档。For more information about importing asset packages into Unity, see the Unity documentation.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 C# 通用 Windows 平台 (UWP) 的语音 SDK。This guide shows how to install the Speech SDK for C# Universal Windows Platform (UWP). 如果只是需要包名称以便自行开始，请在 NuGet 控制台中运行 Install-Package Microsoft.CognitiveServices.Speech。If you just want the package name to get started on your own, run Install-Package Microsoft.CognitiveServices.Speech in the NuGet console.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• Visual Studio 2019（版本不限）Visual Studio 2019 (any edition)
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

创建 Visual Studio 项目并安装语音 SDKCreate a Visual Studio project and install the Speech SDK

若要创建 Visual Studio 项目以用于通用 Windows 平台 (UWP) 开发，需要设置 Visual Studio 开发选项，创建项目，选择目标体系结构，设置音频捕获，然后安装语音 SDK。To create a Visual Studio project for Universal Windows Platform (UWP) development, you need to set up Visual Studio development options, create the project, select the target architecture, set up audio capture, and install the Speech SDK.

设置 Visual Studio 开发选项Set up Visual Studio development options

若要开始，请确保已在 Visual Studio 中正确设置以用于 UWP 开发：To start, make sure you're set up correctly in Visual Studio for UWP development:

1. 打开 Visual Studio 2019 以显示“开始” 窗口。Open Visual Studio 2019 to display the Start window.

   

2. 选择“继续但无需代码” ，转到 Visual Studio IDE。Select Continue without code to go to the Visual Studio IDE.

3. 在 Visual Studio 菜单栏中，选择“工具” > “获取工具和功能” 以打开 Visual Studio 安装程序并查看“修改” 对话框。From the Visual Studio menu bar, select Tools > Get Tools and Features to open Visual Studio Installer and view the Modifying dialog box.

   

4. 在“工作负载” 选项卡的“Windows” 下，找到“通用 Windows 平台开发” 工作负载。In the Workloads tab, under Windows, find the Universal Windows Platform development workload. 如果已选中该工作负载旁的复选框，请关闭“修改” 对话框，然后转到步骤 6。If the check box next to that workload is already selected, close the Modifying dialog box, and go to step 6.

5. 选中“通用 Windows 平台开发” 复选框，选择“修改” ，然后在“在开始之前” 对话框中，选择“继续” 以安装 UWP 开发工作负载。Select the Universal Windows Platform development check box, select Modify, and then in the Before we get started dialog box, select Continue to install the UWP development workload. 安装新功能可能花费一些时间。Installation of the new feature may take a while.

6. 关闭 Visual Studio 安装程序。Close Visual Studio Installer.

创建项目并选择目标体系结构Create the project and select the target architecture

接下来，创建项目：Next, create your project:

1. 在 Visual Studio 菜单栏中，选择“文件” > “新建” > “项目” 以显示“创建新项目” 窗口。In the Visual Studio menu bar, choose File > New > Project to display the Create a new project window.

   

2. 查找并选择“空白应用(通用 Windows)”。Find and select Blank App (Universal Windows). 确保选择此项目类型的 C# 版本（而不是 Visual Basic）。Make sure that you select the C# version of this project type (as opposed to Visual Basic).

3. 选择“下一步” 以显示“配置新项目” 屏幕。Select Next to display the Configure your new project screen.

   

4. 在“项目名称” 中输入 helloworld。In Project name, enter helloworld.

5. 在“位置” 中，导航到并选择或创建用于保存项目的文件夹。In Location, navigate to and select or create the folder to save your project in.

6. 选择“创建” 以转到“新建通用 Windows 平台项目” 窗口。Select Create to go to the New Universal Windows Platform Project window.

   

7. 在“最低版本” （第二个下拉框）中，选择“Windows 10 Fall Creators Update (10.0；内部版本 16299)” ，这是语音 SDK 的最低要求。In Minimum version (the second drop-down box), choose Windows 10 Fall Creators Update (10.0; Build 16299), which is the minimum requirement for the Speech SDK.

8. 在“目标版本” （第一个下拉框）中，选择与“最低版本” 中的值相等或更高的值。In Target version (the first drop-down box), choose a value identical to or later than the value in Minimum version.

9. 选择“确定” 。Select OK. 返回到 Visual Studio IDE，其中新项目已创建并显示在“解决方案资源管理器 ”窗格中。You're returned to the Visual Studio IDE, with the new project created and visible in the Solution Explorer pane.

   

现在选择目标平台体系结构。Now select your target platform architecture. 在 Visual Studio 工具栏中，找到“解决方案平台” 下拉框。In the Visual Studio toolbar, find the Solution Platforms drop-down box. （如果找不到，请选择“查看” > “工具栏” > “标准” 以显示包含“解决方案平台”的工具栏 。）如果运行的是 64 位 Windows，请在下拉框中选择“x64” 。(If you don't see it, choose View > Toolbars > Standard to display the toolbar containing Solution Platforms.) If you're running 64-bit Windows, choose x64 in the drop-down box. 64 位 Windows 也可以运行 32 位应用程序，因此可以根据自己的偏好选择“x86” 。64-bit Windows can also run 32-bit applications, so you can choose x86 if you prefer.

设置音频捕获Set up audio capture

允许项目捕获音频输入：Allow the project to capture audio input:

1. 在“解决方案资源管理器”中，双击“Package.appxmanifest”，以打开包应用程序清单。In Solution Explorer, double-click Package.appxmanifest to open the package application manifest.

2. 选择“功能”选项卡。Select the Capabilities tab.

   

3. 选中“麦克风”功能对应的框。Select the box for the Microphone capability.

4. 在菜单栏中，选择“文件” > “保存 Package.appxmanifest”以保存所做的更改。From the menu bar, choose File > Save Package.appxmanifest to save your changes.

安装语音 SDKInstall the Speech SDK

最后，安装语音 SDK NuGet 包，并在项目中引用语音 SDK：Finally, install the Speech SDK NuGet package, and reference the Speech SDK in your project:

1. 在“解决方案资源管理器”中，右键单击你的解决方案，然后选择“管理解决方案的 NuGet 包”以转到“NuGet - 解决方案”窗口。In Solution Explorer, right-click your solution, and choose Manage NuGet Packages for Solution to go to the NuGet - Solution window.

2. 选择“浏览”。Select Browse.

   

3. 在“包源”中，选择“nuget.org”。In Package source, choose nuget.org.

4. 在“搜索”框中，输入 Microsoft.CognitiveServices.Speech，然后在该包显示在搜索结果中之后选择该包。In the Search box, enter Microsoft.CognitiveServices.Speech, and then choose that package after it appears in the search results.

   

5. 在搜索结果旁的“包状态”窗格中，选择“helloworld”项目。In the package status pane next to the search results, select your helloworld project.

6. 选择“安装”。Select Install.

7. 在“预览更改”对话框中，选择“确定”。In the Preview Changes dialog box, select OK.

8. 在“接受许可证”对话框中，查看许可证，然后选择“我接受”。In the License Acceptance dialog box, view the license, and then select I Accept. 包安装开始，安装完成后，“输出”窗格将显示类似于以下文本的消息：Successfully installed 'Microsoft.CognitiveServices.Speech 1.13.0' to helloworld。The package installation begins, and when installation is complete, the Output pane displays a message similar to the following text: Successfully installed 'Microsoft.CognitiveServices.Speech 1.13.0' to helloworld.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 Xamarin 的语音 SDK，这是一种开源平台，用于为装有 .NET 的 iOS、Android 和 Windows 构建现代的高性能应用程序。This guide shows how to install the Speech SDK for Xamarin, an open-source platform for building modern and performant applications for iOS, Android, and Windows with .NET. 如果只是需要包名称以便自行开始，请在 NuGet 控制台中运行 Install-Package Microsoft.CognitiveServices.Speech。If you just want the package name to get started on your own, run Install-Package Microsoft.CognitiveServices.Speech in the NuGet console.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• Visual Studio 2019Visual Studio 2019
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

创建 Visual Studio 项目并安装语音 SDKCreate a Visual Studio project and install the Speech SDK

若要创建 Visual Studio 项目，以便使用 Xamarin 进行跨平台移动应用 .NET 开发，需要：To create a Visual Studio project for cross-platform mobile app .NET development with Xamarin, you need to:

• 设置 Visual Studio 开发选项。Set up Visual Studio development options.
• 创建项目并选择目标体系结构。Create the project and select the target architecture.
• 安装语音 SDK。Install the Speech SDK.

设置 Visual Studio 开发选项Set up Visual Studio development options

若要开始，请确保已在 Visual Studio 中正确进行设置，以便使用 .NET 进行跨平台移动开发：To start, make sure you're set up correctly in Visual Studio for cross-platform mobile development with .NET:

1. 打开 Visual Studio 2019。Open Visual Studio 2019.

2. 在 Visual Studio 菜单栏中，选择“工具” > “获取工具和功能” 以打开 Visual Studio 安装程序并查看“修改” 对话框。From the Visual Studio menu bar, select Tools > Get Tools and Features to open Visual Studio Installer and view the Modifying dialog box.

   

3. 在“工作负荷” 选项卡的“Windows” 下，找到“使用 .NET 的移动开发”工作负荷 。On the Workloads tab, under Windows, find the Mobile development with .NET workload. 如果已选中该工作负荷旁的复选框，请关闭“修改” 对话框，然后转到步骤 5。If the check box next to that workload is already selected, close the Modifying dialog box, and go to step 5.

4. 选中“使用 .NET 的移动开发” 复选框，然后选择“修改”。 Select the Mobile development with .NET check box, and select Modify. 在“准备工作”对话框中，选择“继续”以安装使用 .NET 的移动开发工作负荷。 In the Before we get started dialog box, select Continue to install the mobile development with .NET workload. 安装新功能可能花费一些时间。Installation of the new feature might take a while.

5. 关闭 Visual Studio 安装程序。Close Visual Studio Installer.

创建项目Create the project

1. 在 Visual Studio 菜单栏中，选择“文件” > “新建” > “项目” 以显示“创建新项目” 窗口。On the Visual Studio menu bar, select File > New > Project to display the Create a new project window.

   

2. 找到并选择“移动应用(Xamarin.Forms)” 。Find and select Mobile App (Xamarin.Forms).

3. 选择“下一步” 以显示“配置新项目” 屏幕。Select Next to display the Configure your new project screen.

   

4. 在“项目名称”中，输入 helloworld 。In Project name, enter helloworld.

5. 在“位置” 中，转到并选择或创建用于保存项目的文件夹。In Location, go to and select or create the folder to save your project in.

6. 选择“创建” 以转到“新建移动应用 Xamarin Forms 项目” 窗口。Select Create to go to the New Mobile App Xamarin Forms Project window.

   

7. 选择“空白”模板。 Select the Blank template.

8. 在“平台”中， 选择 Android、iOS 和 Windows (UWP) 对应的框。In Platform, select the boxes for Android, iOS, and Windows (UWP).

9. 选择“确定” 。Select OK. 返回到 Visual Studio IDE，其中新项目已创建并显示在“解决方案资源管理器 ”窗格中。You're returned to the Visual Studio IDE, with the new project created and visible in the Solution Explorer pane.

   

现在选择目标平台体系结构和启动项目。Now select your target platform architecture and startup project. 在 Visual Studio 工具栏中，找到“解决方案平台” 下拉框。On the Visual Studio toolbar, find the Solution Platforms drop-down box. （如果找不到，请选择“查看” > “工具栏” > “标准” 以显示包含“解决方案平台”的工具栏 。）如果运行的是 64 位 Windows，请在下拉框中选择“x64” 。(If you don't see it, select View > Toolbars > Standard to display the toolbar that contains Solution Platforms.) If you're running 64-bit Windows, select x64 in the drop-down box. 64 位 Windows 也可以运行 32 位应用程序，因此可以根据需要选择“x86” 。You can select x86 if you want because 64-bit Windows also can run 32-bit applications. 在“启动项目”下拉框中， 设置“helloworld.UWP (通用 Windows)”。 In the Start-up Projects drop-down box, set helloworld.UWP (Universal Windows).

安装语音 SDKInstall the Speech SDK

安装语音 SDK NuGet 包，并在项目中引用语音 SDK。Install the Speech SDK NuGet package, and reference the Speech SDK in your project.

1. 在解决方案资源管理器中，右键单击解决方案。In Solution Explorer, right-click your solution. 选择“管理解决方案的 NuGet 包” ，转到“NuGet - 解决方案”窗口。 Select Manage NuGet Packages for Solution to go to the NuGet - Solution window.

2. 选择“浏览” 。Select Browse.

   

3. 在“包源” 中，选择“nuget.org”。In Package source, select nuget.org.

4. 在“搜索”框中，输入 Microsoft.CognitiveServices.Speech。 In the Search box, enter Microsoft.CognitiveServices.Speech. 然后在该包显示在搜索结果中之后选择该包。Then select that package after it appears in the search results.

   

   备注

   Microsoft.CognitiveServices.Speech NuGet 中的 iOS 库未启用 Bitcode。The iOS library inside Microsoft.CognitiveServices.Speech NuGet doesn't have bitcode enabled. 如果需要为应用程序启用 Bitcode 库，请专门使用 iOS 项目的 Microsoft.CognitiveServices.Speech.Xamarin.iOS NuGet。If you need the bitcode library enabled for your application, use Microsoft.CognitiveServices.Speech.Xamarin.iOS NuGet for the iOS project specifically.

5. 在搜索结果旁的“包状态”窗格中，选择所有项目：helloworld、helloworld.Android、helloworld.iOS 和 helloworld.UWP。In the package status pane next to the search results, select all projects: helloworld, helloworld.Android, helloworld.iOS, and helloworld.UWP.

6. 选择“安装” 。Select Install.

7. 在“预览更改” 对话框中，选择“确定” 。In the Preview Changes dialog box, select OK.

8. 在“接受许可证” 对话框中，查看许可证，然后选择“我接受” 。In the License Acceptance dialog box, view the license, and then select I Accept. 安装所有项目的语音 SDK 包引用。Install the Speech SDK package reference to all projects. 安装成功完成后，可能会看到下述针对 helloworld.iOS 的警告。After installation is completed successfully, you might see the following warning for helloworld.iOS. 这是已知问题，不会影响应用功能。This is a known issue and should not affect your app functionality.

   不能解析引用“C:\Users\Default.nuget\packages\microsoft.cognitiveservices.speech\1.7.0\build\Xamarin.iOS\libMicrosoft.CognitiveServices.Speech.core.a”。Could not resolve reference "C:\Users\Default.nuget\packages\microsoft.cognitiveservices.speech\1.7.0\build\Xamarin.iOS\libMicrosoft.CognitiveServices.Speech.core.a". 如果此引用是代码所需的，则可能会出现编译错误。If this reference is required by your code, you may get compilation errors.

语音 SDK 现已安装。The Speech SDK is now installed. 现在可以删除或重复使用在前面的步骤中创建的“helloworld”项目。You may now delete or re-use the "helloworld" project you created in the previous steps.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 Linux 的语音 SDKThis guide shows how to install the Speech SDK for Linux

系统要求System requirements

Linux（Ubuntu 16.04、Ubuntu 18.04、Debian 9、RHEL 7/8、CentOS 7/8）Linux (Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8)

先决条件Prerequisites

若要完成本快速入门，你需要：To complete this quickstart, you'll need:

• Visual Studio 2019Visual Studio 2019

• 支持的 Linux 平台会要求安装某些库（要求安装 libssl 以获取安全套接字层支持；要求安装 libasound2 以获取声音支持）。Supported Linux platforms will require certain libraries installed (libssl for secure sockets layer support and libasound2 for sound support). 请参阅下面的发行版，了解安装这些库的正确版本所需的命令。Refer to your distribution below for the commands needed to install the correct versions of these libraries.

  • 在 Ubuntu 上：On Ubuntu:

    sudo apt-get update
    sudo apt-get install build-essential libssl1.0.0 libasound2 wget
    

  • 在 Debian 9 上：On Debian 9:

    sudo apt-get update
    sudo apt-get install build-essential libssl1.0.2 libasound2 wget
    

  • 在 RHEL/CentOS 上：On RHEL/CentOS:

    sudo yum update
    sudo yum groupinstall "Development tools"
    sudo yum install alsa-lib openssl wget
    

安装语音 SDKInstall Speech SDK

适用于 Linux 的语音 SDK 可用于构建 64 位和 32 位应用程序。The Speech SDK for Linux can be used to build both 64-bit and 32-bit applications. 可以从 https://aka.ms/csspeech/linuxbinary 以 tar 文件格式下载必需的库和头文件。The required libraries and header files can be downloaded as a tar file from https://aka.ms/csspeech/linuxbinary.

下载并安装 SDK，如下所示：Download and install the SDK as follows:

1. 选择应将语音 SDK 文件提取到的目录，然后将 SPEECHSDK_ROOT 环境变量设置为指向该目录。Choose a directory to which the Speech SDK files should be extracted, and set the SPEECHSDK_ROOT environment variable to point to that directory. 使用此变量，在将来的命令中可以轻松引用目录。This variable makes it easy to refer to the directory in future commands. 例如，如果要使用主目录中的 speechsdk 目录，请使用如下所示的命令：For example, if you want to use the directory speechsdk in your home directory, use a command like the following:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. 如果该目录尚不存在，请创建该目录。Create the directory if it doesn't exist yet.

   mkdir -p "$SPEECHSDK_ROOT"
   

3. 下载并提取包含语音 SDK 二进制文件的 .tar.gz 存档：Download and extract the .tar.gz archive containing the Speech SDK binaries:

   wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary
   tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
   

4. 验证所提取的程序包的顶级目录的内容：Validate the contents of the top-level directory of the extracted package:

   ls -l "$SPEECHSDK_ROOT"
   

   目录列表应当包含第三方通告和许可证文件，以及一个包含头文件 (.h) 的 include 目录和一个包含库的 lib 目录。The directory listing should contain the third-party notice and license files, as well as an include directory containing header (.h) files and a lib directory containing libraries.

   路径Path	说明Description
   license.md	许可License
   ThirdPartyNotices.md	第三方声明。Third-party notices.
   REDIST.txt	再分发声明。Redistribution notice.
   include	C 和 C++ 必需的头文件The required header files for C and C++
   lib/x64	x64 必需的用来链接应用程序的本机库Native library for x64 required to link your application
   lib/x86	x86 必需的用来链接应用程序的本机库Native library for x86 required to link your application

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 macOS 10.13 及更高版本上的 C++ 的语音 SDK。This guide shows how to install the Speech SDK for C++ on macOS 10.13 and above.

系统要求System requirements

macOS 10.13 及更高版本macOS 10.13 and above

安装语音 SDKInstall Speech SDK

1. 选择应将语音 SDK 文件提取到的目录，然后将 SPEECHSDK_ROOT 环境变量设置为指向该目录。Choose a directory to which the Speech SDK files should be extracted, and set the SPEECHSDK_ROOT environment variable to point to that directory. 使用此变量，在将来的命令中可以轻松引用目录。This variable makes it easy to refer to the directory in future commands. 例如，如果要使用主目录中的 speechsdk 目录，请使用如下所示的命令：For example, if you want to use the directory speechsdk in your home directory, use a command like the following:

   export SPEECHSDK_ROOT="$HOME/speechsdk"
   

2. 如果该目录尚不存在，请创建该目录。Create the directory if it doesn't exist yet.

   mkdir -p "$SPEECHSDK_ROOT"
   

3. 下载并提取包含语音 SDK 框架的 .zip 存档：Download and extract the .zip archive containing the Speech SDK framework:

   wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
   unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
   

4. 验证所提取的程序包的顶级目录的内容：Validate the contents of the top-level directory of the extracted package:

   ls -l "$SPEECHSDK_ROOT"
   

   目录列表应包含第三方声明和许可证文件，以及 MicrosoftCognitiveServicesSpeech.framework 目录。The directory listing should contain the third-party notice and license files, as well as a MicrosoftCognitiveServicesSpeech.framework directory.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装适用于 Windows 桌面上的 C++ 的语音 SDK。This guide shows how to install the Speech SDK for C++ on Windows Desktop.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• Visual Studio 2019Visual Studio 2019
• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

创建 Visual Studio 项目并安装语音 SDKCreate a Visual Studio project and install the Speech SDK

若要创建 Visual Studio 项目以用于 C++ 桌面开发，需要设置 Visual Studio 开发选项，创建项目，选择目标体系结构，然后安装语音 SDK。To create a Visual Studio project for C++ desktop development, you need to set up Visual Studio development options, create the project, select the target architecture, and install the Speech SDK.

设置 Visual Studio 开发选项Set up Visual Studio development options

若要开始，请确保已在 Visual Studio 中正确设置以用于 C++ 桌面开发：To start, make sure you're set up correctly in Visual Studio for C++ desktop development:

1. 打开 Visual Studio 2019 以显示“开始” 窗口。Open Visual Studio 2019 to display the Start window.

   

2. 选择“继续但无需代码” ，转到 Visual Studio IDE。Select Continue without code to go to the Visual Studio IDE.

3. 在 Visual Studio 菜单栏中，选择“工具” > “获取工具和功能” 以打开 Visual Studio 安装程序并查看“修改” 对话框。From the Visual Studio menu bar, select Tools > Get Tools and Features to open Visual Studio Installer and view the Modifying dialog box.

   

4. 在“工作负载” 选项卡的“Windows” 下，找到“使用 C++ 的桌面开发”工作负载 。In the Workloads tab, under Windows, find the Desktop development with C++ workload. 如果尚未选择该工作负载旁边的复选框，请选中。If the check box next to that workload isn't already selected, select it.

5. 在“单个组件”选项卡中，找到“NuGet 包管理器”复选框。In the Individual components tab, find the NuGet package manager check box. 如果尚未选中此复选框，请选中。If the check box isn't already selected, select it.

6. 选择角上的标签为“关闭” 或“修改” 的按钮。Select the button in the corner labeled either Close or Modify. （按钮名称会有所不同，具体取决于你是否选择了任何功能以进行安装。）如果选择“修改” ，将开始安装，这可能需要一段时间。(The button name varies depending on whether you selected any features for installation.) If you select Modify, installation begins, which may take a while.

7. 关闭 Visual Studio 安装程序。Close Visual Studio Installer.

创建项目并选择目标体系结构Create the project and select the target architecture

接下来，创建项目：Next, create your project:

1. 在 Visual Studio 菜单栏中，选择“文件” > “新建” > “项目” 以显示“创建新项目” 窗口。In the Visual Studio menu bar, choose File > New > Project to display the Create a new project window.

   

2. 找到“控制台应用”并将其选中 。Find and select Console App. 确保选择此项目类型的 C++ 版本（而不是 C# 或 Visual Basic）。Make sure that you select the C++ version of this project type (as opposed to C# or Visual Basic).

3. 选择“下一步” 以显示“配置新项目” 屏幕。Select Next to display the Configure your new project screen.

   

4. 在“项目名称” 中输入 helloworld。In Project name, enter helloworld.

5. 在“位置” 中，导航到并选择或创建用于保存项目的文件夹。In Location, navigate to and select or create the folder to save your project in.

现在选择目标平台体系结构。Now select your target platform architecture. 在 Visual Studio 工具栏中，找到“解决方案平台” 下拉框。In the Visual Studio toolbar, find the Solution Platforms drop-down box. （如果找不到，请选择“查看” > “工具栏” > “标准” 以显示包含“解决方案平台”的工具栏 。）如果运行的是 64 位 Windows，请在下拉框中选择“x64” 。(If you don't see it, choose View > Toolbars > Standard to display the toolbar containing Solution Platforms.) If you're running 64-bit Windows, choose x64 in the drop-down box. 64 位 Windows 也可以运行 32 位应用程序，因此可以根据自己的偏好选择“x86” 。64-bit Windows can also run 32-bit applications, so you can choose x86 if you prefer.

安装语音 SDKInstall the Speech SDK

最后，安装语音 SDK NuGet 包，并在项目中引用语音 SDK：Finally, install the Speech SDK NuGet package, and reference the Speech SDK in your project:

1. 在“解决方案资源管理器”中，右键单击你的解决方案，然后选择“管理解决方案的 NuGet 包”以转到“NuGet - 解决方案”窗口。In Solution Explorer, right-click your solution, and choose Manage NuGet Packages for Solution to go to the NuGet - Solution window.

2. 选择“浏览” 。Select Browse.

   

3. 在“包源” 中，选择“nuget.org” 。In Package source, choose nuget.org.

4. 在“搜索” 框中，输入 Microsoft.CognitiveServices.Speech，然后在该包显示在搜索结果中之后选择该包。In the Search box, enter Microsoft.CognitiveServices.Speech, and then choose that package after it appears in the search results.

   

5. 在搜索结果旁的“包状态”窗格中，选择“helloworld” 项目。In the package status pane next to the search results, select your helloworld project.

6. 选择“安装” 。Select Install.

7. 在“预览更改” 对话框中，选择“确定” 。In the Preview Changes dialog box, select OK.

8. 在“接受许可证” 对话框中，查看许可证，然后选择“我接受” 。In the License Acceptance dialog box, view the license, and then select I Accept. 包安装开始，安装完成后，“输出” 窗格将显示类似于以下文本的消息：Successfully installed 'Microsoft.CognitiveServices.Speech 1.13.0' to helloworld。The package installation begins, and when installation is complete, the Output pane displays a message similar to the following text: Successfully installed 'Microsoft.CognitiveServices.Speech 1.13.0' to helloworld.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 64 位 Java 8 JRE 的语音 SDK。This guide shows how to install the Speech SDK for 64-bit Java 8 JRE. 如果只是需要包名称以便自行开始，那么请知悉在 Maven 中央存储库中未提供 Java SDK。If you just want the package name to get started on your own, the Java SDK is not available in the Maven central repository. 无论是使用 Gradle 还是 pom.xml 依赖项文件，都需要添加指向 https://csspeechstorage.blob.core.windows.net/maven/ 的自定义存储库（请参阅下文了解包名称）。Whether you're using Gradle or a pom.xml dependency file, you need to add a custom repository pointing to https://csspeechstorage.blob.core.windows.net/maven/ (see below for package name).

支持的操作系统Supported operating systems

• Java 语音 SDK 包适用于以下操作系统：The Java Speech SDK package is available for these operating systems:
  • Windows：仅 64 位Windows: 64-bit only
  • Mac：macOS X 10.13 或更高版本Mac: macOS X version 10.13 or later
  • Linux：仅 64 位的 Ubuntu 16.04、Ubuntu 18.04、Debian 9、RHEL 7/8、CentOS 7/8Linux: 64-bit only on Ubuntu 16.04, Ubuntu 18.04, Debian 9, RHEL 7/8, CentOS 7/8

先决条件Prerequisites

• Java 8 或 JDK 8Java 8 or JDK 8

• Eclipse Java IDE（要求已安装 Java）Eclipse Java IDE (requires Java already installed)

• 需要语音 SDK 版本 1.11.0 或更高版本。Speech SDK version 1.11.0 or later is required.

• 支持的 Linux 平台会要求安装某些库（要求安装 libssl 以获取安全套接字层支持；要求安装 libasound2 以获取声音支持）。Supported Linux platforms will require certain libraries installed (libssl for secure sockets layer support and libasound2 for sound support). 请参阅下面的发行版，了解安装这些库的正确版本所需的命令。Refer to your distribution below for the commands needed to install the correct versions of these libraries.

  • 在 Ubuntu 上，请运行以下命令来安装所需的包：On Ubuntu, run the following commands to install the required packages:

    sudo apt-get update
    sudo apt-get install build-essential libssl1.0.0 libasound2
    

  • 在 Debian 9 上，请运行以下命令来安装所需的包：On Debian 9, run the following commands to install the required packages:

    sudo apt-get update
    sudo apt-get install build-essential libssl1.0.2 libasound2
    

  • 在 RHEL/CentOS 上，请运行以下命令来安装所需的包：On RHEL/CentOS, run the following commands to install the required packages:

    sudo yum update
    sudo yum install alsa-lib java-1.8.0-openjdk-devel openssl
    

• 在 Windows 上，需要安装适用于平台的 Microsoft Visual C++ Redistributable for Visual Studio 2019。On Windows, you need the Microsoft Visual C++ Redistributable for Visual Studio 2019 for your platform. 请注意，首次安装它时，可能需要重启 Windows 才能继续使用本指南。Note that installing this for the first time may require you to restart Windows before continuing with this guide.

创建 Eclipse 项目并安装语音 SDKCreate an Eclipse project and install the Speech SDK

1. 启动 Eclipse。Start Eclipse.

2. 在 Eclipse Launcher 中，在“工作区”字段中输入某个新工作区目录的名称。In the Eclipse Launcher, in the Workspace field, enter the name of a new workspace directory. 然后选择“启动”。Then select Launch.

   

3. 片刻之后，Eclipse IDE 的主窗口将会显示。In a moment, the main window of the Eclipse IDE appears. 关闭欢迎屏幕（如果存在）。Close the Welcome screen if one is present.

4. 从 Eclipse 菜单栏上，通过选择“文件” > “新建” > “项目”创建一个新项目。From the Eclipse menu bar, create a new project by choosing File > New > Project.

5. 将显示“新建项目”对话框。The New Project dialog box appears. 选择“Java 项目”，然后选择“下一步”。Select Java Project, and select Next.

   

6. 此时将启动“新建 Java 项目”向导。The New Java Project wizard starts. 在“项目名称”字段中，输入 quickstart，然后选择 JavaSE 1.8 作为执行环境。In the Project name field, enter quickstart, and choose JavaSE-1.8 as the execution environment. 选择“完成”。Select Finish.

   

7. 如果出现了“打开关联的透视图?”窗口，请选择“打开透视图”。If the Open Associated Perspective? window appears, select Open Perspective.

8. 在包资源管理器中，右键单击 quickstart 项目。In the Package explorer, right-click the quickstart project. 从上下文菜单中选择“配置” > “转换为 Maven 项目”。Choose Configure > Convert to Maven Project from the context menu.

   

9. 此时将显示“新建 POM”窗口。The Create new POM window appears. 在“组 ID”字段中输入 com.microsoft.cognitiveservices.speech.samples，然后在“项目 ID”字段中输入 quickstart。In the Group Id field, enter com.microsoft.cognitiveservices.speech.samples, and in the Artifact Id field, enter quickstart. 然后选择“完成”。Then select Finish.

   

10. 打开 pom.xml 文件并对其进行编辑。Open the pom.xml file and edit it.

    • 在文件末尾，在结束标记 </project> 前面，创建一个 repositories 元素，使其中包含对语音 SDK 的 Maven 存储库的引用，如下所示：At the end of the file, before the closing tag </project>, create a repositories element with a reference to the Maven repository for the Speech SDK, as shown here:

    <repositories>
      <repository>
        <id>maven-cognitiveservices-speech</id>
        <name>Microsoft Cognitive Services Speech Maven Repository</name>
        <url>https://csspeechstorage.blob.core.windows.net/maven/</url>
      </repository>
    </repositories>
    

    • 此外，还添加一个 dependencies 元素（使用语音 SDK 版本 1.13.0 作为依赖项）：Also add a dependencies element, with the Speech SDK version 1.13.0 as a dependency:

    <dependencies>
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.7.0</version>
      </dependency>
    </dependencies>
    

    • 保存更改。Save the changes.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装用于 Java on Android 的语音 SDK。This guide shows how to install the Speech SDK for Java on Android. 该安装基于语音 SDK Maven 包和 Android Studio 3.3。The setup is based on the Speech SDK Maven Package, and Android Studio 3.3.

支持的平台Supported platforms

语音 SDK 与具有 32/64 位 ARM 和 Intel x86/x64 兼容处理器的 Android 设备兼容。The Speech SDK is compatible with Android devices having 32/64-bit ARM and Intel x86/x64 compatible processors.

使用 Android Studio 安装语音 SDKInstall the Speech SDK using Android Studio

1. 启动 Android Studio，然后在“欢迎”窗口中选择“启动新的 Android Studio 项目”。Launch Android Studio, and select Start a new Android Studio project in the Welcome window.

   

2. 此时会显示“选择项目”向导。The Choose your project wizard appears. 在活动选择框中选择“手机和平板电脑” 以及“空活动”。Select Phone and Tablet and Empty Activity in the activity selection box. 选择“下一页”。Select Next.

   

3. 在“配置项目”屏幕上，输入“Quickstart”作为名称，输入“samples.speech.cognitiveservices.microsoft.com”作为包名称，。On the Configure your project screen, enter Quickstart as Name and enter samples.speech.cognitiveservices.microsoft.com as Package name. 然后选择项目目录。Then select a project directory. 对于最低 API 级别，选择“API 23: Android 6.0 (Marshmallow)”。For Minimum API level, select API 23: Android 6.0 (Marshmallow). 清除所有其他的复选框，然后选择“完成”。Leave all other check boxes clear, and select Finish.

   

Android Studio 需要一定的时间来准备你的新 Android 项目。Android Studio takes a moment to prepare your new Android project. 接下来对项目进行配置，以便了解 Azure 认知服务语音 SDK 并使用 Java 8。Next, configure the project to know about the Azure Cognitive Services Speech SDK and to use Java 8.

认知服务语音 SDK 的当前版本是 1.13.0。The current version of the Cognitive Services Speech SDK is 1.13.0.

将适用于 Android 的语音 SDK 打包为 AAR（Android 库），其内附必要的库以及所需的 Android 权限。The Speech SDK for Android is packaged as an AAR (Android Library), which includes the necessary libraries and required Android permissions. 它托管在位于 https://csspeechstorage.blob.core.windows.net/maven/ 处的 Maven 存储库中。It's hosted in a Maven repository at https://csspeechstorage.blob.core.windows.net/maven/.

设置项目以使用语音 SDK。Set up your project to use the Speech SDK. 打开“项目结构”窗口，方法是从 Android Studio 菜单栏中选择“文件” > “项目结构”。Open the Project Structure window by selecting File > Project Structure from the Android Studio menu bar. 在“项目结构”窗口中进行以下更改：In the Project Structure window, make the following changes:

1. 在窗口左侧的列表中，选择“项目”。In the list on the left side of the window, select Project. 编辑“默认库存储库”设置，方法是附加逗号和用单引号引起来的 Maven 存储库 URL：'https://csspeechstorage.blob.core.windows.net/maven/'Edit the Default Library Repository settings by appending a comma and our Maven repository URL enclosed in single quotation marks: 'https://csspeechstorage.blob.core.windows.net/maven/'

   

2. 在同一屏幕的左侧选择“应用”。On the same screen, on the left side, select app. 然后在窗口顶部选择“依赖项”选项卡。Then select the Dependencies tab at the top of the window. 选择绿色加号 ( + )，然后从下拉菜单中选择“库依赖项”。Select the green plus sign (+), and select Library dependency from the drop-down menu.

   

3. 在出现的窗口中，输入适用于 Android 的语音 SDK 的名称和版本：com.microsoft.cognitiveservices.speech:client-sdk:1.13.0。In the window that appears, enter the name and version of the Speech SDK for Android, com.microsoft.cognitiveservices.speech:client-sdk:1.13.0. 然后选择“确定”。Then select OK. 现应将语音 SDK 添加到依赖项列表中，如下所示：The Speech SDK should be added to the list of dependencies now, as shown:

   

4. 选择“属性”选项卡。对于“源兼容性”和“目标兼容性”都选择“1.9” 。Select the Properties tab. For both Source Compatibility and Target Compatibility, select 1.9.

   

5. 选择“确定”，关闭“项目结构”窗口并应用对项目所做的更改。Select OK to close the Project Structure window and apply your changes to the project.

现在可以继续完成下面的后续步骤。You can now move on to Next steps below.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装可以在网页中使用的 JavaScript 版语音 SDK。This guide shows how to install the Speech SDK for JavaScript for use with a web page.

新建网站文件夹Create a new Website folder

新建空文件夹。Create a new, empty folder. 如果要在 web 服务器上承载示例，请确保 web 服务器可访问文件夹。In case you want to host the sample on a web server, make sure that the web server can access the folder.

将 JavaScript 的语音 SDK 解压缩到文件夹Unpack the Speech SDK for JavaScript into that folder

将语音 SDK 作为 .zip 包下载，并将其解压缩到新建文件夹。Download the Speech SDK as a .zip package and unpack it into the newly created folder. 这会导致以下五个文件被解压缩：This results in five files being unpacked:

• microsoft.cognitiveservices.speech.sdk.bundle.js 人工可读的语音 SDK 版本。microsoft.cognitiveservices.speech.sdk.bundle.js A human readable version of the Speech SDK.
• microsoft.cognitiveservices.speech.sdk.bundle.js.map 用于调试 SDK 代码的映射文件。microsoft.cognitiveservices.speech.sdk.bundle.js.map A map file used for debugging SDK code.
• microsoft.cognitiveservices.speech.sdk.bundle.d.ts 用于 TypeScript 的对象定义microsoft.cognitiveservices.speech.sdk.bundle.d.ts Object definitions for use with TypeScript
• microsoft.cognitiveservices.speech.sdk.bundle-min.js 语音 SDK 的简化版。microsoft.cognitiveservices.speech.sdk.bundle-min.js A minified version of the Speech SDK.
• speech-processor.js 用于提高某些浏览器性能的代码。speech-processor.js Code to improve performance on some browsers.

创建 index.html 页面Create an index.html page

在文件夹中创建名为 index.html 的新文件，使用文本编辑器打开此文件。Create a new file in the folder, named index.html and open this file with a text editor.

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents

本指南介绍如何安装可以在 NodeJS 中使用的 JavaScript 版语音 SDK。This guide shows how to install the Speech SDK for JavaScript for use with NodeJS. 如果你只是需要包名称以便自行开始操作，请从现有项目运行 npm install microsoft-cognitiveservices-speech-sdk。If you just want the package name to get started on your own, run npm install microsoft-cognitiveservices-speech-sdk from your existing project.

先决条件Prerequisites

本快速入门需要：This quickstart requires:

• NodeJSNodeJS

创建新的 NPM 项目。Create a new NPM project.

创建一个新目录，运行 npm init 并浏览其提示。Create a new directory and run npm init and walk through its prompts.

添加语音 SDK 包Add the Speech SDK package

npm install microsoft-cognitiveservices-speech-sdk运行Run npm install microsoft-cognitiveservices-speech-sdk

后续步骤Next steps

• 快速入门：识别来自麦克风的语音Quickstart: Recognize speech from a microphone
• 快速入门：从文件中识别语音Quickstart: Recognize speech from a file
• 快速入门：识别来自 Azure Blob 的语音Quickstart: Recognize speech from an Azure Blob
• 快速入门：将语音转换为文本Quickstart: Translate speech-to-text
• 快速入门：将文本合成到音频设备Quickstart: Synthesize text to an audio device
• 快速入门：将文本合成到文件Quickstart: Synthesize text to a file
• 快速入门：识别意向Quickstart: Recognize Intents