sapi-lite 0.1.1

A simplified wrapper around Microsoft's Speech API (SAPI) library
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

use windows as Windows;
use Windows::Win32::Media::Speech::{ISpRecoContext, SPCS_DISABLED, SPCS_ENABLED};

use crate::com_util::Intf;
use crate::Result;

use super::{GrammarBuilder, RecognitionPauser};

mod event;
mod sync;

pub use event::{EventHandler, EventfulContext};
pub use sync::SyncContext;

/// Provides the common API shared across different kinds of contexts.
pub struct Context {
    intf: Intf<ISpRecoContext>,
    pauser: RecognitionPauser,
}

impl Context {
    fn new(intf: ISpRecoContext, pauser: RecognitionPauser) -> Self {
        Self {
            intf: Intf(intf),
            pauser,
        }
    }

    /// Enables or disables the recognition of rules from all grammars loaded into this context.
    pub fn set_enabled(&self, enabled: bool) -> Result<()> {
        let state = if enabled { SPCS_ENABLED } else { SPCS_DISABLED };
        unsafe { self.intf.SetContextState(state) }
    }

    /// Creates a [`GrammarBuilder`] that will construct and load a grammar into this context.
    pub fn grammar_builder(&self) -> GrammarBuilder {
        GrammarBuilder::new(self.intf.clone(), self.pauser.clone())
    }
}