Aracılığıyla paylaş


Hızlı Başlangıç: Konuşma SDK'sını yükleme

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.

  1. 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"
    
  2. Dizini mevcut değilse oluşturun.

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. 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"
    
  4. 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.

  1. 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"
    
  2. Dizini mevcut değilse oluşturun.

    mkdir -p "$SPEECHSDK_ROOT"
    
  3. 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"
    
  4. 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.

  1. 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, arm32veya arm64.

  2. 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, arm32veya arm64.

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.0belirli 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:

  1. Apache Maven'ı yükleyin.

  2. Yeni projeyi istediğiniz bir komut istemi açın ve yeni bir pom.xml dosyası oluşturun.

  3. 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>
    
  4. 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.

  1. Node.js’yi yükleyin.

  2. Yeni bir dizin oluşturun, komutunu çalıştırın npm initve istemleri gözden geçirin.

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

Daha fazla bilgi için Node.js örneklerine bakın.

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.

  1. .xcodeproj proje dosyanızın bulunduğu Xcode dizinine gidin.

  2. Podfilepod initbir pod dosyası oluşturmak için komutunu çalıştırın.

  3. 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
    
  4. 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.

  1. .xcodeproj proje dosyanızın bulunduğu Xcode dizinine gidin.

  2. Podfilepod initbir pod dosyası oluşturmak için komutunu çalıştırın.

  3. 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
    
  4. 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 yerine python3 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.