DialogServiceConnector Třída

Objekt, který komunikuje s dialogovým systémem s podporou řeči pomocí služby Bot Framework nebo vlastních příkazů. Tento typ přijímá výsledky převodu řeči na text a také usnadňuje asynchronní odesílání a příjem dat o aktivitě dialogového okna bez řeči.

Dědičnost

builtins.object

DialogServiceConnector

Konstruktor

DialogServiceConnector(dialog_service_config: DialogServiceConfig, audio_config: AudioConfig | None = None)

Parametry

Name	Description
dialog_service_config Vyžadováno	Konfigurace služby dialogového okna, buď pro bot Framework, nebo vlastní příkazy.
audio_config	Konfigurace zvukového vstupu. výchozí hodnota: None

Metody

connect	Synchronně naváže spojení se službou. Připojení se provádí automaticky v případě potřeby, ale toto ruční volání může být užitečné k tomu, aby se zajistilo, že je připojení aktivní před prvním použitím, aby se snížila počáteční latence. Po návratu nemusí být připojení ještě připravené. Přihlaste se k odběru připojené události instance připojení, abyste byli upozorněni na navázání připojení ke službě. K načtení instance pomocí from_dialog_service_connector metody použijte Connection .
connect_async	Asynchronně naváže spojení se službou. Připojení se provádí automaticky v případě potřeby, ale toto ruční volání může být užitečné k tomu, aby se zajistilo, že je připojení aktivní před prvním použitím, aby se snížila počáteční latence.
disconnect	Synchronně se odpojí od služby. Další volání, která vyžadují připojení, se i po ručním odpojení automaticky znovu připojí.
disconnect_async	Asynchronně se odpojí od služby. Další volání, která vyžadují připojení, se i po ručním odpojení automaticky znovu připojí.
listen_once	Synchronně zahájí interakci převodu řeči na text s tímto konektorem a zablokuje se, dokud se neobdrží konečný výsledek převodu řeči na text. Přijatý výsledek převodu řeči na text je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity.
listen_once_async	Asynchronně zahájí interakci převodu řeči na text s tímto konektorem a zablokuje se, dokud se neobdrží konečný výsledek převodu řeči na text. Přijatý výsledek převodu řeči na text je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity.
send_activity	Synchronně odesílá datovou část do back-end služby dialogového okna, ke které je tato instance DialogServiceConnector připojena. Obvykle se jedná o dokument JSON se schématem určeným implementací dialogového okna ve službě a obsah odesílané aktivity by měl být naplněn znalostmi o formátu a obsahu očekávaném od dialogového systému. Odeslané aktivity nejsou přidruženy k žádné jiné interakci a při zpracování službou vygenerují vlastní identifikátor samostatné interakce. Korelace konverzací a dalších interakcí by se měla provádět prostřednictvím samotné datové části aktivity s využitím možností použité implementace dialogového okna.
send_activity_async	Asynchronně odešle aktivitu do záložního dialogového okna, podrobnosti o popisu najdete v části send_activity
start_keyword_recognition	Synchronně zahájí interakci řeči na text s tímto konektorem pomocí klíčového slova. Tato interakce použije zadaný model klíčových slov k neomezenému naslouchání klíčovému slovu, během kterého se zvuk neodesílají do hlasové služby a veškeré zpracování probíhá místně. Při rozpoznání klíčového slova se DialogServiceConnector automaticky připojí k řečové službě a začne odesílat zvuková data těsně před klíčovým slovem, jako by listen_once_async byla vyvolána. Při přijetí mohou být výsledky převodu řeči na text zpracovány poskytnutou obslužnou rutinou výsledků nebo načteny prostřednictvím odběru rozpoznané události. Výsledek převodu řeči na text vygenerovaný touto operací je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity. Voláním stop_keyword_recognition_async zastavíte rozpoznávání iniciované klíčovým slovem.
start_keyword_recognition_async	Asynchronně konfiguruje konektor služby dialogového okna s daným modelem klíčových slov. Po volání této metody konektor naslouchá klíčovému slovu pro spuštění rozpoznávání. Voláním stop_keyword_recognition_async zastavíte rozpoznávání iniciované klíčovým slovem. Podrobný popis funkcí najdete start_keyword_recognition v tématu .
stop_keyword_recognition	Synchronně zastaví rozpoznávání iniciované klíčovým slovem.
stop_keyword_recognition_async	Asynchronně zastaví rozpoznávání iniciované klíčovým slovem.
stop_listening	Vyžaduje okamžité zastavení jakékoli operace aktivního naslouchání. To může přerušit probíhající interakci převodu řeči na text a jakýkoli přijatý výsledek převodu řeči na text může představovat neúplný hlasový vstup. Synchronní metody by se neměly volat při zpracování události. Použijte stop_listening_async , pokud je v reakci na událost žádoucí zastavení.
stop_listening_async	Vyžaduje okamžité zastavení jakékoli operace aktivního naslouchání. To může přerušit probíhající interakci převodu řeči na text a jakýkoli přijatý výsledek převodu řeči na text může představovat neúplný hlasový vstup.

connect

Synchronně naváže spojení se službou. Připojení se provádí automaticky v případě potřeby, ale toto ruční volání může být užitečné k tomu, aby se zajistilo, že je připojení aktivní před prvním použitím, aby se snížila počáteční latence.

Po návratu nemusí být připojení ještě připravené. Přihlaste se k odběru připojené události instance připojení, abyste byli upozorněni na navázání připojení ke službě. K načtení instance pomocí from_dialog_service_connector metody použijte Connection .

connect()

connect_async

Asynchronně naváže spojení se službou. Připojení se provádí automaticky v případě potřeby, ale toto ruční volání může být užitečné k tomu, aby se zajistilo, že je připojení aktivní před prvním použitím, aby se snížila počáteční latence.

connect_async()

Návraty

Typ	Description
	Budoucnost, která se splní po inicializaci připojení.

disconnect

Synchronně se odpojí od služby. Další volání, která vyžadují připojení, se i po ručním odpojení automaticky znovu připojí.

disconnect()

disconnect_async

Asynchronně se odpojí od služby. Další volání, která vyžadují připojení, se i po ručním odpojení automaticky znovu připojí.

disconnect_async()

Návraty

Typ	Description
	Budoucnost, která se splní, když se odpojí.

listen_once

Synchronně zahájí interakci převodu řeči na text s tímto konektorem a zablokuje se, dokud se neobdrží konečný výsledek převodu řeči na text. Přijatý výsledek převodu řeči na text je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity.

listen_once() -> SpeechRecognitionResult

Návraty

Typ	Description
	výsledek rozpoznávání řeči na text.

listen_once_async

Asynchronně zahájí interakci převodu řeči na text s tímto konektorem a zablokuje se, dokud se neobdrží konečný výsledek převodu řeči na text. Přijatý výsledek převodu řeči na text je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity.

listen_once_async() -> ResultFuture

Návraty

Typ	Description
	Budoucnost obsahující hodnotu výsledku převodu řeči na text asynchronního rozpoznávání.

send_activity

Synchronně odesílá datovou část do back-end služby dialogového okna, ke které je tato instance DialogServiceConnector připojena. Obvykle se jedná o dokument JSON se schématem určeným implementací dialogového okna ve službě a obsah odesílané aktivity by měl být naplněn znalostmi o formátu a obsahu očekávaném od dialogového systému. Odeslané aktivity nejsou přidruženy k žádné jiné interakci a při zpracování službou vygenerují vlastní identifikátor samostatné interakce. Korelace konverzací a dalších interakcí by se měla provádět prostřednictvím samotné datové části aktivity s využitím možností použité implementace dialogového okna.

send_activity(activity: str) -> str

Parametry

Name	Description
activity Vyžadováno	serializovaná datová část aktivity, která se má odeslat.

Návraty

Typ

Description

identifikátor interakce získaný při potvrzení aktivity službou. K tomu může dojít před zpracováním a vyhodnocením aktivity implementací dialogového okna a přijetí identifikátoru interakce neznamená žádný úspěch nebo selhání při zpracování aktivity. Informace o úspěchu nebo neúspěchu lze získat prostřednictvím aktivit odpovědí s daty korelace nebo událostmi TurnStatusReceived, které korelují s tímto identifikátorem interakce.

send_activity_async

Asynchronně odešle aktivitu do záložního dialogového okna, podrobnosti o popisu najdete v části send_activity

send_activity_async(activity: str) -> ResultFuture

Parametry

Name	Description
activity Vyžadováno	serializovaná datová část aktivity, která se má odeslat.

Návraty

Typ	Description
	Budoucnost obsahující výslednou hodnotu operace asynchronního odesílání aktivity.

start_keyword_recognition

Synchronně zahájí interakci řeči na text s tímto konektorem pomocí klíčového slova. Tato interakce použije zadaný model klíčových slov k neomezenému naslouchání klíčovému slovu, během kterého se zvuk neodesílají do hlasové služby a veškeré zpracování probíhá místně. Při rozpoznání klíčového slova se DialogServiceConnector automaticky připojí k řečové službě a začne odesílat zvuková data těsně před klíčovým slovem, jako by listen_once_async byla vyvolána. Při přijetí mohou být výsledky převodu řeči na text zpracovány poskytnutou obslužnou rutinou výsledků nebo načteny prostřednictvím odběru rozpoznané události. Výsledek převodu řeči na text vygenerovaný touto operací je také poskytnut nakonfigurované implementaci dialogového okna a tento dialogový systém může v reakci na řečovou interakci vytvořit libovolný počet datových částí aktivity. Hlasové interakce můžou korelovat s aktivitami prostřednictvím dat specifických pro dialog v datové části aktivity.

Voláním stop_keyword_recognition_async zastavíte rozpoznávání iniciované klíčovým slovem.

start_keyword_recognition(model: KeywordRecognitionModel)

Parametry

Name	Description
model Vyžadováno	model rozpoznávání klíčových slov, který určuje klíčové slovo, které se má rozpoznat.

start_keyword_recognition_async

Asynchronně konfiguruje konektor služby dialogového okna s daným modelem klíčových slov. Po volání této metody konektor naslouchá klíčovému slovu pro spuštění rozpoznávání. Voláním stop_keyword_recognition_async zastavíte rozpoznávání iniciované klíčovým slovem.

Podrobný popis funkcí najdete start_keyword_recognition v tématu .

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parametry

Name	Description
model Vyžadováno	model rozpoznávání klíčových slov, který určuje klíčové slovo, které se má rozpoznat.

Návraty

Typ	Description
	Budoucnost, která je splněna po inicializaci rozpoznávání.

stop_keyword_recognition

Synchronně zastaví rozpoznávání iniciované klíčovým slovem.

stop_keyword_recognition()

stop_keyword_recognition_async

Asynchronně zastaví rozpoznávání iniciované klíčovým slovem.

stop_keyword_recognition_async()

Návraty

Typ	Description
	Budoucnost, která je splněna, jakmile bude rozpoznávání zastaveno.

stop_listening

Vyžaduje okamžité zastavení jakékoli operace aktivního naslouchání. To může přerušit probíhající interakci převodu řeči na text a jakýkoli přijatý výsledek převodu řeči na text může představovat neúplný hlasový vstup.

Synchronní metody by se neměly volat při zpracování události. Použijte stop_listening_async , pokud je v reakci na událost žádoucí zastavení.

stop_listening()

Návraty

Typ	Description
	Budoucnost, která se naplní, jakmile se zastaví naslouchání.

stop_listening_async

Vyžaduje okamžité zastavení jakékoli operace aktivního naslouchání. To může přerušit probíhající interakci převodu řeči na text a jakýkoli přijatý výsledek převodu řeči na text může představovat neúplný hlasový vstup.

stop_listening_async()

Návraty

Typ	Description
	Budoucnost, která se naplní, jakmile se zastaví naslouchání.

Atributy

activity_received

Signály, že aktivita byla přijata z back-endu.

Zpětná volání připojená k tomuto signálu ActivityReceivedEventArgsjsou volána s instancí , jako jediným argumentem v závislosti na typu rozpoznávání.

authorization_token

Autorizační token, který se použije pro připojení ke službě.

Poznámka

Volající musí ověřit platnost autorizačního tokenu. Před

platnost autorizačního tokenu vyprší, volající ho musí aktualizovat voláním tohoto setteru pomocí

nový platný token. V opačném případě při rozpoznávání dojde k chybám.

canceled

Signál pro události obsahující zrušené výsledky rozpoznávání (označující pokus o rozpoznání, který byl v důsledku toho zrušen, žádost o přímé zrušení nebo případně selhání přenosu nebo selhání protokolu).

Zpětná volání připojená k tomuto signálu SpeechRecognitionCanceledEventArgsjsou volána s instancí , jako jediným argumentem.

recognized

Signál pro události obsahující konečné výsledky rozpoznávání (označující úspěšný pokus o rozpoznání).

Zpětná volání připojená k tomuto signálu SpeechRecognitionEventArgsjsou volána s instancí , jako jediným argumentem v závislosti na typu rozpoznávání.

recognizing

Signál pro události obsahující průběžné výsledky rozpoznávání

Zpětná volání připojená k tomuto signálu SpeechRecognitionEventArgsjsou volána s instancí , jako jediným argumentem.

session_started

Signál pro události indikující začátek relace rozpoznávání (operace).

Zpětná volání připojená k tomuto signálu SessionEventArgs jsou volána s instancí jako jediným argumentem.

session_stopped

Signál pro události označující konec relace rozpoznávání (operace).

Zpětná volání připojená k tomuto signálu SessionEventArgs jsou volána s instancí jako jediným argumentem.

speech_activity_template

Získá šablonu JSON, která bude poskytnuta službě speech pro další konverzaci. Služba se pokusí sloučit tuto šablonu se všemi aktivitami odeslanými do back-endu dialogového okna, ať už pocházejí z klienta s funkcí SendActivityAsync, nebo generované službou, jako je tomu u výsledků převodu řeči na text.

speech_end_detected

Signál pro události označující konec řeči.

Zpětná volání připojená k tomuto signálu RecognitionEventArgs jsou volána s instancí jako jediným argumentem.

speech_start_detected

Signál pro události označující začátek řeči.

Zpětná volání připojená k tomuto signálu RecognitionEventArgs jsou volána s instancí jako jediným argumentem.

turn_status_received

Signalizuje přijetí aktualizace stavu otočení z back-endu.

Zpětná volání připojená k tomuto signálu TurnStatusReceivedEventArgsjsou volána s instancí , jako jediným argumentem.