Mulai Cepat: Menginstal Speech SDK

  • Artikel

Dokumentasi referensi | Paket (NuGet) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk C#.

Sampel kode dalam dokumentasi ditulis dalam C# 8 dan dijalankan pada .NET standar 2.0.

Persyaratan platform

Speech SDK untuk C# kompatibel dengan Windows, Linux, dan macOS.

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan perencanaan Anda yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

Di Windows, Anda harus menggunakan arsitektur target 64-bit. Windows 10 atau yang lebih baru diperlukan.

Instal Microsoft Visual C++ Redistributable untuk Visual Studio 2015, 2017, 2019, dan 2022 untuk platform Anda. Memasang paket ini untuk pertama kalinya mungkin memerlukan menghidupkan ulang.

Menginstal Speech SDK untuk C#

Speech SDK untuk C# tersedia sebagai paket NuGet dan menerapkan .NET Standar 2.0. Untuk informasi selengkapnya, lihat Microsoft.CognitiveServices.Speech .

Speech SDK untuk C# dapat diinstal dari .NET CLI dengan menggunakan perintah berikut dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

Anda dapat mengikuti panduan ini untuk opsi lainnya.

Panduan ini memperlihatkan cara menginstal Speech SDK untuk aplikasi konsol .NET Framework (Windows).

Panduan ini memerlukan:

Membuat proyek Visual Studio dan memasang Speech SDK

Anda harus memasang paket NuGet Speech SDK agar dapat mereferensikannya dalam kode Anda. Untuk melakukannya, pertama-tama Anda perlu membuat proyek helloworld. Jika sudah memiliki proyek dengan beban kerja pengembangan desktop .NET yang tersedia, Anda dapat menggunakan proyek tersebut dan melompat ke Menggunakan Pengelola Paket NuGet untuk memasang SDK Speech.

Membuat proyek helloworld

  1. Buka Visual Studio.

  2. Di bawah Mulai, pilih Buat proyek baru.

  3. Di Buat proyek baru, pilih Aplikasi Konsol (.NET Framework), lalu pilih Berikutnya.

  4. Di Konfigurasikan proyek baru Anda, untuk Nama proyek masukkan helloworld, pilih atau buat jalur direktori di Lokasi, lalu pilih Buat.

  5. Dari bilah menu Visual Studio, pilih Alat>Dapatkan Alat dan Fitur. Langkah ini membuka Alat Penginstal Visual Studio dan menampilkan kotak dialog Memodifikasi .

  6. Periksa apakah beban kerja pengembangan desktop .NET tersedia. Jika beban kerja tidak diinstal, pilih beban kerja, lalu pilih Ubah untuk memulai penginstalan. Mungkin perlu beberapa menit untuk mengunduh dan memasang.

    Jika pengembangan desktop .NET sudah dipilih, pilih Tutup untuk menutup kotak dialog.

    Cuplikan layar yang memperlihatkan pengaktifan pengembangan desktop .NET.

  7. Tutup Alat penginstal Visual Studio.

Gunakan Pengelola Paket NuGet untuk memasang SDK Speech

  1. Di Penjelajah Solusi, klik kanan proyek helloworld, lalu pilih Kelola Paket NuGet untuk menampilkan Pengelola Paket NuGet.

  2. Di sudut kanan atas, temukan kotak dropdown Sumber Paket, dan pastikan nuget.org dipilih.

    Cuplikan layar yang memperlihatkan Manajer Paket NuGet.

  3. Di sudut kiri atas, pilih Telusuri.

  4. Dalam kotak pencarian, masukkan Microsoft.CognitiveServices.Speech dan pilih Enter.

  5. Dari hasil pencarian, pilih paket Microsoft.CognitiveServices.Speech, lalu pilih Instal untuk menginstal versi stabil terbaru.

    Cuplikan layar yang memperlihatkan pemasangan paket Microsoft.CognitiveServices.Speech NuGet.

  6. Terima semua perjanjian dan lisensi untuk memulai penginstalan.

    Setelah paket diinstal, konfirmasi akan muncul di jendela Konsol Pengelola Paket.

Memilih arsitektur target

Sekarang, untuk membuat dan menjalankan aplikasi konsol, buat konfigurasi platform yang sesuai dengan arsitektur komputer Anda.

  1. Dari menu, pilih Build>Configuration Manager. Kotak dialog Configuration Manager akan muncul.

  2. Di kotak dropdown Platform solusi aktif, pilih Baru. Kotak dialog Platform Solusi Baru akan muncul.

    Cuplikan layar yang memperlihatkan kotak dialog Configuration Manager.

  3. Di kotak dropdown Jenis atau pilih platform baru:

    • Jika Anda menjalankan Windows 64-bit, pilih x64.
    • Jika Anda menjalankan Windows 32-bit, pilih x86.

  4. Pilih OK lalu Tutup.

Dokumentasi referensi | Paket (NuGet) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk C++.

Persyaratan platform

Speech SDK untuk C++ kompatibel dengan Windows, Linux, dan macOS.

Di Windows, Anda harus menggunakan arsitektur target 64-bit. Windows 10 atau yang lebih baru diperlukan.

Instal Microsoft Visual C++ Redistributable untuk Visual Studio 2015, 2017, 2019, dan 2022 untuk platform Anda. Memasang paket ini untuk pertama kalinya mungkin memerlukan menghidupkan ulang.

Menginstal Speech SDK untuk C++

Speech SDK untuk C++ tersedia sebagai paket NuGet. Untuk informasi selengkapnya, lihat Microsoft.CognitiveServices.Speech .

Speech SDK untuk C++ dapat diinstal dari .NET CLI dengan menggunakan perintah berikut dotnet add :

dotnet add package Microsoft.CognitiveServices.Speech

Anda dapat mengikuti panduan ini untuk opsi lainnya.

Panduan ini menunjukkan cara memasang Speech SDK pada Linux.

Gunakan prosedur berikut untuk mengunduh dan memasang SDK. Langkah-langkahnya termasuk mengunduh pustaka dan file header yang diperlukan sebagai file .tar .

  1. Pilih direktori untuk file Speech SDK. Atur variabel lingkungan untuk menunjuk ke direktori tersebut SPEECHSDK_ROOT . Variabel ini memudahkan untuk merujuk ke direktori pada perintah di masa mendatang.

    Untuk menggunakan speechsdk direktori di direktori beranda Anda, jalankan perintah berikut:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Buat direktori jika tidak ada:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Unduh dan ekstrak arsip .tar.gz yang berisi biner Speech SDK:

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

  4. Validasi konten direktori tingkat atas dari paket yang diekstrak:

    ls -l "$SPEECHSDK_ROOT"

    Daftar direktori harus berisi pemberitahuan mitra dan file lisensi. Daftar juga harus berisi direktori include yang menyimpan file header (.h) dan direktori lib yang menyimpan pustaka untuk arm32, arm64, x64, dan x86.

    Jalur Deskripsi
    license.md Lisensi
    ThirdPartyNotices.md Pemberitahuan mitra
    REDIST.txt Pemberitahuan redistribusi
    termasuk File header yang diperlukan untuk C ++
    lib/arm32 Library native untuk ARM32 yang diperlukan untuk menautkan aplikasi Anda
    lib/arm64 Library native untuk ARM64 yang diperlukan untuk menautkan aplikasi Anda
    lib/x64 Library native untuk x64 yang diperlukan untuk menautkan aplikasi Anda
    lib/x86 Library native untuk x86 yang diperlukan untuk menautkan aplikasi Anda

Dokumentasi referensi | Paket (Go) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK for Go.

Persyaratan platform

Perhatian

Artikel ini mereferensikan CentOS, distribusi Linux yang mendekati status End Of Life (EOL). Harap pertimbangkan penggunaan dan perencanaan Anda yang sesuai. Untuk informasi selengkapnya, lihat panduan Akhir Masa Pakai CentOS.

Speech SDK for Go mendukung distribusi berikut pada arsitektur x64:

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

Penting

Gunakan rilis LTS terbaru dari distribusi Linux. Misalnya, jika Anda menggunakan Ubuntu 20.04 LTS, gunakan rilis terbaru Ubuntu 20.04.X.

Speech SDK bergantung pada pustaka sistem Linux berikut:

  • Pustaka bersama pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
  • Pustaka OpenSSL (libssl) versi 1.x dan sertifikat (ca-certificates).
  • Pustaka bersama untuk aplikasi ALSA (libasound).

Anda juga harus menginstal ca-certificates untuk membuat websocket yang aman dan menghindari WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED kesalahan.

Penting

Speech SDK belum mendukung OpenSSL 3.0, yang merupakan default di Ubuntu 22.04 dan Debian 12.

Jalankan perintah ini:

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

Instal biner Go versi 1.13 atau yang lebih baru.

Menginstal Speech SDK untuk Go

Gunakan prosedur berikut untuk mengunduh dan memasang SDK. Langkah-langkahnya termasuk mengunduh pustaka dan file header yang diperlukan sebagai file .tar .

  1. Pilih direktori untuk file Speech SDK. Atur variabel lingkungan untuk menunjuk ke direktori tersebut SPEECHSDK_ROOT . Variabel ini memudahkan untuk merujuk ke direktori pada perintah di masa mendatang.

    Untuk menggunakan speechsdk direktori di direktori beranda Anda, jalankan perintah berikut:

    export SPEECHSDK_ROOT="$HOME/speechsdk"

  2. Buat direktori jika tidak ada:

    mkdir -p "$SPEECHSDK_ROOT"

  3. Unduh dan ekstrak arsip .tar.gz yang berisi biner Speech SDK:

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

  4. Validasi konten direktori tingkat atas dari paket yang diekstrak:

    ls -l "$SPEECHSDK_ROOT"

    Daftar direktori harus berisi pemberitahuan mitra dan file lisensi. Daftar juga harus berisi direktori include yang menyimpan file header (.h) dan direktori lib yang menyimpan pustaka untuk arm32, arm64, x64, dan x86.

    Jalur Deskripsi
    license.md Lisensi
    ThirdPartyNotices.md Pemberitahuan mitra
    REDIST.txt Pemberitahuan redistribusi
    termasuk File header yang diperlukan untuk C ++
    lib/arm32 Library native untuk ARM32 yang diperlukan untuk menautkan aplikasi Anda
    lib/arm64 Library native untuk ARM64 yang diperlukan untuk menautkan aplikasi Anda
    lib/x64 Library native untuk x64 yang diperlukan untuk menautkan aplikasi Anda
    lib/x86 Library native untuk x86 yang diperlukan untuk menautkan aplikasi Anda

Mengonfigurasi lingkungan Go

Lakukan langkah-langkah berikut untuk menyiapkan lingkungan Go Anda untuk menemukan Speech SDK.

  1. Karena pengikatan mengandalkan cgo, Anda perlu mengatur variabel lingkungan agar Go dapat menemukan SDK.

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

    Penting

    Ganti <architecture> dengan arsitektur prosesor CPU Anda: x86, , x64arm32, atau arm64.

  2. Untuk menjalankan aplikasi dan SDK, Anda perlu memberi tahu sistem operasi tempat menemukan pustaka.

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

    Penting

    Ganti <architecture> dengan arsitektur prosesor CPU Anda: x86, , x64arm32, atau arm64.

Dokumentasi referensi | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk Java.

Persyaratan platform

Pilih lingkungan target Anda:

Speech SDK untuk Java kompatibel dengan Windows, Linux, dan macOS.

Di Windows, Anda harus menggunakan arsitektur target 64-bit. Windows 10 atau yang lebih baru diperlukan.

Instal Microsoft Visual C++ Redistributable untuk Visual Studio 2015, 2017, 2019, dan 2022 untuk platform Anda. Memasang paket ini untuk pertama kalinya mungkin memerlukan menghidupkan ulang.

Speech SDK untuk Java tidak mendukung Windows di ARM64.

Pasang Java Development Kit seperti Azul Zulu OpenJDK. Microsoft Build of OpenJDK atau JDK pilihan Anda juga harus berfungsi.

Menginstal Speech SDK untuk Java

Beberapa instruksi menggunakan versi SDK tertentu seperti 1.24.2. Untuk memeriksa versi terbaru, cari repositori GitHub kami.

Pilih lingkungan target Anda:

Panduan ini menunjukkan cara menginstal Speech SDK untuk Java pada Java Runtime.

Sistem operasi yang didukung

Paket Java Speech SDK tersedia untuk sistem operasi berikut:

Ikuti langkah-langkah berikut untuk menginstal Speech SDK untuk Java menggunakan Apache Maven:

  1. Menginstal Apache Maven.

  2. Buka prompt perintah tempat Anda menginginkan proyek baru, dan buat file pom.xml baru.

  3. Salin konten XML berikut ke dalam 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. Jalankan perintah Maven berikut untuk menginstal SDK Azure Cognitive Service untuk Ucapan dan dependensi.

    mvn clean dependency:copy-dependencies

Dokumentasi referensi | Paket (npm) | Sampel Tambahan pada kode sumber GitHub | Library

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk JavaScript.

Speech SDK untuk JavaScript tersedia sebagai paket npm. Lihat microsoft-cognitiveservices-speech-sdk dan repositori GitHub pendampingnya cognitive-services-speech-sdk-js.

Persyaratan platform

Pahami implikasi arsitektur antara Node.js dan browser web klien. Misalnya, model objek dokumen (DOM) tidak tersedia untuk aplikasi sisi server. Sistem file Node.js tidak tersedia untuk aplikasi sisi klien.

Menginstal Speech SDK untuk JavaScript

Bergantung pada lingkungan target, gunakan salah satu panduan berikut ini:

Panduan ini menunjukkan cara memasang Speech SDK untuk JavaScript untuk digunakan dengan Node.js.

  1. Instal Node.js.

  2. Buat direktori baru, jalankan npm init dan pelajari perintahnya.

  3. Untuk menginstal Speech SDK untuk JavaScript, jalankan perintah npm install berikut:

    npm install microsoft-cognitiveservices-speech-sdk

Untuk informasi selengkapnya, lihat sampel Node.js.

Menggunakan Speech SDK

  • Tambahkan pernyataan impor berikut untuk menggunakan Speech SDK di proyek JavaScript Anda:

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

Untuk informasi importselengkapnya tentang, lihat Ekspor dan Impor di situs web JavaScript.

Atau, Anda dapat menggunakan pernyataan persyaratan:

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

Dokumentasi referensi | Paket (Unduh) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk Objective-C.

Tip

Untuk informasi selengkapnya tentang menggunakan Speech SDK untuk Swift, lihat Mengimpor Objective-C ke Swift.

Menginstal Speech SDK untuk Objective-C

Speech SDK untuk Objective-C tersedia secara asli sebagai paket CocoaPod untuk sistem berbasis Mac x64 dan ARM.

Persyaratan sistem untuk Mac:

  • MacOS versi 10.14 atau yang lebih baru

Paket macOS CocoaPod tersedia untuk diunduh dan digunakan dengan Xcode 9.4.1 atau lingkungan pengembangan terintegrasi (IDE) yang lebih baru.

  1. Buka direktori Xcode tempat file proyek .xcodeproj Anda berada.

  2. Jalankan pod init untuk membuat file pod bernama Podfile.

  3. Ganti konten Podfile dengan konten berikut. target Perbarui nama dari AppName ke nama aplikasi Anda. Perbarui platform atau versi pod sesuai kebutuhan.

    platform :osx, 10.14
use_frameworks!

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

  4. Jalankan pod install untuk menginstal Speech SDK.

Atau, unduh CocoaPod biner dan ekstrak kontennya. Dalam proyek Xcode Anda, tambahkan referensi ke folder MicrosoftCognitiveServicesSpeech.xcframework yang diekstrak dan kontennya.

Catatan

Pengembang .NET dapat membangun aplikasi macOS asli dengan menggunakan kerangka kerja aplikasi Xamarin.Mac. Untuk informasi selengkapnya, lihat Xamarin.Mac.

Dokumentasi referensi | Paket (Unduh) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK for Swift.

Tip

Untuk informasi selengkapnya tentang menggunakan Speech SDK untuk Swift, lihat Mengimpor Objective-C ke Swift.

Menginstal Speech SDK untuk Swift

Speech SDK untuk Swift tersedia secara asli sebagai paket CocoaPod untuk sistem berbasis Mac x64 dan ARM.

Persyaratan sistem untuk Mac:

  • MacOS versi 10.14 atau yang lebih baru

Paket macOS CocoaPod tersedia untuk diunduh dan digunakan dengan Xcode 9.4.1 atau lingkungan pengembangan terintegrasi (IDE) yang lebih baru.

  1. Buka direktori Xcode tempat file proyek .xcodeproj Anda berada.

  2. Jalankan pod init untuk membuat file pod bernama Podfile.

  3. Ganti konten Podfile dengan konten berikut. target Perbarui nama dari AppName ke nama aplikasi Anda. Perbarui platform atau versi pod sesuai kebutuhan.

    platform :osx, 10.14
use_frameworks!

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

  4. Jalankan pod install untuk menginstal Speech SDK.

Atau, unduh CocoaPod biner dan ekstrak kontennya. Dalam proyek Xcode Anda, tambahkan referensi ke folder MicrosoftCognitiveServicesSpeech.xcframework yang diekstrak dan kontennya.

Catatan

Pengembang .NET dapat membangun aplikasi macOS asli dengan menggunakan kerangka kerja aplikasi Xamarin.Mac. Untuk informasi selengkapnya, lihat Xamarin.Mac.

Dokumentasi referensi | Paket (PyPi) | Sampel Tambahan pada GitHub

Dalam mulai cepat ini, Anda menginstal Speech SDK untuk Python.

Persyaratan platform

Speech SDK untuk Python kompatibel dengan Windows, Linux, dan macOS.

Di Windows, Anda harus menggunakan arsitektur target 64-bit. Windows 10 atau yang lebih baru diperlukan.

Instal Microsoft Visual C++ Redistributable untuk Visual Studio 2015, 2017, 2019, dan 2022 untuk platform Anda. Memasang paket ini untuk pertama kalinya mungkin memerlukan menghidupkan ulang.

Penting

Pastikan bahwa paket arsitektur target yang sama diinstal. Misalnya, jika Anda menginstal paket x64 redistributable, instal paket X64 Python.

Instal versi Python dari 3.7 atau yang lebih baru.

  • Untuk memeriksa penginstalan Anda, buka terminal dan jalankan perintah python --version. Jika Python diinstal dengan benar, Anda mendapatkan respons seperti Python 3.8.10.

  • Jika Anda menggunakan macOS atau Linux, Anda mungkin perlu menjalankan perintah python3 --version sebagai gantinya.

    Untuk mengaktifkan penggunaan alih-alih pythonpython3, jalankan alias python='python3' untuk menyiapkan alias. Sampel mulai cepat Speech SDK menentukan python penggunaan.

Menginstal Speech SDK untuk Python

Sebelum Anda memasang Speech SDK untuk Python, pastikan untuk memenuhi persyaratan platform.

Menginstal dari PyPI

Untuk menginstal Speech SDK untuk Python, jalankan perintah ini di jendela konsol:

pip install azure-cognitiveservices-speech

Meningkatkan ke Speech SDK terbaru

Untuk meningkatkan ke Speech SDK terbaru, jalankan perintah ini di jendela konsol:

pip install --upgrade azure-cognitiveservices-speech

Anda dapat memeriksa versi Speech SDK untuk Python mana yang saat ini diinstal dengan memeriksa variabel azure.cognitiveservices.speech.__version__. Misalnya, jalankan perintah ini di jendela konsol:

pip list

Menggunakan Speech SDK

Tambahkan pernyataan impor berikut untuk menggunakan Speech SDK di proyek Python Anda:

import azure.cognitiveservices.speech as speechsdk

Konten terkait