Intenties herkennen met eenvoudige taalpatroonkoppeling

De Speech SDK van Azure AI-services heeft een ingebouwde functie voor het herkennen van intenties met eenvoudige taalpatronen. Een intentie is iets wat de gebruiker wil doen: een venster sluiten, een selectievakje markeren, tekst invoegen, enzovoort.

In deze handleiding gebruikt u de Speech SDK om een C++-consoletoepassing te ontwikkelen die intenties afleidt van gebruikersuitingen via de microfoon van uw apparaat. U leert het volgende:

• Een Visual Studio-project maken dat verwijst naar het NuGet-pakket van de Speech SDK
• Een spraakconfiguratie maken en een intentieherkenning ophalen
• Intenties en patronen toevoegen via de Speech SDK-API
• Spraak herkennen met een microfoon
• Asynchrone, gebeurtenisgestuurde continue herkenning gebruiken

Wanneer gebruikt u patroonkoppeling

Gebruik patroonkoppeling als:

• U bent alleen geïnteresseerd in het vergelijken van strikt wat de gebruiker zei. Deze patronen komen agressief overeen dan conversationele language understanding (CLU).
• U hebt geen toegang tot een CLU-model, maar wilt toch intenties.

Zie het overzicht van patroonkoppelingen voor meer informatie.

Vereisten

Zorg ervoor dat u de volgende items hebt voordat u aan deze handleiding begint:

• Een Azure AI-servicesresource of een Unified Speech-resource
• Visual Studio 2019 (elke editie).

Spraak en eenvoudige patronen

De eenvoudige patronen zijn een functie van de Speech SDK en hebben een Azure AI-servicesresource of een Unified Speech-resource nodig.

Een patroon is een woordgroep die een entiteit ergens erin bevat. Een entiteit wordt gedefinieerd door een woord tussen accolades te verpakken. In dit voorbeeld wordt een entiteit gedefinieerd met de id 'floorName', die hoofdlettergevoelig is:

    Take me to the {floorName}

Alle andere speciale tekens en leestekens worden genegeerd.

Intenties worden toegevoegd met aanroepen naar de IntentRecognizer-AddIntent>() API.

Een project maken

Maak een nieuw C#-consoletoepassingsproject in Visual Studio 2019 en installeer de Speech SDK.

Beginnen met standaardcode

We gaan code openen Program.cs en toevoegen die werkt als een skelet voor ons project.

using System;
using System.Threading.Tasks;
using Microsoft.CognitiveServices.Speech;
using Microsoft.CognitiveServices.Speech.Intent;

namespace helloworld
{
    class Program
    {
        static void Main(string[] args)
        {
            IntentPatternMatchingWithMicrophoneAsync().Wait();
        }

        private static async Task IntentPatternMatchingWithMicrophoneAsync()
        {
            var config = SpeechConfig.FromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");
        }
    }
}

Een Speech-configuratie maken

Voordat u een IntentRecognizer object kunt initialiseren, moet u een configuratie maken die gebruikmaakt van de sleutel en locatie voor uw Voorspellingsresource voor Azure AI-services.

• Vervang door "YOUR_SUBSCRIPTION_KEY" de voorspellingssleutel van uw Azure AI-services.
• Vervang deze door "YOUR_SUBSCRIPTION_REGION" de resourceregio van uw Azure AI-services.

In dit voorbeeld wordt de methode FromSubscription() gebruikt om de SpeechConfig te maken. Zie SpeechConfig Class voor een volledige lijst met beschikbare methoden.

Een IntentRecognizer initialiseren

Maak nu een IntentRecognizer. Voeg deze code toe onder uw Speech-configuratie.

using (var intentRecognizer = new IntentRecognizer(config))
{
    
}

Enkele intenties toevoegen

U moet enkele patronen koppelen aan de IntentRecognizer door te bellen AddIntent(). We voegen twee intenties toe met dezelfde id voor het wijzigen van vloeren en een andere intentie met een afzonderlijke id voor het openen en sluiten van deuren. Voeg deze code in het using blok in:

intentRecognizer.AddIntent("Take me to floor {floorName}.", "ChangeFloors");
intentRecognizer.AddIntent("Go to floor {floorName}.", "ChangeFloors");
intentRecognizer.AddIntent("{action} the door.", "OpenCloseDoor");

Notitie

Er is geen limiet voor het aantal entiteiten dat u kunt declareren, maar ze komen losjes overeen. Als u een woordgroep als {action} toevoegt, komt deze overeen wanneer er tekst voor het woord 'deur' staat. Intenties worden geëvalueerd op basis van hun aantal entiteiten. Als er twee patronen overeenkomen, wordt het patroon met meer gedefinieerde entiteiten geretourneerd.

Een intentie herkennen

Vanuit het IntentRecognizer-object roept u de methode RecognizeOnceAsync() aan. Met deze methode wordt de Speech-service gevraagd om spraak in één woordgroep te herkennen en te stoppen met het herkennen van spraak zodra de woordgroep is geïdentificeerd. Voor de eenvoud zullen we wachten tot de toekomstige retournering voltooid is.

Voeg deze code in onder uw intenties:

Console.WriteLine("Say something...");

var result = await intentRecognizer.RecognizeOnceAsync();

De herkenningsresultaten (of fouten) weergeven

Wanneer de Speech-service het herkenningsresultaat retourneert, wordt het resultaat afgedrukt.

Voeg deze code toe onder var result = await recognizer.RecognizeOnceAsync();:

string floorName;
switch (result.Reason)
{
    case ResultReason.RecognizedSpeech:
        Console.WriteLine($"RECOGNIZED: Text= {result.Text}");
        Console.WriteLine($"    Intent not recognized.");
        break;
    case ResultReason.RecognizedIntent:
        Console.WriteLine($"RECOGNIZED: Text= {result.Text}");
        Console.WriteLine($"       Intent Id= {result.IntentId}.");
        var entities = result.Entities;
        if (entities.TryGetValue("floorName", out floorName))
        {
            Console.WriteLine($"       FloorName= {floorName}");
        }
    
        if (entities.TryGetValue("action", out floorName))
        {
            Console.WriteLine($"       Action= {floorName}");
        }
    
        break;
    case ResultReason.NoMatch:
    {
        Console.WriteLine($"NOMATCH: Speech could not be recognized.");
        var noMatch = NoMatchDetails.FromResult(result);
        switch (noMatch.Reason)
        {
            case NoMatchReason.NotRecognized:
                Console.WriteLine($"NOMATCH: Speech was detected, but not recognized.");
                break;
            case NoMatchReason.InitialSilenceTimeout:
                Console.WriteLine($"NOMATCH: The start of the audio stream contains only silence, and the service timed out waiting for speech.");
                break;
            case NoMatchReason.InitialBabbleTimeout:
                Console.WriteLine($"NOMATCH: The start of the audio stream contains only noise, and the service timed out waiting for speech.");
                break;
            case NoMatchReason.KeywordNotRecognized:
                Console.WriteLine($"NOMATCH: Keyword not recognized");
                break;
        }
        break;
    }
    case ResultReason.Canceled:
    {
        var cancellation = CancellationDetails.FromResult(result);
        Console.WriteLine($"CANCELED: Reason={cancellation.Reason}");
    
        if (cancellation.Reason == CancellationReason.Error)
        {
            Console.WriteLine($"CANCELED: ErrorCode={cancellation.ErrorCode}");
            Console.WriteLine($"CANCELED: ErrorDetails={cancellation.ErrorDetails}");
            Console.WriteLine($"CANCELED: Did you set the speech resource key and region values?");
        }
        break;
    }
    default:
        break;
}

Uw code controleren

Op dit punt moet uw code er als volgt uitzien:

using System;
using System.Threading.Tasks;
using Microsoft.CognitiveServices.Speech;
using Microsoft.CognitiveServices.Speech.Intent;

namespace helloworld
{
    class Program
    {
        static void Main(string[] args)
        {
            IntentPatternMatchingWithMicrophoneAsync().Wait();
        }

        private static async Task IntentPatternMatchingWithMicrophoneAsync()
        {
            var config = SpeechConfig.FromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");
            using (var intentRecognizer = new IntentRecognizer(config))
            {
                intentRecognizer.AddIntent("Take me to floor {floorName}.", "ChangeFloors");
                intentRecognizer.AddIntent("Go to floor {floorName}.", "ChangeFloors");
                intentRecognizer.AddIntent("{action} the door.", "OpenCloseDoor");

                Console.WriteLine("Say something...");

                var result = await intentRecognizer.RecognizeOnceAsync();

                string floorName;
                switch (result.Reason)
                {
                    case ResultReason.RecognizedSpeech:
                        Console.WriteLine($"RECOGNIZED: Text= {result.Text}");
                        Console.WriteLine($"    Intent not recognized.");
                        break;
                    case ResultReason.RecognizedIntent:
                        Console.WriteLine($"RECOGNIZED: Text= {result.Text}");
                        Console.WriteLine($"       Intent Id= {result.IntentId}.");
                        var entities = result.Entities;
                        if (entities.TryGetValue("floorName", out floorName))
                        {
                            Console.WriteLine($"       FloorName= {floorName}");
                        }

                        if (entities.TryGetValue("action", out floorName))
                        {
                            Console.WriteLine($"       Action= {floorName}");
                        }

                        break;
                    case ResultReason.NoMatch:
                    {
                        Console.WriteLine($"NOMATCH: Speech could not be recognized.");
                        var noMatch = NoMatchDetails.FromResult(result);
                        switch (noMatch.Reason)
                        {
                            case NoMatchReason.NotRecognized:
                                Console.WriteLine($"NOMATCH: Speech was detected, but not recognized.");
                                break;
                            case NoMatchReason.InitialSilenceTimeout:
                                Console.WriteLine($"NOMATCH: The start of the audio stream contains only silence, and the service timed out waiting for speech.");
                                break;
                            case NoMatchReason.InitialBabbleTimeout:
                                Console.WriteLine($"NOMATCH: The start of the audio stream contains only noise, and the service timed out waiting for speech.");
                                break;
                            case NoMatchReason.KeywordNotRecognized:
                                Console.WriteLine($"NOMATCH: Keyword not recognized");
                                break;
                        }
                        break;
                    }
                    case ResultReason.Canceled:
                    {
                        var cancellation = CancellationDetails.FromResult(result);
                        Console.WriteLine($"CANCELED: Reason={cancellation.Reason}");

                        if (cancellation.Reason == CancellationReason.Error)
                        {
                            Console.WriteLine($"CANCELED: ErrorCode={cancellation.ErrorCode}");
                            Console.WriteLine($"CANCELED: ErrorDetails={cancellation.ErrorDetails}");
                            Console.WriteLine($"CANCELED: Did you set the speech resource key and region values?");
                        }
                        break;
                    }
                    default:
                        break;
                }
            }
        }
    }
}

De app bouwen en uitvoeren

U bent nu klaar om uw app te bouwen en de spraakherkenning te testen met behulp van de Speech-service.

1. De code compileren: kies in de menubalk van Visual Studio Build>Build Solution.
2. Start uw app: kies in de menubalk Debug>Start Debugging of druk op F5.
3. Herkenning starten - u wordt gevraagd iets te zeggen. De standaardtaal is Engels. Uw spraak wordt verzonden naar de Speech-service, getranscribeerd als tekst en weergegeven in de console.

Als u bijvoorbeeld 'Neem me mee naar verdieping 7', moet dit de uitvoer zijn:

Say something ...
RECOGNIZED: Text= Take me to floor 7.
  Intent Id= ChangeFloors
  FloorName= 7

Een project maken

Maak een nieuw C++-consoletoepassingsproject in Visual Studio 2019 en installeer de Speech SDK.

Beginnen met standaardcode

We gaan code openen helloworld.cpp en toevoegen die werkt als een skelet voor ons project.

    #include <iostream>
    #include <speechapi_cxx.h>

    using namespace Microsoft::CognitiveServices::Speech;
    using namespace Microsoft::CognitiveServices::Speech::Intent;

    int main()
    {
        std::cout << "Hello World!\n";

        auto config = SpeechConfig::FromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");
    }

Een Speech-configuratie maken

Voordat u een IntentRecognizer object kunt initialiseren, moet u een configuratie maken die gebruikmaakt van de sleutel en locatie voor uw Voorspellingsresource voor Azure AI-services.

• Vervang door "YOUR_SUBSCRIPTION_KEY" de voorspellingssleutel van uw Azure AI-services.
• Vervang deze door "YOUR_SUBSCRIPTION_REGION" de resourceregio van uw Azure AI-services.

In dit voorbeeld wordt de methode FromSubscription() gebruikt om de SpeechConfig te maken. Zie SpeechConfig Class voor een volledige lijst met beschikbare methoden.

Een IntentRecognizer initialiseren

Maak nu een IntentRecognizer. Voeg deze code toe onder uw Speech-configuratie.

    auto intentRecognizer = IntentRecognizer::FromConfig(config);

Enkele intenties toevoegen

U moet enkele patronen koppelen aan de IntentRecognizer door te bellen AddIntent(). We voegen twee intenties toe met dezelfde id voor het wijzigen van vloeren en een andere intentie met een afzonderlijke id voor het openen en sluiten van deuren.

    intentRecognizer->AddIntent("Take me to floor {floorName}.", "ChangeFloors");
    intentRecognizer->AddIntent("Go to floor {floorName}.", "ChangeFloors");
    intentRecognizer->AddIntent("{action} the door.", "OpenCloseDoor");

Notitie

Er is geen limiet voor het aantal entiteiten dat u kunt declareren, maar ze komen losjes overeen. Als u een woordgroep als {action} toevoegt, komt deze overeen wanneer er tekst voor het woord 'deur' staat. Intenties worden geëvalueerd op basis van hun aantal entiteiten. Als er twee patronen overeenkomen, wordt het patroon met meer gedefinieerde entiteiten geretourneerd.

Een intentie herkennen

Vanuit het IntentRecognizer-object roept u de methode RecognizeOnceAsync() aan. Met deze methode wordt de Speech-service gevraagd om spraak in één woordgroep te herkennen en te stoppen met het herkennen van spraak zodra de woordgroep is geïdentificeerd. Voor de eenvoud zullen we wachten tot de toekomstige retournering voltooid is.

Voeg deze code in onder uw intenties:

    std::cout << "Say something ..." << std::endl;
    auto result = intentRecognizer->RecognizeOnceAsync().get();

De herkenningsresultaten (of fouten) weergeven

Wanneer de Speech-service het herkenningsresultaat retourneert, wordt het resultaat afgedrukt.

Voeg deze code toe onder auto result = intentRecognizer->RecognizeOnceAsync().get();:

switch (result->Reason)
{
case ResultReason::RecognizedSpeech:
        std::cout << "RECOGNIZED: Text = " << result->Text.c_str() << std::endl;
        std::cout << "NO INTENT RECOGNIZED!" << std::endl;
        break;
case ResultReason::RecognizedIntent:
    std::cout << "RECOGNIZED: Text = " << result->Text.c_str() << std::endl;
    std::cout << "  Intent Id = " << result->IntentId.c_str() << std::endl;
    auto entities = result->GetEntities();
    if (entities.find("floorName") != entities.end())
    {
        std::cout << "  Floor name: = " << entities["floorName"].c_str() << std::endl;
    }

    if (entities.find("action") != entities.end())
    {
        std::cout << "  Action: = " << entities["action"].c_str() << std::endl;
    }

    break;
case ResultReason::NoMatch:
{
    auto noMatch = NoMatchDetails::FromResult(result);
    switch (noMatch->Reason)
    {
    case NoMatchReason::NotRecognized:
        std::cout << "NOMATCH: Speech was detected, but not recognized." << std::endl;
        break;
    case NoMatchReason::InitialSilenceTimeout:
        std::cout << "NOMATCH: The start of the audio stream contains only silence, and the service timed out waiting for speech." << std::endl;
        break;
    case NoMatchReason::InitialBabbleTimeout:
        std::cout << "NOMATCH: The start of the audio stream contains only noise, and the service timed out waiting for speech." << std::endl;
        break;
    case NoMatchReason::KeywordNotRecognized:
        std::cout << "NOMATCH: Keyword not recognized" << std::endl;
        break;
    }
    break;
}
case ResultReason::Canceled:
{
    auto cancellation = CancellationDetails::FromResult(result);

    if (!cancellation->ErrorDetails.empty())
    {
        std::cout << "CANCELED: ErrorDetails=" << cancellation->ErrorDetails.c_str() << std::endl;
        std::cout << "CANCELED: Did you set the speech resource key and region values?" << std::endl;
    }
}
default:
    break;
}

Uw code controleren

Op dit punt moet uw code er als volgt uitzien:

#include <iostream>
#include <speechapi_cxx.h>

using namespace Microsoft::CognitiveServices::Speech;
using namespace Microsoft::CognitiveServices::Speech::Intent;

int main()
{
    auto config = SpeechConfig::FromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");
    auto intentRecognizer = IntentRecognizer::FromConfig(config);

    intentRecognizer->AddIntent("Take me to floor {floorName}.", "ChangeFloors");
    intentRecognizer->AddIntent("Go to floor {floorName}.", "ChangeFloors");
    intentRecognizer->AddIntent("{action} the door.", "OpenCloseDoor");

    std::cout << "Say something ..." << std::endl;

    auto result = intentRecognizer->RecognizeOnceAsync().get();

    switch (result->Reason)
    {
    case ResultReason::RecognizedSpeech:
        std::cout << "RECOGNIZED: Text = " << result->Text.c_str() << std::endl;
        std::cout << "NO INTENT RECOGNIZED!" << std::endl;
        break;
    case ResultReason::RecognizedIntent:
        std::cout << "RECOGNIZED: Text = " << result->Text.c_str() << std::endl;
        std::cout << "  Intent Id = " << result->IntentId.c_str() << std::endl;
        auto entities = result->GetEntities();
        if (entities.find("floorName") != entities.end())
        {
            std::cout << "  Floor name: = " << entities["floorName"].c_str() << std::endl;
        }

        if (entities.find("action") != entities.end())
        {
            std::cout << "  Action: = " << entities["action"].c_str() << std::endl;
        }

        break;
    case ResultReason::NoMatch:
    {
        auto noMatch = NoMatchDetails::FromResult(result);
        switch (noMatch->Reason)
        {
        case NoMatchReason::NotRecognized:
            std::cout << "NOMATCH: Speech was detected, but not recognized." << std::endl;
            break;
        case NoMatchReason::InitialSilenceTimeout:
            std::cout << "NOMATCH: The start of the audio stream contains only silence, and the service timed out waiting for speech." << std::endl;
            break;
        case NoMatchReason::InitialBabbleTimeout:
            std::cout << "NOMATCH: The start of the audio stream contains only noise, and the service timed out waiting for speech." << std::endl;
            break;
        case NoMatchReason::KeywordNotRecognized:
            std::cout << "NOMATCH: Keyword not recognized." << std::endl;
            break;
        }
        break;
    }
    case ResultReason::Canceled:
    {
        auto cancellation = CancellationDetails::FromResult(result);

        if (!cancellation->ErrorDetails.empty())
        {
            std::cout << "CANCELED: ErrorDetails=" << cancellation->ErrorDetails.c_str() << std::endl;
            std::cout << "CANCELED: Did you set the speech resource key and region values?" << std::endl;
        }
    }
    default:
        break;
    }
}

De app bouwen en uitvoeren

U bent nu klaar om uw app te bouwen en de spraakherkenning te testen met behulp van de Speech-service.

1. De code compileren: kies in de menubalk van Visual Studio Build>Build Solution.
2. Start uw app: kies in de menubalk Debug>Start Debugging of druk op F5.
3. Herkenning starten - u wordt gevraagd iets te zeggen. De standaardtaal is Engels. Uw spraak wordt verzonden naar de Speech-service, getranscribeerd als tekst en weergegeven in de console.

Als u bijvoorbeeld 'Neem me mee naar verdieping 7', moet dit de uitvoer zijn:

Say something ...
RECOGNIZED: Text = Take me to floor 7.
  Intent Id = ChangeFloors
  Floor name: = 7

Referentiedocumentatie | Aanvullende voorbeelden op GitHub

In deze quickstart installeert u de Speech SDK voor Java.

Platformvereisten

Kies uw doelomgeving:

Java Runtime

De Speech SDK voor Java is compatibel met Windows, Linux en macOS.

Windows

In Windows moet u de 64-bits doelarchitectuur gebruiken. Windows 10 of hoger is vereist.

Installeer Microsoft Visual C++ Redistributable voor Visual Studio 2015, 2017, 2019 en 2022 voor uw platform. Als u dit pakket voor de eerste keer installeert, moet u mogelijk opnieuw opstarten.

De Speech SDK voor Java biedt geen ondersteuning voor Windows in ARM64.

Linux

De Speech SDK voor Java ondersteunt de volgende distributies op de x64-, ARM32- en ARM64-architecturen:

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

Belangrijk

Gebruik de meest recente LTS-versie van de Linux-distributie. Als u bijvoorbeeld Ubuntu 20.04 LTS gebruikt, gebruikt u de nieuwste versie van Ubuntu 20.04.X.

De Speech SDK is afhankelijk van de volgende Linux-systeembibliotheken:

• De gedeelde bibliotheken van de GNU C-bibliotheek, waaronder de POSIX Threads Programming-bibliotheek, libpthreads.
• De OpenSSL-bibliotheek, versie 1.x (libssl1) of 3.x (libssl3) en certificaten (ca-certificates).
• De gedeelde bibliotheek voor ALSA-toepassingen (libasound2).

Ubuntu 20.04/22.04/24.04

Voer deze opdrachten uit:

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

Debian 11/12

Voer deze opdrachten uit:

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

Amazon Linux 2023

Voer deze opdrachten uit:

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

Azure Linux 3.0

Voer deze opdrachten uit:

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

MacOS

Een macOS-versie 10.14 of hoger is vereist.

Android

De Speech SDK is compatibel met Android-apparaten met 32/64-bits ARM-processor en Intel x86/x64-compatibele processors.

Installeer een Java Development Kit zoals Azul Zulu OpenJDK. De Microsoft Build van OpenJDK of uw favoriete JDK moet ook werken.

De Speech SDK voor Java installeren

Sommige instructies gebruiken een specifieke SDK-versie, zoals 1.42.0. Als u de nieuwste versie wilt controleren, zoekt u in onze GitHub-opslagplaats.

Kies uw doelomgeving:

Java Runtime

Deze handleiding laat zien hoe u de Speech SDK voor Java installeert in de Java Runtime.

Ondersteunde besturingssystemen

Het Speech SDK-pakket voor Java is beschikbaar voor deze besturingssystemen:

• Windows: alleen 64-bits.
• Mac: macOS X versie 10.14 of hoger.
• Linux: Bekijk de ondersteunde Linux-distributies en doelarchitecturen.

Maven

Volg deze stappen om de Speech SDK voor Java te installeren met behulp van Apache Maven:

1. Installeer Apache Maven.

2. Open een opdrachtprompt waarin u het nieuwe project wilt opnemen en maak een nieuw pom.xml bestand.

3. Kopieer de volgende XML-inhoud naar 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.42.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. Voer de volgende Maven-opdracht uit om de Speech SDK en afhankelijkheden te installeren.

   mvn clean dependency:copy-dependencies
   

Eclipse

Een Eclipse-project maken en de Speech SDK installeren

1. Installeer de Eclipse Java IDE. Voor deze IDE moet Java al zijn geïnstalleerd.

2. Start Eclipse.

3. Voer in Eclipse Launcher in het vak Werkruimte de naam in van een nieuwe werkruimtemap. Selecteer vervolgens Starten.

   

4. Binnen enkele ogenblikken verschijnt het hoofdvenster van de Eclipse-IDE. Sluit het welkomstscherm als dit verschijnt.

5. Selecteer Bestand>nieuw>project in het Eclipse-menu.

6. Het dialoogvenster Nieuw project wordt weergegeven. Selecteer Java Project en selecteer vervolgens Volgende.

   

7. De wizard Nieuw Java-project wordt gestart. Voer in het veld Projectnaam snelstart in. Kies JavaSE-1.8 als uitvoeringsomgeving. Selecteer Voltooien.

   

8. Als het venster Gekoppeld perspectief openen? wordt weergegeven, selecteert u Perspectief openen.

9. Klik in Package Explorer met de rechtermuisknop op het snelstartproject . Selecteer Converteren naar Maven-project configureren>in het contextmenu.

   

10. Het venster Nieuw POM maken wordt weergegeven. Voer in het veld Groeps-id com.microsoft.cognitiveservices.speech.samples in. Voer in het veld Artefact-id de quickstart in. Selecteer vervolgens Voltooien.

    

11. Open het pom.xml bestand en bewerk het:

    1. Voeg een dependencies element toe aan het einde van het bestand, vóór de afsluitende tag </project>, met de Speech SDK als een afhankelijkheid:

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

    1. De wijzigingen opslaan.

Gradle

Gradle-configuraties

Gradle-configuraties vereisen een expliciete verwijzing naar de afhankelijkheidsextensie .jar :

// build.gradle

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

Android

In deze gids ontdekt u hoe u de Speech SDK kunt installeren voor Java op Android.

De Speech SDK voor Android is verpakt als een AAR-bestand (Android Archive), dat de benodigde bibliotheken en vereiste Android-machtigingen bevat.

De Speech SDK installeren met Behulp van Android Studio

Maak een nieuw project in Android Studio en voeg de Speech SDK voor Java toe als bibliotheekafhankelijkheid. De installatie is gebaseerd op het Speech SDK Maven-pakket en Android Studio Chipmunk 2021.2.1.

Een leeg project maken

1. Open Android Studio en selecteer Nieuw project.

   

2. Selecteer in het venster Nieuw project dat wordt weergegeven de lege activiteit Telefoon en Tablet>en selecteer vervolgens Volgende.

   

3. Voer SpeechQuickstart in het tekstvak Naam in.

   

4. Voer samples.speech.cognitiveservices.microsoft.com in het tekstvak Pakketnaam in.

5. Selecteer een projectmap in het selectievak Locatie opslaan.

6. Selecteer Java in het selectievak Taal .

7. Selecteer API 23: Android 6.0 (Marshmallow) in het selectievak minimum-API-niveau .

8. Selecteer Voltooien.

Het duurt even voordat Android Studio uw nieuwe project voorbereidt. Voor de eerste keer dat u Android Studio gebruikt, kan het enkele minuten duren om voorkeuren in te stellen, licenties te accepteren en de wizard te voltooien.

De Speech SDK voor Java installeren op Android

Voeg de Speech SDK toe als een afhankelijkheid in uw project.

1. Selecteer de app Bestandsprojectstructuurafhankelijkheden.>>>

2. Selecteer het plusteken (+) om een afhankelijkheid toe te voegen onder Gedeclareerde afhankelijkheden. Selecteer vervolgens Bibliotheekafhankelijkheid in de vervolgkeuzelijst.

   

3. Voer in het venster Bibliotheekafhankelijkheid toevoegen dat wordt weergegeven de naam en versie van de Speech SDK voor Java in: com.microsoft.cognitiveservices.speech:client-sdk:1.42.0. Selecteer vervolgens Zoeken.

4. Zorg ervoor dat de geselecteerde groeps-id com.microsoft.cognitiveservices.speech is en selecteer vervolgens OK.

5. Selecteer OK om het venster Projectstructuur te sluiten en wijzigingen toe te passen op het project.

Beginnen met standaardcode

1. Open Main.java vanuit de src dir.

2. Vervang de inhoud van het bestand door het volgende:

package quickstart;
import java.util.Dictionary;
import java.util.concurrent.ExecutionException;

import com.microsoft.cognitiveservices.speech.*;
import com.microsoft.cognitiveservices.speech.intent.*;

public class Program {
    public static void main(String[] args) throws InterruptedException, ExecutionException {
        IntentPatternMatchingWithMicrophone();
    }

    public static void IntentPatternMatchingWithMicrophone() throws InterruptedException, ExecutionException {
        SpeechConfig config = SpeechConfig.fromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");
    }
}

Een Speech-configuratie maken

Voordat u een IntentRecognizer object kunt initialiseren, moet u een configuratie maken die gebruikmaakt van de sleutel en locatie voor uw Voorspellingsresource voor Azure AI-services.

• Vervang door "YOUR_SUBSCRIPTION_KEY" de voorspellingssleutel van uw Azure AI-services.
• Vervang deze door "YOUR_SUBSCRIPTION_REGION" de resourceregio van uw Azure AI-services.

In dit voorbeeld wordt de methode FromSubscription() gebruikt om de SpeechConfig te maken. Zie SpeechConfig Class voor een volledige lijst met beschikbare methoden.

Een IntentRecognizer initialiseren

Maak nu een IntentRecognizer. Voeg deze code toe onder uw Speech-configuratie.

try (IntentRecognizer intentRecognizer = new IntentRecognizer(config)) {
    
}

Enkele intenties toevoegen

U moet enkele patronen koppelen aan de IntentRecognizer door te bellen addIntent(). We voegen twee intenties toe met dezelfde id voor het wijzigen van vloeren en een andere intentie met een afzonderlijke id voor het openen en sluiten van deuren. Voeg deze code in het try blok in:

intentRecognizer.addIntent("Take me to floor {floorName}.", "ChangeFloors");
intentRecognizer.addIntent("Go to floor {floorName}.", "ChangeFloors");
intentRecognizer.addIntent("{action} the door.", "OpenCloseDoor");

Notitie

Er is geen limiet voor het aantal entiteiten dat u kunt declareren, maar ze komen losjes overeen. Als u een woordgroep zoals {action} toevoegt, komt deze overeen wanneer er tekst voor het woord 'deur' staat. Intenties worden geëvalueerd op basis van hun aantal entiteiten. Als er twee patronen overeenkomen, wordt het patroon met meer gedefinieerde entiteiten geretourneerd.

Een intentie herkennen

Vanuit het IntentRecognizer-object roept u de methode recognizeOnceAsync() aan. Met deze methode wordt de Speech-service gevraagd om spraak in één woordgroep te herkennen en te stoppen met het herkennen van spraak zodra de woordgroep is geïdentificeerd. Voor de eenvoud zullen we wachten tot de toekomstige retournering voltooid is.

Voeg deze code in onder uw intenties:

System.out.println("Say something...");

IntentRecognitionResult result = intentRecognizer.recognizeOnceAsync().get();

De herkenningsresultaten (of fouten) weergeven

Wanneer het herkenningsresultaat wordt geretourneerd door de Speech-service, wordt het resultaat afgedrukt.

Voeg deze code toe onder IntentRecognitionResult result = recognizer.recognizeOnceAsync().get();:

if (result.getReason() == ResultReason.RecognizedSpeech) {
    System.out.println("RECOGNIZED: Text= " + result.getText());
    System.out.println(String.format("%17s", "Intent not recognized."));
}
else if (result.getReason() == ResultReason.RecognizedIntent) {
    System.out.println("RECOGNIZED: Text= " + result.getText());
    System.out.println(String.format("%17s %s", "Intent Id=", result.getIntentId() + "."));
    Dictionary<String, String> entities = result.getEntities();

    if (entities.get("floorName") != null) {
        System.out.println(String.format("%17s %s", "FloorName=", entities.get("floorName")));
    }
    if (entities.get("action") != null) {
        System.out.println(String.format("%17s %s", "Action=", entities.get("action")));
    }
}
else if (result.getReason() == ResultReason.NoMatch) {
    System.out.println("NOMATCH: Speech could not be recognized.");
}
else if (result.getReason() == ResultReason.Canceled) {
    CancellationDetails cancellation = CancellationDetails.fromResult(result);
    System.out.println("CANCELED: Reason=" + cancellation.getReason());

    if (cancellation.getReason() == CancellationReason.Error)
    {
        System.out.println("CANCELED: ErrorCode=" + cancellation.getErrorCode());
        System.out.println("CANCELED: ErrorDetails=" + cancellation.getErrorDetails());
        System.out.println("CANCELED: Did you update the subscription info?");
    }
}

Uw code controleren

Op dit punt moet uw code er als volgt uitzien:

package quickstart;
import java.util.Dictionary;
import java.util.concurrent.ExecutionException;

import com.microsoft.cognitiveservices.speech.*;
import com.microsoft.cognitiveservices.speech.intent.*;

public class Main {
    public static void main(String[] args) throws InterruptedException, ExecutionException {
        IntentPatternMatchingWithMicrophone();
    }

    public static void IntentPatternMatchingWithMicrophone() throws InterruptedException, ExecutionException {
        SpeechConfig config = SpeechConfig.fromSubscription("YOUR_SUBSCRIPTION_KEY", "YOUR_SUBSCRIPTION_REGION");

        try (IntentRecognizer intentRecognizer = new IntentRecognizer(config)) {
            intentRecognizer.addIntent("Take me to floor {floorName}.", "ChangeFloors");
            intentRecognizer.addIntent("Go to floor {floorName}.", "ChangeFloors");
            intentRecognizer.addIntent("{action} the door.", "OpenCloseDoor");

            System.out.println("Say something...");

            IntentRecognitionResult result = intentRecognizer.recognizeOnceAsync().get();
            if (result.getReason() == ResultReason.RecognizedSpeech) {
            System.out.println("RECOGNIZED: Text= " + result.getText());
            System.out.println(String.format("%17s", "Intent not recognized."));
            }
            else if (result.getReason() == ResultReason.RecognizedIntent) {
                System.out.println("RECOGNIZED: Text= " + result.getText());
                System.out.println(String.format("%17s %s", "Intent Id=", result.getIntentId() + "."));
                Dictionary<String, String> entities = result.getEntities();

                if (entities.get("floorName") != null) {
                    System.out.println(String.format("%17s %s", "FloorName=", entities.get("floorName")));
                }
                if (entities.get("action") != null) {
                    System.out.println(String.format("%17s %s", "Action=", entities.get("action")));
                }
            }
            else if (result.getReason() == ResultReason.NoMatch) {
                System.out.println("NOMATCH: Speech could not be recognized.");
            }
            else if (result.getReason() == ResultReason.Canceled) {
                CancellationDetails cancellation = CancellationDetails.fromResult(result);
                System.out.println("CANCELED: Reason=" + cancellation.getReason());

                if (cancellation.getReason() == CancellationReason.Error)
                {
                    System.out.println("CANCELED: ErrorCode=" + cancellation.getErrorCode());
                    System.out.println("CANCELED: ErrorDetails=" + cancellation.getErrorDetails());
                    System.out.println("CANCELED: Did you update the subscription info?");
                }
            }
        }
    }
}

De app bouwen en uitvoeren

U bent nu klaar om uw app te bouwen en onze intentieherkenning te testen met behulp van de spraakservice en de ingesloten patroonmatcher.

Selecteer de knop Uitvoeren in Eclipse of druk op Ctrl+F11 en bekijk vervolgens de uitvoer voor de tekst 'Iets zeggen...' prompt. Zodra deze wordt weergegeven, spreekt u uw uiting en bekijkt u de uitvoer.

Als u bijvoorbeeld 'Neem me mee naar verdieping 7', moet dit de uitvoer zijn:

Say something ...
RECOGNIZED: Text= Take me to floor 7.
  Intent Id= ChangeFloors
  FloorName= 7

Volgende stappen

Verbeter uw patroonkoppeling met behulp van aangepaste entiteiten.