Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Başvuru belgeleri | Paketi (NuGet) | GitHub'da ek örnekler
Bu hızlı başlangıçta C# için Konuşma SDK'sını yükleyeceksiniz.
Platform gereksinimleri
C# için Konuşma SDK'sı Windows, Linux ve macOS ile uyumludur.
Windows'ta 64 bit hedef mimariyi kullanmanız gerekir. Windows 10 veya üzeri gereklidir.
Platformunuz için Microsoft Visual Studio için Visual C++ Yeniden Dağıtılabilir 2015, 2017, 2019 ve 2022'yi yükleyin. Bu paketi ilk kez yüklemek için yeniden başlatma gerekebilir.
C için Konuşma SDK'sını yükleme#
C# için Konuşma SDK'sı bir NuGet paketi olarak kullanılabilir ve .NET Standard 2.0'ı uygular. Daha fazla bilgi için bkz . Microsoft.CognitiveServices.Speech.
C# için Konuşma SDK'sı aşağıdaki dotnet add
komut kullanılarak .NET CLI'dan yüklenebilir:
dotnet add package Microsoft.CognitiveServices.Speech
Başvuru belgeleri | Paketi (NuGet) | GitHub'da ek örnekler
Bu hızlı başlangıçta C++ için Konuşma SDK'sını yükleyebilirsiniz.
Platform gereksinimleri
C++ için Konuşma SDK'sı Windows, Linux ve macOS ile uyumludur.
Windows'ta 64 bit hedef mimariyi kullanmanız gerekir. Windows 10 veya üzeri gereklidir.
Platformunuz için Microsoft Visual Studio için Visual C++ Yeniden Dağıtılabilir 2015, 2017, 2019 ve 2022'yi yükleyin. Bu paketi ilk kez yüklemek için yeniden başlatma gerekebilir.
C++ için Konuşma SDK'sını yükleme
C++ için Konuşma SDK'sı bir NuGet paketi olarak kullanılabilir. Daha fazla bilgi için bkz . Microsoft.CognitiveServices.Speech.
C++ için Konuşma SDK'sı aşağıdaki dotnet add
komut kullanılarak .NET CLI'dan yüklenebilir:
dotnet add package Microsoft.CognitiveServices.Speech
Daha fazla seçenek için bu kılavuzları izleyebilirsiniz.
Bu kılavuzda Linux için Konuşma SDK'sının nasıl yükleneceği gösterilmektedir.
SDK'yi indirip yüklemek için aşağıdaki yordamı kullanın. Adımlar, gerekli kitaplıkları ve üst bilgi dosyalarını .tar dosyası olarak indirmeyi içerir.
Konuşma SDK'sı dosyaları için bir dizin seçin. Ortam değişkenini bu
SPEECHSDK_ROOT
dizine işaret etmek için ayarlayın. Bu değişken, ileride komutlarda bu dizine başvurmayı kolaylaştırır.Giriş dizininizde speechsdk dizinini kullanmak için aşağıdaki komutu çalıştırın:
export SPEECHSDK_ROOT="$HOME/speechsdk"
Dizini mevcut değilse oluşturun.
mkdir -p "$SPEECHSDK_ROOT"
Konuşma SDK'sı ikili dosyalarını içeren .tar.gz arşivini indirin ve ayıklayın:
wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
Açılan paketin en üst düzey dizininin içeriğini doğrulayın:
ls -l "$SPEECHSDK_ROOT"
Dizin listesi, iş ortağı bildirimlerini ve lisans dosyalarını içermelidir. Liste ayrıca üst bilgi (.h) dosyalarını barındıran bir include dizini ve arm32, arm64, x64 ve x86 kitaplıklarını barındıran bir lib dizini içermelidir.
Yol Açıklama license.md Lisans ThirdPartyNotices.md İş ortağı bildirimleri REDIST.txt Yeniden dağıtım bildirimi içerir C++ için gerekli üst bilgi dosyaları lib/arm32 Uygulamanızı bağlamak için GEREKEN ARM32 için yerel kitaplık lib/arm64 ARM64 yerel kitaplık uygulamanızı bağlamak için gereklidir. lib/x64 Uygulamanızı bağlamak için gereken x64 yerel kitaplığı lib/x86 Uygulamanızı bağlamak için gereken x86 yerel kütüphane
Başvuru belgeleri | Paketi (Go) | GitHub'da ek örnekler
Bu hızlı başlangıçta Go için Konuşma SDK'sını yükleyebilirsiniz.
Platform gereksinimleri
Go için Konuşma SDK'sı x64 mimarisinde aşağıdaki dağıtımları destekler:
- Ubuntu 20.04/22.04/24.04
- Debian 11/12
Önemli
Linux dağıtımının en son LTS sürümünü kullanın. Örneğin, Ubuntu 20.04 LTS kullanıyorsanız Ubuntu 20.04.X'in en son sürümünü kullanın.
Konuşma SDK'sı aşağıdaki Linux sistem kitaplıklarına bağlıdır:
- POSIX Threads Programlama kitaplığı da dahil olmak üzere GNU C kitaplığının paylaşılan kitaplıkları
libpthreads
. - OpenSSL kitaplığı, sürüm 1.x (
libssl1
) veya 3.x (libssl3
) ve sertifikalar (ca-certificates
). - ALSA uygulamaları için paylaşılan kitaplık (
libasound2
).
Şu komutları çalıştırın:
sudo apt-get update
sudo apt-get install build-essential ca-certificates libasound2-dev libssl-dev wget
Go ikili sürümü 1.13 veya üzerini yükleyin.
Go için Konuşma SDK'sını yükleme
SDK'yi indirip yüklemek için aşağıdaki yordamı kullanın. Adımlar, gerekli kitaplıkları ve üst bilgi dosyalarını .tar dosyası olarak indirmeyi içerir.
Konuşma SDK'sı dosyaları için bir dizin seçin. Ortam değişkenini bu
SPEECHSDK_ROOT
dizine işaret etmek için ayarlayın. Bu değişken, ileride komutlarda bu dizine başvurmayı kolaylaştırır.Giriş dizininizde speechsdk dizinini kullanmak için aşağıdaki komutu çalıştırın:
export SPEECHSDK_ROOT="$HOME/speechsdk"
Dizini mevcut değilse oluşturun.
mkdir -p "$SPEECHSDK_ROOT"
Konuşma SDK'sı ikili dosyalarını içeren .tar.gz arşivini indirin ve ayıklayın:
wget -O SpeechSDK-Linux.tar.gz https://aka.ms/csspeech/linuxbinary tar --strip 1 -xzf SpeechSDK-Linux.tar.gz -C "$SPEECHSDK_ROOT"
Açılan paketin en üst düzey dizininin içeriğini doğrulayın:
ls -l "$SPEECHSDK_ROOT"
Dizin listesi, iş ortağı bildirimlerini ve lisans dosyalarını içermelidir. Liste ayrıca üst bilgi (.h) dosyalarını barındıran bir include dizini ve arm32, arm64, x64 ve x86 kitaplıklarını barındıran bir lib dizini içermelidir.
Yol Açıklama license.md Lisans ThirdPartyNotices.md İş ortağı bildirimleri REDIST.txt Yeniden dağıtım bildirimi dahil etme C++ için gerekli üst bilgi dosyaları lib/arm32 Uygulamanızı bağlamak için GEREKEN ARM32 için yerel kitaplık lib/arm64 ARM64 yerel kitaplık uygulamanızı bağlamak için gereklidir. lib/x64 Uygulamanızı bağlamak için gereken x64 yerel kitaplığı lib/x86 Uygulamanızı bağlamak için gereken x86 yerel kütüphane
Go ortamını yapılandırma
Aşağıdaki adımlar, Go ortamınızın Konuşma SDK'sını bulmasını sağlar.
Bağlantılar
cgo
'ye bağlı olduğundan, Go'nun SDK'yı bulabilmesi için ortam değişkenlerini ayarlamanız gerekir.export CGO_CFLAGS="-I$SPEECHSDK_ROOT/include/c_api" export CGO_LDFLAGS="-L$SPEECHSDK_ROOT/lib/<architecture> -lMicrosoft.CognitiveServices.Speech.core"
Önemli
değerini CPU'nuzun işlemci mimarisiyle değiştirin
<architecture>
:x64
,arm32
veyaarm64
.Uygulamaları ve SDK'yı çalıştırmak için, işletim sistemine kitaplıkları nerede bulacağını söylemeniz gerekir.
export LD_LIBRARY_PATH="$SPEECHSDK_ROOT/lib/<architecture>:$LD_LIBRARY_PATH"
Önemli
değerini CPU'nuzun işlemci mimarisiyle değiştirin
<architecture>
:x64
,arm32
veyaarm64
.
Başvuru belgeleri | GitHub'da ek örnekler
Bu hızlı başlangıçta Java için Konuşma SDK'sını yükleyebilirsiniz.
Platform gereksinimleri
Hedef ortamınızı seçin:
Java için Konuşma SDK'sı Windows, Linux ve macOS ile uyumludur.
Windows'ta 64 bit hedef mimariyi kullanmanız gerekir. Windows 10 veya üzeri gereklidir.
Platformunuz için Microsoft Visual Studio için Visual C++ Yeniden Dağıtılabilir 2015, 2017, 2019 ve 2022'yi yükleyin. Bu paketi ilk kez yüklemek için yeniden başlatma gerekebilir.
Java için Konuşma SDK'sı ARM64'te Windows'u desteklemez.
Azul Zulu OpenJDK gibi bir Java Geliştirme Seti yükleyin. OpenJDK'nin Microsoft Derlemesi veya tercih ettiğiniz JDK de çalışmalıdır.
Java için Konuşma SDK'sını yükleme
Yönergelerden bazıları gibi 1.43.0
belirli bir SDK sürümünü kullanır. En son sürümü denetlemek için GitHub depomuzda arama yapın.
Hedef ortamınızı seçin:
Bu kılavuzda Java Çalışma Zamanı'na Java için Konuşma SDK'sının nasıl yükleneceği gösterilmektedir.
Desteklenen işletim sistemleri
Java için Konuşma SDK'sı paketi şu işletim sistemleri için kullanılabilir:
- Windows: Yalnızca 64 bit.
- Mac: macOS X sürüm 10.14 veya üzeri.
- Linux: Desteklenen Linux dağıtımlarına ve hedef mimarilerine bakın.
Apache Maven kullanarak Java için Konuşma SDK'sını yüklemek için şu adımları izleyin:
Apache Maven'ı yükleyin.
Yeni projeyi istediğiniz bir komut istemi açın ve yeni bir pom.xml dosyası oluşturun.
Aşağıdaki XML içeriğini pom.xml kopyalayın:
<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>
Konuşma SDK'sını ve bağımlılıkları yüklemek için aşağıdaki Maven komutunu çalıştırın.
mvn clean dependency:copy-dependencies
Başvuru belgeleri | Paket (npm) | GitHub'daki ek örnekler | Kütüphane kaynak kodu
Bu hızlı başlangıçta JavaScript için Konuşma SDK'sını yükleyebilirsiniz.
JavaScript için Konuşma SDK'sı bir npm paketi olarak kullanılabilir. Bkz . microsoft-cognitiveservices-speech-sdk ve onun eşlikçisi GitHub deposu cognitive-services-speech-sdk-js.
Platform gereksinimleri
Node.js ve istemci web tarayıcıları arasındaki mimari etkileri anlama. Örneğin, belge nesne modeli (DOM) sunucu tarafı uygulamalarda kullanılamaz. Node.js dosya sistemi istemci tarafı uygulamaları tarafından kullanılamaz.
JavaScript için Konuşma SDK'sını yükleme
Hedef ortama bağlı olarak aşağıdaki kılavuzlardan birini kullanın:
Bu kılavuzda, Node.js ile kullanmak üzere JavaScript için Konuşma SDK'sının nasıl yükleneceği gösterilmektedir.
Node.js’yi yükleyin.
Yeni bir dizin oluşturun, komutunu çalıştırın
npm init
ve istemleri gözden geçirin.JavaScript için Konuşma SDK'sını yüklemek için aşağıdaki
npm install
komutu çalıştırın:npm install microsoft-cognitiveservices-speech-sdk
Konuşma SDK'sını kullanma
JavaScript projenizde Konuşma SDK'sını kullanmak için aşağıdaki içeri aktarma deyimini ekleyin:
import * as sdk from "microsoft-cognitiveservices-speech-sdk";
Daha fazla bilgi için JavaScript web sitesinde import
belgesine bakın.
Alternatif olarak, bir require deyimi kullanabilirsiniz:
const sdk = require("microsoft-cognitiveservices-speech-sdk");
Başvuru belgeleri | Paketi (indirme) | GitHub'da ek örnekler
Bu hızlı başlangıçta Objective-C için Konuşma SDK'sını yükleyebilirsiniz.
İpucu
Swift için Konuşma SDK'sını kullanma hakkında daha fazla bilgi için bkz . Objective-C'yi Swift'e aktarma.
Objective-C için Konuşma SDK'sını yükleme
Objective-C için Konuşma SDK'sı, Mac x64 ve ARM tabanlı sistemler için CocoaPod paketi olarak yerel olarak kullanılabilir.
Mac için sistem gereksinimleri:
- macOS sürüm 10.14 veya üzeri
macOS CocoaPod paketi, Xcode 9.4.1 veya üzeri tümleşik geliştirme ortamı (IDE) ile indirilebilir ve kullanılabilir.
.xcodeproj proje dosyanızın bulunduğu Xcode dizinine gidin.
Podfile
pod init
bir pod dosyası oluşturmak için komutunu çalıştırın.Podfile içeriğini aşağıdaki içerikle değiştirin.
target
adını,AppName
uygulamanızın adıyla güncelleyin. Platform veya pod sürümünü gerektiği gibi güncelleştirin.platform :osx, 10.14 use_frameworks! target 'AppName' do pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0' end
Konuşma SDK'sını yüklemek için komutunu çalıştırın
pod install
.
Alternatif olarak, ikili CocoaPod'ı indirin ve içeriğini ayıklayın. Xcode projenizde, ayıklanan MicrosoftCognitiveServicesSpeech.xcframework klasörüne ve içerdiği dosyalara bir referans ekleyin.
Başvuru belgeleri | Paketi (indirme) | GitHub'da ek örnekler
Bu hızlı başlangıçta Swift için Konuşma SDK'sını yükleyebilirsiniz.
İpucu
Swift için Konuşma SDK'sını kullanma hakkında daha fazla bilgi için bkz . Objective-C'yi Swift'e aktarma.
Swift için Konuşma SDK'sını yükleme
Swift için Konuşma SDK'sı, Mac x64 ve ARM tabanlı sistemler için CocoaPod paketi olarak yerel olarak kullanılabilir.
Mac için sistem gereksinimleri:
- macOS sürüm 10.14 veya üzeri
macOS CocoaPod paketi, Xcode 9.4.1 veya üzeri tümleşik geliştirme ortamı (IDE) ile indirilebilir ve kullanılabilir.
.xcodeproj proje dosyanızın bulunduğu Xcode dizinine gidin.
Podfile
pod init
bir pod dosyası oluşturmak için komutunu çalıştırın.Podfile içeriğini aşağıdaki içerikle değiştirin.
target
adını,AppName
uygulamanızın adıyla güncelleyin. Platform veya pod sürümünü gerektiği gibi güncelleştirin.platform :osx, 10.14 use_frameworks! target 'AppName' do pod 'MicrosoftCognitiveServicesSpeech-macOS', '~> 1.43.0' end
Konuşma SDK'sını yüklemek için komutunu çalıştırın
pod install
.
Alternatif olarak, ikili CocoaPod'ı indirin ve içeriğini ayıklayın. Xcode projenizde, ayıklanan MicrosoftCognitiveServicesSpeech.xcframework klasörüne ve içerdiği dosyalara bir referans ekleyin.
Başvuru belgeleri | Paketi (PyPi) | GitHub'da ek örnekler
Bu hızlı başlangıçta Python için Konuşma SDK'sını yükleyebilirsiniz.
Platform gereksinimleri
Python için Konuşma SDK'sı Windows, Linux ve macOS ile uyumludur.
Windows'ta 64 bit hedef mimariyi kullanmanız gerekir. Windows 10 veya üzeri gereklidir.
Platformunuz için Microsoft Visual Studio için Visual C++ Yeniden Dağıtılabilir 2015, 2017, 2019 ve 2022'yi yükleyin. Bu paketi ilk kez yüklemek için yeniden başlatma gerekebilir.
Önemli
Aynı hedef mimariye sahip paketlerin yüklendiğinden emin olun. Örneğin, x64 yeniden dağıtılabilir paketini yüklerseniz x64 Python paketini yükleyin.
Python'ın 3.8 veya sonraki bir sürümünden bir sürümünü yükleyin.
Yüklemenizi denetlemek için bir terminal açın ve komutunu
python --version
çalıştırın. Python düzgün yüklendiyse,Python 3.8.10
gibi bir yanıt alırsınız.macOS veya Linux kullanıyorsanız, bunun yerine komutunu
python3 --version
çalıştırmanız gerekebilir.python
yerinepython3
kullanımını etkinleştirmek için,alias python='python3'
komutunu çalıştırarak bir diğer ad ayarlayın. Konuşma SDK'sı hızlı başlangıç örnekleri,python
kullanımını belirtir.
Python için Konuşma SDK'sını yükleme
Python için Konuşma SDK'sını yüklemeden önce platform gereksinimlerini karşıladığınızdan emin olun.
PyPI'dan yükleme
Python için Konuşma SDK'sını yüklemek için konsol penceresinde şu komutu çalıştırın:
pip install azure-cognitiveservices-speech
En son Konuşma SDK'sına yükseltme
En son Konuşma SDK'sına yükseltmek için konsol penceresinde şu komutu çalıştırın:
pip install --upgrade azure-cognitiveservices-speech
Değişkeni inceleyerek Python sürümü için şu anda hangi Konuşma SDK'sının azure.cognitiveservices.speech.__version__
yüklü olduğunu denetleyebilirsiniz. Örneğin, konsol penceresinde şu komutu çalıştırın:
pip list
Konuşma SDK'sını kullanma
Python projenizde Konuşma SDK'sını kullanmak için aşağıdaki içeri aktarma deyimini ekleyin:
import azure.cognitiveservices.speech as speechsdk
Kod örnekleri
Ayrıntılı örnekler GitHub'daki Azure-Samples/cognitive-services-speech-sdk deposunda bulunur. C# (UWP ve Unity dahil), C++, Java, JavaScript (Tarayıcı ve Node.jsdahil), Objective-C, Python ve Swift için örnekler vardır. Go için kod örnekleri GitHub'daki Microsoft/cognitive-services-speech-sdk-go deposunda bulunur.