dialog kelas::D ialogServiceConnector

class Dialog::DialogServiceConnector
  : public std::enable_shared_from_this< DialogServiceConnector >
  : public Utils::NonCopyable
  : public Utils::NonMovable

Objek yang digunakan untuk menyambungkan DirectLineSpeech atau CustomCommands.

Objek jenis ini dibuat melalui metode pabrik FromConfig .

Anggota

Diakui

Sitnaksis: public EventSignal< constSpeechRecognitionEventArgs & > Recognized;

Sinyal untuk peristiwa yang berisi hasil pengenalan ucapan.

Mengenali

Sitnaksis: public EventSignal< constSpeechRecognitionEventArgs & > Recognizing;

Sinyal untuk peristiwa yang berisi hasil pengenalan perantara.

SessionStarted

Sitnaksis: public EventSignal< constSessionEventArgs & > SessionStarted;

Sinyal yang menunjukkan dimulainya sesi mendengarkan.

Sesi Dihentikan

Sitnaksis: public EventSignal< constSessionEventArgs & > SessionStopped;

Sinyal yang menunjukkan akhir sesi mendengarkan.

SpeechStartDetected

Sitnaksis: public EventSignal< constRecognitionEventArgs & > SpeechStartDetected;

Sinyal yang menunjukkan deteksi pertama data ucapan dalam frasa saat ini.

SpeechEndDetected

Sitnaksis: public EventSignal< constRecognitionEventArgs & > SpeechEndDetected;

Sinyal yang menunjukkan akhir data ucapan frasa saat ini yang terdeteksi.

Batal

Sitnaksis: public EventSignal< constSpeechRecognitionCanceledEventArgs & > Canceled;

Sinyal untuk peristiwa yang berkaitan dengan pembatalan interaksi. Kejadian ini menunjukkan apakah alasannya adalah pembatalan langsung atau kesalahan.

ActivityReceived

Sitnaksis: public EventSignal< constActivityReceivedEventArgs & > ActivityReceived;

Menandakan bahwa aktivitas diterima dari backend.

TurnStatusReceived

Sitnaksis: public EventSignal< constTurnStatusReceivedEventArgs & > TurnStatusReceived;

Memberi sinyal bahwa pembaruan status giliran diterima dari backend.

Properti

Sitnaksis: public PropertyCollection & Properties;

Kumpulan properti dan nilainya yang ditentukan untuk DialogServiceConnector ini.

~DialogServiceConnector

Sitnaksis: public inline virtual ~DialogServiceConnector ( );

Menghancurkan instans.

ConnectAsync

Sitnaksis: public inline std::future< void > ConnectAsync ( );

Terhubung dengan back end.

Mengembalikan

Operasi asinkron yang memulai koneksi.

Putuskan SambunganSinkronkan

Sitnaksis: public inline std::future< void > DisconnectAsync ( );

Putuskan sambungan dari ujung belakang.

Mengembalikan

Operasi asinkron yang memulai pemutusan sambungan.

SendActivityAsync

Sitnaksis: public inline std::future< std::string > SendActivityAsync ( const std::string & activity );

Mengirim aktivitas ke dialog dukungan.

Parameter

  • activity Aktivitas yang akan dikirim

Mengembalikan

Operasi asinkron yang memulai operasi.

StartKeywordRecognitionAsync

Sitnaksis: public inline std::future< void > StartKeywordRecognitionAsync ( std::shared_ptr< KeywordRecognitionModel > model );

Memulai pengenalan kata kunci.

Parameter

  • model Menentukan model kata kunci yang akan digunakan.

Mengembalikan

Operasi asinkron yang memulai operasi.

StopKeywordRecognitionAsync

Sitnaksis: public inline std::future< void > StopKeywordRecognitionAsync ( );

Hentikan pengenalan kata kunci.

Mengembalikan

Operasi asinkron yang memulai operasi.

ListenOnceAsync

Sitnaksis: public inline std::future< std::shared_ptr< SpeechRecognitionResult > > ListenOnceAsync ( );

Memulai sesi mendengarkan yang akan berakhir setelah ucapan pertama.

Mengembalikan

Operasi asinkron yang memulai operasi.

StopListeningAsync

Sitnaksis: public inline std::future< void > StopListeningAsync ( );

Meminta agar operasi mendengarkan aktif segera selesai, mengganggu ucapan yang sedang berlangsung, dan memberikan hasil yang mencerminkan data audio apa pun yang telah diambil sejauh ini.

Mengembalikan

Tugas yang mewakili operasi asinkron yang menghentikan sesi mendengarkan aktif.

SetAuthorizationToken

Sitnaksis: public inline void SetAuthorizationToken ( const std::string & token );

Mengatur token otorisasi yang akan digunakan untuk menyambungkan ke layanan. Catatan: Pemanggil perlu memastikan bahwa token otorisasi valid. Sebelum token otorisasi kedaluwarsa, pemanggil perlu merefreshnya dengan memanggil setter ini dengan token baru yang valid. Jika tidak, konektor akan mengalami kesalahan selama operasinya.

Parameter

  • token Token otorisasi.

GetAuthorizationToken

Sitnaksis: public inline std::string GetAuthorizationToken ( );

Mendapatkan token otorisasi.

Mengembalikan

Token otorisasi

SetSpeechActivityTemplate

Sitnaksis: public inline void SetSpeechActivityTemplate ( const std::string & activityTemplate );

Mengatur templat JSON yang akan disediakan ke layanan ucapan untuk percakapan berikutnya. Layanan akan mencoba menggabungkan templat ini ke dalam semua aktivitas yang dikirim ke backend dialog, baik berasal dari klien dengan SendActivityAsync atau dihasilkan oleh layanan, seperti halnya dengan hasil ucapan ke teks.

Parameter

  • activityTemplate Payload aktivitas, sebagai string JSON, yang akan digabungkan ke dalam semua pesan aktivitas yang berlaku.

GetSpeechActivityTemplate

Sitnaksis: public inline std::string GetSpeechActivityTemplate ( );

Mendapatkan templat JSON yang akan disediakan ke layanan ucapan untuk percakapan berikutnya. Layanan akan mencoba menggabungkan templat ini ke dalam semua aktivitas yang dikirim ke backend dialog, baik berasal dari klien dengan SendActivityAsync atau dihasilkan oleh layanan, seperti halnya dengan hasil ucapan ke teks.

Mengembalikan

Templat aktivitas JSON saat ini diatur yang akan digunakan pada permintaan berikutnya.

FromConfig

Sitnaksis: public inline static std::shared_ptr< DialogServiceConnector > FromConfig ( std::shared_ptr< DialogServiceConfig > connectorConfig , std::shared_ptr< Audio::AudioConfig > audioConfig );

Membuat konektor layanan dialog dari DialogServiceConfig dan Audio::AudioConfig. Pengguna harus menggunakan fungsi ini untuk membuat konektor layanan dialog.

Parameter

  • connectorConfig Konfigurasi layanan dialog.

  • audioConfig Konfigurasi audio.

Mengembalikan

Penunjuk cerdas bersama dari konektor layanan dialog yang dibuat.

auto audioConfig = [Audio::AudioConfig::FromDefaultMicrophoneInput](audio-audioconfig.md#fromdefaultmicrophoneinput)();
auto config = [CustomCommandsConfig::FromAuthorizationToken](dialog-customcommandsconfig.md#fromauthorizationtoken)("my_app_id","my_auth_token", "my_region");
auto connector = [DialogServiceConnector::FromConfig](#fromconfig)(config, audioConfig);

Ketika berbicara tentang DialogServiceConfig , kami mengacu pada salah satu kelas yang mewarisinya. Kelas tertentu yang akan digunakan tergantung pada backend dialog yang digunakan: