Struct VoiceCondition 

pub struct VoiceCondition {
    pub speaker_audio: Option<AudioInput>,
    pub cached_voice_id: Option<String>,
    pub language: Option<String>,
    pub emotion: Option<String>,
    pub speaking_rate: Option<f32>,
    pub pitch_shift: Option<f32>,
    pub energy_scale: Option<f32>,
    pub tags: BTreeMap<String, String>,
}

说话人参考 / 风格条件（映射到上游请求 JSON 的 voice 字段）。

比把参考音频塞进顶层 audio 更语义化：支持「用参考音频克隆音色」、 「用 cached_voice_id 复用已注册音色」、以及风格/语速/音高控制。 通过 TtsRequest::voice 设置。

Fields

speaker_audio: Option<AudioInput>

说话人参考音频（声音克隆）。

cached_voice_id: Option<String>

已缓存的音色 id（复用之前克隆得到的音色，免去再次上传参考音频）。

language: Option<String>

风格：语言。

emotion: Option<String>

风格：情绪。

speaking_rate: Option<f32>

风格：语速缩放。

pitch_shift: Option<f32>

风格：音高偏移。

energy_scale: Option<f32>

风格：能量缩放。

tags: BTreeMap<String, String>

风格：自由标签。

Implementations

impl VoiceCondition

pub fn speaker(audio: impl Into<AudioInput>) -> Self

以说话人参考音频（声音克隆）构造。

pub fn cached(id: impl Into<String>) -> Self

以已缓存音色 id 构造（复用音色）。

pub fn language(self, language: impl Into<String>) -> Self

设置语言。

pub fn emotion(self, emotion: impl Into<String>) -> Self

设置情绪。

pub fn speaking_rate(self, rate: f32) -> Self

设置语速缩放。

pub fn pitch_shift(self, shift: f32) -> Self

设置音高偏移。

pub fn energy_scale(self, scale: f32) -> Self

设置能量缩放。

pub fn tag(self, key: impl Into<String>, value: impl Into<String>) -> Self

设置一个风格标签。

Trait Implementations

impl Clone for VoiceCondition

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VoiceCondition

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for VoiceCondition

fn default() -> Self

Returns the “default value” for a type.