aria-kit 0.7.0

Audio capture, transcription, synthesis, and voice-analysis contracts for local speech apps
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Speaking synthesized audio through the default output device.

use super::SpeakerOutput;
use crate::cancel::CancelToken;

use super::{Engine, SpeakingRate, SpeechText, Synthesis, SynthesisError, Voice, stream};

impl<T: Engine> Synthesis<T> {
    /// Speaks with the engine's default voice at its natural pace and waits
    /// until the utterance has been heard.
    pub fn speak(&self, text: &SpeechText) -> Result<(), SynthesisError> {
        self.speak_with(text, None, SpeakingRate::standard(), &CancelToken::never())
    }

    /// Speaks one utterance and waits until it has been heard.
    pub fn speak_with(
        &self,
        text: &SpeechText,
        voice: Option<&Voice>,
        rate: SpeakingRate,
        cancel: &CancelToken,
    ) -> Result<(), SynthesisError> {
        if cancel.is_cancelled() {
            return Err(SynthesisError::Cancelled);
        }

        if self.engine.plays_audio_itself() {
            let (writer, speech) = stream(self.engine.sample_rate());
            let outcome = self
                .engine
                .synthesize_with(text, voice, rate, writer, cancel);
            drop(speech);
            return outcome;
        }

        let output = SpeakerOutput::new().map_err(|source| SynthesisError::Playback { source })?;
        self.start_with(text, voice, rate, cancel)?
            .play_on(&output, || {})
    }
}