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.

Belgelerdeki kod örnekleri C# 8 ile yazılır ve .NET standard 2.0 üzerinde çalıştırılır.

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

Daha fazla seçenek için bu kılavuzları izleyebilirsiniz.

Bu kılavuzda bir .NET Framework (Windows) konsol uygulaması için Konuşma SDK'sının nasıl yükleneceği gösterilmektedir.

Bu kılavuz şunları gerektirir:

Visual Studio projesi oluşturma ve Konuşma SDK'sını yükleme

Kodunuzda başvurabilmek için Konuşma SDK'sı NuGet paketini yüklemeniz gerekir. Bunu yapmak için önce bir helloworld projesi oluşturmanız gerekebilir. .NET masaüstü geliştirme iş yüküne sahip bir projeniz zaten varsa, bu projeyi kullanabilir ve Konuşma SDK'sını yüklemek için NuGet Paket Yöneticisi kullanma bölümüne atlayabilirsiniz.

Helloworld projesi oluşturma

  1. Visual Studio'yu açın.

  2. Başlarken'in altında Yeni proje oluştur'u seçin.

  3. Yeni proje oluştur bölümünde Konsol Uygulaması (.NET Framework) öğesini ve ardından İleri'yi seçin.

  4. Yeni projenizi yapılandırın bölümünde Proje adı alanına helloworld yazın, Konum'da dizin yolunu seçin veya oluşturun ve ardından Oluştur'u seçin.

  5. Visual Studio menü çubuğunda Araçlar Araçları>ve Özellikleri Al'ı seçin. Bu adım Visual Studio Yükleyicisi açar ve Değiştir iletişim kutusunu görüntüler.

  6. .NET masaüstü geliştirme iş yükünün kullanılabilir olup olmadığını denetleyin. İş yükü yüklü değilse, yüklemeyi başlatmak için iş yükünü seçin ve ardından Değiştir'i seçin. İndirmek ve yüklemek birkaç dakika sürebilir.

    .NET masaüstü geliştirme zaten seçiliyse, iletişim kutusunu kapatmak için Kapat'ı seçin.

    .NET masaüstü geliştirmeyi etkinleştirmeyi gösteren ekran görüntüsü.

  7. Visual Studio Yükleyicisi kapatın.

Konuşma SDK'sını yüklemek için NuGet Paket Yöneticisi kullanma

  1. Çözüm Gezgini'da helloworld projesine sağ tıklayın ve nuget paketlerini yönet'i seçerek NuGet Paket Yöneticisi gösterin.

  2. Sağ üst köşede Paket Kaynağı açılan kutusunu bulun ve nuget.org seçildiğinden emin olun.

    NuGet Paket Yöneticisi gösteren ekran görüntüsü.

  3. Sol üst köşede Gözat'ı seçin.

  4. Arama kutusuna Microsoft.CognitiveServices.Speech yazın ve Enter tuşuna basın.

  5. Arama sonuçlarından Microsoft.CognitiveServices.Speech paketini seçin ve ardından En son kararlı sürümü yüklemek için Yükle'yi seçin.

    Microsoft.CognitiveServices.Speech NuGet paketini yüklemeyi gösteren ekran görüntüsü.

  6. Yüklemeyi başlatmak için tüm sözleşmeleri ve lisansları kabul edin.

    Paket yüklendikten sonra, Paket Yöneticisi Konsolu penceresinde bir onay görüntülenir.

Hedef mimariyi seçin

Konsol uygulamasını derlemek ve çalıştırmak için bilgisayarınızın mimarisiyle eşleşen bir platform yapılandırması oluşturun.

  1. Menüden Yapılandırma Yöneticisi Derle'yi> seçin. Configuration Manager iletişim kutusu açılır.

  2. Etkin çözüm platformu açılan kutusunda Yeni'yi seçin. Yeni Çözüm Platformu iletişim kutusu görüntülenir.

    Configuration Manager iletişim kutusunu gösteren ekran görüntüsü.

  3. Yeni platform yazın veya seçin açılan kutusunda:

    • 64 bit Windows çalıştırıyorsanız x64'i seçin.
    • 32 bit Windows çalıştırıyorsanız x86'yı seçin.
  4. Tamam'ı ve ardından Kapat'ı seçin.

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. Yoksa dizini 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
    include C++ için gerekli üst bilgi dosyaları
    lib/arm32 Uygulamanızı bağlamak için GEREKEN ARM32 için yerel kitaplık
    lib/arm64 Uygulamanızı bağlamak için GEREKEN ARM64 için yerel kitaplık
    lib/x64 Uygulamanızı bağlamak için gereken x64 yerel kitaplığı
    lib/x86 Uygulamanızı bağlamak için gereken x86 yerel kitaplığı

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ılibasound2 () için paylaşılan kitaplık.

Ş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. Yoksa dizini 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
    include C++ için gerekli üst bilgi dosyaları
    lib/arm32 Uygulamanızı bağlamak için GEREKEN ARM32 için yerel kitaplık
    lib/arm64 Uygulamanızı bağlamak için GEREKEN ARM64 için yerel kitaplık
    lib/x64 Uygulamanızı bağlamak için gereken x64 yerel kitaplığı
    lib/x86 Uygulamanızı bağlamak için gereken x86 yerel kitaplığı

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ğlamalar üzerinde cgoolduğundan, Go'un 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.24.2belirli 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.40.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 | Paketi (npm) | GitHub | Kitaplığı kaynak kodundaki ek örnekler

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";
    

hakkında importdaha fazla bilgi için bkz . JavaScript web sitesinde Dışarı ve İçeri Aktarma .

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. Podfile adlı bir pod dosyası oluşturmak için komutunu çalıştırınpod init.

  3. Podfile içeriğini aşağıdaki içerikle değiştirin. öğesinin target adını AppName uygulamanızın adına güncelleştirin. 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.40.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çeriğine bir başvuru ekleyin.

Not

.NET geliştiricileri Xamarin.Mac uygulama çerçevesini kullanarak yerel macOS uygulamaları oluşturabilir. Daha fazla bilgi için bkz . Xamarin.Mac.

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. Podfile adlı bir pod dosyası oluşturmak için komutunu çalıştırınpod init.

  3. Podfile içeriğini aşağıdaki içerikle değiştirin. öğesinin target adını AppName uygulamanızın adına güncelleştirin. 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.40.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çeriğine bir başvuru ekleyin.

Not

.NET geliştiricileri Xamarin.Mac uygulama çerçevesini kullanarak yerel macOS uygulamaları oluşturabilir. Daha fazla bilgi için bkz . Xamarin.Mac.

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 gibi Python 3.8.10bir yanıt alırsınız.

  • macOS veya Linux kullanıyorsanız, bunun yerine komutunu python3 --version çalıştırmanız gerekebilir.

    yerine python3kullanımını python etkinleştirmek için komutunu çalıştırarak alias python='python3' bir diğer ad ayarlayın. Konuşma SDK'sı hızlı başlangıç örnekleri kullanımı belirtir python .

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