C++SAPI的使用

### 使用C++调用SAPI实现文字转语音

为了使用Microsoft的Speech API (SAPI)，开发者可以在程序中引入`SpeechLib`命名空间下的各类功能[^1]。对于C++而言，要使能这一特性并执行诸如文本到语音(TTS)的任务，则需要链接至相应的库文件，并初始化COM环境。

下面是一个简单的例子展示怎样创建一个能够朗读给定字符串的应用：

#include <iostream>
#include <sapi.h>

int main() {
    ISpVoice* pVoice = nullptr;

    // 初始化 COM 库
    HRESULT hr = CoInitialize(NULL);
    
    if (FAILED(hr)) {
        std::cerr << "Failed to initialize COM library." << std::endl;
        return -1;
    }

    // 创建 SpVoice 对象实例
    hr = CoCreateInstance(CLSID_SpVoice, NULL, CLSCTX_ALL, IID_ISpVoice, reinterpret_cast<void**>(&pVoice));

    if (SUCCEEDED(hr)) {
        // 设置待朗读的文字内容
        hr = pVoice->Speak(L"Hello world", SPF_DEFAULT, NULL);

        // 清理资源
        pVoice->Release();
        pVoice = nullptr;
    } else {
        std::cerr << "Failed to create SAPI voice instance." << std::endl;
    }
    
    // 关闭 COM 环境
    CoUninitialize();

    return 0;
}

这段代码展示了如何设置和释放SAPI对象以及处理可能发生的错误情况。它还说明了如何通过`ISpVoice`接口的方法来指定想要转换成声音的消息[^2]。