Clientmodus: song (zangsynthese) - VOICEVOX for Laravel

Laten zingen in de clientmodus

Voor zangsynthese in de clientmodus gebruik je de API’s sing_frame_audio_query en frame_synthesis van de officiële VOICEVOX-engine. Anders dan bij talk moet je eerst een Score en Notes opbouwen.

Voorbereiding

docker pull voicevox/voicevox_engine:cpu-latest
docker run --rm -p '127.0.0.1:50021:50021' voicevox/voicevox_engine:cpu-latest

Een `Score` en `Note`s maken

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),
]);

Parameter	Type	Beschrijving
`length`	`int`	Framelengte
`lyric`	`string`	Songtekst. Een lege string of weglaten betekent een rust
`key`	`int\|null`	MIDI-nootnummer

Met Note::len($ticks, $bpm) kun je de framelengte berekenen uit MIDI-ticks en BPM. Het is overzichtelijk om een kwartnoot als 480 ticks te behandelen.

Basisgebruik

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` en `id`

teacher: het stijl-ID dat aan sing_frame_audio_query wordt doorgegeven. Op dit moment bestaat er maar één, namelijk 6000, dus de standaardwaarde is 6000.
generate(id:): het stijl-ID dat aan frame_synthesis wordt doorgegeven

Je kunt de lijst met beschikbare zangstemmen ophalen met singers().

use Revolution\Voicevox\Voicevox;

$singers = Voicevox::singers();

F0 en volume aanpassen met `tap()`

Bij song is de meerwaarde van tap() bijzonder duidelijk: je kunt de SongAudioQuery aanpassen voordat je hem doorgeeft aan 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);

Als je F0 en volume afzonderlijk bijwerkt, doe dat dan in de volgorde F0 → volume.

->tap(function (SongAudioQuery $song) {
    $song->updateF0();
    $song->updateVolume();
})

tap() is ook handig wanneer je de Score hebt gewijzigd en opnieuw wilt synchroniseren.

->tap(function (SongAudioQuery $song) {
    $song->score->notes[2] = Note::make(length: Note::len(480, 120), lyric: 'ファ', key: 65);
    $song->sync();
})

De gedachte achter tap() staat samengevat in De tap()-helper en de Tappable-trait. VOICEVOX for Laravel is een typisch voorbeeld van “alleen het tussenobject aanpassen zonder de returnwaarde te veranderen”.

Volgende pagina’s

Score en Note in detail

Bekijk de framelengteberekening en patronen voor JSON-beheer.

Native song

Gebruik dezelfde Score in de native modus via FFI.

VOICEVOX Core for PHP gebruiken

Bekijk de spraaksyntheseflow met alleen de corebibliotheek.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Clientmodus: song (zangsynthese) - VOICEVOX for Laravel

Laten zingen in de clientmodus

Voorbereiding

Een `Score` en `Note`s maken

Basisgebruik

`teacher` en `id`

F0 en volume aanpassen met `tap()`

Volgende pagina’s

Score en Note in detail

Native song

VOICEVOX Core for PHP gebruiken

​Laten zingen in de clientmodus

​Voorbereiding

​Een Score en Notes maken

​Basisgebruik

​teacher en id

​F0 en volume aanpassen met tap()

​Volgende pagina’s

Score en Note in detail

Native song

VOICEVOX Core for PHP gebruiken

Laten zingen in de clientmodus

Voorbereiding

Een `Score` en `Note`s maken

Basisgebruik

`teacher` en `id`

F0 en volume aanpassen met `tap()`

Volgende pagina’s