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

  • Статья

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

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

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

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

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

Внимание

Эта статья ссылается на CentOS, дистрибутив Linux, который приближается к состоянию конца жизни (EOL). Пожалуйста, рассмотрите возможность использования и планирования соответствующим образом. Дополнительные сведения см. в руководстве centOS End Of Life.

В 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 службы "Речь" для консольного приложения .NET Framework (Windows).

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

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

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

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

  1. Откройте Visual Studio.

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

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

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

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

  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". Откроется диалоговое окноConfigurationManager (Диспетчер конфигураций).

  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 для службы "Речь" для Linux.

Чтобы загрузить и установить пакет SDK, выполните следующие действия. Эти шаги включают скачивание необходимых библиотек и файлов заголовков в виде файла .tar.

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

    Чтобы использовать речь каталога в домашнем каталоге, выполните следующую команду:

    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"

    Список каталогов должен содержать уведомления партнера и файлы лицензий. В списке также должен содержаться каталог, содержащий файлы заголовков (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.

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

Внимание

Эта статья ссылается на CentOS, дистрибутив Linux, который приближается к состоянию конца жизни (EOL). Пожалуйста, рассмотрите возможность использования и планирования соответствующим образом. Дополнительные сведения см. в руководстве centOS End Of Life.

Пакет SDK службы "Речь" для Go поддерживает следующие дистрибутивы архитектуры x64:

  • Ubuntu 18.04/20.04
  • Debian 9/10/11
  • Red Hat Enterprise Linux (RHEL) 8
  • CentOS 7

Внимание

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

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

  • Общие библиотеки библиотеки GNU C, включая библиотеку программирования потоков POSIX. libpthreads
  • Библиотека OpenSSL (libssl) версии 1.x и сертификаты (ca-certificates).
  • Общая библиотека для приложений ALSA (libasound).

Чтобы установить безопасный websocket, необходимо также установить ca-certificates и избежать WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED ошибки.

Внимание

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

Выполните следующие команды.

sudo apt-get update
sudo apt-get install build-essential libssl-dev ca-certificates libasound2 wget

Установите двоичный файл Go версии 1.13 или более поздней.

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

Чтобы загрузить и установить пакет SDK, выполните следующие действия. Эти шаги включают скачивание необходимых библиотек и файлов заголовков в виде файла .tar.

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

    Чтобы использовать речь каталога в домашнем каталоге, выполните следующую команду:

    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"

    Список каталогов должен содержать уведомления партнера и файлы лицензий. В списке также должен содержаться каталог, содержащий файлы заголовков (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 службы "Речь", выполните следующие действия.

  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"

    Внимание

    Замените <architecture> архитектуру процессора ЦП: x86, , x64arm32или arm64.

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

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

    Внимание

    Замените <architecture> архитектуру процессора ЦП: x86, , x64arm32или arm64.

Справочная документация | Дополнительные примеры в 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.

Установите пакет средств разработки 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.37.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.

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

Связанный контент