Rychlý start: Konverzace s více zařízeními

Článek
02/28/2024

V tomto rychlém startu se dozvíte, jak pomocí sady Speech SDK vytvořit novou konverzaci s více zařízeními s podporou překladu a připojit se k existující konverzaci.

Poznámka:

Sada Speech SDK pro Javu, JavaScript, Objective-C a Swift podporují konverzaci s více zařízeními, ale zatím jsme tu nezahrnuli průvodce.

Všechny ukázky sady Speech SDK pro jazyk C# můžete zobrazit nebo stáhnout na GitHubu.

Požadavky

Než začnete, nezapomeňte:

Přidání ukázkového kódu

Otevřete Program.cs a nahraďte veškerý kód v něm následujícím kódem:

using Microsoft.CognitiveServices.Speech;
using Microsoft.CognitiveServices.Speech.Audio;
using Microsoft.CognitiveServices.Speech.Transcription;
using System;
using System.Threading.Tasks;

namespace HelloWorld
{
    class Program
    {
        static async Task Main(string[] args)
        {
            await CreateConversationAsync();
        }

        static async Task CreateConversationAsync()
        {
            // Replace these values with the details of your Cognitive Speech subscription
            string subscriptionKey = "YourSubscriptionKey";

            // Replace below with your region identifier from here: https://aka.ms/speech/sdkregion
            string region = "YourServiceRegion";

            // Sets source and target languages.
            // Replace with the languages of your choice, from list found here: https://aka.ms/speech/sttt-languages
            string fromLanguage = "en-US";
            string toLanguage = "de";

            // Set this to the display name you want for the conversation host
            string displayName = "The host";

            // Create the task completion source that will be used to wait until the user presses Ctrl + C
            var completionSource = new TaskCompletionSource<bool>();

            // Register to listen for Ctrl + C
            Console.CancelKeyPress += (s, e) =>
            {
                completionSource.TrySetResult(true);
                e.Cancel = true; // don't terminate the current process
            };

            // Create an instance of the speech translation config
            var config = SpeechTranslationConfig.FromSubscription(subscriptionKey, region);
            config.SpeechRecognitionLanguage = fromLanguage;
            config.AddTargetLanguage(toLanguage);

            // Create the conversation
            using (var conversation = await Conversation.CreateConversationAsync(config).ConfigureAwait(false))
            {
                // Start the conversation so the host user and others can join
                await conversation.StartConversationAsync().ConfigureAwait(false);

                // Get the conversation ID. It will be up to your scenario to determine how this is shared with other participants.
                string conversationId = conversation.ConversationId;
                Console.WriteLine($"Created '{conversationId}' conversation");

                // At this point, you can use the conversation object to manage the conversation. 
                // For example, to mute everyone else in the room you can call this method:
                await conversation.MuteAllParticipantsAsync().ConfigureAwait(false);

                // Configure which audio source you want to use. If you are using a text only language, you 
                // can use the other overload of the constructor that takes no arguments
                var audioConfig = AudioConfig.FromDefaultMicrophoneInput();
                using (var conversationTranslator = new ConversationTranslator(audioConfig))
                {
                    // You should connect all the event handlers you need at this point
                    conversationTranslator.SessionStarted += (s, e) =>
                    {
                        Console.WriteLine($"Session started: {e.SessionId}");
                    };
                    conversationTranslator.SessionStopped += (s, e) =>
                    {
                        Console.WriteLine($"Session stopped: {e.SessionId}");
                    };
                    conversationTranslator.Canceled += (s, e) =>
                    {
                        switch (e.Reason)
                        {
                            case CancellationReason.EndOfStream:
                                Console.WriteLine($"End of audio reached");
                                break;

                            case CancellationReason.Error:
                                Console.WriteLine($"Canceled due to error. {e.ErrorCode}: {e.ErrorDetails}");
                                break;
                        }
                    };
                    conversationTranslator.ConversationExpiration += (s, e) =>
                    {
                        Console.WriteLine($"Conversation will expire in {e.ExpirationTime.TotalMinutes} minutes");
                    };
                    conversationTranslator.ParticipantsChanged += (s, e) =>
                    {
                        Console.Write("The following participant(s) have ");
                        switch (e.Reason)
                        {
                            case ParticipantChangedReason.JoinedConversation:
                                Console.Write("joined");
                                break;

                            case ParticipantChangedReason.LeftConversation:
                                Console.Write("left");
                                break;

                            case ParticipantChangedReason.Updated:
                                Console.Write("been updated");
                                break;
                        }

                        Console.WriteLine(":");

                        foreach (var participant in e.Participants)
                        {
                            Console.WriteLine($"\t{participant.DisplayName}");
                        }
                    };
                    conversationTranslator.TextMessageReceived += (s, e) =>
                    {
                        Console.WriteLine($"Received an instant message from '{e.Result.ParticipantId}': '{e.Result.Text}'");
                        foreach (var entry in e.Result.Translations)
                        {
                            Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
                        }
                    };
                    conversationTranslator.Transcribed += (s, e) =>
                    {
                        Console.WriteLine($"Received a transcription from '{e.Result.ParticipantId}': '{e.Result.Text}'");
                        foreach (var entry in e.Result.Translations)
                        {
                            Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
                        }
                    };
                    conversationTranslator.Transcribing += (s, e) =>
                    {
                        Console.WriteLine($"Received a partial transcription from '{e.Result.ParticipantId}': '{e.Result.Text}'");
                        foreach (var entry in e.Result.Translations)
                        {
                            Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
                        }
                    };

                    // Enter the conversation to start receiving events
                    await conversationTranslator.JoinConversationAsync(conversation, displayName).ConfigureAwait(false);

                    // You can now send an instant message to all other participants in the room
                    await conversationTranslator.SendTextMessageAsync("The instant message to send").ConfigureAwait(false);

                    // If specified a speech to text language, you can start capturing audio
                    await conversationTranslator.StartTranscribingAsync().ConfigureAwait(false);
                    Console.WriteLine("Started transcribing. Press Ctrl + c to stop");

                    // At this point, you should start receiving transcriptions for what you are saying using the default microphone. Press Ctrl+c to stop audio capture
                    await completionSource.Task.ConfigureAwait(false);

                    // Stop audio capture
                    await conversationTranslator.StopTranscribingAsync().ConfigureAwait(false);

                    // Leave the conversation. After this you will no longer receive events
                    await conversationTranslator.LeaveConversationAsync().ConfigureAwait(false);
                }

                // End the conversation
                await conversation.EndConversationAsync().ConfigureAwait(false);

                // Delete the conversation. Any other participants that are still in the conversation will be removed
                await conversation.DeleteConversationAsync().ConfigureAwait(false);
            }
        }
    }
}

Ve stejném souboru nahraďte řetězec YourSubscriptionKey klíčem předplatného služby Cognitive Speech.
Nahraďte řetězec YourServiceRegion oblastí přidruženou k vašemu předplatnému.
V řádku nabídek zvolte Soubor>uložit vše.

Vytvoření a spuštění aplikace pro vytvoření nové konverzace

Na řádku nabídek vyberte Sestavit>řešení a sestavte aplikaci. Kód by se teď měl zkompilovat bez chyb.
Zvolte Spustit ladění ladění (nebo stiskněte klávesu F5) a spusťte aplikaci helloworld.>
Jakmile se Started transcribing zobrazí zpráva, můžete začít mluvit. Při mluvení se zobrazí přepisy.
- Pokud kód konverzace sdílíte s ostatními a připojí se ke konverzaci, uvidíte také jejich přepisy.
Až mluvení dokončíte, stisknutím kombinace kláves Ctrl+C zastavíte záznam zvuku a ukončíte konverzaci.

Sestavení a spuštění aplikace pro připojení k existující konverzaci

Do Program.cs zkopírujte a vložte následující funkci:

static async Task JoinConversationAsync(string conversationId)
{
    // Set this to the display name you want for the participant
    string displayName = "participant";

    // Set the speech to text, or text language you want to use
    string language = "en-US";

    // Create the task completion source that will be used to wait until the user presses Ctrl + c
    var completionSource = new TaskCompletionSource<bool>();

    // Register to listen for Ctrl+C
    Console.CancelKeyPress += (s, e) =>
    {
        completionSource.TrySetResult(true);
        e.Cancel = true; // don't terminate the current process
    };

    // As a participant, you don't need to specify any subscription key, or region. You can directly create
    // the conversation translator object
    var audioConfig = AudioConfig.FromDefaultMicrophoneInput();
    using (var conversationTranslator = new ConversationTranslator(audioConfig))
    {
        // Register for any events you are interested here. For now let's just register for
        // transcription, and instant message events
        conversationTranslator.TextMessageReceived += (s, e) =>
        {
            Console.WriteLine($"Received an instant message from '{e.Result.ParticipantId}': '{e.Result.Text}'");
            foreach (var entry in e.Result.Translations)
            {
                Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
            }
        };
        conversationTranslator.Transcribed += (s, e) =>
        {
            Console.WriteLine($"Received a transcription from '{e.Result.ParticipantId}': '{e.Result.Text}'");
            foreach (var entry in e.Result.Translations)
            {
                Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
            }
        };
        conversationTranslator.Transcribing += (s, e) =>
        {
            Console.WriteLine($"Received a partial transcription from '{e.Result.ParticipantId}': '{e.Result.Text}'");
            foreach (var entry in e.Result.Translations)
            {
                Console.WriteLine($"\tTranslated into '{entry.Key}': '{entry.Value}'");
            }
        };

        // To start receiving events, you will need to join the conversation
        await conversationTranslator.JoinConversationAsync(conversationId, displayName, language).ConfigureAwait(false);

        // You can now send an instant message
        await conversationTranslator.SendTextMessageAsync("Message from participant").ConfigureAwait(false);

        // Start capturing audio if you specified a speech to text language
        await conversationTranslator.StartTranscribingAsync().ConfigureAwait(false);
        Console.WriteLine("Started transcribing. Press Ctrl-C to stop");

        // At this point, you should start receiving transcriptions for what you are saying using
        // the default microphone. Press Ctrl+C to stop audio capture
        await completionSource.Task.ConfigureAwait(false);

        // Stop audio capture
        await conversationTranslator.StopTranscribingAsync().ConfigureAwait(false);

        // Leave the conversation. You will stop receiving events after this
        await conversationTranslator.LeaveConversationAsync().ConfigureAwait(false);
    }
}

Nahraďte CreateConversationAsync(); ve funkci public static async Task Main(string[] args) :

// Set this to the conversation you want to join
JoinConversationAsync("YourConversationId");

Budete muset vytvořit konverzaci, ke které se můžete připojit:
1. Spusťte prohlížeč a přejděte na: https://translator.microsoft.com.
2. Vyberte Zahájit konverzaci.
3. Přihlaste se pomocí některé z dostupných možností.
4. Zadejte název (např. hostitel).
5. Vyberte jazyk (např. angličtinu).
6. Vyberte tlačítko Enter.
7. Poznamenejte si kód konverzace v horní části stránky.
Tip

Pokud použijete tlačítko kopírování na webové stránce, nezapomeňte odebrat translate.it/ tlačítko na začátku. Potřebujete jenom 5mísícové ID konverzace (příklad: ABCDE).

Vraťte se do sady Visual Studio a nahraďte řetězec YourConversationId ID konverzace, které jste vytvořili v předchozím kroku.
Na řádku nabídek vyberte Sestavit>řešení a sestavte aplikaci. Kód by se teď měl zkompilovat bez chyb.
Zvolte Spustit ladění ladění (nebo stiskněte klávesu F5) a spusťte aplikaci helloworld.>
Jakmile se Started transcribing zobrazí zpráva, můžete začít mluvit. Při mluvení se zobrazí přepisy.
- Pokud se vrátíte do prohlížeče, měli byste vidět, že se tam při mluvení zobrazí i přepisy.
Až mluvení dokončíte, stisknutím kombinace kláves Ctrl+C zastavíte záznam zvuku a ukončíte konverzaci.
Vraťte se do prohlížeče a ukončete konverzaci pomocí tlačítka pro ukončení v pravém horním rohu.

Další kroky

Prozkoumání ukázek jazyka C# na GitHubu

Všechny ukázky sady Speech SDK C++ si můžete zobrazit nebo stáhnout na GitHubu.

Požadavky

Než začnete, nezapomeňte:

Přidání ukázkového kódu

V sadě Visual Studio otevřete zdrojový soubor helloworld.cpp.

Nahraďte veškerý kód následujícím fragmentem kódu:

#include "pch.h"

#define WIN32_LEAN_AND_MEAN
#include <Windows.h>

#include <iostream>
#include <thread>
#include <future>
#include <string>
#include <speechapi_cxx.h>

using namespace std::chrono_literals;
using namespace Microsoft::CognitiveServices::Speech;
using namespace Microsoft::CognitiveServices::Speech::Audio;
using namespace Microsoft::CognitiveServices::Speech::Transcription;

// Create a promise we will set when the user presses Ctrl-C
std::promise<bool> promise;
// Create the future we will use to wait for the promise to be fulfilled
std::future<bool> future = promise.get_future();

void StartNewConversation()
{
    // Set these
    std::string subscriptionKey("YourSubscriptionKey");

    // Replace below with your own region identifier from here: https://aka.ms/speech/sdkregion
    std::string region("YourServiceRegion");

    std::string speechLanguage("en-US");

    // Create the conversation object you'll need to manage the conversation
    auto speechConfig = SpeechConfig::FromSubscription(subscriptionKey, region);
    speechConfig->SetSpeechRecognitionLanguage(speechLanguage);
    auto conversation = Conversation::CreateConversationAsync(speechConfig).get();

    // Start the conversation so you and others can join
    conversation->StartConversationAsync().get();

    // Get the conversation ID. It will be up to your scenario to determine how this is shared with other participants.
    std::cout << "Created conversation: " << conversation->GetConversationId() << std::endl;

    // You can now call various commands to manage the room. For example:
    conversation->MuteAllParticipantsAsync().get();

    // Create the conversation translator you'll need to send audio, send IMs, and receive conversation events
    auto audioConfig = AudioConfig::FromDefaultMicrophoneInput();
    auto conversationTranslator = ConversationTranslator::FromConfig(audioConfig);

    // Add any event handlers
    conversationTranslator->SessionStarted += [](const SessionEventArgs& args)
    {
        std::cout << "Session started " << args.SessionId << std::endl;
    };
    conversationTranslator->SessionStopped += [](const SessionEventArgs& args)
    {
        std::cout << "Session stopped " << args.SessionId << std::endl;
    };
    conversationTranslator->Canceled += [](const ConversationTranslationCanceledEventArgs& args)
    {
        switch (args.Reason)
        {
            case CancellationReason::EndOfStream:
                std::cout << "End of audio reached" << std::endl;
                break;

            case CancellationReason::Error:
                std::cout << "Canceled due to error. " << (long)args.ErrorCode << ": " << args.ErrorDetails << std::endl;
                break;
        }
    };
    conversationTranslator->ConversationExpiration += [](const ConversationExpirationEventArgs& args)
    {
        std::cout << "Conversation will expire in " << args.ExpirationTime.count() << " minutes" << std::endl;
    };
    conversationTranslator->ParticipantsChanged += [](const ConversationParticipantsChangedEventArgs& args)
    {
        std::cout << "The following participant(s) have ";
        switch (args.Reason)
        {
            case ParticipantChangedReason::JoinedConversation:
                std::cout << "joined";
                break;

            case ParticipantChangedReason::LeftConversation:
                std::cout << "left";
                break;

            case ParticipantChangedReason::Updated:
                std::cout << "been updated";
                break;
        }

        std::cout << ":" << std::endl;

        for(std::shared_ptr<Participant> participant : args.Participants)
        {
            std::cout << "\t" << participant->DisplayName << std::endl;
        }
    };
    conversationTranslator->Transcribing += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received a partial transcription from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };
    conversationTranslator->Transcribed += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received a transcription from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };
    conversationTranslator->TextMessageReceived += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received an instant message from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };

    // Join the conversation so you can start receiving events
    conversationTranslator->JoinConversationAsync(conversation, "Test Host").get();

    // Send an instant message
    conversationTranslator->SendTextMessageAsync("This is a short test message").get();

    // Start sending audio
    conversationTranslator->StartTranscribingAsync().get();
    std::cout << "Started transcribing. Press Ctrl + C to stop" << std::endl;
    future.get(); // wait for Ctrl - C to be pressed

    // Stop audio capture
    conversationTranslator->StopTranscribingAsync().get();

    // Leave the conversation. You will stop receiving events
    conversationTranslator->LeaveConversationAsync().get();

    // Once you are done, remember to delete the conversation.
    conversation->EndConversationAsync().get(); // You will not be able to rejoin after this
    conversation->DeleteConversationAsync().get(); // All participants still in the room will be ejected
}

int main()
{
    // Register a handler for the Ctrl - C callback
    SetConsoleCtrlHandler(
        [](DWORD dwCtrlType) -> BOOL
        {
            if (dwCtrlType == CTRL_C_EVENT)
            {
                // Signal that the user has pressed ctrl + C
                promise.set_value(true);
                return TRUE;
            }

            return FALSE;
        },
        TRUE);

    StartNewConversation();
}

Ve stejném souboru nahraďte řetězec YourSubscriptionKey klíčem předplatného.
Nahraďte řetězec YourServiceRegion oblastí přidruženou k vašemu předplatnému.
V řádku nabídek zvolte Soubor>uložit vše.

Vytvoření a spuštění aplikace pro vytvoření nové konverzace

Na řádku nabídek vyberte Sestavit>řešení a sestavte aplikaci. Kód by se teď měl zkompilovat bez chyb.
Zvolte Spustit ladění ladění (nebo stiskněte klávesu F5) a spusťte aplikaci helloworld.>
Jakmile se Started transcribing zobrazí zpráva, můžete začít mluvit. Při mluvení se zobrazí přepisy.
- Pokud kód konverzace sdílíte s ostatními a připojí se ke konverzaci, uvidíte také jejich přepisy.
Až budete hotovi, stiskněte ctrl+C na klávesnici a zastavte zachytávání zvuku.

Poznámka:

V sadě Visual Studio se může zobrazit zpráva o výjimce podobné této: Exception thrown at 0x76EB90BF (KernelBase.dll) in helloworld.exe: 0x40010005: Control-C. Můžete ji bezpečně ignorovat.

Pokračujte stisknutím F5.

Sestavení a spuštění aplikace pro připojení k existující konverzaci

Zkopírujte a vložte následující funkci do helloworld.cpp těsně před int main() funkci:

void JoinExistingConversation(const std::string& conversationId)
{
    std::string speechLanguage("en-US");

    // You'll now need to create a ConversationTranslator to send audio, send IMs, and receive conversation events
    auto audioConfig = AudioConfig::FromDefaultMicrophoneInput();
    auto conversationTranslator = ConversationTranslator::FromConfig(audioConfig);

    // Attach event handlers here. For example:
    conversationTranslator->Transcribing += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received a partial transcription from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };
    conversationTranslator->Transcribed += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received a transcription from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };
    conversationTranslator->TextMessageReceived += [](const ConversationTranslationEventArgs& args)
    {
        std::cout << "Received an instant message from " << args.Result->ParticipantId << ": " << args.Result->Text << std::endl;
        for (const auto& entry : args.Result->Translations)
        {
            std::cout << "\t" << entry.first << ": " << entry.second << std::endl;
        }
    };

    // Join the conversation
    conversationTranslator->JoinConversationAsync(conversationId, "participant", speechLanguage).get();

    // Start sending audio
    conversationTranslator->StartTranscribingAsync().get();
    std::cout << "Started transcribing. Press Ctrl + C to stop" << std::endl;
    future.get(); // wait for Ctrl - C to be pressed

    // Stop audio capture
    conversationTranslator->StopTranscribingAsync().get();

    // Once you are done, leave the conversation
    conversationTranslator->LeaveConversationAsync().get();
}

Nahraďte StartNewConversation(); ve funkci int main() :

// Set this to the conversation you want to join
JoinExistingConversation("YourConversationId");

Budete muset vytvořit konverzaci, ke které se můžete připojit:
1. Spusťte prohlížeč a přejděte na: https://translator.microsoft.com.
2. Vyberte Zahájit konverzaci.
3. Přihlaste se pomocí některé z dostupných možností.
4. Zadejte název (např. hostitel).
5. Vyberte jazyk (např. angličtinu).
6. Vyberte tlačítko Enter.
7. Poznamenejte si kód konverzace v horní části stránky.
Tip

Pokud použijete tlačítko kopírování na webové stránce, nezapomeňte odebrat translate.it/ tlačítko na začátku. Potřebujete jenom 5mísícové ID konverzace (příklad: ABCDE).

Vraťte se do sady Visual Studio a nahraďte YourConversationId ve funkci int main() ID konverzace z předchozího kroku.
Na řádku nabídek vyberte Sestavit>řešení a sestavte aplikaci. Kód by se měl zkompilovat bez chyb.
Zvolte Spustit ladění ladění (nebo stiskněte klávesu F5) a spusťte aplikaci helloworld.>
Jakmile se Started transcribing zobrazí zpráva, můžete začít mluvit. Při mluvení se zobrazí přepisy.
- Pokud se vrátíte do prohlížeče, měli byste vidět, že se tam při mluvení zobrazí i přepisy.
Až mluvení dokončíte, stisknutím kombinace kláves Ctrl+C zastavíte záznam zvuku a ukončíte konverzaci.

Poznámka:

V sadě Visual Studio se může zobrazit zpráva o výjimce podobné této: Exception thrown at 0x76EB90BF (KernelBase.dll) in helloworld.exe: 0x40010005: Control-C. Můžete ji bezpečně ignorovat.

Pokračujte stisknutím F5.
Vraťte se do prohlížeče a ukončete konverzaci pomocí tlačítka pro ukončení v pravém horním rohu.

Další kroky

Prozkoumání ukázek C++ na GitHubu

Share via

Rychlý start: Konverzace s více zařízeními

Požadavky

Přidání ukázkového kódu

Vytvoření a spuštění aplikace pro vytvoření nové konverzace

Sestavení a spuštění aplikace pro připojení k existující konverzaci

Další kroky

Požadavky

Přidání ukázkového kódu

Vytvoření a spuštění aplikace pro vytvoření nové konverzace

Sestavení a spuštění aplikace pro připojení k existující konverzaci

Další kroky

Další materiály