DialogServiceConnector Osztály

Olyan objektum, amely a Bot Framework vagy az egyéni parancsok használatával kommunikál egy beszédalapú párbeszédpanelrendszerrel. Ez a típus beszédfelismerési eredményeket kap, és megkönnyíti a nem beszédfelismerési párbeszédpanel tevékenységadatainak aszinkron küldését és fogadását.

Öröklődés

builtins.object

DialogServiceConnector

Konstruktor

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

Paraméterek

Name	Description
dialog_service_config Kötelező	A párbeszédpanel-szolgáltatás konfigurációja robot-keretrendszerhez vagy egyéni parancsokhoz.
audio_config	A hangbemenet konfigurációja. alapértelmezett érték: None

Metódusok

connect	Szinkron módon kapcsolatot létesít a szolgáltatással. A rendszer szükség esetén automatikusan végrehajtja a kapcsolatot, de ez a manuális hívás hasznos lehet annak érdekében, hogy a kapcsolat aktív legyen az első használat előtt a kezdeti késés csökkentése érdekében. Visszatérés esetén előfordulhat, hogy a kapcsolat még nem áll készen. Iratkozzon fel a kapcsolatpéldánycsatlakoztatott eseményére, hogy értesítést kapjon a szolgáltatáshoz való csatlakozás létrejöttéről. A használatával Connection lekérheti a példányt metódussal from_dialog_service_connector .
connect_async	Aszinkron módon kapcsolatot létesít a szolgáltatással. A rendszer szükség esetén automatikusan végrehajtja a kapcsolatot, de ez a manuális hívás hasznos lehet annak érdekében, hogy a kapcsolat aktív legyen az első használat előtt a kezdeti késés csökkentése érdekében.
disconnect	Szinkron módon bontja a kapcsolatot a szolgáltatással. A további, kapcsolatot igénylő hívások a manuális leválasztást követően is automatikusan újracsatlakoznak.
disconnect_async	Aszinkron módon bontja a kapcsolatot a szolgáltatással. A további, kapcsolatot igénylő hívások a manuális leválasztást követően is automatikusan újracsatlakoznak.
listen_once	Szinkron módon elindítja a beszéd-szöveg interakciót ezzel az összekötővel, és letiltja, amíg egyetlen beszéd-szöveg végső eredmény nem érkezik. A kapott beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is meg van adva, és ez a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adathoz vezethet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel.
listen_once_async	Aszinkron módon elindít egy beszéd-szöveg interakciót ezzel az összekötővel, és letiltja, amíg egyetlen beszéd-szöveg végső eredmény nem érkezik. A kapott beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is meg van adva, és ez a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adathoz vezethet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel.
send_activity	Szinkron módon adat hasznos adatokat küld a DialogServiceConnector-példányhoz csatlakoztatott párbeszédpanel-háttérszolgáltatásnak. Ez általában egy JSON-dokumentum, amelynek sémáját a szolgáltatás párbeszédpanel-implementációja határozza meg, és az elküldött tevékenységek tartalmát fel kell tölteni a párbeszédpanelrendszer formátumával és tartalmi elvárásaival kapcsolatos ismeretekkel. Az elküldött tevékenységek nincsenek más interakciókhoz társítva, és a szolgáltatás feldolgozásakor saját különálló interakcióazonosítót hoznak létre. A beszélgetések és más interakciók korrelációját a tevékenység hasznos adatain keresztül kell elvégezni a használt párbeszédpanel-implementáció képességeinek használatával.
send_activity_async	Aszinkron módon küld egy tevékenységet a háttérrendszeri párbeszédpanelre. A leírás részleteit itt találja: send_activity
start_keyword_recognition	Szinkron módon elindít egy beszéd-szöveg interakciót ezzel az összekötővel egy kulcsszó használatával. Ez az interakció a megadott kulcsszómodellt fogja használni egy kulcsszó határozatlan idejű figyelésére, amely során a rendszer nem küld hangokat a beszédszolgáltatásnak, és minden feldolgozás helyileg történik. Ha felismer egy kulcsszót, a DialogServiceConnector automatikusan csatlakozik a beszédszolgáltatáshoz, és elkezd hangadatokat küldeni közvetlenül a kulcsszó előtt, mintha listen_once_async meghívták volna. Fogadáskor a megadott eredménykezelő feldolgozhatja a beszédfelismerési eredményeket, vagy lekérheti a felismert eseményre való előfizetésen keresztül. A művelet által generált beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is része, és a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adattal rendelkezhet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel. Hívás stop_keyword_recognition_async a kulcsszó által kezdeményezett felismerés leállításához.
start_keyword_recognition_async	Aszinkron módon konfigurálja a párbeszédpanel-szolgáltatás-összekötőt a megadott kulcsszómodellel. A metódus meghívása után az összekötő figyeli a kulcsszót a felismerés elindításához. Hívás stop_keyword_recognition_async a kulcsszó által kezdeményezett felismerés leállításához. A funkció részletes leírását itt találja start_keyword_recognition .
stop_keyword_recognition	Szinkron módon leállítja a kulcsszó által kezdeményezett felismerést.
stop_keyword_recognition_async	Aszinkron módon leállítja a kulcsszó által kezdeményezett felismerést.
stop_listening	Azonnali leállítást kér minden aktív figyelési művelethez. Ez megszakíthatja a diktálás közbeni interakciót, és a kapott beszédfelismerési eredmények hiányos beszédbevitelt jelenthetnek. Az események kezelésekor nem szabad szinkron metódusokat meghívni. Akkor használja stop_listening_async , ha egy eseményre válaszul leállításra van szükség.
stop_listening_async	Azonnali leállítást kér minden aktív figyelési művelethez. Ez megszakíthatja a diktálás közbeni interakciót, és a kapott beszédfelismerési eredmények hiányos beszédbevitelt jelenthetnek.

connect

Szinkron módon kapcsolatot létesít a szolgáltatással. A rendszer szükség esetén automatikusan végrehajtja a kapcsolatot, de ez a manuális hívás hasznos lehet annak érdekében, hogy a kapcsolat aktív legyen az első használat előtt a kezdeti késés csökkentése érdekében.

Visszatérés esetén előfordulhat, hogy a kapcsolat még nem áll készen. Iratkozzon fel a kapcsolatpéldánycsatlakoztatott eseményére, hogy értesítést kapjon a szolgáltatáshoz való csatlakozás létrejöttéről. A használatával Connection lekérheti a példányt metódussal from_dialog_service_connector .

connect()

connect_async

Aszinkron módon kapcsolatot létesít a szolgáltatással. A rendszer szükség esetén automatikusan végrehajtja a kapcsolatot, de ez a manuális hívás hasznos lehet annak érdekében, hogy a kapcsolat aktív legyen az első használat előtt a kezdeti késés csökkentése érdekében.

connect_async()

Válaszok

Típus	Description
	Egy olyan jövő, amely a kapcsolat inicializálása után teljesül.

disconnect

Szinkron módon bontja a kapcsolatot a szolgáltatással. A további, kapcsolatot igénylő hívások a manuális leválasztást követően is automatikusan újracsatlakoznak.

disconnect()

disconnect_async

Aszinkron módon bontja a kapcsolatot a szolgáltatással. A további, kapcsolatot igénylő hívások a manuális leválasztást követően is automatikusan újracsatlakoznak.

disconnect_async()

Válaszok

Típus	Description
	Egy olyan jövő, amely a kapcsolat bontása után teljesül.

listen_once

Szinkron módon elindítja a beszéd-szöveg interakciót ezzel az összekötővel, és letiltja, amíg egyetlen beszéd-szöveg végső eredmény nem érkezik. A kapott beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is meg van adva, és ez a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adathoz vezethet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel.

listen_once() -> SpeechRecognitionResult

Válaszok

Típus	Description
	a beszédfelismerésből származó beszédfelismerés eredménye.

listen_once_async

Aszinkron módon elindít egy beszéd-szöveg interakciót ezzel az összekötővel, és letiltja, amíg egyetlen beszéd-szöveg végső eredmény nem érkezik. A kapott beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is meg van adva, és ez a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adathoz vezethet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel.

listen_once_async() -> ResultFuture

Válaszok

Típus	Description
	Az aszinkron felismerés beszéd-szöveg eredményértékét tartalmazó jövő.

send_activity

Szinkron módon adat hasznos adatokat küld a DialogServiceConnector-példányhoz csatlakoztatott párbeszédpanel-háttérszolgáltatásnak. Ez általában egy JSON-dokumentum, amelynek sémáját a szolgáltatás párbeszédpanel-implementációja határozza meg, és az elküldött tevékenységek tartalmát fel kell tölteni a párbeszédpanelrendszer formátumával és tartalmi elvárásaival kapcsolatos ismeretekkel. Az elküldött tevékenységek nincsenek más interakciókhoz társítva, és a szolgáltatás feldolgozásakor saját különálló interakcióazonosítót hoznak létre. A beszélgetések és más interakciók korrelációját a tevékenység hasznos adatain keresztül kell elvégezni a használt párbeszédpanel-implementáció képességeinek használatával.

send_activity(activity: str) -> str

Paraméterek

Name	Description
activity Kötelező	az elküldendő tevékenység szerializált hasznos adatai.

Válaszok

Típus

Description

a szolgáltatás által a tevékenység nyugtázásakor beszerzett interakciós azonosító. Ez akkor fordulhat elő, ha a tevékenységet a párbeszédpanel implementációja feldolgozta és kiértékelte, és az interakciós azonosító fogadása nem jelzi a tevékenység feldolgozásának sikerét vagy sikertelenségét. A sikerre vagy a hibára vonatkozó információk a korrelációs adatokkal végzett választevékenységekkel vagy az ehhez az interakcióazonosítóhoz kapcsolódó TurnStatusReceived eseményekkel szerezhetőek be.

send_activity_async

Aszinkron módon küld egy tevékenységet a háttérrendszeri párbeszédpanelre. A leírás részleteit itt találja: send_activity

send_activity_async(activity: str) -> ResultFuture

Paraméterek

Name	Description
activity Kötelező	az elküldendő tevékenység szerializált hasznos adatai.

Válaszok

Típus	Description
	Az aszinkron tevékenységküldési művelet eredményértékét tartalmazó jövő.

start_keyword_recognition

Szinkron módon elindít egy beszéd-szöveg interakciót ezzel az összekötővel egy kulcsszó használatával. Ez az interakció a megadott kulcsszómodellt fogja használni egy kulcsszó határozatlan idejű figyelésére, amely során a rendszer nem küld hangokat a beszédszolgáltatásnak, és minden feldolgozás helyileg történik. Ha felismer egy kulcsszót, a DialogServiceConnector automatikusan csatlakozik a beszédszolgáltatáshoz, és elkezd hangadatokat küldeni közvetlenül a kulcsszó előtt, mintha listen_once_async meghívták volna. Fogadáskor a megadott eredménykezelő feldolgozhatja a beszédfelismerési eredményeket, vagy lekérheti a felismert eseményre való előfizetésen keresztül. A művelet által generált beszédfelismerési eredmény a konfigurált párbeszédpanel-implementációnak is része, és a párbeszédpanel-rendszer bármilyen mennyiségű hasznos adattal rendelkezhet a beszédfelismerésre válaszul. A beszédfelismerési interakciók a tevékenység hasznos adatainak párbeszédpanel-specifikus adataival korrelálhatnak a tevékenységekkel.

Hívás stop_keyword_recognition_async a kulcsszó által kezdeményezett felismerés leállításához.

start_keyword_recognition(model: KeywordRecognitionModel)

Paraméterek

Name	Description
model Kötelező	a felismerni kívánt kulcsszót meghatározó kulcsszófelismerő modell.

start_keyword_recognition_async

Aszinkron módon konfigurálja a párbeszédpanel-szolgáltatás-összekötőt a megadott kulcsszómodellel. A metódus meghívása után az összekötő figyeli a kulcsszót a felismerés elindításához. Hívás stop_keyword_recognition_async a kulcsszó által kezdeményezett felismerés leállításához.

A funkció részletes leírását itt találja start_keyword_recognition .

start_keyword_recognition_async(model: KeywordRecognitionModel)

Paraméterek

Name	Description
model Kötelező	a felismerni kívánt kulcsszót meghatározó kulcsszófelismerő modell.

Válaszok

Típus	Description
	Egy olyan jövő, amely a felismerés inicializálása után teljesül.

stop_keyword_recognition

Szinkron módon leállítja a kulcsszó által kezdeményezett felismerést.

stop_keyword_recognition()

stop_keyword_recognition_async

Aszinkron módon leállítja a kulcsszó által kezdeményezett felismerést.

stop_keyword_recognition_async()

Válaszok

Típus	Description
	Egy olyan jövő, amely a felismerés leállítása után teljesül.

stop_listening

Azonnali leállítást kér minden aktív figyelési művelethez. Ez megszakíthatja a diktálás közbeni interakciót, és a kapott beszédfelismerési eredmények hiányos beszédbevitelt jelenthetnek.

Az események kezelésekor nem szabad szinkron metódusokat meghívni. Akkor használja stop_listening_async , ha egy eseményre válaszul leállításra van szükség.

stop_listening()

Válaszok

Típus	Description
	A jövő, amely teljesült, ha a hallgatás leállt.

stop_listening_async

Azonnali leállítást kér minden aktív figyelési művelethez. Ez megszakíthatja a diktálás közbeni interakciót, és a kapott beszédfelismerési eredmények hiányos beszédbevitelt jelenthetnek.

stop_listening_async()

Válaszok

Típus	Description
	A jövő, amely teljesült, ha a hallgatás leállt.

Attribútumok

activity_received

Azt jelzi, hogy egy tevékenység érkezett a háttérrendszerből.

A jelhez kapcsolódó visszahívásokat egy ActivityReceivedEventArgs, példány hívja meg egyetlen argumentumként, a felismerő típusától függően.

authorization_token

A szolgáltatáshoz való csatlakozáshoz használt engedélyezési jogkivonat.

Megjegyzés

A hívónak biztosítania kell, hogy az engedélyezési jogkivonat érvényes legyen. A

az engedélyezési jogkivonat lejár, a hívónak frissítenie kell, ha meghívja ezt a beállítót egy

új érvényes jogkivonat. Ellenkező esetben a felismerő hibákat fog tapasztalni a felismerés során.

canceled

A megszakított felismerési eredményeket tartalmazó események jelzése (ez azt jelzi, hogy a felismerési kísérlet megszakadt, vagy közvetlen lemondási kérelem, vagy másik lehetőségként átviteli vagy protokollhiba történt).

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy SpeechRecognitionCanceledEventArgspéldány hívja meg.

recognized

A végleges felismerési eredményeket tartalmazó események jelzése (a sikeres felismerési kísérlet jelzése).

A jelhez kapcsolódó visszahívásokat egy SpeechRecognitionEventArgs, példány hívja meg egyetlen argumentumként, a felismerő típusától függően.

recognizing

A köztes felismerési eredményeket tartalmazó események jelzése.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy SpeechRecognitionEventArgspéldány hívja meg.

session_started

A felismerési munkamenet (művelet) kezdetét jelző események jelzése.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy SessionEventArgs példány hívja meg.

session_stopped

A felismerési munkamenet (művelet) végét jelző események jelzése.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy SessionEventArgs példány hívja meg.

speech_activity_template

Lekéri a beszédszolgáltatásnak a következő beszélgetéshez biztosított JSON-sablont. A szolgáltatás megpróbálja egyesíteni ezt a sablont a párbeszédpanel háttérrendszerébe küldött összes tevékenységgel, függetlenül attól, hogy az ügyfél a SendActivityAsync szolgáltatással származik-e, vagy amelyet a szolgáltatás hozott létre, ahogyan a beszédfelismerési eredmények esetében is.

speech_end_detected

A beszéd végét jelző események jelzése.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy RecognitionEventArgs példány hívja meg.

speech_start_detected

A beszéd kezdetét jelző események jelzése.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy RecognitionEventArgs példány hívja meg.

turn_status_received

Azt jelzi, hogy a háttérrendszertől fordulati állapotfrissítés érkezett.

A jelhez kapcsolódó visszahívásokat egyetlen argumentumként egy TurnStatusReceivedEventArgspéldány hívja meg.