Skip to content

Commit 205e436

Browse files
author
v-jerkin
committed
rerrange a bit of material after discussion with Nitin
1 parent a988042 commit 205e436

File tree

1 file changed

+22
-19
lines changed

1 file changed

+22
-19
lines changed

articles/cognitive-services/Speech-Service/overview.md

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -20,13 +20,7 @@ Like the other Azure speech services, the Speech service is powered by the prove
2020
> [!NOTE]
2121
> The Speech service is currently in public preview. Return here regularly for documentation updates, new code samples, and more.
2222
23-
## Speech SDK and Speech Devices SDK
24-
25-
To simplify the development of speech-enabled applications, Microsoft provides the [Speech SDK](speech-sdk.md) for use with the new Speech service. The Speech SDK provides consistent native Speech to Text and Speech Translation APIs for C#, C++, and Java. If you're developing with one of these languages, the Speech SDK makes development easier by handling the network details for you.
26-
27-
Microsoft also offers a [Speech Devices SDK](speech-devices-sdk.md), an integrated hardware and software platform for developers of speech-enabled devices. Our hardware partner provides reference designs and development units, while we provide a device-optimized SDK that takes full advantage of the hardware's capabilities.
28-
29-
## Primary Speech service functions
23+
## Main Speech service functions
3024

3125
The primary functions of the Speech service are Speech to Text (also called speech recognition or transcription), Text to Speech (speech synthesis), and Speech Translation.
3226

@@ -39,18 +33,6 @@ The primary functions of the Speech service are Speech to Text (also called spee
3933
\* *Intent recognition requires a LUIS subscription.*
4034

4135

42-
## Using the Speech service
43-
44-
If you're using a supported programming language, the [Speech SDK](speech-sdk.md) makes development easier. The Speech service also has a [REST API](rest-apis.md) works with any programming language, but does not offer all the functions offered by the SDK.
45-
46-
|<br>Method|Speech<br>to Text|Text to<br>Speech|Speech<br>Translation|<br>Description|
47-
|-|-|-|-|-|
48-
|[Speech SDK](speech-sdk.md)|Yes|No|Yes|Native APIs for C#, C++, and Java to simplify development.|
49-
|[REST](rest-apis.md)|Yes|Yes|No|A simple HTTP-based API that makes it easy to add speech to your applications.|
50-
51-
The Speech service also provides WebSockets protocols for streaming Speech to Text and Speech Translation. The Speech SDKs use these protocols. We encourage you to use the Speech SDK rather than trying to implement your own WebSockets communication with the Speech service. However, if you already have code that uses Bing Speech or Translator Speech via WebSockets, it is straightforward to update it to use the Speech service. The WebSockets protocols are compatible; only the endpoints are different.
52-
53-
5436
## Customizing speech features
5537

5638
The Speech service lets you use your own data to train the models underlying the Speech service's Speech to Text and Text to Speech features.
@@ -65,6 +47,27 @@ The Speech service lets you use your own data to train the models underlying the
6547
Once created, your custom models can be used anywhere you'd use the standard models in your app's Speech to Text or Text to Speech functionality.
6648

6749

50+
## Using the Speech service
51+
52+
To simplify the development of speech-enabled applications, Microsoft provides the [Speech SDK](speech-sdk.md) for use with the new Speech service. The Speech SDK provides consistent native Speech to Text and Speech Translation APIs for C#, C++, and Java. If you're developing with one of these languages, the Speech SDK makes development easier by handling the network details for you.
53+
54+
The Speech service also has a [REST API](rest-apis.md) that works with any programming language that can make HTTP requests. The REST interface, however, does not offer the streaming, real-time functionality ofthe SDK.
55+
56+
|<br>Method|Speech<br>to Text|Text to<br>Speech|Speech<br>Translation|<br>Description|
57+
|-|-|-|-|-|
58+
|[Speech SDK](speech-sdk.md)|Yes|No|Yes|Native APIs for C#, C++, and Java to simplify development.|
59+
|[REST](rest-apis.md)|Yes|Yes|No|A simple HTTP-based API that makes it easy to add speech to your applications.|
60+
61+
### WebSockets
62+
63+
The Speech service also has WebSockets protocols for streaming Speech to Text and Speech Translation. The Speech SDKs use these protocols to communicate with the Speech service. You should use the Speech SDK rather than trying to implement your own WebSockets communication with the Speech service.
64+
65+
If you already have code that uses Bing Speech or Translator Speech via WebSockets, though, it is straightforward to update it to use the Speech service. The WebSockets protocols are compatible; only the endpoints are different.
66+
67+
### Speech Devices SDK
68+
69+
The [Speech Devices SDK](speech-devices-sdk.md) is an integrated hardware and software platform for developers of speech-enabled devices. Our hardware partner provides reference designs and development units. Microsoft provides a device-optimized SDK that takes full advantage of the hardware's capabilities.
70+
6871

6972
## Speech scenarios
7073

0 commit comments

Comments
 (0)