DialogServiceConnector Klass

Ett objekt som kommunicerar med ett talaktiverat dialogsystem med hjälp av antingen Bot Framework eller anpassade kommandon. Den här typen tar emot tal till text-resultat och underlättar även asynkron sändning och mottagning av aktivitetsdata som inte är taldialog.

Arv

builtins.object

DialogServiceConnector

Konstruktor

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

Parametrar

Name	Description
dialog_service_config Obligatorisk	Konfigurationen för dialogtjänsten, antingen för bot framework eller anpassade kommandon.
audio_config	Konfigurationen för ljudindata. standardvärde: None

Metoder

connect	Upprättar synkront en anslutning till tjänsten. Anslutningen utförs automatiskt när det behövs, men det här manuella anropet kan vara användbart för att kontrollera att anslutningen är aktiv innan den första användningen för att minska den inledande svarstiden. När anslutningen returneras kanske den inte är klar än. Prenumerera på den anslutna händelsen för anslutningsinstansen för att meddelas när anslutningen till tjänsten har upprättats. Använd Connection för att hämta instansen med hjälp from_dialog_service_connector av metoden .
connect_async	Asynkront upprättar en anslutning till tjänsten. Anslutningen utförs automatiskt när det behövs, men det här manuella anropet kan vara användbart för att kontrollera att anslutningen är aktiv innan den första användningen för att minska den inledande svarstiden.
disconnect	Kopplar synkront från tjänsten. Efterföljande anrop som kräver en anslutning återansluts fortfarande automatiskt efter manuell frånkoppling.
disconnect_async	Kopplar asynkront från tjänsten. Efterföljande anrop som kräver en anslutning återansluts fortfarande automatiskt efter manuell frånkoppling.
listen_once	Startar synkront en tal till text-interaktion med den här anslutningsappen och blockerar tills ett enda slutresultat för tal till text tas emot. Det mottagna tal till text-resultatet tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten.
listen_once_async	Asynkront startar en tal-till-text-interaktion med den här anslutningsappen och blockerar tills ett enda slutresultat för tal till text tas emot. Det mottagna tal till text-resultatet tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten.
send_activity	Skickar synkront en datanyttolast till serverdelstjänsten i dialogrutan som den här DialogServiceConnector-instansen är ansluten till. Detta är vanligtvis ett JSON-dokument med dess schema som bestäms av dialogimplementeringen i tjänsten och innehållet i en skickad aktivitet bör fyllas med kunskap om dialogsystemets format och innehållsförväntningar. Skickade aktiviteter är inte associerade med någon annan interaktion och genererar en egen fristående interaktionsidentifierare när de bearbetas av tjänsten. Korrelation mellan konversationer och andra interaktioner bör utföras via själva aktivitetsnyttolasten med hjälp av funktionerna i den dialogimplementering som används.
send_activity_async	Skickar en aktivitet asynkront till säkerhetskopieringsdialogrutan, se beskrivningsinformation på send_activity
start_keyword_recognition	Startar synkront en tal till text-interaktion med den här anslutningsappen med hjälp av ett nyckelord. Den här interaktionen använder den angivna nyckelordsmodellen för att lyssna efter ett nyckelord på obestämd tid, under vilken ljud inte skickas till taltjänsten och all bearbetning utförs lokalt. När ett nyckelord identifieras ansluter DialogServiceConnector automatiskt till taltjänsten och börjar skicka ljuddata från precis före nyckelordet som om listen_once_async det anropades. När det tas emot kan tal till text-resultat bearbetas av den tillhandahållna resultathanteraren eller hämtas via en prenumeration på den identifierade händelsen. Tal till text-resultatet som genereras av den här åtgärden tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten. Anropa stop_keyword_recognition_async för att stoppa den nyckelordsinitierade igenkänningen.
start_keyword_recognition_async	Konfigurerar dialogtjänstens anslutningsapp asynkront med den angivna nyckelordsmodellen. När du har anropat den här metoden lyssnar anslutningsappen efter nyckelordet för att starta igenkänningen. Anropa stop_keyword_recognition_async för att stoppa den nyckelordsinitierade igenkänningen. Mer start_keyword_recognition detaljerad beskrivning av funktionerna finns i.
stop_keyword_recognition	Synkront stoppar den nyckelordsinitierade igenkänningen.
stop_keyword_recognition_async	Asynkront stoppar den nyckelordsinitierade igenkänningen.
stop_listening	Begär ett omedelbart stopp för alla aktiva lyssningsåtgärder. Detta kan avbryta en pågående tal-till-text-interaktion och alla mottagna tal till text-resultat kan representera ofullständiga talindata. Synkrona metoder ska inte anropas vid hantering av en händelse. Använd stop_listening_async om ett stopp önskas som svar på en händelse.
stop_listening_async	Begär ett omedelbart stopp för alla aktiva lyssningsåtgärder. Detta kan avbryta en pågående tal-till-text-interaktion och alla mottagna tal till text-resultat kan representera ofullständiga talindata.

connect

Upprättar synkront en anslutning till tjänsten. Anslutningen utförs automatiskt när det behövs, men det här manuella anropet kan vara användbart för att kontrollera att anslutningen är aktiv innan den första användningen för att minska den inledande svarstiden.

När anslutningen returneras kanske den inte är klar än. Prenumerera på den anslutna händelsen för anslutningsinstansen för att meddelas när anslutningen till tjänsten har upprättats. Använd Connection för att hämta instansen med hjälp from_dialog_service_connector av metoden .

connect()

connect_async

Asynkront upprättar en anslutning till tjänsten. Anslutningen utförs automatiskt när det behövs, men det här manuella anropet kan vara användbart för att kontrollera att anslutningen är aktiv innan den första användningen för att minska den inledande svarstiden.

connect_async()

Returer

Typ	Description
	En framtid som uppfylls när anslutningen har initierats.

disconnect

Kopplar synkront från tjänsten. Efterföljande anrop som kräver en anslutning återansluts fortfarande automatiskt efter manuell frånkoppling.

disconnect()

disconnect_async

Kopplar asynkront från tjänsten. Efterföljande anrop som kräver en anslutning återansluts fortfarande automatiskt efter manuell frånkoppling.

disconnect_async()

Returer

Typ	Description
	En framtid som uppfylls när den kopplas från.

listen_once

Startar synkront en tal till text-interaktion med den här anslutningsappen och blockerar tills ett enda slutresultat för tal till text tas emot. Det mottagna tal till text-resultatet tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten.

listen_once() -> SpeechRecognitionResult

Returer

Typ	Description
	tal till text-resultatet från taligenkänningen.

listen_once_async

Asynkront startar en tal-till-text-interaktion med den här anslutningsappen och blockerar tills ett enda slutresultat för tal till text tas emot. Det mottagna tal till text-resultatet tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten.

listen_once_async() -> ResultFuture

Returer

Typ	Description
	En framtid som innehåller tal till text-resultatvärdet för den asynkrona igenkänningen.

send_activity

Skickar synkront en datanyttolast till serverdelstjänsten i dialogrutan som den här DialogServiceConnector-instansen är ansluten till. Detta är vanligtvis ett JSON-dokument med dess schema som bestäms av dialogimplementeringen i tjänsten och innehållet i en skickad aktivitet bör fyllas med kunskap om dialogsystemets format och innehållsförväntningar. Skickade aktiviteter är inte associerade med någon annan interaktion och genererar en egen fristående interaktionsidentifierare när de bearbetas av tjänsten. Korrelation mellan konversationer och andra interaktioner bör utföras via själva aktivitetsnyttolasten med hjälp av funktionerna i den dialogimplementering som används.

send_activity(activity: str) -> str

Parametrar

Name	Description
activity Obligatorisk	den serialiserade nyttolasten för en aktivitet som ska skickas.

Returer

Typ

Description

en interaktionsidentifierare som hämtas när aktiviteten bekräftas av tjänsten. Detta kan inträffa innan aktiviteten bearbetas och utvärderas av dialogimplementeringen och mottagandet av en interaktionsidentifierare indikerar inte att aktiviteten har lyckats eller misslyckats. Information om lyckade eller misslyckade åtgärder kan hämtas via svarsaktiviteter med korrelationsdata eller med TurnStatusReceived-händelser som korrelerar med den här interaktionsidentifieraren.

send_activity_async

Skickar en aktivitet asynkront till säkerhetskopieringsdialogrutan, se beskrivningsinformation på send_activity

send_activity_async(activity: str) -> ResultFuture

Parametrar

Name	Description
activity Obligatorisk	den serialiserade nyttolasten för en aktivitet som ska skickas.

Returer

Typ	Description
	En framtid som innehåller resultatvärdet för den asynkrona aktiviteten som skickar åtgärden.

start_keyword_recognition

Startar synkront en tal till text-interaktion med den här anslutningsappen med hjälp av ett nyckelord. Den här interaktionen använder den angivna nyckelordsmodellen för att lyssna efter ett nyckelord på obestämd tid, under vilken ljud inte skickas till taltjänsten och all bearbetning utförs lokalt. När ett nyckelord identifieras ansluter DialogServiceConnector automatiskt till taltjänsten och börjar skicka ljuddata från precis före nyckelordet som om listen_once_async det anropades. När det tas emot kan tal till text-resultat bearbetas av den tillhandahållna resultathanteraren eller hämtas via en prenumeration på den identifierade händelsen. Tal till text-resultatet som genereras av den här åtgärden tillhandahålls också till den konfigurerade dialogimplementeringen och det dialogsystemet kan generera valfritt antal aktivitetsnyttolaster som svar på talinteraktionen. Talinteraktioner kan korreleras med aktiviteter via dialogspecifika data i aktivitetsnyttolasten.

Anropa stop_keyword_recognition_async för att stoppa den nyckelordsinitierade igenkänningen.

start_keyword_recognition(model: KeywordRecognitionModel)

Parametrar

Name	Description
model Obligatorisk	nyckelordsigenkänningsmodellen som anger nyckelordet som ska identifieras.

start_keyword_recognition_async

Konfigurerar dialogtjänstens anslutningsapp asynkront med den angivna nyckelordsmodellen. När du har anropat den här metoden lyssnar anslutningsappen efter nyckelordet för att starta igenkänningen. Anropa stop_keyword_recognition_async för att stoppa den nyckelordsinitierade igenkänningen.

Mer start_keyword_recognition detaljerad beskrivning av funktionerna finns i.

start_keyword_recognition_async(model: KeywordRecognitionModel)

Parametrar

Name	Description
model Obligatorisk	nyckelordsigenkänningsmodellen som anger nyckelordet som ska identifieras.

Returer

Typ	Description
	En framtid som uppfylls när erkännandet har initierats.

stop_keyword_recognition

Synkront stoppar den nyckelordsinitierade igenkänningen.

stop_keyword_recognition()

stop_keyword_recognition_async

Asynkront stoppar den nyckelordsinitierade igenkänningen.

stop_keyword_recognition_async()

Returer

Typ	Description
	En framtid som uppfylls när erkännandet har stoppats.

stop_listening

Begär ett omedelbart stopp för alla aktiva lyssningsåtgärder. Detta kan avbryta en pågående tal-till-text-interaktion och alla mottagna tal till text-resultat kan representera ofullständiga talindata.

Synkrona metoder ska inte anropas vid hantering av en händelse. Använd stop_listening_async om ett stopp önskas som svar på en händelse.

stop_listening()

Returer

Typ	Description
	En framtid som uppfylls när lyssnandet har stoppats.

stop_listening_async

Begär ett omedelbart stopp för alla aktiva lyssningsåtgärder. Detta kan avbryta en pågående tal-till-text-interaktion och alla mottagna tal till text-resultat kan representera ofullständiga talindata.

stop_listening_async()

Returer

Typ	Description
	En framtid som uppfylls när lyssnandet har stoppats.

Attribut

activity_received

Signaler om att en aktivitet togs emot från serverdelen.

Återanrop som är anslutna till den här signalen anropas med en ActivityReceivedEventArgs, -instans som ett enda argument, beroende på typen av identifierare.

authorization_token

Den auktoriseringstoken som ska användas för att ansluta till tjänsten.

Anteckning

Anroparen måste se till att auktoriseringstoken är giltig. Före

auktoriseringstoken upphör att gälla måste anroparen uppdatera den genom att anropa den här inställningen med en

ny giltig token. Annars uppstår fel i igenkänningen under igenkänningen.

canceled

Signal för händelser som innehåller avbrutna igenkänningsresultat (som anger ett igenkänningsförsök som avbröts till följd av en direkt annulleringsbegäran eller, alternativt, ett transport- eller protokollfel).

Återanrop som är anslutna till den här signalen anropas med en SpeechRecognitionCanceledEventArgs, -instans som enda argument.

recognized

Signal för händelser som innehåller slutigenkänningsresultat (vilket indikerar ett lyckat igenkänningsförsök).

Återanrop som är anslutna till den här signalen anropas med en SpeechRecognitionEventArgs, -instans som ett enda argument, beroende på typen av identifierare.

recognizing

Signal för händelser som innehåller mellanliggande igenkänningsresultat.

Återanrop som är anslutna till den här signalen anropas med en SpeechRecognitionEventArgs, -instans som enda argument.

session_started

Signal för händelser som anger början av en igenkänningssession (åtgärd).

Återanrop som är anslutna till den här signalen anropas med en SessionEventArgs instans som enda argument.

session_stopped

Signal för händelser som anger slutet av en igenkänningssession (åtgärd).

Återanrop som är anslutna till den här signalen anropas med en SessionEventArgs instans som enda argument.

speech_activity_template

Hämtar JSON-mallen som ska tillhandahållas till taltjänsten för nästa konversation. Tjänsten försöker sammanfoga den här mallen till alla aktiviteter som skickas till dialogrutans serverdel, oavsett om den kommer från klienten med SendActivityAsync eller genereras av tjänsten, vilket är fallet med tal till text-resultat.

speech_end_detected

Signal för händelser som anger slutet av talet.

Återanrop som är anslutna till den här signalen anropas med en RecognitionEventArgs instans som enda argument.

speech_start_detected

Signal för händelser som anger början av talet.

Återanrop som är anslutna till den här signalen anropas med en RecognitionEventArgs instans som enda argument.

turn_status_received

Signaler om att en ändringsstatusuppdatering togs emot från serverdelen.

Återanrop som är anslutna till den här signalen anropas med en TurnStatusReceivedEventArgs, -instans som enda argument.