Mulai Cepat: Menginstal Speech SDK

Dokumentasi referensi | Paket (NuGet) | Sampel tambahan di GitHub

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

Persyaratan platform

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

Windows

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.

Linux

Speech SDK untuk C# hanya mendukung distribusi berikut pada arsitektur x64, ARM32, dan ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

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 dari pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
• Pustaka OpenSSL, versi 1.x (libssl1) atau 3.x (libssl3), dan sertifikat (ca-certificates).
• Pustaka bersama untuk aplikasi ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Jalankan perintah ini:

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

Debian 11/12

Jalankan perintah ini:

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

Amazon Linux 2023

Jalankan perintah ini:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Jalankan perintah ini:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Diperlukan macOS versi 10.14 atau yang lebih baru.

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 .

Terminal

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

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

Speech SDK untuk C# dapat diinstal dengan menggunakan perintah berikut Install-Package :

Install-Package Microsoft.CognitiveServices.Speech

Dokumentasi referensi | Paket (NuGet) | Sampel tambahan di GitHub

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

Persyaratan platform

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

Windows

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.

Linux

Speech SDK untuk C++ hanya mendukung distribusi berikut pada arsitektur x64, ARM32, dan ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

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 dari pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
• Pustaka OpenSSL, versi 1.x (libssl1) atau 3.x (libssl3), dan sertifikat (ca-certificates).
• Pustaka bersama untuk aplikasi ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Jalankan perintah ini:

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

Debian 11/12

Jalankan perintah ini:

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

Amazon Linux 2023

Jalankan perintah ini:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Jalankan perintah ini:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Diperlukan macOS versi 10.14 atau yang lebih baru.

Menginstal Speech SDK untuk C++

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

Terminal

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

dotnet add package Microsoft.CognitiveServices.Speech

PowerShell

Speech SDK untuk C++ dapat diinstal dengan menggunakan perintah berikut Install-Package :

Install-Package Microsoft.CognitiveServices.Speech

Anda dapat mengikuti panduan ini untuk opsi lainnya.

Linux

Panduan ini menunjukkan cara memasang Speech SDK pada Linux.

Gunakan prosedur berikut untuk mengunduh dan memasang SDK. Langkah-langkahnya meliputi mengunduh pustaka yang diperlukan dan file headerdalam bentuk 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	Berkas 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	Perpustakaan native untuk x64 yang diperlukan untuk menghubungkan aplikasi Anda
   lib/x86	Perpustakaan asli untuk x86 diperlukan guna menautkan aplikasi Anda.

macOS

Panduan ini menunjukkan cara menginstal Speech SDK untuk C++ di macOS 10.14 dan yang lebih baru. Langkah-langkahnya termasuk mengunduh pustaka yang diperlukan dan file headersebagai file .zip.

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 .zip yang berisi Speech SDK XCFramework:

   wget -O SpeechSDK-macOS.zip https://aka.ms/csspeech/macosbinary
   unzip SpeechSDK-macOS.zip -d "$SPEECHSDK_ROOT"
   

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

   ls -l "$SPEECHSDK_ROOT"
   

   Daftar direktori harus berisi pemberitahuan mitra, file lisensi, dan direktori MicrosoftCognitiveServicesSpeech.xcframework .

Windows

Panduan ini menunjukkan cara memasang Speech SDK untuk C++ di sistem beroperasi Windows Desktop.

Panduan penyiapan ini memerlukan:

• Microsoft Visual C++ Redistributable untuk Visual Studio untuk platform Windows. Saat memasangnya untuk pertama kali, mungkin diperlukan untuk memulai ulang.
• Visual Studio.

Membuat proyek Visual Studio dan menginstal Speech SDK

Untuk membuat proyek Visual Studio untuk pengembangan desktop C++, Anda perlu:

• Menyiapkan opsi pengembangan Visual Studio.
• Membuat proyek.
• Pilih arsitektur target.
• Instal SDK Ucapan.

Menyiapkan opsi pengembangan Visual Studio

Untuk memulai, pastikan Anda telah melakukan persiapan dengan benar di Visual Studio untuk pengembangan desktop C++:

1. Buka Visual Studio 2019 untuk menampilkan jendela mulai.

2. Pilih Lanjutkan tanpa kode untuk membuka Visual Studio IDE.

   

3. Dari bilah menu Visual Studio, pilih Alat>Dapatkan Alat dan Fitur untuk membuka Alat penginstal Visual Studio dan melihat kotak dialog Memodifikasi.

4. Pada tab Beban Kerja, di bawah Windows, temukan pengembangan Desktop dengan beban kerja C++. Jika beban kerja tersebut belum dipilih, pilih beban kerja tersebut.

   

5. Pada tab Komponen individual, temukan manajer paket NuGet. Jika belum dipilih, pilih.

6. Pilih Tutup atau Ubah. Nama tombol bervariasi tergantung apakah Anda memilih fitur apa pun untuk penginstalan.

   Jika Anda memilih Ubah, penginstalan dimulai. Proses ini mungkin memakan waktu beberapa saat.

7. Tutup Penginstal Visual Studio.

Membuat proyek

Selanjutnya, buat proyek Anda dan pilih arsitektur target:

1. Dari menu Visual Studio, pilih >untuk menampilkan jendela Buat proyek baru.

2. Temukan dan pilih Aplikasi Konsol. Pastikan Anda memilih versi C++ dari jenis proyek ini, dibandingkan dengan C# atau Visual Basic.

3. Pilih Selanjutnya.

   

4. Dalam kotak dialog Konfigurasikan proyek baru Anda, di Nama proyek, masukkan helloworld.

5. Di Lokasi, buka dan pilih atau buat folder tempat Anda ingin menyimpan proyek, lalu pilih Buat.

   

6. Pilih arsitektur platform target Anda. Pada toolbar Visual Studio, temukan kotak dropdown Platform Solusi. Jika Anda tidak melihatnya, pilih View>Toolbars>Standard untuk menampilkan bar alat yang berisi Platform Solusi.

   Jika Anda menjalankan Windows 64-bit, pilih x64 di kotak dropdown. Windows 64-bit juga dapat menjalankan aplikasi 32-bit, sehingga Anda dapat memilih x86 jika Anda menginginkannya.

Menginstal Speech SDK dengan menggunakan Visual Studio

Terakhir, pasang Paket Speech SDK NuGet, dan referensikan Speech SDK dalam proyek Anda:

1. Di Penjelajah Solusi, klik kanan solusi Anda, lalu pilih Kelola Paket NuGet untuk Solusi untuk masuk ke jendela NuGet - Solusi.

2. Pilih Telusur.

3. Di Sumber paket, pilih nuget.org.

   

4. Dalam kotak Pencarian, masukkan Microsoft.CognitiveServices.Speech. Pilih paket itu setelah muncul di hasil pencarian.

5. Di panel status paket di samping hasil pencarian, pilih proyek helloworld Anda.

6. Pilih Instal.

   

7. Di kotak dialog Pratinjau Perubahan, pilih OK.

8. Dalam kotak dialog Penerimaan Lisensi, tampilkan lisensi, lalu pilih Saya Terima. Penginstalan paket dimulai. Penginstalan paket dimulai, dan saat penginstalan selesai, panel Output menampilkan pesan yang mirip dengan teks berikut: Successfully installed 'Microsoft.CognitiveServices.Speech 1.15.0' to helloworld.

Dokumentasi Referensi | Paket (Go) | Contoh Tambahan di GitHub

Dalam panduan cepat ini, Anda menginstal Speech SDK untuk Go.

Persyaratan platform

Speech SDK for Go mendukung distribusi berikut pada arsitektur x64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12

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 dari pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
• Pustaka OpenSSL, versi 1.x (libssl1) atau 3.x (libssl3), dan sertifikat (ca-certificates).
• Pustaka bersama untuk aplikasi ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Jalankan perintah ini:

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

Debian 11/12

Jalankan perintah ini:

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

Amazon Linux 2023

Jalankan perintah ini:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Jalankan perintah ini:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl 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 meliputi mengunduh pustaka yang diperlukan dan file headerdalam bentuk 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	Berkas 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	Perpustakaan native untuk x64 yang diperlukan untuk menghubungkan aplikasi Anda
   lib/x86	Perpustakaan asli untuk x86 diperlukan guna 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: x64, , arm32atau 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: x64, , arm32atau arm64.

Dokumentasi referensi | sampel tambahan di GitHub

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

Persyaratan platform

Pilih lingkungan target Anda:

Java Runtime

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

Windows

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.

Linux

Speech SDK untuk Java mendukung distribusi berikut pada arsitektur x64, ARM32, dan ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

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 dari pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
• Pustaka OpenSSL, versi 1.x (libssl1) atau 3.x (libssl3), dan sertifikat (ca-certificates).
• Pustaka bersama untuk aplikasi ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Jalankan perintah ini:

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

Debian 11/12

Jalankan perintah ini:

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

Amazon Linux 2023

Jalankan perintah ini:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Jalankan perintah ini:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Diperlukan macOS versi 10.14 atau yang lebih baru.

Android

Speech SDK kompatibel dengan perangkat Android yang memiliki prosesor ARM 32/64-bit dan prosesor yang kompatibel dengan Intel x86/x64.

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.43.0. Untuk memeriksa versi terbaru, cari repositori GitHub kami.

Pilih lingkungan target Anda:

Java Runtime

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:

• Windows: Hanya 64-bit.
• Mac: macOS X versi 10.14 atau yang lebih baru.
• Linux: Lihat distribusi Linux dan arsitektur target yang didukung.

Maven

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.43.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. Jalankan perintah Maven berikut untuk menginstal Speech SDK dan dependensi.

   mvn clean dependency:copy-dependencies
   

Gerhana

Membuat proyek Eclipse dan menginstal Speech SDK

1. Instal Eclipse Java IDE. IDE ini mengharuskan Java sudah dipasang.

2. Mulai Eclipse.

3. Di Eclipse Launcher, di bidang Ruang Kerja, masukkan nama direktori ruang kerja baru. Lalu pilih Luncurkan.

   

4. Dalam sekejap, jendela utama Eclipse IDE muncul. Tutup layar Selamat Datang jika ada.

5. Dari menu Eclipse, pilih File>Proyek Baru.>

6. Kotak dialog Proyek Baru muncul. Pilih Proyek Java, dan pilih Berikutnya.

   

7. Panduan Proyek Java Baru dimulai. Di bidang Nama proyek, masukkan mulai cepat. Pilih JavaSE-1.8 sebagai lingkungan eksekusi. Pilih Selesai.

   Tampilan layar wizard Proyek Java Baru, dengan pilihan untuk membuat proyek Java.

8. Jika jendela Buka Perspektif Terkait muncul, pilih Buka Perspektif.

9. Di penjelajah Paket, klik kanan proyek mulai cepat. Pilih Konfigurasikan>Konversi ke Proyek Maven dari menu konteks.

   

10. Jendela Buat POM baru muncul. Di bidang Group Id, masukkan com.microsoft.cognitiveservices.speech.samples. Di bidang Id Artefak, masukkan mulai cepat. Selanjutnya pilih Selesai.

    

11. Buka file pom.xml dan edit:

    1. dependencies Tambahkan elemen di akhir file, sebelum tag </project>penutup , dengan Speech SDK sebagai dependensi:

    <dependencies>
      <dependency>
        <groupId>com.microsoft.cognitiveservices.speech</groupId>
        <artifactId>client-sdk</artifactId>
        <version>1.43.0</version>
      </dependency>
    </dependencies>
    

    1. Simpan perubahan.

Gradle

Konfigurasi gradle

Konfigurasi Gradle memerlukan referensi eksplisit ke ekstensi dependensi .jar :

// build.gradle

dependencies {
    implementation group: 'com.microsoft.cognitiveservices.speech', name: 'client-sdk', version: "1.43.0", ext: "jar"
}

Android

Panduan ini menunjukkan cara memasang SDK Ucapan untuk Java pada Android.

Speech SDK untuk Android dikemas sebagai file Android Archive (AAR), yang mencakup pustaka yang diperlukan dan izin Android yang diperlukan.

Pasang Speech SDK menggunakan Android Studio

Buat proyek baru di Android Studio dan tambahkan Speech SDK untuk Java sebagai dependensi pustaka. Penyiapan didasarkan pada Paket Maven Speech SDK dan Android Studio Chipmunk 2021.2.1.

Membuat proyek Kosong

1. Buka Android Studio dan pilih Proyek baru.

   

2. Di jendela Proyek baru yang muncul, pilih Telepon dan Tablet>Aktivitas Kosong, lalu pilih Berikutnya.

   

3. Masukkan SpeechQuickstart di kotak teks Nama.

   

4. Masukkan samples.speech.cognitiveservices.microsoft.com, dalam kotak teks Nama paket.

5. Pilih direktori proyek dalam kotak pilihan Simpan lokasi.

6. Pilih Java dalam kotak pilihan Bahasa.

7. Pilih API 26: Android 8.0 (Oreo) di kotak Pilihan tingkat API Minimum .

8. Pilih Selesai.

Android Studio membutuhkan waktu untuk menyiapkan proyek baru Anda. Untuk pertama kalinya Anda menggunakan Android Studio, mungkin perlu beberapa menit untuk mengatur preferensi, menerima lisensi, dan menyelesaikan wizard.

Menginstal Speech SDK untuk Java di Android

Tambahkan Speech SDK sebagai dependensi dalam proyek Anda.

1. Pilih File>Struktur proyek>Dependensi>aplikasi.

2. Pilih simbol plus (+) untuk menambahkan dependensi di bawah Dependensi yang Dinyatakan. Lalu pilih Dependensi pustaka dari menu dropdown.

   

3. Di jendela Tambahkan Dependensi Pustaka yang muncul, masukkan nama dan versi dari Speech SDK untuk Java: com.microsoft.cognitiveservices.speech:client-sdk:1.43.0. Kemudian pilih Cari.

4. Pastikan ID Grup yang dipilih adalah com.microsoft.cognitiveservices.speech, lalu pilih OK.

5. Pilih OKE untuk menutup jendela Struktur Proyek dan menerapkan perubahan Anda pada proyek.

Dokumentasi referensi | Paket (npm) | Sampel tambahan di GitHub | Kode sumber pustaka

Dalam panduan cepat ini, Anda akan 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:

Node.js

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.

Berbasis browser

Panduan ini memperlihatkan cara memasang Speech SDK untuk JavaScript untuk digunakan dengan halaman web.

Ekstrak ke sebuah folder

1. Membuat folder baru yang kosong. Jika Anda ingin menghosting sampel di server web, pastikan server web dapat mengakses folder.

2. Unduh SDK Ucapan sebagai paket .zip dan ekstrak ke dalam folder yang baru dibuat. File-file ini dibongkar:

   • microsoft.cognitiveservices.speech.sdk.bundle.js: Versi Speech SDK yang dapat dibaca manusia.
   • microsoft.cognitiveservices.speech.sdk.bundle.js.map: File peta yang digunakan untuk men-debug kode SDK.
   • microsoft.cognitiveservices.speech.sdk.bundle.d.ts: Definisi objek untuk digunakan dengan TypeScript.
   • microsoft.cognitiveservices.speech.sdk.bundle-min.js: Versi yang di minimumkan dari Speech SDK.
   • speech-processor.js: Kode untuk meningkatkan performa di beberapa browser.

3. Buat file baru di folder bernama index.html di folder, dan buka file ini dengan editor teks.

Tag skrip HTML

Unduh dan ekstrak file microsoft.cognitiveservices.speech.sdk.bundle.js dari Speech SDK untuk JavaScript. Tempatkan di folder yang file HTML Anda dapat mengakses.

<script src="microsoft.cognitiveservices.speech.sdk.bundle.js"></script>;

Kiat

Jika Anda menargetkan browser web, dan menggunakan tag <script>, awalan sdk tidak diperlukan. Awalan sdk adalah alias yang digunakan untuk memberi nama modul require.

Atau, Anda dapat langsung menyertakan <script> tag dalam elemen HTML <head> , mengandalkan JSDelivr.

<script src="https://cdn.jsdelivr.net/npm/microsoft-cognitiveservices-speech-sdk@latest/distrib/browser/microsoft.cognitiveservices.speech.sdk.bundle-min.js">
</script>

Untuk informasi selengkapnya, lihat sampel berbasis browser.

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 lebih lanjut tentang import, lihat Ekspor dan Impor di situs web JavaScript.

Atau, Anda dapat menggunakan pernyataan persyaratan:

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

Paket dokumentasi | referensi (unduh) | Sampel tambahan di GitHub

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

Kiat

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

Menginstal Speech SDK untuk Objective-C

Mac

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.43.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.

Ios

Speech SDK untuk Objective-C tersedia sebagai paket CocoaPod bawaan.

Persyaratan sistem untuk iOS:

• MacOS versi 10.14 atau yang lebih baru
• Menargetkan iOS 9.3 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 :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.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.

Paket dokumentasi | referensi (unduh) | Sampel tambahan di GitHub

Dalam panduan memulai cepat ini, Anda menginstal Speech SDK untuk Swift.

Kiat

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

Menginstal Speech SDK untuk Swift

Mac

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.43.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.

Ios

Speech SDK untuk Swift tersedia secara bawaan sebagai paket CocoaPod.

Persyaratan sistem untuk iOS:

• MacOS versi 10.14 atau yang lebih baru
• Menargetkan iOS 9.3 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 yang berikut ini. target Perbarui nama dari AppName ke nama aplikasi Anda. Perbarui platform atau versi pod sesuai kebutuhan.

   platform :ios, '9.3'
   use_frameworks!
   
   target 'AppName' do
     pod 'MicrosoftCognitiveServicesSpeech-iOS', '~> 1.43.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.

Dokumentasi referensi | Paket (PyPi) | Sampel tambahan di GitHub

Dalam panduan cepat ini, Anda akan menginstal Speech SDK untuk Python.

Persyaratan platform

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

Windows

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.

Linux

Speech SDK untuk Python mendukung distribusi berikut pada arsitektur x64 dan ARM64:

• Ubuntu 20.04/22.04/24.04
• Debian 11/12
• Amazon Linux 2023
• Azure Linux 3.0

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 dari pustaka GNU C, termasuk pustaka Pemrograman Utas POSIX, libpthreads.
• Pustaka OpenSSL, versi 1.x (libssl1) atau 3.x (libssl3), dan sertifikat (ca-certificates).
• Pustaka bersama untuk aplikasi ALSA (libasound2).

Ubuntu 20.04/22.04/24.04

Jalankan perintah ini:

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

Debian 11/12

Jalankan perintah ini:

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

Amazon Linux 2023

Jalankan perintah ini:

sudo yum update
sudo yum install alsa-lib ca-certificates openssl wget

Azure Linux 3.0

Jalankan perintah ini:

sudo tdnf update
sudo tdnf install alsa-lib ca-certificates openssl wget

macOS

Diperlukan macOS versi 10.14 atau yang lebih baru.

Instal versi Python dari 3.8 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 menggunakan python sebagai pengganti python3, jalankan alias python='python3' untuk menyiapkan alias. Sampel demonstrasi mulai cepat untuk Speech SDK menentukan penggunaan python.

Menginstal Speech SDK untuk Python

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

PyPI

Menginstal dari PyPI

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

pip install azure-cognitiveservices-speech

Tingkatkan 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

Visual Studio Code

Memasang Speech SDK menggunakan Visual Studio Code

Untuk menginstal Speech SDK untuk Python:

1. Unduh dan instal Visual Studio Code.

2. Jalankan Visual Studio Code dan pasang ekstensi Python:

   1. Pilih File>Preferensi>Ekstensi.
   2. Cari Python, temukan ekstensi Python untuk Visual Studio Code diterbitkan oleh Microsoft, lalu pilih Pasang.

   

3. Pilih Terminal>Terminal Baru untuk membuka terminal dalam Visual Studio Code.

4. Pada prompt terminal, jalankan perintah berikut untuk menginstal paket Speech SDK untuk Python.

   python -m pip install azure-cognitiveservices-speech
   

Untuk informasi selengkapnya tentang Visual Studio Code dan Python, lihat Visual Studio Code dan Memulai Python di VISUAL Code.

Menggunakan Speech SDK

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

import azure.cognitiveservices.speech as speechsdk

Sampel kode

Sampel mendalam tersedia di repositori Azure-Samples/cognitive-services-speech-sdk di GitHub. Ada sampel untuk C# (termasuk UWP dan Unity), C++, Java, JavaScript (termasuk Browser dan Node.js), Objective-C, Python, dan Swift. Sampel kode untuk Go tersedia di repositori Microsoft/cognitive-services-speech-sdk-go di GitHub.

Konten terkait

• Mulai cepat Ucapan ke teks
• Panduan Cepat Teks ke Ucapan
• Mulai cepat terjemahan ucapan