Установка пакета SDK службы "Речь"

  • Статья

Справочная документация | Пакет (NuGet) | Дополнительные примеры в GitHub

В этом руководстве объясняется, как установить пакет SDK службы "Речь" для C#.

Примеры кода в документации написаны на C# 8 и выполняются на .NET Standard 2.0.

Требования платформы

Пакет SDK службы "Речь" для C# совместим с Windows, Linux и macOS.

В Windows необходимо использовать 64-разрядную целевую архитектуру. требуется Windows 10 или более поздней версии.

Необходимо установить распространяемый Microsoft Visual C++ для Visual Studio 2015, 2017, 2019 и 2022 для вашей платформы. При первой установке этого пакета может потребоваться перезагрузка.

Установка пакета SDK службы "Речь" для C#

Пакет SDK службы "Речь" для C# доступен в виде пакета NuGet и реализует .NET Standard 2.0. Дополнительные сведения см. в статье Microsoft.CognitiveServices.Speech.

Пакет SDK службы "Речь" для C# можно установить из .NET CLI с помощью следующей команды dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

Пакет SDK службы "Речь" для C# можно установить с помощью следующей команды Install-Package:

Install-Package Microsoft.CognitiveServices.Speech

Дополнительные параметры см. в руководстве ниже.

Выберите целевую среду

В этом руководстве показано, как установить пакет SDK службы "Речь" для консольного приложения .NET Framework (Windows).

Предварительные требования

Для работы с этим руководством требуется следующее:

Создание проекта Visual Studio и установка пакета SDK службы "Речь"

Вам необходимо установить пакет SDK NuGet для службы "Речь", чтобы вы могли ссылаться на него в коде. Для этого может потребоваться сначала создать проект helloworld. Если у вас уже есть проект с рабочей нагрузкой Разработка классических приложений .NET, можно использовать этот проект и перейти к разделу Установка пакета SDK для службы "Речь" с помощью диспетчера пакетов NuGet.

Создание проекта helloworld

  1. Запустите Visual Studio 2019.

  2. В окне Начало работы выберите Создать проект.

  3. В окне Создание проекта выберите Консольное приложение (.NET Framework) и нажмите кнопку Далее.

  4. В окне Настройка нового проекта введите helloworld в Имя проекта, выберите или создайте путь каталога в Расположение, а затем выберите Создать.

  5. В строке меню Visual Studio выберите Инструменты >Получить инструменты и компоненты. На этом шаге открывается Visual Studio Installer и отображается диалоговое окно Идет изменение.

  6. Проверьте, доступна ли рабочая нагрузка разработки классического приложения .NET. Если рабочая нагрузка не была установлена, установите флажок возле нее, а затем выберите Изменить, чтобы начать установку. Скачивание и установка могут занять несколько минут.

    Если флажок рядом с пунктом Разработка классических приложений .NET уже установлен, выберите Закрыть, чтобы выйти из диалогового окна.

    Снимок экрана: включение разработки классических приложений .NET.

  7. Закройте Visual Studio Installer.

Установка пакета SDK для службы "Речь" с помощью диспетчера пакетов NuGet

  1. В Обозревателе решений щелкните правой кнопкой мыши проект helloworld и выберите Управление пакетами NuGet, чтобы отобразить Диспетчер пакетов NuGet.

  2. В правом верхнем углу найдите раскрывающийся список Источник пакета и убедитесь, что выбран параметр NuGet.org.

    Снимок экрана: диспетчер пакетов NuGet.

  3. В левом верхнем углу нажмите кнопку Просмотреть.

  4. В поле поиска введите Microsoft.CognitiveServices.Speech и выберите Ввести.

  5. В результатах поиска выберите пакет Microsoft.CognitiveServices.Speech, а затем выберите Установить для установки последней стабильной версии.

    Снимок экрана: установка пакета NuGet Microsoft.CognitiveServices.Speech.

  6. Примите все соглашения и лицензии для запуска установки.

    После установки пакета на Консоли диспетчера пакетов появится подтверждение.

Выбор целевой архитектуры

Чтобы создать и запустить консольное приложение, создайте конфигурацию платформы, соответствующую архитектуре компьютера.

  1. В строке меню выберите Сборка>Configuration Manager (Диспетчер конфигураций). Откроется диалоговое окноДиспетчер конфигураций.

  2. В раскрывающемся списке Активная платформа решения выберите команду Новый. Откроется диалоговое окно Создание платформы решения.

    Снимок экрана: диалоговое окно Configuration Manager.

  3. В раскрывающемся списке Введите или выберите новую платформу.

    • Если вы используете 64-разрядную версию Windows, выберите x64.
    • Если вы используете 32-разрядную версию Windows, выберите x86.

  4. Нажмите ОК, а затем Закрыть.

Справочная документация | Пакет (NuGet) | Дополнительные примеры в GitHub

В этом руководстве объясняется, как установить пакет SDK службы "Речь" для C++.

Требования платформы

Пакет SDK службы "Речь" для C++ совместим с Windows, Linux и macOS.

В Windows необходимо использовать 64-разрядную целевую архитектуру. требуется Windows 10 или более поздней версии.

Необходимо установить распространяемый Microsoft Visual C++ для Visual Studio 2015, 2017, 2019 и 2022 для вашей платформы. При первой установке этого пакета может потребоваться перезагрузка.

Установка пакета SDK службы "Речь" для C++

Пакет SDK службы "Речь" для C++ доступен в виде пакета NuGet. Дополнительные сведения см. в статье Microsoft.CognitiveServices.Speech.

Пакет SDK службы "Речь" для C++ можно установить из .NET CLI с помощью следующей команды dotnet add:

dotnet add package Microsoft.CognitiveServices.Speech

Пакет SDK службы "Речь" для C# можно установить с помощью следующей команды Install-Package:

Install-Package Microsoft.CognitiveServices.Speech

Дополнительные параметры см. в руководстве ниже.

Выберите целевую среду

Здесь также описано, как установить пакет SDK для службы "Речь" для Linux.

Чтобы загрузить и установить пакет SDK, выполните следующие действия. Необходимые библиотеки и файлы заголовков можно скачать в виде TAR-файла по ссылке: https://aka.ms/csspeech/linuxbinary.

  1. Выберите каталог, в который должны быть извлечены файлы пакета SDK для службы "Речь", и задайте переменную среды SPEECHSDK_ROOT, чтобы она указывала на этот каталог. Эта переменная упрощает подключение к каталогу в будущих командах.

    Например, если вы хотите использовать каталог speechsdk в домашнем каталоге, используйте следующую команду.

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Если каталога нет, создайте его.

    mkdir -p "$SPEECHSDK_ROOT"

  3. Скачайте и извлеките архив .tar.gz с двоичными файлами пакета SDK для службы "Речь".

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

  4. Проверьте содержимое каталога верхнего уровня извлеченного пакета.

    ls -l "$SPEECHSDK_ROOT"

    Список файлов в каталоге должен содержать уведомление третьих лиц и файлы лицензии, а также каталог include, в котором хранятся файлы заголовков (.h), и каталог lib, содержащий библиотеки для arm32, arm64, x64 и x86.

    Путь Description
    license.md Лицензия
    ThirdPartyNotices.md Уведомления сторонних производителей
    REDIST.txt Уведомление о повторном распространении
    include Необходимые файлы заголовков для C++
    lib/arm32 Собственная библиотека для ARM32, необходимая для привязки приложения
    lib/arm64 Собственная библиотека для ARM64, необходимая для привязки приложения
    lib/x64 Собственная библиотека для 64-разрядной ОС, необходимая для привязки приложения
    lib/x86 Собственная библиотека для 32-разрядной ОС, необходимая для привязки приложения

Справочная документация | Пакет (Go) | Дополнительные примеры в GitHub

В этом руководстве объясняется, как установить пакет SDK службы "Речь" для Go.

Требования платформы

При использовании с Linux пакет SDK службы "Речь" для Go поддерживает только Ubuntu 18.04/20.04/22.04, Debian 9/10/11, Red Hat Enterprise Linux (RHEL) 8 и CentOS 8 в архитектуре x64.

Важно!

Используйте последний выпуск LTS дистрибутива Linux. Например, если вы работаете с Ubuntu 20.04 LTS, используйте последний выпуск Ubuntu 20.04.X.

Пакет SDK службы "Речь" зависит от следующих системных библиотек Linux:

  • общие библиотеки в библиотеке GNU C, включая библиотеку программирования потоков POSIX, libpthreads;
  • Библиотека OpenSSL (libssl) версии 1.x и сертификаты (ca-certificates)
  • общую библиотеку для приложений ALSA (libasound)
  • Также необходимо установить, ca-certificates чтобы установить безопасный websocket и избежать WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED ошибки.
sudo apt-get update
sudo apt-get install build-essential libssl-dev ca-certificates libasound2 wget

Важно!

Пакет SDK службы "Речь" не поддерживает OpenSSL 3.0, который по умолчанию используется в Ubuntu 22.04.

Только в Ubuntu 22.04 установите последнюю версию libssl1.1 либо в виде двоичного пакета, либо путем компиляции из источников.

Необходимо установить двоичный файл Go 1.13 или более поздней версии.

Установка пакета SDK службы "Речь" для Go

Чтобы загрузить и установить пакет SDK, выполните следующие действия. Необходимые библиотеки и файлы заголовков можно скачать в виде TAR-файла по ссылке: https://aka.ms/csspeech/linuxbinary.

  1. Выберите каталог, в который должны быть извлечены файлы пакета SDK для службы "Речь", и задайте переменную среды SPEECHSDK_ROOT, чтобы она указывала на этот каталог. Эта переменная упрощает подключение к каталогу в будущих командах.

    Например, если вы хотите использовать каталог speechsdk в домашнем каталоге, используйте следующую команду.

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Если каталога нет, создайте его.

    mkdir -p "$SPEECHSDK_ROOT"

  3. Скачайте и извлеките архив .tar.gz с двоичными файлами пакета SDK для службы "Речь".

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

  4. Проверьте содержимое каталога верхнего уровня извлеченного пакета.

    ls -l "$SPEECHSDK_ROOT"

    Список файлов в каталоге должен содержать уведомление третьих лиц и файлы лицензии, а также каталог include, в котором хранятся файлы заголовков (.h), и каталог lib, содержащий библиотеки для arm32, arm64, x64 и x86.

    Путь Description
    license.md Лицензия
    ThirdPartyNotices.md Уведомления сторонних производителей
    REDIST.txt Уведомление о повторном распространении
    include Необходимые файлы заголовков для C++
    lib/arm32 Собственная библиотека для ARM32, необходимая для привязки приложения
    lib/arm64 Собственная библиотека для ARM64, необходимая для привязки приложения
    lib/x64 Собственная библиотека для 64-разрядной ОС, необходимая для привязки приложения
    lib/x86 Собственная библиотека для 32-разрядной ОС, необходимая для привязки приложения

Настройка среды Go

Чтобы настроить среду Go для поиска пакета SDK службы "Речь", выполните следующие действия. В обоих шагах замените <architecture> архитектурой вашего ЦП: x86, x64, arm32 или arm64.

  1. Так как привязки зависят от cgo, вам нужно задать переменные среды, чтобы помочь Go найти пакет SDK.

    export CGO_CFLAGS="-I$SPEECHSDK_ROOT/include/c_api"
export CGO_LDFLAGS="-L$SPEECHSDK_ROOT/lib/<architecture> -lMicrosoft.CognitiveServices.Speech.core"

  2. Для запуска приложений и пакета SDK нужно сообщить операционной системе, где найти библиотеки.

    export LD_LIBRARY_PATH="$SPEECHSDK_ROOT/lib/<architecture>:$LD_LIBRARY_PATH"

Справочная документация | Дополнительные примеры в GitHub

Здесь также описано, как установить пакет SDK для службы "Речь" для Java.

Требования платформы

Выберите целевую среду

Пакет SDK службы "Речь" для Java совместим с Windows, Linux и macOS.

В Windows необходимо использовать 64-разрядную целевую архитектуру. требуется Windows 10 или более поздней версии.

Для платформы необходимо установить распространяемый Microsoft Visual C++ для Visual Studio 2015, 2017, 2019 и 2022. При первой установке этого пакета может потребоваться перезагрузка.

Пакет SDK службы "Речь" для Java не поддерживает Windows в ARM64.

Необходимо установить комплект SDK для Java, например Azul Zulu OpenJDK. Кроме того, должна работать сборка Microsoft OpenJDK или предпочтительный JDK.

Установка пакета SDK службы "Речь" для Java

Некоторые инструкции используют определенную версию пакета SDK, например 1.24.2. Просмотреть сведения о последней версии можно в нашем репозитории GitHub.

Выберите целевую среду

В этом руководстве объясняется, как установить пакет SDK службы "Речь" для Java в среде выполнения Java.

Поддерживаемые операционные системы

Пакет SDK службы "Речь" для Java доступен для таких операционных систем:

Выполните следующие действия, чтобы установить пакет SDK службы "Речь" для Java с помощью Apache Maven:

  1. Установите Apache Maven.
  2. Откройте командную строку, в которой должен быть создан новый проект, и создайте файл pom.xml.
  3. Скопируйте следующее XML-содержимое в pom.xml:
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.microsoft.cognitiveservices.speech.samples</groupId>
    <artifactId>quickstart-eclipse</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <build>
        <sourceDirectory>src</sourceDirectory>
        <plugins>
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.7.0</version>
            <configuration>
            <source>1.8</source>
            <target>1.8</target>
            </configuration>
        </plugin>
        </plugins>
    </build>
    <dependencies>
        <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.28.0</version>
        </dependency>
    </dependencies>
</project>
  4. Выполните следующую команду Maven, чтобы установить пакет SDK службы "Речь" и зависимости. 
    mvn clean dependency:copy-dependencies

Справочная документация | Пакет (npm) | Дополнительные примеры в GitHub | Исходный код библиотеки

В этом руководстве объясняется, как установить пакет SDK для службы "Речь" для JavaScript.

Пакет SDK службы "Речь" для JavaScript доступен в виде пакета NPM. См. статью о microsoft-cognitiveservices-speech-sdk и его сопутствующем репозитории GitHub cognitive-services-speech-sdk-js.

Требования платформы

Обязательно учитывайте различные архитектурные аспекты Node.js и клиентских веб-браузеров. Например, модель DOM недоступна для приложений на стороне сервера, так как файловая система Node.js недоступна для клиентских приложений.

Установка пакета SDK службы "Речь" для JavaScript

В зависимости от целевой среды используйте одно из следующих руководств:

Выберите целевую среду

Здесь также описано, как установить пакет SDK службы "Речь" для JavaScript для использования с Node.js. Если вам нужно только имя пакета, чтобы приступить к работе самостоятельно, выполните npm install microsoft-cognitiveservices-speech-sdk в существующем проекте.

Предварительные требования

Для работы с этим кратким руководством вам понадобится Node.js.

Создание проекта NPM

Создайте каталог, выполните npm init и следуйте пошаговым инструкциям.

Добавление пакета SDK службы "Речь"

Выполните команду npm install microsoft-cognitiveservices-speech-sdk.

Здесь также описано, как установить пакет SDK службы "Речь" для JavaScript для использования с Node.js.

  1. Установите Node.js.

  2. Создайте каталог, выполните npm init и следуйте пошаговым инструкциям.

  3. Чтобы установить пакет SDK службы "Речь" для JavaScript, выполните следующую команду npm install.

    npm install microsoft-cognitiveservices-speech-sdk

Дополнительные сведения см. на странице Примеры Node.js.

Использование пакета SDK для службы "Речь"

Добавьте следующую инструкцию импорта для использования пакета SDK службы "Речь" в проекте JavaScript:

import * as sdk from "microsoft-cognitiveservices-speech-sdk";

Дополнительные сведения о import см. в разделе Экспорт и импорт на веб-сайте JavaScript.

Кроме того, вы можете использовать оператор require:

const sdk = require("microsoft-cognitiveservices-speech-sdk");

Справочная документация | Пакет (скачивание) | Дополнительные примеры в GitHub

В этом руководстве показано, как установить пакет SDK службы "Речь" для Objective-C.

Совет

Дополнительные сведения об использовании пакета SDK службы "Речь" для Swift см. в статье Импорт Objective-C в Swift.

Установка пакета SDK службы "Речь" для Objective-C

Пакет SDK службы "Речь" для Objective-C доступен в виде собственного пакета CocoaPod для компьютеров Mac x64 и ARM.

Требования к системе для Mac:

  • macOS 10.14 или более поздней версии

Пакет macOS CocoaPod доступен для загрузки и использования с интегрированной средой разработки (IDE) Xcode 9.4.1 (или более поздней версии).

  1. Перейдите в каталог Xcode, где находится файл проекта .xcodeproj.

  2. Выполните команду pod init, чтобы создать файл pod с именем Podfile.

  3. Замените все содержимое Podfile следующим. Замените имя target из AppName именем приложения. При необходимости обновите версию платформы или pod.

    platform :osx, 10.14
use_frameworks!

target 'AppName' do
  pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.28.0'
end

  4. Выполните pod install, чтобы установить пакет SDK службы "Речь".

Кроме того, вы можете скачать двоичный файл CocoaPod и распаковать его, чтобы извлечь содержимое. В проекте Xcode добавьте ссылку на извлеченную папку MicrosoftCognitiveServicesSpeech.xcframework и ее содержимое.

Примечание

Разработчики на .NET могут создавать нативные приложения macOS с помощью исполняющей среды Xamarin.Mac. Дополнительные сведения см. в разделе Xamarin.Mac.

Справочная документация | Пакет (скачивание) | Дополнительные примеры в GitHub

В этом руководстве объясняется, как установить пакет SDK службы "Речь" для Swift.

Совет

Дополнительные сведения об использовании пакета SDK службы "Речь" для Swift см. в статье Импорт Objective-C в Swift.

Установка пакета SDK службы "Речь" для Swift

Пакет SDK службы "Речь" для Swift доступен в виде собственного пакета CocoaPod для компьютеров Mac x64 и ARM.

Требования к системе для Mac:

  • macOS 10.14 или более поздней версии

Пакет macOS CocoaPod доступен для загрузки и использования с интегрированной средой разработки (IDE) Xcode 9.4.1 (или более поздней версии).

  1. Перейдите в каталог Xcode, где находится файл проекта .xcodeproj.

  2. Выполните команду pod init, чтобы создать файл pod с именем Podfile.

  3. Замените все содержимое Podfile следующим. Замените имя target из AppName именем приложения. При необходимости обновите версию платформы или pod.

    platform :osx, 10.14
use_frameworks!

target 'AppName' do
  pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.28.0'
end

  4. Выполните pod install, чтобы установить пакет SDK службы "Речь".

Кроме того, вы можете скачать двоичный файл CocoaPod и распаковать его, чтобы извлечь содержимое. В проекте Xcode добавьте ссылку на извлеченную папку MicrosoftCognitiveServicesSpeech.xcframework и ее содержимое.

Примечание

Разработчики на .NET могут создавать нативные приложения macOS с помощью исполняющей среды Xamarin.Mac. Дополнительные сведения см. в разделе Xamarin.Mac.

Справочная документация | Пакет (PyPi) | Дополнительные примеры в GitHub

а также как установить пакет SDK для службы "Речь" для Python.

Требования платформы

Пакет SDK для службы "Речь" (Python) совместим с Windows, Linux и macOS.

В Windows необходимо использовать 64-разрядную целевую архитектуру. требуется Windows 10 или более поздней версии.

Для платформы необходимо установить распространяемый Microsoft Visual C++ для Visual Studio 2015, 2017, 2019 и 2022. При первой установке этого пакета может потребоваться перезагрузка.

Важно!

Убедитесь, что установлены пакеты той же целевой архитектуры. Например, при установке распространяемого пакета x64 необходимо установить пакет x64 для Python.

Установите версию Python с версии 3.7 или более поздней.

Чтобы проверить установку, откройте терминал и выполните команду python --version. Если он установлен правильно, вы получите ответ типа "Python 3.8.10". Если вы используете macOS или Linux, вам может потребоваться выполнить команду python3 --version . Чтобы включить использование python вместо python3, выполните команду alias python='python3' , чтобы настроить псевдоним. В примерах краткого руководства по пакету SDK службы "Речь" указано python использование.

Установка пакета SDK службы "Речь" для Python

Перед установкой пакета SDK службы "Речь" для Python убедитесь, что выполнены требования к платформе.

Выбор инструмента или интегрированной среды разработки

Установка из PyPI

Чтобы установить пакет SDK службы "Речь" для Python, выполните следующую команду в терминале.

pip install azure-cognitiveservices-speech

Обновление до последнего пакета SDK службы "Речь"

Чтобы выполнить обновление до последней версии пакета SDK службы "Речь", выполните в терминале следующую команду:

pip install --upgrade azure-cognitiveservices-speech

Вы можете узнать, какая версия пакета SDK службы "Речь" для Python сейчас установлена, проверив переменную azure.cognitiveservices.speech.__version__. Например, выполните в терминале следующую команду:

pip list

Использование пакета SDK для службы "Речь"

Добавьте следующую инструкцию импорта, чтобы использовать пакет SDK службы "Речь" в проекте Python:

import azure.cognitiveservices.speech as speechsdk

Дальнейшие действия