什么是原生模式
原生模式通过 VOICEVOX Core for PHP,用 PHP FFI 直接调用 VOICEVOX CORE。 无需启动官方引擎即可合成,但需要配置 FFI 与本地库。前置准备
- 已完成 安装与配置
- 已完成 VOICEVOX Core for PHP 的配置
- 已在
.env中设置VOICEVOX_CORE_PATH
基本使用
原生模式使用talk() helper。
指定 Style ID
id 请指定已加载的 .vvm 中包含的 Style ID。
config/voicevox.php 中 core.vvms 所包含的模型。
使用 tap() 调整 Audio Query
在原生模式下 tap() 的用法相同。不过 TalkAudioQuery 与客户端模式是不同的类。
tap() 这一模式本身整理在 tap() helper 与 Tappable trait 中。VOICEVOX for Laravel 是其实际案例。使用 AquesTalk 风格的假名记法
原生模式没有enable_katakana_english,因此不适合直接读取包含英语的输入。
作为替代,你可以使用直接传入 AquesTalk 风格假名记法的 kana()。
与客户端模式的区别
| 项目 | 客户端 Talk | 原生 Talk |
|---|---|---|
| 引擎启动 | 需要 | 不需要 |
| FFI | 不需要 | 需要 |
| 英语自动片假名转换 | 有 | 无 |
| API 入口 | Voicevox::talk() | talk() |
下一步阅读
原生 Song
通过 FFI 使用歌声模型。
VOICEVOX Core for PHP
了解纯 PHP wrapper 侧的配置与限制。