AquesTalk10 Win マニュアル株式会社 アクエスト
www.a-quest.com

概要
本文書は、音声合成ライブラリ AquesTalk10 Win をアプリケーションに組み込んで使用するためのプログラミングの方法、注意点を示したものです。
AquesTalk10 は、かな表記の音声記号列から WAV 音声データを生成するライブラリです。
AquesTalk10 は、声質パラメータを指定することで様々な声質の音声を生成できる特徴があります。
本ライブラリを使用するには、開発ライセンスキーの設定が必要です。このライセンスキーを設定しない場合は、評価版として動作し、以下の制限があります。
評価版の制限「ナ行、マ行」を指定すると、すべて「ヌ」と発声します

また、本ライブラリをアプリケーションに組み込んで使用する際には使用ライセンス
使用ライセンス、配布には頒布ライ頒布ライ使用ライセンス
センスが必要です。ライセンスの種類や購入方法は、弊社サイトのライセンスのページを参照してくださ
センス
い。

仕様

ライブラリ形式

DLL(ダイナミックライブラリ) i386/x64対応 OS

Windows 10/8/7/Vista/XP, 32bit/64bit 版

入力データ形式

かな表記音声記号列（Shift JIS/UTF8/UTF16)

出力データ形式

WAV フォーマット（16KHz サンプリング,16bitPCM,モノラル）データ*サンプリング周波数は声質パラメータにより変化

声種

ベース音素片 3 種 パラメータでユーザカスタマイズ可関数 I/F

C 関数呼び出しマルチスレッド対応

ライブラリサイズ

約 400KByteビルド・実行
ヘッダ、ライブラリ
プログラムのコンパイル時にはヘッダファイル(AquesTalk.h)をインクルードします。必要に応じてインクルードファイルのパスを設定しておきます。リンク時には、AquesTalk.lib ファイルをリンクするファイルに追加しておきます。なお、LoadLibrary()などで実行時に動的にリンクすることも可能です。
パッケージ内の lib フォルダが 32bit 版、lib64 フォルダが 64bit 版となります。

実行
アプリの実行の際には、AquesTalk.dll が必要です。通常、このファイルはアプリの exe ファイルと同じディレクトリに配置します。

依存ライブラリ
AquesTalk.dll は、コンパイルオプション/MT でビルドしています。したがって、AquesTalk.dll が使用する C ランタイム ライブラリ (CRT) は DLL 内に含まれています（静的リンク）。実行時に必要なライブ
ラリは KERNEL32.dll だけで、これは Windows のシステムディレクトリに含まれています。アプリの開発において依存ライブラリを意識する必要はありません。
AquesTalk_Synthe()関数で返された音声データは、使用後に AquesTalk_FreeWav()で解放してください。
アプリ側で free() などを使用して解放すると、異なる CRT の場合にハングします。

関 数 API
AquesTalk_Synthe

AquesTalk.h

説明

かな表記音声記号列(SJIS)から音声波形を生成します構文

unsigned char * AquesTalk_Synthe(const AQTK_VOICE *pParam, const char *koe, int *size)

引数
pParam

声質パラメータ(構造体 AQTK_VOICE のアドレス)を指定

koe

音声記号列（SJIS NULL 終端）を指定

size

生成した音声データのサイズが返る[byte]（エラーの場合はエラーコードが返る）

戻り値

WAV フォーマットの音声データを返す。
ヒープ領域を関数内部で確保するので、解放は AquesTalk_FreeWave()で行う。
エラー時は、NULL を返す。このとき size にエラーコードが設定される。

AquesTalk_Synthe_Utf8

AquesTalk.h

説明

かな表記音声記号列(UTF-8)から音声波形を生成します構文

unsigned char * AquesTalk_Synthe_Utf8(const AQTK_VOICE *pParam, const char *koe, int*size)

引数
pParam

声質パラメータ(構造体 AQTK_VOICE のアドレス)を指定

koe

音声記号列（UTF-8 NULL 終端）を指定

size

生成した音声データのサイズが返る[byte]（エラーの場合はエラーコードが返る）

戻り値

WAV フォーマットの音声データを返す。
ヒープ領域を関数内部で確保するので、解放は AquesTalk_FreeWave()で行う。
エラー時は、NULL を返す。このとき size にエラーコードが設定される。

AquesTalk_Synthe_Utf16

AquesTalk.h

説明

かな表記音声記号列(UTF-16)から音声波形を生成します構文

unsigned char * AquesTalk_Synthe_Utf16(const AQTK_VOICE *pParam, const unsigned short*koe, int *size)

引数
pParam

声質パラメータ(構造体 AQTK_VOICE のアドレス)を指定

koe

音声記号列（UTF-16 NULL 終端 BOM の有無は問わない エンディアンは実行環境に従う）を指定

size

生成した音声データのサイズが返る[byte]（エラーの場合はエラーコードが返る）

戻り値

WAV フォーマットの音声データを返す。
ヒープ領域を関数内部で確保するので、解放は AquesTalk_FreeWave()で行う。
エラー時は、NULL を返す。このとき size にエラーコードが設定される。

AquesTalk_FreeWave
説明

音声データの領域を開放

構文

void AquesTalk_FreeWave(unsigned char *wav)

引数wav

WAV フォーマットのデータ（AquesTalk_Synthe()等で生成した音声データ）

戻り値なし

AquesTalk.hAquesTalk_SetDevKey

AquesTalk.h

説明

開発ライセンスキーを設定。音声波形を生成する前に一度呼び出すことで、以降、製品版とし動作し、評価版の制限がなくなる。

構文

int AquesTalk_SetDevKey(const char *key)

引数key

開発ライセンスキー文字列(半角英数)

戻り値

ライセンスキーが正しければ 0、正しくなければ 1 が返る。
不正なキーでも 0 を返す場合がある。このとき制限は解除されない。

AquesTalk_SetUsr
AquesTalk_SetUsrKey
UsrKeyAquesTalk.h

説明使用ライセンスキーを設定。音声波形を生成する前に一度呼び出すことで、以降、合成音声データに含まれる透かしが使用ライセンス無しから取得済みに変化する。

構文

int AquesTalk_SetUsrKey(const char *key)

引数key

使用ライセンスキー、または頒布ライセンスキーの文字列(半角英数)

戻り値

ライセンスキーが正しければ 0、正しくなければ 1 が返る。
不正なキーでも、まれに 0 を返す場合がある。このときはライセンス無しのままである。

音声記号列
AquesTalk10 は、かな表記の音声記号列から音声を合成します。漢字を含んだテキスト文字列から音声を合成するときは、別途、言語処理ライブラリ AqKanji2Koe を用いて漢字仮名交じりテキストから音声記号列に変換する必要があります。
音声記号列の詳細は、付属の音声記号列仕様書を参照してください。

声質パラメータ
AquesTalk10 は声質パラメータの値を変更することで、様々な声種で合成できます。声質パラメータの種類と効果を以下に示します。
bas

声色のベースとなる基本素片 F1E,F2E,M1E のいずれかを指定

spd

話速。値が大きいほど発話速度が速い

vol

音量。デフォルトは 100。値が大きいほど音量が大きくなる。１００以下を指定の場合は、比例して音量が変化する。１００以上を指定した場合は、コンプレッサーが機能する。

pit

声の高さがパラメータに比例する。

acc

アクセントの強さ。値が大きいほどアクセントによるピッチの高低が大きくなる。

lmd

主に声質の高低を表現するが、より複雑な声質の変化がある。

fsc

声質の高低を表現。デフォルトは 100。サンプリング周波数を変化するだけなので、これに応じて話速や声の高さも同時に変化する。

AquesTalk.h には、声質パラメータの値をセットしたプリセット声種を複数用意しています。簡単に使う
場合は、これを AquesTalk_Synthe()の声質パラメータの引数にすることができます。

エラーコード表関数が返すエラーコードの内容は、次の通りです。
値

内容100

その他のエラー

101

メモリ不足

103

音声記号列指定エラー(語頭の長音、促音の連続など)

104

音声記号列に有効な読みがない

105

音声記号列に未定義の読み記号が指定された

106

音声記号列のタグの指定が正しくない

107

タグの長さが制限を越えている（または[>]がみつからない）

108

タグ内の値の指定が正しくない

120

音声記号列が長すぎる

121

１つのフレーズ中の読み記号が多すぎる

122

音声記号列が長い（内部バッファオーバー1）

サンプルプログラム
次に示すコードは、音声記号列から音声データを生成し、WAV ファイルとして出力する最も単純なプログラムです(同等のソースが、パッケージに含まれています。samples/HelloTalk/HelloTalk.cpp)。
7 行目ではローカル変数 voice に、プリセット声種 g_VoiceF1 をコピーして、8 行目で話速を 120 と少し早めに設定しています。
11 行目の"こんにちわ。" の部分を、任意の音声記号列に変更することで、異なるメッセーを生成可能です。

#include <stdio.h>#include <AquesTalk.h> // AquestTalk クラスのヘッダ
int main(int ac, char **av){// 声質パラメータ
AQTK_VOICE voice = gVoice_F1;
voice.spd = 120;
int size;
unsigned char *wav = AquesTalk_Synthe(&voice, "こんにちわ。", &size);if(wav==0) {fprintf(stderr, "ERR %d", size); // エラー時は size にエラーコードが返る
return -1;}// ルートディレクトリに生成した音声データを保存
FILE *fp = fopen("\\ZZZ.wav", "wb");
fwrite(wav, 1, size, fp);
fclose(fp);// Synthe()で生成した音声データは、使用後に呼び出し側で解放する
AquesTalk_FreeWave (wav);
return 0;}

C や C++以外の言語環境(たとえば C#,VB など）での使用方法はここでは示しません。データ型の変換等の処理が必要になりますが、各言語の DLL を呼び出す一般的な方法を参照してください。なお、
AquesTalk_Synthe()関数はポインタを返しますので、VB ではラッパーが必要になるかもしれません。

サンプルアプリ
任意の音声記号列から音声を合成して再生、合成音声をファイルに出力する機能を持った、サンプルアプ
リ AqTk10App が本パッケージ含まれています(samples/AqTk10App/AqTk10App.exe)。
声質パラメータを自由に変更して、声質の変化を確認することもできます。
また、開発ライセンスキーを登録すれば、評価版の制限なしで音声合成可能です。

アプリ開発ガイドライン
アプリケーションの開発(評価での使用を除く)は、以下のガイドラインに従ってください。

ライセンスキー
本ライブラリの動作は、開発ライセンスキーと使用ライセンスキー、頒布ライセンスキーの 3 種類の関連キーに依存します。これらのキーは、各ライセンス購入時に発行されるライセンス証に記載されています。
AquesTalk_SetDevKey（）をアプリケーションの起動初期に一度呼び出します。引数には開発ライセンスキーを指定します。これにより製品版として動作し、評価版の制限がなくなります。
AquesTalk_SetUsrKey()をアプリケーションの起動初期に一度呼び出します。AquesTalk_SetDevKey()との呼び出し順序は任意です。引数には、使用ライセンスキー、または頒布ライセンスキーを指定します。
この指定により、合成音声データに含まれる透かしが、使用ライセンス無しの状態から取得済みに変化します。この変化による聴感上の違いはありません。
頒布ライセンスによりアプリを配布する場合は、頒布ライセンスキーを指定して呼び出します。
それ以外の場合は、エンドユーザが使用ライセンスキーを指定できるようにします。なお、エンドユーザが個人かつ非営利の利用の場合は使用ライセンスが不要なので、使用ライセンスキーが未指定の場合は、この関数の呼び出しをスキップして構いません。
関数の戻り値のチェックは必ず行い、エラーの場合はエンドユーザにその旨を通知してください。

声質パラメータ
エンドユーザによる声質パラメータの変更機能の有無は任意です。
変更可能にする場合、アプリケーション間での声質パラメータの値を共有するために、声質パラメータの値を写像しないでください。
例えば、話速のパラメータの範囲は 50 から 300 ですが、これを 0 から 100 の範囲にマッピングしてエンドユーザに提示しないでください。
エンドユーザに提示する各パラメータの名称には、AquesTalk.h に記載の漢字名称(話速など)や、3 文字の構造体変数名(spd など)を用いるのが望ましいです。

文書履歴

日付版

2017/10/07

1.0

変更箇所

更新内容

更新者

新規作成

N.Y