Skip to content

Commit 3a4f49c

Browse files
megvanhuygenmegvanhuygen
authored
Merge pull request #109046 from IEvangelist/speechSdkRewrite
About the Speech SDK rewrite
2 parents 50c04ea + c8d54d9 commit 3a4f49c

20 files changed

+697
-218
lines changed

‎.openpublishing.redirection.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50553,6 +50553,10 @@
5055350553
"source_path": "articles/aks/use-cosmosdb-osba-mongo-app.md",
5055450554
"redirect_url": "/azure/aks/",
5055550555
"redirect_document_id": false
50556+
},
50557+
{
50558+
"source_path": "articles/cognitive-services/speech-service/ship-application.md",
50559+
"redirect_url": "/azure/cognitive-services/speech-service/speech-sdk"
5055650560
}
5055750561
]
5055850562
}

‎articles/cognitive-services/Speech-Service/get-started.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,12 @@ manager: nitinme
99
ms.service: cognitive-services
1010
ms.subservice: speech-service
1111
ms.topic: conceptual
12-
ms.date: 02/26/2020
12+
ms.date: 04/03/2020
1313
ms.author: erhopf
1414
ms.custom: seodec18, seo-javascript-october2019
1515
---
1616

17-
# Try the Speech service for free
17+
# Try the Speech service for free''
1818

1919
In this article, you choose an option to easily test the Speech service free of charge so you can discover what the service can do, and decide whether it's right for your needs. Choose one of the two following options depending on your situation and use-case:
2020

@@ -93,4 +93,4 @@ Complete one of our 10-minute quickstarts or check out our SDK samples:
9393

9494
> [!div class="nextstepaction"]
9595
> [Quickstart: Recognize speech in C#](~/articles/cognitive-services/Speech-Service/quickstarts/speech-to-text-from-microphone.md?pivots=programming-language-csharp&tabs=dotnet)
96-
> [Speech SDK samples](speech-sdk.md#get-the-samples)
96+
> [Speech SDK samples](speech-sdk.md#sample-source-code)

‎articles/cognitive-services/Speech-Service/how-to-migrate-from-bing-speech.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ manager: nitinme
99
ms.service: cognitive-services
1010
ms.subservice: speech-service
1111
ms.topic: conceptual
12-
ms.date: 03/17/2020
12+
ms.date: 04/03/2020
1313
ms.author: nitinme
1414

1515
# Customer intent: As a developer currently using the deprecated Bing Speech, I want to learn the differences between Bing Speech and the Speech service, so that I can migrate my application to the Speech service.
@@ -91,4 +91,4 @@ For Speech service, SDK, and API support, visit the Speech service [support page
9191
## See also
9292
* [Speech service release notes](releasenotes.md)
9393
* [What is the Speech service](overview.md)
94-
* [Speech service and Speech SDK documentation](speech-sdk.md#get-the-sdk)
94+
* [Speech service and Speech SDK documentation](speech-sdk.md#get-the-speech-sdk)

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-android.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
When developing for Android, there are two Speech SDKs available. The Java Speech SDK is available natively as an Android package, or the .NET Speech SDK could be used with **Xamarin.Android** as it implements .NET Standard 2.0.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="Android" src="https://docs.microsoft.com/media/logos/logo_android.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
# [Android Studio](#tab/android-studio)
22+
23+
[!INCLUDE [get-speech-sdk-dotnet](get-speech-sdk-java.md)]
24+
25+
# [Xamarin.Android](#tab/android-xamarin)
26+
27+
:::row:::
28+
:::column span="3":::
29+
Xamarin.Android exposes the complete Android SDK for .NET developers. Build fully native Android apps using C# or F# in Visual Studio. For more information, see <a href="https://docs.microsoft.com/xamarin/android/" target="_blank">Xamarin.Android <span class="docon docon-navigate-external x-hidden-focus"></span></a>
30+
:::column-end:::
31+
:::column:::
32+
<br>
33+
<div class="icon is-large">
34+
<img alt="Xamarin" src="https://docs.microsoft.com/media/logos/logo_xamarin.svg" width="60px">
35+
&nbsp; ❤️ &nbsp;
36+
<img alt="Android" src="https://docs.microsoft.com/media/logos/logo_android.svg" width="60px">
37+
</div>
38+
:::column-end:::
39+
:::row-end:::
40+
41+
[!INCLUDE [get-speech-sdk-dotnet](get-speech-sdk-dotnet.md)]
42+
43+
---

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-browser.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
The JavaScript Speech SDK is available as an npm package, see <a href="https://www.npmjs.com/package/microsoft-cognitiveservices-speech-sdk" target="_blank">microsoft-cognitiveservices-speech-sdk <span class="docon docon-navigate-external x-hidden-focus"></span></a> and it's companion GitHub repository <a href="https://github.com/Microsoft/cognitive-services-speech-sdk-js" target="_blank">cognitive-services-speech-sdk-js <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="JavaScript" src="https://docs.microsoft.com/media/logos/logo_js.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
> [!TIP]
22+
> Although the JavaScript Speech SDK is available as an npm package, thus both client web browsers and Node.js can consume it - consider the various architectural implications of each environment. For example, the <a href="https://en.wikipedia.org/wiki/Document_Object_Model" target="_blank">document object model (DOM) <span class="docon docon-navigate-external x-hidden-focus"></span></a> is not available for server-side applications just as the <a href="https://nodejs.org/api/fs.html" target="_blank">file system <span class="docon docon-navigate-external x-hidden-focus"></span></a> is not available to client-side applications.
23+
24+
### Node.js Package Manager (NPM)
25+
26+
To install the JavaScript Speech SDK, run the following `npm install` command below.
27+
28+
```nodejs
29+
npm install microsoft-cognitiveservices-speech-sdk
30+
```
31+
32+
### HTML script tag
33+
34+
Alternatively, you could directly include a `<script>` tag in the HTMLs `<head>` element, relying on the <a href="https://www.jsdelivr.com/package/npm/microsoft-cognitiveservices-speech-sdk" target="_blank">**JSDelivr** NPM syndicate <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
35+
36+
```html
37+
<script src="https://cdn.jsdelivr.net/npm/[email protected]/distrib/lib/microsoft.cognitiveservices.speech.sdk.min.js">
38+
</script>
39+
```
40+
41+
For more information, see the <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/javascript/browser" target="_blank">Web Browser Speech SDK quickstart <span class="docon docon-navigate-external x-hidden-focus"></span></a>.

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-cpp.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
The C++ Speech SDK is available on Windows, Linux, and macOS. For more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="C++" src="https://docs.microsoft.com/media/logos/logo_Cplusplus.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
#### C++ NuGet package
22+
23+
The C++ Speech SDK can be installed from the **Package Manager** with the following `Install-Package` command.
24+
25+
```powershell
26+
Install-Package Microsoft.CognitiveServices.Speech
27+
```
28+
29+
#### C++ binaries and header files
30+
31+
Alternatively, the C++ Speech SDK can be installed from binaries. Download the SDK as a <a href="https://aka.ms/csspeech/linuxbinary" target="_blank">.tar package <span class="docon docon-navigate-external x-hidden-focus"></span></a> and unpack the files in a directory of your choice. The contents of this package (which include header files for both x86 and x64 target architectures) are structured as follows:
32+
33+
| Path | Description |
34+
|------------------------|------------------------------------------------------|
35+
| `license.md` | License |
36+
| `ThirdPartyNotices.md` | Third-party notices |
37+
| `include` | Header files for C++ |
38+
| `lib/x64` | Native x64 library for linking with your application |
39+
| `lib/x86` | Native x86 library for linking with your application |
40+
41+
To create an application, copy or move the required binaries (and libraries) into your development environment. Include them as required in your build process.
42+
43+
#### Additional resources
44+
45+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/cpp" target="_blank">Windows, Linux, and macOS quickstart C++ source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-dotnet.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
The .NET Speech SDK is available as a NuGet package and implements .NET Standard 2.0, for more information, see <a href="https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech" target="_blank">Microsoft.CognitiveServices.Speech <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="C#" src="https://docs.microsoft.com/media/logos/logo_Csharp.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
#### C# NuGet Package
22+
23+
The .NET Speech SDK can be installed from the **.NET Core CLI** with the following `dotnet add` command.
24+
25+
```dotnetcli
26+
dotnet add package Microsoft.CognitiveServices.Speech
27+
```
28+
29+
The .NET Speech SDK can be installed from the **Package Manager** with the following `Install-Package` command.
30+
31+
```powershell
32+
Install-Package Microsoft.CognitiveServices.Speech
33+
```
34+
35+
#### Additional resources
36+
37+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/csharp" target="_blank">.NET Core, .NET Framework, Unity, UWP, and Xamarin quickstart C# source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-ios.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
When developing for iOS, there are two Speech SDKs available. The Objective-C Speech SDK is available natively as an iOS CocoaPod package. Alternatively, the .NET Speech SDK could be used with Xamarin.iOS as it implements .NET Standard 2.0.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="iOS" src="https://docs.microsoft.com/media/logos/logo_ios.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
> [!TIP]
22+
> For details using the Objective-C Speech SDK with Swift, see <a href="https://developer.apple.com/documentation/swift/imported_c_and_objective-c_apis/importing_objective-c_into_swift" target="_blank">Importing Objective-C into Swift <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
23+
24+
### System requirements
25+
26+
- A macOS version 10.3 or later
27+
- Target iOS 9.3 or later
28+
29+
# [Xcode](#tab/ios-xcode)
30+
31+
:::row:::
32+
:::column span="3":::
33+
The iOS CocoaPod package is available for download and use with the <a href="https://apps.apple.com/us/app/xcode/id497799835" target="_blank">Xcode 9.4.1 (or later) <span class="docon docon-navigate-external x-hidden-focus"></span></a> integrated development environment (IDE). First, <a href="https://aka.ms/csspeech/iosbinary" target="_blank">download the binary CocoaPod <span class="docon docon-navigate-external x-hidden-focus"></span></a>. Extract the pod in the same directory for its intended use, create a *Podfile* and list the `pod` as a `target`.
34+
:::column-end:::
35+
:::column:::
36+
<br>
37+
<div class="icon is-large">
38+
<img alt="Xcode" src="https://docs.microsoft.com/media/logos/logo_xcode.svg" width="60px">
39+
</div>
40+
:::column-end:::
41+
:::row-end:::
42+
43+
```
44+
platform :ios, '9.3'
45+
use_frameworks!
46+
47+
target 'AppName' do
48+
pod 'MicrosoftCognitiveServicesSpeech', '~> 1.10.0'
49+
end
50+
```
51+
52+
# [Xamarin.iOS](#tab/ios-xamarin)
53+
54+
:::row:::
55+
:::column span="3":::
56+
Xamarin.iOS exposes the complete iOS SDK for .NET developers. Build fully native iOS apps using C# or F# in Visual Studio. For more information, see <a href="https://docs.microsoft.com/xamarin/ios/" target="_blank">Xamarin.iOS <span class="docon docon-navigate-external x-hidden-focus"></span></a>.
57+
:::column-end:::
58+
:::column:::
59+
<br>
60+
<div class="icon is-large">
61+
<img alt="Xamarin" src="https://docs.microsoft.com/media/logos/logo_xamarin.svg" width="60px">
62+
&nbsp; ❤️ &nbsp;
63+
<img alt="iOS" src="https://docs.microsoft.com/media/logos/logo_ios.svg" width="60px">
64+
</div>
65+
:::column-end:::
66+
:::row-end:::
67+
68+
[!INCLUDE [Get .NET Speech SDK](get-speech-sdk-dotnet.md)]
69+
70+
---
71+
72+
#### Additional resources
73+
74+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/objectivec/ios" target="_blank">iOS Speech SDK quickstart Objective-C source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>
75+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/swift/ios" target="_blank">iOS Speech SDK quickstart Swift source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>

‎articles/cognitive-services/Speech-Service/includes/get-speech-sdk-java.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
author: IEvangelist
3+
ms.service: cognitive-services
4+
ms.topic: include
5+
ms.date: 03/27/2020
6+
ms.author: dapine
7+
---
8+
9+
:::row:::
10+
:::column span="3":::
11+
The Java SDK for Android is packaged as an <a href="https://developer.android.com/studio/projects/android-library" target="_blank">AAR (Android Library) <span class="docon docon-navigate-external x-hidden-focus"></span></a>, which includes the necessary libraries and required Android permissions. It's hosted in a Maven repository at `https://csspeechstorage.blob.core.windows.net/maven/` as package `com.microsoft.cognitiveservices.speech:client-sdk:1.11.0`.
12+
:::column-end:::
13+
:::column:::
14+
<br>
15+
<div class="icon is-large">
16+
<img alt="Java" src="https://docs.microsoft.com/media/logos/logo_java.svg" width="60px">
17+
</div>
18+
:::column-end:::
19+
:::row-end:::
20+
21+
To consume the package from your Android Studio project, make the following changes:
22+
23+
1. In the project-level *build.gradle* file, add the following to the `repository` section:
24+
```gradle
25+
maven { url 'https://csspeechstorage.blob.core.windows.net/maven/' }
26+
```
27+
28+
2. In the module-level *build.gradle* file, add the following to the `dependencies` section:
29+
```gradle
30+
implementation 'com.microsoft.cognitiveservices.speech:client-sdk:1.11.0'
31+
```
32+
33+
The Java SDK is also part of the [Speech Devices SDK](../speech-devices-sdk.md).
34+
35+
#### Additional resources
36+
37+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/java/android" target="_blank">Android specific Java quickstart source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>
38+
- <a href="https://github.com/Azure-Samples/cognitive-services-speech-sdk/tree/master/quickstart/java/jre" target="_blank">Java Runtime (JRE) quickstart source code <span class="docon docon-navigate-external x-hidden-focus"></span></a>

0 commit comments

Comments
 (0)