このトピックでは、音声合成マークアップ言語 (SSML) の機能とタグについて説明し、SSML の使用方法の例を示します。
概要
SSML は、音声合成用の XML ベースのマークアップ言語です。プレーンテキスト合成と比較して、SSML ベースの合成は合成コンテンツの品質を向上させ、さまざまな合成効果をサポートします。 SSML を使用すると、音声合成サービスが読み取るコンテンツを指定し、サービスがテキストを読み取る方法を指定できます。たとえば、文や単語の区切り方、発音の制御、一時停止の方法などを指定できます。
Alibaba Cloud が提供する音声合成サービスは、World Wide Web Consortium (W3C) の SSML 1.0 に基づいて実装されています。詳細については、「音声合成マークアップ言語 (SSML) バージョン 1.1」をご参照ください。ただし、W3C 標準で定義されているすべてのマークアップタイプがサポートされているわけではありません。音声合成サービスは、ビジネス要件に基づいてマークアップタイプをサポートします。
使用上の注意
SSML は中国語と英語でサポートされており、各言語でサポートされている SSML タグとコンテンツは異なります。以下のセクションでは、タグについて説明し、タグの使用例を示します。
すべてのテキストは、<speak> タグと </speak> タグで囲む必要があります。音声合成タスクで <speak> タグと </speak> タグの組み合わせを複数回使用し、SSML をテキストと一緒に使用できます。
テキストの先頭の <speak> タグの前にある XML ヘッダーは省略できます。
タグで囲まれたテキストに特別な XML 文字が含まれている場合は、それらの文字をエスケープする必要があります。次のセクションでは、特殊文字と対応するエスケープ文字について説明します。
二重引用符 ("): "
一重引用符 ('): '
アンパサンド (&): &
小なり記号 (<): <
大なり記号 (>): >
インテリジェントボイスと人間の声のクローニング (Basic Edition) は、このトピックで説明されているすべての SSML タグと属性をサポートしています。
人間の声のクローニング (Public Edition) は、人間の声のクローニング (Public Edition) 用の <speak>、<break>、<s>、<sub>、<w>、<phoneme>、<say-as> タグをサポートしています。この場合、<speak> タグは、rate、pitch、volume 属性をサポートします。その他のタグは属性設定をサポートしておらず、空の属性を持つタグと呼ばれます。
タグ
<speak>
説明
<speak> タグは、サポートされるすべての SSML タグのルートノードです。SSML タグを呼び出す必要があるすべてのテキストは、<speak> タグと </speak> タグで囲む必要があります。
構文
<speak>SSML タグを呼び出す必要があるテキスト</speak>属性
次の表に、<speak> タグでサポートされている属性を示します。
属性名
属性タイプ
属性値
必須
説明
voice
文字列
呼び出すことができる音声の名前。 voice 属性の値には、siyue などの小文字のみを含めることができます。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成に使用される音声を指定します。指定された音声は、API リクエストの
voiceパラメーターで指定された音声よりも優先されます。詳細については、「インテリジェントボイスサンプル」をご参照ください。
encodeType
文字列
PCM/WAV/MP3
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成のオーディオファイル形式を指定します。指定されたオーディオファイル形式は、API リクエストの
formatパラメーターで指定されたオーディオファイル形式よりも優先されます。sampleRate
文字列
8000/16000/24000/48000
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成のオーディオサンプリングレートを指定します。指定されたオーディオサンプリングレートは、API リクエストの
sample_rateパラメーターで指定されたオーディオサンプリングレートよりも優先されます。rate
文字列
有効な値:-500 ~ 500 の整数。デフォルト値:0。
0 より大きい値は、話速が速くなることを示します。
0 より小さい値は、話速が遅くなることを示します。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成のオーディオ速度を指定します。指定されたオーディオ速度は、API リクエストの
speech_rateパラメーターで指定されたオーディオ速度よりも優先されます。pitch
文字列
有効な値:-500 ~ 500 の整数。デフォルト値:0。
0 より大きい値は、ピッチが上がることを示します。
0 より小さい値は、ピッチが下がることを示します。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成のオーディオピッチを指定します。指定されたオーディオピッチは、API リクエストの
pitch_rateパラメーターで指定されたオーディオピッチよりも優先されます。volume
文字列
有効な値:0 ~ 100 の整数。デフォルト値:50。
50 より大きい値は、音量が大きくなることを示します。
50 より小さい値は、音量が小さくなることを示します。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、音声合成の音量を指定します。指定された音量は、API リクエストの
volumeパラメーターで指定された音量よりも優先されます。effect
文字列
robot/lolita/lowpass/echo/eq/lpfilter/hpfilter
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性を使用すると、合成音声にさまざまな効果音を生み出すことができます。有効な値:
robot: ロボットボイス
lolita: 少女ボイス
lowpass: ローパス効果
echo: エコー効果
eq: イコライザー
lpfilter: ローパスフィルター
hpfilter: ハイパスフィルター
説明eq、lpfilter、hpfilter の値は高度なフィルターを指定します。この属性を eq、lpfilter、または hpfilter に設定すると、
effectValue属性を設定して、指定したフィルターのカスタム効果を指定できます。SSML 構造は 1 つの効果音のみをサポートします。この属性に複数の値を設定することはできません。
この属性を設定すると、システムレイテンシが増加する可能性があります。
effectValue
文字列
特定のフィルターの効果。 effect 属性を eq、lpfilter、または hpfilter に設定すると、この属性を設定して、指定したフィルターのデフォルト効果を変更できます。
いいえ
eq: イコライザーを指定します。システムは 8 つのデフォルトバンドを提供します。周波数:["40Hz", "100Hz", "200Hz", "400Hz", "800Hz", "1600Hz", "4000Hz", "12000Hz"]。帯域幅:["1.0q", "1.0q", "1.0q", "1.0q", "1.0q", "1.0q", "1.0q", "1.0q"]。この属性を設定する場合は、各バンドのゲインを指定する必要があります。ゲインの範囲は -20 dB ~ 20 dB です。たとえば、effectValue 属性を 1 1 1 1 1 1 1 1 に設定できます。入力値は、スペースで区切られた 8 つの整数で構成される文字列です。値 0 は、バンドのゲインが調整されていないことを示します。
lpfilter: ローパスフィルターの周波数。(0, 必要なサンプリングレート/2] の範囲の整数です。たとえば、effectValue 属性を 800 に設定できます。
hpfilter: ハイパスフィルターの周波数。(0, 必要なサンプリングレート/2] の範囲の整数です。たとえば、effectValue 属性を 1200 に設定できます。
bgm
文字列
オンラインで呼び出すことができる背景音楽 (BGM) の名前。 bgm 属性の説明を表示して、詳細情報を取得できます。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、合成音声の BGM を指定します。
backgroundMusicVolume
文字列
有効な値:0 ~ 100 の整数。デフォルト値:50。
50 より大きい値は、音量が大きくなることを示します。
50 より小さい値は、音量が小さくなることを示します。
いいえ
この属性は、音声合成用の Alibaba Cloud の独自タグに含まれています。この属性は、BGM の音量を指定します。
次の表に、bgm 属性を示します。
組み込み BGM URL
カスタム BGM URL
音声合成サービスは、いくつかの組み込み BGM ストリームを提供します。次の URL をクリックして、BGM ストリームを聞くことができます。
ビジネス要件に基づいてカスタム BGM を使用できます。カスタム BGM を指定する前に、アクセス制御リスト (ACL) がパブリック読み取りまたはパブリック読み取り/書き込みである Alibaba Cloud Object Storage Service (OSS) バケットに BGM を保存する必要があります。バケットの作成方法の詳細については、「バケットの作成」をご参照ください。HTTP または HTTPS プロトコルを使用して、バケットに保存されているオブジェクトの URL を生成できます。詳細については、「ステップ 2: オブジェクトのアップロード」をご参照ください。
アップロードするオーディオファイルの要件:
オーディオファイルは、サンプリングレート 16 kHz のモノラル WAV ファイルである必要があります。
音声合成用の短いテキストのサイズは 3.5 MB を超えません。音声合成用の長いテキストのサイズは 10 MB を超えません。
合成時間が BGM 時間よりも長い場合、BGM は循環的に再生されます。オーディオファイルが WAV 形式でない場合は、次のコマンドを実行してオーディオファイルを WAV 形式に変換できます。
ffmpeg -i 入力オーディオファイル -acodec pcm_s16le -ac 1 -ar 16000 必要なオーディオファイル.wav。タグ内の URL に特別な XML 文字が含まれている場合は、それらの文字をエスケープします。
ビット深度は 16 ビットです。
重要アップロードされたオーディオファイルの著作権については、法的責任を負います。
タグの関係
<speak> タグには、テキストと次のタグを含めることができます。
<break>
<s>
<w>
<phoneme>
<say-as>
例
空の属性
<speak>SSML タグを呼び出す必要があるテキスト</speak>合成結果: SSML-speak1.mp3
属性 voice
<speak voice="xiaogang">これは男性の声です。</speak>合成結果: SSML-speak2.mp3
属性 encodeType
<speak encodeType="mp3">圧縮形式で音声を生成できます。</speak>合成結果: SSML-encode.mp3
属性 sampleRate
<speak sampleRate="8000">ファイルサイズは、サンプリングレート 16 kHz の音声の半分です。</speak>合成結果: SSML-speak4.mp3
属性 rate
<speak rate="200">平均よりも速く話します。</speak>合成結果: SSML-speak5.mp3
属性 pitch
<speak pitch="-100">私の声のピッチは他の人よりも低いです。</speak>合成結果: SSML-speak6.mp3
属性 volume
<speak volume="80">私の声は大きいです。</speak>合成結果: SSML-speak7.mp3
スペースで区切られた属性の組み合わせ
<speak rate="200" pitch="-100" volume="80">複数の属性を使用すると、私の声はこのように聞こえます。</speak>合成結果: SSML-speak8.mp3
属性 effect
<speak effect="robot">ウォーリーロボットは好きですか?</speak>合成結果: SSML-speak9.mp3
属性 bgm
<speak bgm="http://nls.alicdn.com/bgm/2.wav" backgroundMusicVolume="30" rate="-500" volume="40"><break time="2s"/>日陰の崖の上の古木は、厚い苔の層で覆われています<break time="700ms"/>竹林にはまだ雨音が響いています<break time="700ms"/>絹の生産は国民経済に貢献しています<break time="700ms"/>綿州の景色は一見の価値があります<break time="2s"/></speak>合成結果: SSML-speak10.mp3
<emotion>
説明
<emotion> タグは、音声合成に多感情ボイスを適用するために使用されます。このタグはオプションです。複数の感情をサポートしていないボイスにタグを設定すると、エラーが発生します。
構文
<emotion category="happy" intensity="1.0">なんて素晴らしい日だ!</emotion>属性
次の表に、<emotion> タグでサポートされている属性を示します。
属性名
属性タイプ
属性値
必須
説明
category
文字列
列挙値。たとえば、neutral や happy などです。
はい
音声の感情。次の表に、各ボイスでサポートされている感情を示します。
intensity
文字列
値は 0.01 ~ 2.0 の範囲の浮動小数点数です。
いいえ
感情の強度。デフォルト値は 1.0 で、事前定義された感情の強度を示します。最小値は 0.01 で、特定の感情へのわずかな傾きを示します。最小値は 2.0 で、感情の強度が 2 倍になることを示します。
多感情ボイスは、さまざまな感情カテゴリをサポートしています。
ボイス名
voice の値
感情カテゴリ
Zhi Miao_multi-emotional
zhimiao_emo
serious, sad, disgust, jealousy, embarrassed, happy, fear, surprise, neutral, frustrated, affectionate, gentle, angry, newscast, customer-service, story, living
Zhi Mi_multi-emotional
zhimi_emo
angry, fear, happy, hate, neutral, sad, surprise
Zhi Yan_multi-emotional
zhiyan_emo
neutral, happy, angry, sad, fear, hate, surprise, arousal
Zhi Bei_multi-emotional
zhibei_emo
neutral, happy, angry, sad, fear, hate, surprise
Zhi Tian_multi-emotional
zhitian_emo
neutral, happy, angry, sad, fear, hate, surprise
タグの関係
<emotion> タグには、テキストと次のタグを含めることができます。
<s>
<sub>
<say-as>
<w>
<phoneme>
<soundEvent/>
<break/>
例
空の属性
<speak voice="zhitian_emo"><emotion category="happy" intensity="1.0">なんて素晴らしい日だ!</emotion></speak>合成結果: SSML-emotion.wav
<break>
説明
<break> タグはテキストに一時停止を挿入し、オプションです。
構文
<break time="string"/>属性
属性名
属性タイプ
属性値
必須
説明
time
文字列
[数値]s/[数値]ms
いいえ
一時停止の長さ(秒またはミリ秒)。例:2 秒または 50 ミリ秒。
一時停止が秒単位の場合は、数値の値は [1, 10] の範囲の整数です。この場合、値の形式は [数値]s です。
一時停止がミリ秒単位の場合は、数値の値は [50, 10000] の範囲の整数です。この場合、値の形式は [数値]ms です。
タグの関係
<break> タグは空のタグであり、タグを含めることはできません。 <s> タグを使用する場合は、<break> タグを <s> タグと </s> タグで囲む必要があります。これは、文または段落に一時停止が挿入されることを示します。
例
<speak>目を閉じて休憩してください。<break time="500ms"/>さて、目を開けてください。</speak>合成結果: SSML-break.mp3
<s>
説明
<s> タグはテキストの文構造を指定し、オプションです。
構文
<s>テキスト</s>属性
該当なし。
タグの関係
<s> タグには、テキストと次のタグを含めることができます。
<break>
<w>
<phoneme>
<say-as>
例
<speak><s>これは最初の文です。</s><s>これは 2 番目の文です。</s></speak>合成結果: SSML-s.mp3
<sub>
説明
<sub> タグは、タグで囲まれたテキストをエイリアスに置き換えるために使用されます。
構文
<sub alias="string"></sub>属性
属性名
属性タイプ
属性値
必須
説明
alias
文字列
新しいテキストの内容。
はい
タグ内のテキストを置き換えるために使用されるテキスト。
タグの関係
<sub> タグにはテキストを含めることができます。
例
<speak><sub alias="ネットワークプロトコル標準">W3C</sub></speak>合成結果: SSML-sub.mp3
<w>
説明
<w> タグはテキストの単語構造を指定し、オプションです。ほとんどの場合、英語のテキストでは単語分割にスペースが使用されます。このタグを使用する必要はありません。 <w> タグと </w> タグで囲まれたテキストは、英語の場合にのみ独立した単語または句である必要があります。
構文
<w>テキスト</w>属性
該当なし。
タグの関係
<w> タグにはテキストを含めることができます。
例
<speak>南京市長<w>江大橋</w>は本日スピーチを行いました。</speak>合成結果: SSML-w.mp3
<phoneme>
説明
<phoneme> タグは、タグで囲まれたテキストの発音を制御し、オプションです。このタグは英語のテキストではサポートされていません。
構文
<phoneme alphabet="string" ph="string">テキスト</phoneme>属性
属性名
属性タイプ
属性値
必須
説明
alphabet
文字列
py
はい
py の値はピンインを示します。
ph
文字列
タグで囲まれたテキストに対応するピンイン文字列。
はい
ピンインの値割り当てルール:
ピンインの音節はスペースで区切られます。ピンインの音節の数は単語の数と同じである必要があります。
各ピンインの音節は、音と声調記号で構成されます。声調記号は声調番号 1 ~ 5 で表され、5 は軽声を示します。
タグの関係
<phoneme> タグにはテキストを含めることができます。
例
<speak>qu<phoneme alphabet="py" ph="dian3 dang4 hang2">dian dang hang</phoneme>ba zhe ge wan yi<phoneme alphabet="py" ph="dang4 diao4">dang diao</phoneme></speak>合成結果: SSML-phoneme.mp3
<soundEvent>
説明
<soundEvent> タグは、SSML ベースの合成中にテキストの任意の位置にサウンドキューを挿入するために使用されます。
構文
<soundEvent src="URL"/>属性
属性名
属性タイプ
属性値
必須
説明
src
文字列
サウンドキューの URL。
はい
ビジネス要件に基づいてカスタムサウンドキューを使用できます。カスタム BGM を指定する前に、アクセス制御リスト (ACL) がパブリック読み取りまたはパブリック読み取り/書き込みである Alibaba Cloud Object Storage Service (OSS) バケットに BGM を保存する必要があります。バケットの作成方法の詳細については、「バケットの作成」をご参照ください。HTTP または HTTPS プロトコルを使用して、バケットに保存されているオブジェクトの URL を生成できます。詳細については、「ステップ 2: オブジェクトのアップロード」をご参照ください。
アップロードするオーディオファイルの要件:
オーディオファイルは、サンプリングレート 16 kHz のモノラル WAV ファイルである必要があります。
最大ファイルサイズは 2 MB です。
ビット深度は 16 ビットです。
重要
アップロードされたオーディオファイルの著作権については、法的責任を負います。
タグの関係
<soundEvent> タグは空のタグであり、タグを含めることはできません。
例
<speak>馬が驚いて<soundEvent src="http://nls.alicdn.com/sound-event/horse-neigh.wav"/>人々は逃げ散りました。</speak>合成結果: SSML-sound-event.mp3
<say-as>
説明
<say-as> タグは、タグで囲まれたテキストのタイプを指定するため、テキストはこのタイプのデフォルトの発音方法に基づいて発音できます。
構文
<say-as interpret-as="string">テキスト</say-as>属性
属性名
属性タイプ
属性値
必須
説明
interpret-as
文字列
cardinal/digits/telephone/name/address/id/characters/punctuation/date/time/currency/measure
はい
タグで囲まれたテキストのタイプ。有効な値:
cardinal: テキストは整数または小数として読み取られます。
digits: テキストは数字として読み取られます。
telephone: テキストは電話番号として読み取られます。
name: テキストは名前として読み取られます。
address: テキストは住所として読み取られます。
id: テキストはアカウント名またはニックネームとして読み取られます。
characters: テキストは文字ごとに読み取られます。
punctuation: テキストは句読点として読み取られます。
• date: テキストは日付として読み取られます。
• time: テキストは時刻として読み取られます。
• currency: テキストは金額として読み取られます。
• measure: テキストは測定単位として読み取られます。
<say-as> タグがサポートするテキストタイプ
cardinal
形式
例
説明
数値文字列
145
有効な整数:最大 20 桁の正と負の整数([-99999999999999999999,99999999999999999999] の範囲)。
有効な小数:小数点以下の桁数に制限はありません。ただし、小数点以下 10 桁まで保持することをお勧めします。
マイナス記号 + 数値文字列
-145
3 桁ごとにコンマで区切られた数値文字列
10,000
マイナス記号 + 3 桁ごとにコンマで区切られた数値文字列
-10,124
数値文字列 + 小数点 + 2 つのゼロ
10.00
マイナス記号 + 数値文字列 + 小数点 + 2 つのゼロ
-110.00
数値文字列 + 小数点 + 数値文字列
79.090
マイナス記号 + 数値文字列 + 小数点 + 数値文字列
-79.001
形式
例
英語出力
説明
数値文字列
145
one hundred forty five
有効な整数:最大 13 桁の正と負の整数([-999999999999,999999999999] の範囲)。
有効な小数:小数点以下の桁数に制限はありません。ただし、小数点以下 10 桁まで保持することをお勧めします。
ゼロで始まる数値文字列
0145
one hundred forty five
マイナス記号 + 数値文字列
-145
minus hundred forty five
3 桁ごとにコンマで区切られた数値文字列
60,000
sixty thousand
マイナス記号 + 3 桁ごとにコンマで区切られた数値文字列
-208,000
minus two hundred eight thousand
数値文字列 + 小数点 + ゼロ
12.00
twelve
数値文字列 + 小数点 + 数値文字列
12.34
twelve point three four
3 桁ごとにコンマで区切られた数値文字列 + 小数点 + 数値文字列
1,000.1
one thousand point one
マイナス記号 + 数値文字列 + 小数点 + 数値文字列
-12.34
minus twelve point three four
マイナス記号 + 3 桁ごとにコンマで区切られた数値文字列 + 小数点 + 数値文字列
-1,000.1
minus one thousand point one
数値文字列(3 桁ごとにコンマで区切られた数値文字列)+ ハイフン + 数値(3 桁ごとにコンマで区切られた数値文字列)
1-1,000
one to one thousand
その他のデフォルトの読み方
012.34
twelve point three four
なし。
1/2
one half
-3/4
minus three quarters
5.1/6
five point one over six
-3 1/2
minus three and a half
1,000.3^3
one thousand point three to the power of three
3e9.1
three times ten to the power of nine point one
23.10%
twenty three point one percent
digits
形式
例
説明
数値文字列
129090909
数値文字列の長さに制限はありません。数値文字列には最大 20 桁を含めることをお勧めします。
数値文字列に 10 桁を超える数字が含まれている場合は、各数字の後に一時停止を挿入する必要があります。
形式
例
英語出力
説明
数値文字列
12034
one two zero three four
数値文字列の長さに制限はありません。数値文字列には最大 20 桁を含めることをお勧めします。
数値文字列の数字がハイフン (-) またはスペースでグループ化されている場合、グループ間にコンマが挿入されて一時停止が作成されます。数値文字列には最大 5 つのグループがサポートされています。
数値文字列 + スペースまたは接続詞 + 数値文字列 + スペースまたは接続詞 + 数値文字列 + スペースまたは接続詞 + 数値文字列
1-23-456 7890
one, two three, four five six, seven eight nine zero
telephone
形式
例
説明
固定電話番号
4930286
固定電話番号は 7 桁または 8 桁にすることができます。スペースまたはハイフン (-) を使用して数字を区切ることができます。
7 桁の固定電話番号は 2 つのグループに分割できます。この場合、最初のグループには 3 桁が含まれ、2 番目のグループには 4 桁が含まれます。 8 桁の固定電話番号は 2 つのグループに分割できます。この場合、各グループには 4 桁が含まれます。
493 0286
493-0286
62552560
6255 2560
6255-2560
固定電話番号 + 内線番号
4930286-109
内線番号は最大 4 桁にすることができます。
4930286, extension 109
4930286, 内線 109
4930286、内線 109
市外局番 + 固定電話番号
01062552560
010、02x、03xx、04xx、05xx、07xx、08xx、09xx の市外局番がサポートされています。
010 62552560
010 6255 2560
010 6255-2560
010-62552560
010-6255-2560
(010)62552560
03198907098
0319-8907098
市外局番 + 固定電話番号 + 内線番号
010 62552560-109
なし。
010-62552560-109
(010)62552560-109
(010)62552560, extension 109
(010)62552560, 内線 109
(010)62552560、内線 109
国番号 + 市外局番 + 固定電話番号
86-010-62791627
86、(86)、+86、(+86)、0086 の国番号形式がサポートされており、すべて eight-six として読み取られます。
(86)10-62791627
+86-010-62791627
0086-10-62791627
(+86)-10-6279 1627
国番号 + 市外局番 + 固定電話番号 + 内線番号
(86)21-58118818-207
なし。
(86)021-5811-8818-207
(86)021-58118818, x. 207
(86)21-5811-8818, ex. 207
+86-021-58118818, extension 207
携帯電話番号
139 0000 5678
携帯電話番号は 11 桁で構成され、3-3-5 および 3-4-4 の形式で区切ることができます。
139-000-05678
139 000 05678
国番号 + 携帯電話番号
+86-13900005678
なし。
(+86)-139-0000-5678
+8613900005678
0086-139 000 05678
サービス番号
123
一般的なサービス番号がサポートされています。
10 桁のサービス番号は 400 または 800 で始めることができ、3-4-4 の形式で区切ることができます。
16 桁のサービス番号は 12530、17951、12593 で始めることができます。
95678
4008110510
800-810-8888
1253013520638377
備考
(86)(21)9899-80800-0909
数値文字列と区切り文字がサポートされています。区切り文字には括弧とハイフン (-) を使用できます。
形式
例
英語出力
説明
数値文字列
12034
one two oh three four
数値文字列の長さに制限はありません。数値文字列には最大 20 桁を含めることをお勧めします。数値文字列の数字がハイフン (-) またはスペースでグループ化されている場合、グループ間にコンマが挿入されて一時停止が作成されます。数値文字列には最大 5 つのグループがサポートされています。
数値文字列 + スペースまたは接続詞 + 数値文字列 + スペースまたは接続詞 + 数値文字列
1-23-456 7890
one, two three, four five six, seven eight nine oh
プラス記号 + 数値文字列 + スペースまたは接続詞 + 数値文字列
+43-211-0567
plus four three, two one one, oh five six seven
左括弧 + 数値文字列 + 右括弧 + スペース + 数値文字列 + スペースまたは接続詞 + 数値文字列
(21) 654-3210
(two one) six five four, three two one oh
id
形式
例
説明
文字列
dell0101
大文字と小文字、0 ~ 9 の数字、アンダースコア (_) がサポートされています。
出力スペースは、文字間に一時停止が挿入され、文字が 1 つずつ読み取られることを示します。
myid_1998
AiTest
英語のテキストでは、このタグは characters タグと同じ役割を果たします。
characters
形式
例
説明
文字列
ISBN 1-001-099098-1
漢字、大文字と小文字、0 ~ 9 の数字、特定の全角文字と半角文字がサポートされています。
出力スペースは、文字間に一時停止が挿入され、文字が 1 つずつ読み取られることを示します。タグで囲まれたテキストに特別な XML 文字が含まれている場合は、それらの文字をエスケープする必要があります。
x10b2345_u
v1.0.1
Version 2.0
Su M MA000
Airbus A330
Models s01, s02, and s03
エアバス A330
αβγ
形式
例
英語出力
説明
文字列
*b+3$.c-0'=α
asterisk B plus three dollar dot C dash zero apostrophe equals alpha
漢字、大文字と小文字、0 ~ 9 の数字、特定の全角文字と半角文字がサポートされています。
出力スペースは、文字間に一時停止が挿入され、文字が 1 つずつ読み取られることを示します。
タグで囲まれたテキストに特別な XML 文字が含まれている場合は、それらの文字をエスケープする必要があります。
punctuation
形式
例
説明
句読点
...
一般的な中国語と英語の句読点がサポートされています。出力スペースは文字間に一時停止が挿入され、文字が 1 つずつ読み取られることを示します。
タグで囲まれたテキストに特別な XML 文字が含まれている場合は、それらの文字をエスケープする必要があります。
。。
!"#$%&
'()*+
,-./:;
<=>?@
[\]^_
英語のテキストでは、このタグは characters タグと同じ役割を果たします。
date
形式
例
説明
年
71
2 桁と 4 桁の年がサポートされています。
2 桁の年は 60 ~ 99、00 ~ 09、10 ~ 19 です。
4 桁の年は 1000 ~ 1999 と 2000 ~ 2099 です。
04
19
1011
1998
2008
年と月
April, 98
1 月から 9 月までは、ゼロの有無にかかわらず数字で表すことができます。たとえば、1908 年 4 月では、4 月は 4 または 04 で表すことができます。
April 1998
August, 08
August 2008
年、月、日
April 23, 98
1 日から 9 日までは、ゼロの有無にかかわらず数字で表すことができます。たとえば、1908 年 4 月 8 日の日付を表す場合は、4 または 04 を使用して 4 月を示し、8 または 08 を使用して 8 日を示すことができます。
April 23, 1998
August 8, 08
August 08, 2008
年、月、日
April 23, 98
月の 1 日目から 9 日目までは、ゼロの有無にかかわらず数字で表すことができます。たとえば、1908 年 4 月 8 日の日付を表す場合は、4 月を示すために 4 または 04 を使用し、8 日を示すために 8 または 08 を使用できます。
1998 年 4 月 23 日
August 8, 08
2008 年 8 月 8 日
月と日
March 20
なし。
August 07
年と月
2018/08
スラッシュ (/)、ハイフン (-)、ピリオド (.) は、日、月、年の間の区切り文字として使用できます。
2018-08
2018.08
年、月、日
2018/08/08
2018-8-8
2018.08.08
年、月、日~年、月、日
September 1~30, 04
チルダ (~) とハイフン (-) は、日付間の区切り文字として使用できます。
September 01, 2004 - June 08, 2008
年、月、日~日
September 1~30, 04
2004 年 9 月 1 日~2008 年 6 月 8 日
年と月~年と月
April, 01~April, 10
April 2001 ~ April 2010
月と日~月と日
October 1~October 7
October 01~October 07
月と日~日
October 1~7
October 01~07
年、月、日
2018/03/03~2019/01/01
スラッシュ (/) とピリオド (.) は、日、月、年の間の区切り文字として使用でき、チルダ (~) とハイフン (-) は、日付間の区切り文字として使用できます。
1997.9.9~1998.9.9
月と日
10/20~10/31
月~月
Jan~Oct
January~October
年、月、日
10/20/2018
4 桁の年のみがサポートされています。スラッシュ (/) のみ区切り文字として使用できます。月/日/年の形式のみがサポートされています。
形式
例
英語出力
説明
4 桁/2 桁または 4 桁-2 桁
2000/01
two thousand, oh one
年をまたぐ範囲
1900-01
nineteen hundred, oh one
2001-02
twenty oh one, oh two
2019-20
twenty nineteen, twenty
1998-99
nineteen ninety eight, ninety nine
1999-00
nineteen ninety nine, oh oh
1 または 2 で始まる 4 桁の数字
2000
two thousand
4 桁の年
1900
nineteen hundred
1905
nineteen oh five
2021
twenty twenty one
曜日-曜日
または
曜日~曜日
または
曜日&曜日
mon-wed
monday to wednesday
タグで囲まれたテキストに特別な XML 文字が含まれている場合は、それらの文字をエスケープする必要があります。
tue~fri
tuesday to friday
sat&sun
saturday and sunday
DD-DD MMM, YYYY
または
DD~DD MMM, YYYY
または
DD&DD MMM, YYYY
19-20 Jan, 2000
the nineteen to the twentieth of january two thousand
DD は 2 桁の日付、MMM は月の 3 文字の略語または月の正式名称、YYYY は 1 または 2 で始まる 4 桁の年を指定します。
01 ~ 10 Jul, 2020
the first to the tenth of july twenty twenty
05&06 Apr, 2009
the fifth and the sixth of april two thousand nine
MMM DD-DD
または
MMM DD~DD
または
MMM DD&DD
Feb 01 - 03
feburary the first to the third
MMM は月の 3 文字の略語または月の正式名称を指定し、DD は 2 桁の日付を指定します。
Aug 10~20
august the tenth to the twentieth
Dec 11&12
december the eleventh and the twelfth
MMM-MMM
または
MMM~MMM
または
MMM&MMM
Jan-Jun
january to june
MMM は月の 3 文字の略語または月の正式名称を指定します。
jul ~ dec
july to december
sep&oct
september and october
YYYY-YYYY
または
YYYY~YYYY
1990 - 2000
nineteen ninety to two thousand
YYYY は 1 または 2 で始まる 4 桁の年を指定します。
2001~2021
two thousand one to twenty twenty one
WWW DD MMM YYYY
Sun 20 Nov 2011
sunday the twentieth of november twenty eleven
WWW は曜日の 3 文字の略語または曜日の正式名称を指定します。 DD は 2 桁の日付を指定します。 MMM は月の 3 文字の略語または月の正式名称を指定します。 MM は 2 桁の月番号、月の 3 文字の略語、または月の正式名称を指定します。 YYYY は 1 または 2 で始まる 4 桁の年を指定します。
WWW DD MMM
Sun 20 Nov
sunday the twentieth of november
WWW MMM DD YYYY
Sun Nov 20 2011
sunday november the twentieth twenty eleven
WWW MMM DD
Sun Nov 20
sunday november the twentieth
WWW YYYY-MM-DD
Sat 2010-10-01
saturday october the first twenty ten
WWW YYYY/MM/DD
Sat 2010/10/01
saturday october the first twenty ten
WWW MM/DD/YYYY
Sun 11/20/2011
sunday november the twentieth twenty eleven
MM/DD/YYYY
11/20/2011
november the twentieth twenty eleven
YYYY
1998
nineteen ninety eight
その他のデフォルトの読み方
10 Mar, 2001
the tenth of march two thousand one
なし。
10 Mar
the tenth of march
Mar 2001
march two thousand one
Fri. 10/Mar/2001
friday the tenth of march two thousand one
Mar 10th, 2001
march the tenth two thousand one
Mar 10
march the tenth
2001/03/10
march the tenth two thousand one
2001-03-10
march the tenth two thousand one
2000s
two thousands
2010's
twenty tens
1900's
nineteen hundreds
1990s
nineteen nineties
time
形式
例
説明
時刻
12:00
一般的な時刻と時刻範囲の形式がサポートされています。
12:00:00
10:20
10:20:30
09:18:14
時点~時点
11:00~12:00
09:00-14:00
11:00~11:30
11:00-12:18
10:30~11:00
09:28-10:00
10:20~11:20
06:00~08:00
10:20 a.m.~1:30 p.m.
時刻の略語
5:00 am
5:30 am
5:20:12 am
7:00 am
7:30 AM
7:20:12 a.m.
07:08:12 A.M.
5:00 pm
5:30 PM
5:20:12 p.m.
05:09:12 P.M.
9:00 pm
9:30 pm
9:20:12 PM
9:02:12 P.M.
12:00 pm
12:30 p.m.
12:20:12 PM
形式
例
英語出力
説明
HH:MM AM または PM
09:00 AM
nine A M
HH は 1 桁または 2 桁の時間を指定します。 MM は 2 桁の分を指定します。 AM は正午前の時刻を指定します。 PM は正午後の時刻を指定します。
09:03 PM
nine oh three P M
09:13 p.m.
nine thirteen p m
HH:MM
21:00
twenty one hundred
HHMM
100
one o'clock
時点-時点
8:00 am - 05:30 pm
eight a m to five thirty p m
一般的な時刻範囲と形式がサポートされています。
7:05~10:15 AM
seven oh five to ten fifteen A M
09:00-13:00
nine o'clock to thirteen hundred
currency
形式
例
説明
数値 + 通貨コード
12.00 CNY
次の通貨コードがサポートされています:AUD、CAD、HKD、JPY、USD、CHF、NOK、SEK、GBP、CNY、CNY、EUR。
整数、小数、およびコンマ (,) で区切られた国際表記がサポートされています。
12.50 CNY
12,000,000 CNY
12,000,000.00 CNY
12,000.35 CNY
通貨記号 + 数値
$12
次の通貨記号がサポートされています:カナダドル ($) 米ドル ($) フランスフラン (Fr) デンマーククローネ (kr) ポンド (£) 中国元 (¥) ユーロ (€)。
整数、小数、およびコンマ (,) で区切られた国際表記がサポートされています。
$12.00
$12.12
$12,000
$12,000.00
$12,000.99
その他のデフォルトの読み方
1213
なし。
1213 KML
1213.00 KML
1213.9 KML
1,000 KML
1,000.00 KML
1,000.98 KML
12,000
形式
例
英語出力
説明
数値 + 通貨コード
1.00 CNY
one yuan
整数、小数、およびコンマ (,) で区切られた国際表記がサポートされています。
サポートされている通貨コード:
CN¥ (元)
CNY (元)
CNY (元)
AUD (オーストラリアドル)
CAD (カナダドル)
CHF (スイスフラン)
DKK (デンマーククローネ)
EUR (ユーロ)
GBP (イギリスポンド)
HKD (香港ドル)
JPY (日本円)
NOK (ノルウェークローネ)
SEK (スウェーデンクローナ)
SGD (シンガポールドル)
USD (米ドル)
2.02 CNY
two point zero two yuan
1,000.23 CN¥
one thousand point two three yuan
1.01 SGD
one singapore dollar and one cent
2.01 CAD
two canadian dollars and one cent
3.1 HKD
three hong kong dollars and ten cents
1,000.00 EUR
one thousand euros
通貨コード + 数値
US$ 1.00
one US dollar
整数、小数、およびコンマ (,) で区切られた国際表記がサポートされています。
サポートされている通貨コード:
US$ (米ドル)
CA$ (カナダドル)
AU$ (オーストラリアドル)
SG$ (シンガポールドル)
HK$ (香港ドル)
C$ (カナダドル)
A$ (オーストラリアドル)
$ (ドル)
£ (ポンド)
€ (ユーロ)
CN¥ (元)
CNY (元)
CNY (元)
AUD (オーストラリアドル)
CAD (カナダドル)
CHF (スイスフラン)
DKK (デンマーククローネ)
EUR (ユーロ)
GBP (イギリスポンド)
HKD (香港ドル)
JPY (日本円)
NOK (ノルウェークローネ)
SEK (スウェーデンクローナ)
SGD (シンガポールドル)
USD (米ドル)
$0.01
one cent
JPY 1.01
one japanese yen and one sen
£1.1
one pound and ten pence
€ 2.01
two euros and one cent
USD 1,000
one thousand united states dollars
数値 + 数値単位 + 通貨コード
または
通貨コード + 数値 + 数値単位
1.23 Tn CNY
one point two three trillion yuan
次の数値単位がサポートされています:
thousand
million
billion
trillion
Mil (million)
mil (million)
Bil (billion)
bil (billion)
MM (million)
Bn (billion)
bn (billion)
Tn (trillion)
tn (trillion)
K (thousand)
k (thousand)
M (million)
m (million)
$1.2 K
one point two thousand dollars
measure
形式
例
説明
数値 + 中国語単位
2 個
一般的な中国語単位と単位の略語がサポートされています。
120 ヘクタール
100 ミリグラム以上
約 100 メートル
100 人以上
1 センチメートル 20 ミリメートル
120.00 平方キロメートル
数値 + 単位の略語
120.56 cm²
120 平方メートル 56 平方センチメートル
100 m 12 cm 6 mm
範囲
10~15 kg
10.24 ~ 789.82 ムー
10 メートル~15 メートル
10.24 cm~19.08 cm
数値 + 単位 + "/" + 単位
CNY 10/kg
CNY 199 ~ 299/個
CNY 299.99/g ~ CNY 399.99/g
その他のデフォルトの読み方
12 個
30 rm
400,000,000 人
12.897 マイクログラム
形式
例
英語出力
説明
数値 + 測定単位
1.0 kg
one kilogram
整数、小数、およびコンマ (,) で区切られた国際表記がサポートされています。
一般的な単位の略語がサポートされています。
1,234.01 km
one thousand two hundred thirty four point zero one kilometres.
測定単位
mm2
square millimetre
次の表に、<say-as> タグがサポートする一般的な表記を示します。
表記
英語での発音
!
exclamation mark
"
double quote
#
pound
$
dollar
%
percent
&
and
'
left quote
(
left parenthesis
)
right parenthesis
*
asterisk
+
plus
,
comma
-
dash
.
dot
/
slash
:
colon
;
semicolon
<
less than
=
equals
>
greater than
?
question mark
@
at
[
left bracket
\
back slash
]
right bracket
^
caret
_
underscore
`
back quote
{
left brace
|
vertical bar
}
right brace
~
tilde
!
exclamation mark
「
left double quote
」
right double quote
‘
left quote
’
right quote
(
left parenthesis
)
right parenthesis
,
comma
。
full stop
--
em dash
:
colon
;
semicolon
?
question mark
、
enumeration comma
…
ellipsis
...
ellipsis
《
left guillemet
》
right guillemet
¥
yuan
≥
greater than or equal to
≤
less than or equal to
≠
not equal
≈
approximately equal
±
plus or minus
×
times
π
pi
Α
alpha
Β
beta
Γ
gamma
Δ
delta
Ε
epsilon
Ζ
zeta
Θ
theta
Ι
iota
Κ
kappa
∧
lambda
Μ
mu
Ν
nu
Ξ
ksi
Ο
omicron
∏
pi
Ρ
rho
∑
sigma
Τ
tau
Υ
upsilon
Φ
phi
Χ
chi
Ψ
psi
Ω
omega
α
alpha
β
beta
γ
gamma
δ
delta
ε
epsilon
ζ
zeta
η
eta
θ
theta
ι
iota
κ
kappa
λ
lambda
μ
mu
ν
nu
ξ
ksi
ο
omicron
π
pi
ρ
rho
σ
sigma
τ
tau
υ
upsilon
φ
phi
χ
chi
ψ
psi
ω
omega
次の表に、<say-as> タグがサポートする測定単位を示します。
形式
タイプ
英語の例
略語
長さ
nm (nanometre), μm (micrometre), mm (millimetre), cm (centimetre), m (metre), km (kilometre), ft (foot), in (inch)
面積
cm² (square centimetre), ㎡ (square metre), km2 (square kilometre), SqFt (square foot)
体積
cm³ (cubic centimetre), m³ (cubic metre), km3 (cubic kilometre), mL (millilitre), L (litre), gal (gallon)
重量
μg (microgram), mg (milligram), g (gram), kg (kilogram)
時間
min (minute), sec (second), ms (millisecond)
電磁気
μA (microamp), mA (milliamp), Hz (hertz), kHz (kilohertz), MHz (megahertz), GHz (gigahertz), V (volt), kV (kilovolt), kWh (kilowatt hour)
音声
dB (decibel)
圧力
Pa (pascal), kPa (kilopascal), MPa (megapascal)
その他の一般的な単位
次のタイプの英語の測定単位もサポートされています:tsp (teaspoon), rpm (round per minute), KB (kilobyte), mmHg (millimetre of mercury)。
タグの関係
<sub> タグにはテキストを含めることができます。
例
cardinal
<speak><say-as interpret-as="cardinal">12345</say-as></speak>中国語での合成結果: SSML-say-as_Cardinal.mp3
<speak><say-as interpret-as="cardinal">10234</say-as></speak>英語での合成結果: en-SSML-say-as_cardinal.mp3
digits
<speak><say-as interpret-as="digits">12345</say-as></speak>中国語での合成結果: SSML-say-as_digit.mp3
<speak><say-as interpret-as="digits">10234</say-as></speak>英語での合成結果: en-SSML-say-as_digits.mp3
telephone
<speak><say-as interpret-as="telephone">12345</say-as></speak>中国語での合成結果: SSML-say-as_Telephone.mp3
<speak><say-as interpret-as="telephone">10234</say-as></speak>英語での合成結果: en-SSML-say-as_telephone.mp3
name
<speak>彼女の以前の名前は<say-as interpret-as="name">曾国藩です。</say-as></speak>合成結果: SSML-say-as_Name.mp3
address
<speak><say-as interpret-as="address">芙蓉国际 1 号棟 3 ユニット 304 号室</say-as></speak>合成結果: SSML-say-as_Address.mp3
id
<speak><say-as interpret-as="id">myid_1998</say-as></speak>合成結果: SSML-say-as_id.mp3
characters
<speak><say-as interpret-as="characters">ギリシャ文字 αβ</say-as></speak>中国語での合成結果: SSML-say-as_characters.mp3
<speak><say-as interpret-as="characters">*b+3.c$=α</say-as></speak>英語での合成結果: en-SSML-say-as_characters.mp3
punctuation
<speak><say-as interpret-as="punctuation">-./:;</say-as></speak>date
<speak><say-as interpret-as="date">1000-10-10</say-as></speak>中国語での合成結果: SSML-say-as_date.mp3
<speak><say-as interpret-as="date">10-01-2020</say-as></speak>英語での合成結果: en-SSML-say-as_date.mp3
time
<speak><say-as interpret-as="time">5:00am</say-as></speak>中国語での合成結果: SSML-say-as_time.mp3
<speak><say-as interpret-as="time">0500</say-as></speak>英語での合成結果: en-SSML-say-as_time.mp3
currency
<speak><say-as interpret-as="currency">13,000,000.00CNY</say-as></speak>中国語での合成結果: SSML-say-as_currency.mp3
<speak><say-as interpret-as="currency">$1,000.01</say-as></speak>英語での合成結果: en-SSML-say-as_currency.mp3
measure
<speak><say-as interpret-as="measure">100m12cm6mm</say-as></speak>中国語での合成結果: SSML-say-as_measure.mp3
<speak><say-as interpret-as="measure">1,000.01kg</say-as></speak>英語での合成結果: en-SSML-say-as_measure.mp3
総合的な例
<speak>北宋時代、<say-as interpret-as="date">1121 年 10 月 10 日</say-as>、<say-as interpret-as="address">開封市の郊外</say-as>は<sub alias="ダブルイレブン">ダブルイレブン</sub>ショッピングフェスティバルの楽しい雰囲気に包まれていました。ラバのキャラバンが城門に入ると、美しい女性が<phoneme alphabet="py" ph="zou3 xiang4">近づいて</phoneme>、<say-as interpret-as="name">阿發という名前の</say-as>隊列の先頭にいる男性に声をかけました。</speak>
<speak>「こんにちは、当店では本日、特別プロモーションを実施しています。すべての靴がセール中で、<say-as interpret-as="digits">199</say-as>で<say-as interpret-as="cardinal">100</say-as>円引きになります。お見逃しなく。」</speak>
<speak>「ありがとう、でも本当に急がないと。今は<say-as interpret-as="time">09:59:59</say-as>です。時間通りに商品を届けられないと、サプライチェーン全体が失敗する可能性があります。」</speak>
<speak><say-as interpret-as="name">阿發</say-as>は額の汗を拭きながら、客引きの叫び声でいっぱいの混雑した路地をチームを案内しました。</speak>
<speak>最新のカラー生地はこちらで手に入ります。 2 つ購入すると 1 つ無料になります。</speak>
<speak>ベストセラーの帽子。 7 日間の無条件返品ポリシーを提供しています。</speak>
<speak>男女問わず、あらゆる種類の難病を治療します。</speak>
<speak>突然、馬が驚いて道を走り始めました。子供も驚き、母親の腕の中に倒れ込み、<break time="50ms"/>泣き叫びました。</speak>
<speak>「ママ、ママ!」</speak>
<speak>その時、<say-as interpret-as="name">阿發</say-as>は思いました</speak>
<speak>「怖い!」</speak>
<speak>彼はすぐに<phoneme alphabet="py" ph="qian2 bao1">財布</phoneme>を覆い、商品を届けるために道を進み続けました。途中で、<say-as interpret-as="address">開封市</say-as>のにぎやかな光景が<say-as interpret-as="name">阿發</say-as>に深い印象を与えました。</speak>
<speak>時が経ち、街の賑わいが薄れると、彼は筆を取り、ショッピングフェスティバル中に長い巻物に絵を描きました。巻物の絵は「清明上河図」と名付けられました。</speak>