SpeechConfig Klasse

Klasse, die Konfigurationen für sprach-/absichtserkennung und Sprachsynthese definiert.

Die Konfiguration kann auf unterschiedliche Weise initialisiert werden:

• aus abonnement: übergeben Sie einen Abonnementschlüssel und eine Region

• von Endpunkt: Übergeben Sie einen Endpunkt. Abonnementschlüssel oder Autorisierungstoken sind optional.

• from host: Übergeben Sie eine Hostadresse. Abonnementschlüssel oder Autorisierungstoken sind optional.

• from-Autorisierungstoken: Übergeben Sie ein Autorisierungstoken und eine Region.

Vererbung

builtins.object

SpeechConfig

Konstruktor

SpeechConfig(subscription: str | None = None, region: str | None = None, endpoint: str | None = None, host: str | None = None, auth_token: str | None = None, speech_recognition_language: str | None = None)

Parameter

Name	Beschreibung
subscription	Der Abonnementschlüssel. Standardwert: None
region	Der Regionsname (siehe Regionsseite). Standardwert: None
endpoint	Der Dienstendpunkt, mit dem eine Verbindung hergestellt werden soll. Standardwert: None
host	Der Diensthost, mit dem eine Verbindung hergestellt werden soll. Der Standardressourcenpfad wird angenommen. Format ist "protocol://host:port", wobei ":p ort" optional ist. Standardwert: None
auth_token	Das Autorisierungstoken. Standardwert: None
speech_recognition_language	Die Eingabesprache für die Spracherkennung. Die Sprache wird im BCP-47-Format angegeben. Standardwert: None

Methoden

enable_audio_logging	Aktiviert die Audioprotokollierung im Dienst. Audio- und Inhaltsprotokolle werden entweder im Microsoft-eigenen Speicher oder in Ihrem eigenen Speicherkonto gespeichert, das mit Ihrem Cognitive Services-Abonnement (Bring Your Own Storage, BYOS) verknüpft ist. Hinweis In Version 1.5.0 hinzugefügt.
enable_dictation	Aktiviert das Diktieren. Wird nur in der kontinuierlichen Spracherkennung unterstützt. Hinweis In Version 1.5.0 hinzugefügt.
get_property	Rufen Sie eine Eigenschaft nach ID ab.
get_property_by_name	Rufen Sie eine Eigenschaft nach Name ab.
request_word_level_timestamps	Enthält Zeitstempel auf Wortebene in das Antwortergebnis. Hinweis In Version 1.5.0 hinzugefügt.
set_profanity	Legen Sie die Obszönitätsoption fest. Hinweis In Version 1.5.0 hinzugefügt.
set_properties	Legen Sie mehrere Eigenschaften nach ID fest.
set_properties_by_name	Legen Sie mehrere Eigenschaften nach Name fest.
set_property	Legen Sie eine Eigenschaft nach ID fest.
set_property_by_name	Legen Sie eine Eigenschaft nach Name fest.
set_proxy	Legen Sie Proxyinformationen fest. Hinweis Proxyfunktionen sind unter macOS nicht verfügbar. Diese Funktion hat keine Auswirkungen auf diese Plattform.
set_service_property	Legt einen Eigenschaftswert fest, der mithilfe des angegebenen Kanals an den Dienst übergeben wird. Hinweis In Version 1.5.0 hinzugefügt.
set_speech_synthesis_output_format	Legen Sie das Audioformat für die Sprachsyntheseausgabe fest.

enable_audio_logging

Aktiviert die Audioprotokollierung im Dienst. Audio- und Inhaltsprotokolle werden entweder im Microsoft-eigenen Speicher oder in Ihrem eigenen Speicherkonto gespeichert, das mit Ihrem Cognitive Services-Abonnement (Bring Your Own Storage, BYOS) verknüpft ist.

Hinweis

In Version 1.5.0 hinzugefügt.

enable_audio_logging()

enable_dictation

Aktiviert das Diktieren. Wird nur in der kontinuierlichen Spracherkennung unterstützt.

Hinweis

In Version 1.5.0 hinzugefügt.

enable_dictation()

get_property

Rufen Sie eine Eigenschaft nach ID ab.

get_property(property_id: PropertyId) -> str

Parameter

Name	Beschreibung
property_id Erforderlich	Die ID der abzurufenden Eigenschaft.

Gibt zurück

Typ	Beschreibung
	Der Wert der Eigenschaft.

get_property_by_name

Rufen Sie eine Eigenschaft nach Name ab.

get_property_by_name(property_name: str) -> str

Parameter

Name	Beschreibung
property_name Erforderlich	Der Name der abzurufenden Eigenschaft.

Gibt zurück

Typ	Beschreibung
	Der Wert der Eigenschaft.

request_word_level_timestamps

Enthält Zeitstempel auf Wortebene in das Antwortergebnis.

Hinweis

In Version 1.5.0 hinzugefügt.

request_word_level_timestamps()

set_profanity

Legen Sie die Obszönitätsoption fest.

Hinweis

In Version 1.5.0 hinzugefügt.

set_profanity(profanity_option: ProfanityOption) -> None

Parameter

Name	Beschreibung
profanity_option Erforderlich	Die festzulegende Obszönitätsebene.

set_properties

Legen Sie mehrere Eigenschaften nach ID fest.

set_properties(properties: Dict[PropertyId, str])

Parameter

Name	Beschreibung
properties Erforderlich	Eine Dict-Zuordnungseigenschafts-ID zu den festzulegenden Werten.

set_properties_by_name

Legen Sie mehrere Eigenschaften nach Name fest.

set_properties_by_name(properties: Dict[str, str])

Parameter

Name	Beschreibung
properties Erforderlich	Eine Dict-Zuordnungseigenschafts-ID zu den festzulegenden Werten.

set_property

Legen Sie eine Eigenschaft nach ID fest.

set_property(property_id: PropertyId, value: str)

Parameter

Name	Beschreibung
property_id Erforderlich	Die ID der festzulegenden Eigenschaft.
value Erforderlich	Der Wert, der für die -Eigenschaft festgelegt werden soll.

set_property_by_name

Legen Sie eine Eigenschaft nach Name fest.

set_property_by_name(property_name: str, value: str)

Parameter

Name	Beschreibung
property_name Erforderlich	Der Name der festzulegenden Eigenschaft.
value Erforderlich	Der Wert, der für die -Eigenschaft festgelegt werden soll.

set_proxy

Legen Sie Proxyinformationen fest.

Hinweis

Proxyfunktionen sind unter macOS nicht verfügbar. Diese Funktion hat keine Auswirkungen auf

diese Plattform.

set_proxy(hostname: str, port: int, username: str = None, password: str = None)

Parameter

Name	Beschreibung
hostname Erforderlich	Der Hostname des Proxyservers. Fügen Sie dem Hostnamen keine Protokollinformationen (http) hinzu.
port Erforderlich	Die Portnummer des Proxyservers.
username	Der Benutzername des Proxyservers. Standardwert: None
password	Das Kennwort des Proxyservers. Standardwert: None

set_service_property

Legt einen Eigenschaftswert fest, der mithilfe des angegebenen Kanals an den Dienst übergeben wird.

Hinweis

In Version 1.5.0 hinzugefügt.

set_service_property(name: str, value: str, channel: ServicePropertyChannel)

Parameter

Name	Beschreibung
name Erforderlich	Der Eigenschaftenname.
value Erforderlich	Der Eigenschaftswert.
channel Erforderlich	Der Kanal, der verwendet wird, um die angegebene Eigenschaft an den Dienst zu übergeben.

set_speech_synthesis_output_format

Legen Sie das Audioformat für die Sprachsyntheseausgabe fest.

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

Parameter

Name	Beschreibung
format_id Erforderlich	Die Audioformat-ID, z.B. Riff16Khz16BitMonoPcm.

Attribute

authorization_token

Das Autorisierungstoken, das zum Herstellen einer Verbindung mit dem Dienst verwendet wird.

Hinweis

Der Aufrufer muss sicherstellen, dass das Autorisierungstoken gültig ist. Vor dem

Das Autorisierungstoken läuft ab, der Aufrufer muss es aktualisieren, indem er diesen Setter mit einem aufruft.

neues gültiges Token. Da Konfigurationswerte beim Erstellen einer neuen Erkennung kopiert werden,

Der neue Tokenwert gilt nicht für Erkennungen, die bereits erstellt wurden. Für

Erkennungen, die zuvor erstellt wurden, müssen Sie das Autorisierungstoken des

entsprechende Erkennung, um das Token zu aktualisieren. Andernfalls werden die Erkennunger

Fehler während der Erkennung.

endpoint_id

Die Endpunkt-ID.

output_format

Das Ausgabeformat (einfach oder detailliert) des Spracherkennungsergebnisses.

region

Der Regionsschlüssel, der zum Erstellen der Erkennung verwendet wurde.

speech_recognition_language

Der Name der gesprochenen Sprache, die im BCP-47-Format erkannt werden soll.

speech_synthesis_language

Abrufen der Sprache für die Sprachsynthese.

speech_synthesis_output_format_string

Rufen Sie die Audioformatzeichenfolge der Sprachsyntheseausgabe ab.

speech_synthesis_voice_name

Rufen Sie den Namen der Sprachsynthese ab.

subscription_key

Der Abonnementschlüssel, der zum Erstellen der Erkennung verwendet wurde.