كيفية التعرف على الأهداف مع مطابقة نمط اللغة البسيطة

تحتوي خدمات Azure الذكاء الاصطناعي Speech SDK على ميزة مضمنة لتوفير التعرف على الهدف مع مطابقة نمط اللغة البسيط. الهدف هو شيء يريد المستخدم القيام به: إغلاق نافذة، ووضع علامة على خانة اختيار، وإدراج بعض النص، وما إلى ذلك.

في هذا الدليل، يمكنك استخدام خدمة Speech SDK لتطوير تطبيق وحدة تحكم C++ الذي يستمد الأهداف من كلام المستخدم المنطوق من خلال ميكروفون جهازك. ‏‫ستتعلم كيفية:

• أنشئ مشروع Visual Studio بالرجوع إلى حزمة Speech SDK NuGet
• إنشاء تكوين الكلام والحصول علـى أداة التعرف على الهدف
• إضافة الأهداف والأنماط عبر Speech SDK API
• التعرّف على الكلام من الميكروفون
• استخدم التعرف المستمر غير المتزامن المستند إلى الحدث

متى تستخدم مُطابقة النمط

استخدم مطابقة النمط إذا:

• أنت مهتم فقط بمطابقة ما قاله المستخدم بدقة. تتطابق هذه الأنماط بقوة أكبر من فهم لغة المحادثة (CLU).
• ليس لديك حق الوصول إلى نموذج CLU، ولكنك لا تزال تريد الأهداف.

لمزيد مـن المعلومات، راجع نظرة عامة على مطابقة النمط.

المتطلبات الأساسية

تأكد من أن لديك العناصر التالية قبل بدء هذا الدليل:

• مورد خدمات Azure الذكاء الاصطناعي أو مورد الكلام الموحد
• Visual Studio 2019(أي إصدار).

الكلام والأنماط البسيطة

الأنماط البسيطة هي ميزة من ميزات Speech SDK وتحتاج إلى مورد خدمات Azure الذكاء الاصطناعي أو مورد Speech موحد.

النمط هو عبارة تتضمن كياناً في مكان ما داخله. يُعرَّف الكيان عن طريق التفاف كلمة بين أقواس متعرجة. يُعرِّف هذا المثال كياناً يحمل المعرّف "floorName"، وهو حساس لحالة الأحرف:

    Take me to the {floorName}

يتم تجاهل جميع الأحرف الخاصة الأخرى وعلامات الترقيم.

تتم إضافة الأهداف باستخدام استدعاءات إلى IntentRecognizer-AddIntent>() API.

إنشاء مشروع

إنشاء مَشروع تطبيق وحدة تحكم C# جديد في Visual Studio 2019 وتثبيت Speech SDK.

ابدأ ببعض التعليمات البرمجية المتداولة

لنفتح Program.cs ونضيف بعض التعليمات البرمجية التي تعمل كهيكل لمشروعنا.

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

إنشاء تكوين الكلام.

قبل أن تتمكن من تهيئة كائن IntentRecognizer ، تحتاج إلى إنشاء تكوين يستخدم المفتاح والموقع لمورد توقع خدمات Azure الذكاء الاصطناعي.

• استبدل "YOUR_SUBSCRIPTION_KEY" بمفتاح توقع خدمات Azure الذكاء الاصطناعي.
• استبدل "YOUR_SUBSCRIPTION_REGION" بمنطقة مورد خدمات Azure الذكاء الاصطناعي.

يستخدم هذا النموذج أسلوبFromSubscription()لإنشاء SpeechConfig. للحصول على قائمة كاملة بالطرق المتاحة، راجعفئة SpeechConfig.

تهيئة المتعرف على الأهداف

الآن أنشئ IntentRecognizer. إدراج هذا الكود مباشرةً أسفل تكوين الكلام.

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

إضافة بعض الأهداف

تحتاج إلى إقران بعض الأنماط مع IntentRecognizer عن طريق استدعاء AddIntent(). سيُضاف هدفان بنفس المُعرّف لتغيير الطوابق، وإضافة هدف آخر بمُعرّف منفصل لفتح الأبواب وإغلاقها. إدخال هذا الرمز داخل الكتلة using:

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

إشعار

لا يوجد حد لعدد الكيانات التي يمكنك الإعلان عنها، ولكن ستتم مطابقتها باستفاضة. إذا أضفت عبارة مثل "{action} door" فستتطابق في أي وقت يوجد فيه نص قبل كلمة "door". يُجرى تقييم الأهداف بناء على عدد الكيانات. إذا تطابق نمطان، يُعاد النمط الذي يحتوي على كيانات أكثر تحديداً.

التعرف على الهدف

من الكائنIntentRecognizer، ستطلب طريقةRecognizeOnceAsync(). تطلب هذه الطريقة من خدمة الكلام التعرف على الكلام في عبارة واحدة، والتوقف عن التعرف على الكلام بمجرد تحديد العبارة. من أجل التبسيط، سننتظر حتى يكتمل.

إدراج هـذه التعليمة البرمجية أسفل أهدافك:

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

var result = await intentRecognizer.RecognizeOnceAsync();

عرض نتائج التعرف (أو الأخطاء)

عند إرجاع نتيجة التعرف بواسطة خدمة الكلام، سوف نقوم بطباعة النتيجة.

أدخِل هذا الرمز أسفل 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;
}

تحقق من الكود الخاص بك.

في هذه النقطة، يجب أن تظهر التعليمات البرمجية كذلك:

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

إنشاء تطبيقك وتشغيله

الآن أنت مستعد لإنشاء التطبيق واختبار التعرف على الكلام باستخدام خدمة التعرف على الكلام.

1. ترجمة التعليمات البرمجية - من شريط قوائم Visual Studio، اختر إنشاء>إنشاء حل.
2. ابدأ تشغيل تطبيقك - من شريط القوائم، اخترتصحيح الأخطاء>بدء التصحيح أو اضغط F5.
3. بدء التعرف - سوف يطالبك بقول شيء ما. اللغة الافتراضية هـي اللغة الإنجليزية. يُرسل الكلام إلى خدمة التعرف على الكلام ونسخه كنص وتقديمه في وحدة التحكم.

على سبيل المثال، إذا قلت "خذني إلى الطابق 7"، يكون الناتج كالآتي:

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

إنشاء مشروع

إنشاء مشروع تطبيق وحدة تحكم C++‎ جديد فـي Visual Studio 2019 وتثبيت Speech SDK.

ابدأ ببعض التعليمات البرمجية المتداولة

لنفتح helloworld.cpp ونضيف بعض التعليمات البرمجية التي تعمل كهيكل لمشروعنا.

    #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");
    }

إنشاء تكوين الكلام.

قبل أن تتمكن من تهيئة كائن IntentRecognizer ، تحتاج إلى إنشاء تكوين يستخدم المفتاح والموقع لمورد توقع خدمات Azure الذكاء الاصطناعي.

• استبدل "YOUR_SUBSCRIPTION_KEY" بمفتاح توقع خدمات Azure الذكاء الاصطناعي.
• استبدل "YOUR_SUBSCRIPTION_REGION" بمنطقة مورد خدمات Azure الذكاء الاصطناعي.

يستخدم هذا النموذج أسلوبFromSubscription()لإنشاء SpeechConfig. للحصول على قائمة كاملة بالطرق المتاحة، راجعفئة SpeechConfig.

تهيئة المتعرف على الأهداف

الآن أنشئ IntentRecognizer. إدراج هذا الكود مباشرةً أسفل تكوين الكلام.

    auto intentRecognizer = IntentRecognizer::FromConfig(config);

إضافة بعض الأهداف

تحتاج إلى إقران بعض الأنماط مع IntentRecognizer عن طريق استدعاء AddIntent(). سيُضاف هدفان بنفس المُعرّف لتغيير الطوابق، وإضافة هدف آخر بمُعرّف منفصل لفتح الأبواب وإغلاقها.

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

إشعار

لا يوجد حد لعدد الكيانات التي يمكنك الإعلان عنها، ولكن ستتم مطابقتها باستفاضة. إذا أضفت عبارة مثل "{action} door" فستتطابق في أي وقت يوجد فيه نص قبل كلمة "door". يُجرى تقييم الأهداف بناء على عدد الكيانات. إذا تطابق نمطان، يُعاد النمط الذي يحتوي على كيانات أكثر تحديداً.

التعرف على الهدف

من الكائنIntentRecognizer، ستطلب طريقةRecognizeOnceAsync(). تطلب هذه الطريقة من خدمة الكلام التعرف على الكلام في عبارة واحدة، والتوقف عن التعرف على الكلام بمجرد تحديد العبارة. من أجل التبسيط، سننتظر حتى يكتمل.

إدراج هـذه التعليمة البرمجية أسفل أهدافك:

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

عرض نتائج التعرف (أو الأخطاء)

عند إرجاع نتيجة التعرف بواسطة خدمة الكلام، سوف نقوم بطباعة النتيجة.

أدخِل هذا الرمز أسفل 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;
}

تحقق من الكود الخاص بك.

في هذه النقطة، يجب أن تظهر التعليمات البرمجية كذلك:

#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;
    }
}

إنشاء تطبيقك وتشغيله

الآن أنت مستعد لإنشاء التطبيق واختبار التعرف على الكلام باستخدام خدمة التعرف على الكلام.

1. ترجمة التعليمات البرمجية - من شريط قوائم Visual Studio، اختر إنشاء>إنشاء حل.
2. ابدأ تشغيل تطبيقك - من شريط القوائم، اخترتصحيح الأخطاء>بدء التصحيح أو اضغط F5.
3. بدء التعرف - سوف يطالبك بقول شيء ما. اللغة الافتراضية هـي اللغة الإنجليزية. يُرسل الكلام إلى خدمة التعرف على الكلام ونسخه كنص وتقديمه في وحدة التحكم.

على سبيل المثال، إذا قلت "خذني إلى الطابق 7"، يكون الناتج كالآتي:

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

وثائق مرجعية | نماذج إضافية على GitHub

في هذا التشغيل السريع، يمكنك تثبيت Speech SDK ل Java.

متطلبات النظام الأساسي

اختر البيئة المستهدفة:

Java Runtime

يتوافق Speech SDK لـ Java مع أنظمة التشغيل Windows وLinux وmacOS.

Windows

في Windows، يجب استخدام بنية الهدف 64 بت. مطلوب Windows 10 أو إصدار أحدث.

قم بتثبيت Microsoft Visual C++ Redistributable ل Visual Studio 2015 و2017 و2019 و2022 للنظام الأساسي الخاص بك. يتطلب التثبيت لأول مرة إعادة تشغيل.

لا يدعم Speech SDK ل Java Windows على ARM64.

Linux

تنبيه

تشير هذه المقالة إلى CentOS، وهو توزيع Linux يقترب من حالة نهاية العمر الافتراضي (EOL). يرجى مراعاة استخدامك والتخطيط وفقا لذلك. لمزيد من المعلومات، راجع إرشادات نهاية العمر الافتراضي CentOS.

يدعم Speech SDK ل Java التوزيعات التالية على بنى x64 وARM32 (Debian/Ubuntu) وARM64 (Debian/Ubuntu):

• Ubuntu 18.04/20.04
• دبيان 10/11
• Red Hat Enterprise Linux (RHEL) 7/8
• CentOS 7

هام

استخدم أحدث إصدار LTS لتوزيع Linux. على سبيل المثال، إذا كنت تستخدم Ubuntu 20.04 LTS، استخدم أحدث إصدار من Ubuntu 20.04.X.

يعتمد Speech SDK على مكتبات نظام Linux التالية:

• المكتبات المشتركة لمكتبة GNU C، بما في ذلك مكتبة برمجة مؤشرات ترابط POSIX، libpthreads.
• مكتبة OpenSSL (libssl) الإصدار 1.x والشهادات (ca-certificates).
• المكتبة المشتركة لتطبيقات ALSA (libasound).

يجب عليك أيضا التثبيت ca-certificates لإنشاء websocket آمن وتجنب WS_OPEN_ERROR_UNDERLYING_IO_OPEN_FAILED الخطأ.

هام

لا يدعم Speech SDK حتى الآن OpenSSL 3.0، وهو الإعداد الافتراضي في Ubuntu 22.04 وD debian 12.

Ubuntu 18.04/20.04

شغَّل هذه الأوامر:

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

دبيان 10/11

لاستخدام Speech SDK في Alpine Linux، أنشئ بيئة Debian chroot كما هو موثق في Alpine Linux Wiki على تشغيل برامج glibc. ثم اتبع تعليمات Debian هنا.

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

RHEL 7/8 وCentOS 7

تنبيه

تشير هذه المقالة إلى CentOS، وهو توزيع Linux يقترب من حالة نهاية العمر الافتراضي (EOL). يرجى مراعاة استخدامك والتخطيط وفقا لذلك. لمزيد من المعلومات، راجع إرشادات نهاية العمر الافتراضي CentOS.

تثبيت أدوات التطوير والمكتبات:

sudo yum update
sudo yum groupinstall "Development tools"
sudo yum install alsa-lib openssl wget

هام

• من RHEL/CentOS 7، اتبع الإرشادات حول كيفية تكوين RHEL/CentOS 7 للكلام SDK.
• على RHEL، اتبع الإرشادات حول كيفية تكوين OpenSSL ل Linux.

ماك

مطلوب macOS بالإصدار 10.14 أو أحدث.

Android

يتوافق Speech SDK مع أجهزة Android التي تحتوي على معالج ARM 32/64 بت ومعالجات Intel x86/x64 المتوافقة.

تثبيت Java Development Kit مثل Azul Zulu OpenJDK. يجب أن يعمل Microsoft Build of OpenJDK أو JDK المفضل لديك أيضًا.

تثبيت SDK الكلام لـ Java

بعض الإرشادات تستخدم إصدار SDK معينًا مثل 1.24.2. للتحقق من أحدث إصدار، ابحث في مستودع GitHub.

اختر البيئة المستهدفة:

Java Runtime

هذا الدليل يوضح كيفية تثبيت Speech SDK لـ Java على Java Runtime.

أنظمة التشغيل المدعومة

تُتاح Speech SDK لحزمة Java لأنظمة التشغيل هذه:

• Windows: 64 بت فقط.
• Mac - macOS X الإصدار 10.14 أو أحدث.
• Linux: راجع توزيعات Linux المدعومة والبنى المستهدفة.

Maven

اتبع هذه الخطوات لتثبيت Speech SDK لـ Java باستخدام Apache Maven:

1. قم بتثبيت Apache Maven.

2. افتح موجه الأوامر حيث تريد المشروع الجديد، وأنشئ ملف pom.xml جديد.

3. انسخ محتوى XML التالي إلى 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.37.0</version>
           </dependency>
       </dependencies>
   </project>
   

4. يجب تشغيل أمر Maven التالي لتثبيت Speech SDK والتبعيات.

   mvn clean dependency:copy-dependencies
   

الكسوف

إنشاء مشروع Eclipse وتثبيت Speech SDK

1. قم بتثبيت Eclipse Java IDE. يتطلب IDE هذا تثبيت Java بالفعل.

2. تشغيل Eclipse.

3. في Eclipse Launcher في المربع مساحة العمل، أدخل اسم دليل مساحة عمل جديد. ثم حدد تشغيل.

   

4. وفي لحظة، تظهر النافذة الرئيسية لـ Eclipse Launcher. أغلق شاشة الترحيب إذا كان أحد موجوداً.

5. من قائمة Eclipse، حدد File>New>Project.

6. يظهر مربع الحوار للمشروع الجديد. حدد مشروع Java، ثم حدد التالي.

   

7. يبدأ معالج المشروع الجديد لـ Java. في الحقل Project name، أدخِل quickstart. اختر JavaSE-1.8 لتكون بيئة التنفيذ. حدد إنهاء.

   

8. ماذا يحدث في حالةAssociated Perspective المفتوحة؟تظهر النافذة، وبعدها قم بتحديدOpen Perspective.

9. في Package explorer، اضغط بزر الماوس الأيمن فوق مشروع التشغيل السريع. حدد Configure>Convert to Maven Project من قائمة السياق.

   

10. تظهر نافذة إنشاء POM جديد. في حقل معرف المجموعة، أدخل com.microsoft.cognitiveservices.speech.samples. في الحقل Artifact Id، أدخل quickstart. ثم حدد إنهاء.

    

11. افتح ملف pom.xml ثم حرره:

    1. أضف عنصرا dependencies في نهاية الملف، قبل علامة </project>الإغلاق ، مع Speech SDK كتبعية:

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

    1. ا‏‏حفظ التغييرات.

Gradle

تكوينات Gradle

تتطلب تكوينات Gradle مرجعا صريحا إلى ملحق التبعية .jar :

// build.gradle

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

Android

يوضح هذا الدليل كيفية تثبيت Speech SDK لـ Java على Android.

يتم تجميع Speech SDK لنظام Android في حزمة ملف Android Archive (AAR)، والتي تتضمن المكتبات الضرورية وأذونات Android المطلوبة.

تثبيت Speech SDK باستخدام Android Studio

أنشئ مشروعًا جديدًا في Android Studio وإضافة Speech SDK ل Java كتبعية مكتبة. ويستند الإعداد على حزمة Speech SDK Maven، وAndroid Studio Chipmunk 2021.2.1.

إنشاء مشروع فارغ

1. افتح Android Studio وحدد New project.

   

2. في نافذة New project التي تظهر، حدد Phone and Tablet>Empty Activity، ثم حدد Next.

   

3. أدخل SpeechQuickstart في مربع النص Name.

   

4. أدخل samples.speech.cognitiveservices.microsoft.com في مربع النص Package name.

5. حدد دليل مشروع في مربع التحديد حفظ الموقع.

6. حدد Java في مربع التحديد Language.

7. حدد API 23: Android 6.0 (Marshmallow) في مربع التحديد Minimum API level.

8. حدد إنهاء.

يستغرق Android Studio بعض الوقت لإعداد مشروعك الجديد. للمرة الأولى التي تستخدم فيها Android Studio، قد يستغرق الأمر بضع دقائق لتعيين التفضيلات وقبول التراخيص وإكمال المعالج.

تثبيت SDK الكلام لـ Java على Android

أضف Speech SDK كتبعية في مشروعك.

1. حدد File>Project structure>Dependencies>app.

2. حدد رمز الجمع (+) لإضافة تبعية ضمن Declared Dependencies. ثم حدد تبعية المكتبة من القائمة المنسدلة.

   

3. في نافذة Add Library Dependency التي تظهر، أدخل اسم وإصدار Speech SDK ل Java: com.microsoft.cognitiveservices.speech:client-sdk:1.37.0. ثم حدد بحث.

4. تأكد من أن Group ID المحدد هو com.microsoft.cognitiveservices.speech، ثم حدد OK.

5. حدد OK لإغلاق نافذة Project Structure وتطبيق تغييراتك على المشروع.

ابدأ ببعض التعليمات البرمجية المتداولة

1. افتح Main.java من src dir.

2. استبدال محتويات الملف بالتعليمات البرمجية التالية:

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

إنشاء تكوين الكلام.

قبل أن تتمكن من تهيئة كائن IntentRecognizer ، تحتاج إلى إنشاء تكوين يستخدم المفتاح والموقع لمورد توقع خدمات Azure الذكاء الاصطناعي.

• استبدل "YOUR_SUBSCRIPTION_KEY" بمفتاح توقع خدمات Azure الذكاء الاصطناعي.
• استبدل "YOUR_SUBSCRIPTION_REGION" بمنطقة مورد خدمات Azure الذكاء الاصطناعي.

يستخدم هذا النموذج أسلوبFromSubscription()لإنشاء SpeechConfig. للحصول على قائمة كاملة بالطرق المتاحة، راجعفئة SpeechConfig.

تهيئة المتعرف على الأهداف

الآن أنشئ IntentRecognizer. إدراج هذا الكود مباشرةً أسفل تكوين الكلام.

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

إضافة بعض الأهداف

تحتاج إلى إقران بعض الأنماط مع IntentRecognizer عن طريق استدعاء addIntent(). سيُضاف هدفان بنفس المُعرّف لتغيير الطوابق، وإضافة هدف آخر بمُعرّف منفصل لفتح الأبواب وإغلاقها. إدخال هذا الرمز داخل الكتلة try:

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

إشعار

لا يوجد حد لعدد الكيانات التي يمكنك الإعلان عنها، ولكن ستتم مطابقتها باستفاضة. إذا أضفت عبارة مثل "{action} door" فستتطابق في أي وقت يوجد فيه نص قبل كلمة "door". يُجرى تقييم الأهداف بناء على عدد الكيانات. إذا تطابق نمطان، يُعاد النمط الذي يحتوي على كيانات أكثر تحديداً.

التعرف على الهدف

من الكائنIntentRecognizer، ستطلب طريقةrecognizeOnceAsync(). تطلب هذه الطريقة من خدمة الكلام التعرف على الكلام في عبارة واحدة، والتوقف عن التعرف على الكلام بمجرد تحديد العبارة. من أجل التبسيط، سننتظر حتى يكتمل.

إدراج هـذه التعليمة البرمجية أسفل أهدافك:

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

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

عرض نتائج التعرف (أو الأخطاء)

عند إرجاع نتيجة التعرف بواسطة خدمة الكلام، سوف نقوم بطباعة النتيجة.

أدخِل هذا الرمز أسفل 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?");
    }
}

تحقق من الكود الخاص بك.

في هذه النقطة، يجب أن تظهر التعليمات البرمجية كذلك:

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?");
                }
            }
        }
    }
}

إنشاء تطبيقك وتشغيله

أنت الآن جاهز لإنشاء تطبيقك واختبار التعرف على الهدف باستخدام خدمة الكلام ومطابق النمط المضمن.

حدد زر التشغيل في Eclipse أو اضغط على ctrl+F11، ثم شاهد الإخراج ل "Say something..." موجه. بمجرد ظهوره، تحدث كلامك وشاهد الإخراج.

على سبيل المثال، إذا قلت "خذني إلى الطابق 7"، يكون الناتج كالآتي:

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

الخطوات التالية

تحسين مطابقة النمط الخاص بك باستخدام الكيانات المخصصة.