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

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

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

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

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

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

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

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

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

Пакет 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 уже установлен, выберите Закрыть, чтобы выйти из диалогового окна.

    Screenshot that shows enabling .NET desktop development.

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

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

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

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

    Screenshot that shows NuGet Package Manager.

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

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

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

    Screenshot that shows installing the Microsoft.CognitiveServices.Speech NuGet package.

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

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

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

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

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

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

    Screenshot that shows the Configuration Manager dialog.

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

    • Если вы используете 64-разрядную версию Windows, выберите x64.
    • Если вы используете 32-разрядную версию Windows, выберите x86.
  4. Нажмите ОК, а затем Закрыть.

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

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

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

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

В Windows можно использовать целевую архитектуру x64 или x86.

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

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

Пакет 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 для распознавания речи использует libMicrosoft.CognitiveServices.Speech.core.so. Убедитесь, что целевая архитектура (x86, x64) соответствует приложению. В зависимости от версии Linux могут потребоваться дополнительные зависимости:

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

Важно!

В Ubuntu 22.04 установите libssl1.1 как двоичный пакет, например libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb, или скомпилировав его из источников. Пакет SDK службы "Речь" не поддерживает OpenSSL 3.0, который по умолчанию используется в Ubuntu 22.04.

Вот пример установки libssl1.1 в Ubuntu 22.04:

wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb
sudo dpkg -i libssl1.1_1.1.1l-1ubuntu1.3_amd64.deb

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

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

Чтобы загрузить и установить пакет 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 необходимо использовать целевую архитектуру x64.

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

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

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

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

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

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

Примечание

Пакет SDK службы "Речь" для Java недоступен в центральном репозитории Maven. Неважно, используете ли вы Gradle или файл зависимостей pom.xml, нужно добавить пользовательский репозиторий с указанием на https://azureai.azureedge.net/maven/ (имя пакета см. ниже).

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

Пакет 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>
        <repositories>
            <repository>
            <id>maven-cognitiveservices-speech</id>
            <name>Microsoft Cognitive Services Speech Maven Repository</name>
            <url>https://azureai.azureedge.net/maven/</url>
            </repository>
        </repositories>
        <dependencies>
            <dependency>
            <groupId>com.microsoft.cognitiveservices.speech</groupId>
            <artifactId>client-sdk</artifactId>
            <version>1.22.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 службы "Речь"

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

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

Здесь также описано, как установить пакет 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");

Дополнительные сведения о require см. в разделе Что требуется? на веб-сайте Node.js.

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

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

Совет

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

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

Пакет 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.22.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 службы "Речь"

Пакет 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.22.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 можно использовать целевую архитектуру x64 или x86.

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

Установите Python версии от 3.7 до 3.10. Чтобы проверить установку, откройте терминал и выполните команду python --version. Если установка выполнена правильно, вы получите ответ "Python 3.8.2".

Важно!

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

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

Перед установкой пакета 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

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