跳转到主要内容

在原生模式下让它唱歌

原生模式的歌声合成通过 PHP FFI 直接调用 VOICEVOX CORE。 构建 ScoreNote 的方式与客户端模式一致。

前置准备

  1. 已完成 安装与配置
  2. 已配置好 VOICEVOX Core for PHP
  3. 已在 .env 中设置 VOICEVOX_CORE_PATH
使用歌声模型时,请确认 config/voicevox.phpcore.vvms 中包含 s0.vvm

构建 ScoreNote

基本使用

使用相同的 Score,就能在客户端模式与原生模式中复用同一份乐谱。

使用 tap() 重新同步 F0 与音量

原生 Song 中 tap() 同样有用。调整完 SongAudioQuery 后可直接传给 generate()
如需分别更新 F0 与音量,请务必按以下顺序执行。

与客户端模式的区别

FFI 的机制请参见 PHP FFI;仅使用核心库时的流程请参见 VOICEVOX Core for PHP 用法

下一步阅读

Score 与 Note 详解

了解 Song 乐谱数据的实用管理方法。

客户端 Song

对比与 HTTP 客户端版的差异。

VOICEVOX for Laravel 概览

汇总查看各模式与相关页面。
最后修改于 2026年7月18日