クライアントモードで歌わせる
クライアントモードの歌声合成では、公式 VOICEVOX エンジンの sing_frame_audio_query と frame_synthesis API を使います。
Talk と違って、先に Score と Note を組み立てる必要があります。
事前準備
docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest
Score と Note を作る
use Revolution\Voicevox\Song\Note;
use Revolution\Voicevox\Song\Score;
$score = Score::make([
Note::make(length: 15),
Note::make(length: Note::len(ticks: 480, bpm: 120), lyric: 'ド', key: 60),
Note::make(length: Note::len(480, 120), lyric: 'レ', key: 62),
Note::make(length: Note::len(960, 120), lyric: 'ミ', key: 64),
Note::make(length: 2),
]);
| パラメーター | 型 | 説明 |
|---|
length | int | フレーム長 |
lyric | string | 歌詞。空文字または省略で休符 |
key | int|null | MIDI ノート番号 |
Note::len($ticks, $bpm) を使うと、MIDI の ticks と BPM からフレーム長を計算できます。四分音符を 480 ticks として扱うと分かりやすいです。
基本的な使い方
use Revolution\Voicevox\Song\Note;
use Revolution\Voicevox\Song\Score;
use Revolution\Voicevox\Voicevox;
$score = Score::make([
Note::make(length: 15),
Note::make(length: Note::len(480, 120), lyric: 'ド', key: 60),
Note::make(length: Note::len(480, 120), lyric: 'レ', key: 62),
Note::make(length: Note::len(960, 120), lyric: 'ミ', key: 64),
Note::make(length: 2),
]);
$response = Voicevox::song($score, teacher: 6000)
->generate(id: 3001);
$response->storeAs('client', 'song.wav');
teacher と id
teacher: sing_frame_audio_query に渡すスタイル ID。現状は6000ひとつしか存在しないのでデフォルトで6000。generate(id:): frame_synthesis に渡すスタイル ID
利用可能な歌声スピーカー一覧は singers() で取得できます。
use Revolution\Voicevox\Voicevox;
$singers = Voicevox::singers();
tap() で F0 とボリュームを調整する
Song では tap() の使いどころが特に分かりやすく、SongAudioQuery を調整してから generate() へ流せます。
use Revolution\Voicevox\Client\SongAudioQuery;
use Revolution\Voicevox\Voicevox;
$response = Voicevox::song($score, teacher: 6000)
->tap(function (SongAudioQuery $song) {
$song->sync();
})
->generate(id: 3001);
->tap(function (SongAudioQuery $song) {
$song->updateF0();
$song->updateVolume();
})
tap() が便利です。
->tap(function (SongAudioQuery $song) {
$song->score->notes[2] = Note::make(length: Note::len(480, 120), lyric: 'ファ', key: 65);
$song->sync();
})
次に読むページ
Score と Note 詳細
フレーム長計算と JSON 管理パターンを確認します。
ネイティブ Song
同じ Score を FFI 経由のネイティブモードで使います。
VOICEVOX Core for PHP 使い方
コアライブラリ単体での音声合成フローを確認します。
