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 の作成に使用されたサブスクリプション キー。