SpeechConfig クラス

音声/意図認識と音声合成の構成を定義するクラス。

構成は、さまざまな方法で初期化できます。

• サブスクリプションから: サブスクリプション キーとリージョンを渡す

• エンドポイントから: エンドポイントを渡します。 サブスクリプション キーまたは承認トークンは省略可能です。

• from host: ホスト アドレスを渡します。 サブスクリプション キーまたは承認トークンは省略可能です。

• 承認トークンから: 承認トークンとリージョンを渡します

継承

builtins.object

SpeechConfig

コンストラクター

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)

パラメーター

名前	説明
subscription	サブスクリプション キー。 既定値: None
region	リージョン名 ( リージョン ページを参照)。 既定値: None
endpoint	接続するサービス エンドポイント。 既定値: None
host	接続するサービス ホスト。 標準リソース パスが想定されます。 形式は "protocol://host:port" で、":p ort" は省略可能です。 既定値: None
auth_token	承認トークン。 既定値: None
speech_recognition_language	音声認識に対する入力言語。 言語は BCP-47 形式で指定されています。 既定値: None

メソッド

enable_audio_logging	サービスでオーディオ ログを有効にします。 オーディオ ログとコンテンツ ログは、Microsoft 所有のストレージ、または Cognitive Services サブスクリプションにリンクされている独自のストレージ アカウント (Bring Your Own Storage (BYOS) 対応 Speech リソース) に格納されます。 注意 バージョン 1.5.0 で追加されました。
enable_dictation	ディクテーションを有効にします。 音声認識でのみサポートされます。 注意 バージョン 1.5.0 で追加されました。
get_property	ID でプロパティを取得します。
get_property_by_name	名前でプロパティを取得します。
request_word_level_timestamps	応答結果に単語レベルのタイムスタンプが含まれます。 注意 バージョン 1.5.0 で追加されました。
set_profanity	不適切な表現オプションを設定します。 注意 バージョン 1.5.0 で追加されました。
set_properties	ID で複数のプロパティを設定します。
set_properties_by_name	名前で複数のプロパティを設定します。
set_property	ID でプロパティを設定します。
set_property_by_name	名前でプロパティを設定します。
set_proxy	プロキシ情報を設定します。 注意 macOS ではプロキシ機能を使用できません。 この関数は に影響しません このプラットフォーム。
set_service_property	指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。 注意 バージョン 1.5.0 で追加されました。
set_speech_synthesis_output_format	音声合成出力オーディオ形式を設定します。

enable_audio_logging

サービスでオーディオ ログを有効にします。 オーディオ ログとコンテンツ ログは、Microsoft 所有のストレージ、または Cognitive Services サブスクリプションにリンクされている独自のストレージ アカウント (Bring Your Own Storage (BYOS) 対応 Speech リソース) に格納されます。

注意

バージョン 1.5.0 で追加されました。

enable_audio_logging()

enable_dictation

ディクテーションを有効にします。 音声認識でのみサポートされます。

注意

バージョン 1.5.0 で追加されました。

enable_dictation()

get_property

ID でプロパティを取得します。

get_property(property_id: PropertyId) -> str

パラメーター

名前	説明
property_id 必須	取得するプロパティの ID。

戻り値

型	説明
	プロパティの値。

get_property_by_name

名前でプロパティを取得します。

get_property_by_name(property_name: str) -> str

パラメーター

名前	説明
property_name 必須	取得するプロパティの名前。

戻り値

型	説明
	プロパティの値。

request_word_level_timestamps

応答結果に単語レベルのタイムスタンプが含まれます。

注意

バージョン 1.5.0 で追加されました。

request_word_level_timestamps()

set_profanity

不適切な表現オプションを設定します。

注意

バージョン 1.5.0 で追加されました。

set_profanity(profanity_option: ProfanityOption) -> None

パラメーター

名前	説明
profanity_option 必須	設定する不適切な表現レベル。

set_properties

ID で複数のプロパティを設定します。

set_properties(properties: Dict[PropertyId, str])

パラメーター

名前	説明
properties 必須	設定する値に対する dict マッピング プロパティ ID。

set_properties_by_name

名前で複数のプロパティを設定します。

set_properties_by_name(properties: Dict[str, str])

パラメーター

名前	説明
properties 必須	設定する値に対する dict マッピング プロパティ ID。

set_property

ID でプロパティを設定します。

set_property(property_id: PropertyId, value: str)

パラメーター

名前	説明
property_id 必須	設定するプロパティの ID。
value 必須	プロパティに設定する値。

set_property_by_name

名前でプロパティを設定します。

set_property_by_name(property_name: str, value: str)

パラメーター

名前	説明
property_name 必須	設定するプロパティの名前。
value 必須	プロパティに設定する値。

set_proxy

プロキシ情報を設定します。

注意

macOS ではプロキシ機能を使用できません。 この関数は に影響しません

このプラットフォーム。

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

パラメーター

名前	説明
hostname 必須	プロキシ サーバーのホスト名。 ホスト名にプロトコル情報 (http) を追加しないでください。
port 必須	プロキシ サーバーのポート番号。
username	プロキシ サーバーのユーザー名。 既定値: None
password	プロキシ サーバーのパスワード。 既定値: None

set_service_property

指定したチャネルを使用してサービスに渡されるプロパティ値を設定します。

注意

バージョン 1.5.0 で追加されました。

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

パラメーター

名前	説明
name 必須	プロパティ名。
value 必須	プロパティ値。
channel 必須	指定したプロパティをサービスに渡すために使用されるチャネル。

set_speech_synthesis_output_format

音声合成出力オーディオ形式を設定します。

set_speech_synthesis_output_format(format_id: SpeechSynthesisOutputFormat)

パラメーター

名前	説明
format_id 必須	オーディオ形式 ID (例: Riff16Khz16BitMonoPcm)。

属性

authorization_token

サービスへの接続に使用される承認トークン。

注意

呼び出し元は、認証トークンが有効であることを確認する必要があります。 の前に

承認トークンの有効期限が切れます。呼び出し元は、 を使用してこのセッターを呼び出して更新する必要があります。

新しい有効なトークン。 新しい認識エンジンの作成時に構成値がコピーされると、

新しいトークン値は、既に作成されている認識エンジンには適用されません。 For

以前に作成された認識エンジンでは、 の承認トークンを設定する必要があります。

トークンを更新する対応する認識エンジン。 それ以外の場合、認識エンジンは

認識中にエラーが発生する可能性があります。

endpoint_id

エンドポイント ID。

output_format

音声認識結果の出力形式 (単純または詳細)。

region

Recognizer の作成に使用されたリージョン キー。

speech_recognition_language

BCP-47 形式で認識される音声言語の名前。

speech_synthesis_language

音声合成言語を取得します。

speech_synthesis_output_format_string

音声合成出力オーディオフォーマット文字列を取得します。

speech_synthesis_voice_name

音声合成音声名を取得します。

subscription_key

Recognizer の作成に使用されたサブスクリプション キー。