huaweicloud-CodeArts-TextToSpeechSample-cpp:基于CodeArts IDE的华为云语音合成应用开发示例

1、介绍

CodeArts IDE面向华为云开发者提供的智能化可扩展桌面集成开发环境（IDE），结合华为云行业和产业开发套件，实现极致的一站式用云和开发体验。

• 连接华为云，用云更畅快：内置华为云帐号支持和华为云API开发套件，支持一键登录后快速用云，浏览、查找、引用和调试云服务API，并有样例代码支持

• 编码新体验，开发更高效：内置华为自研C/C++语言开发支持，提供全新的工程加载、语法着色、符号解析、编码重构和运行调试等开发体验，提升开发效率

• 能力可扩展，生态更开放：支持基于插件的能力扩展，开放的插件标准，开源的插件框架，开放的插件市场，形成更加开放的生态系统

• 界面可裁剪，体验更优质：支持基于组建的界面剪裁，在精简模式下形成专用工具的优质体验，又可以在需要时升级为全模式的全量IDE工具

CodeArts IDE for C/C++：基于C/C++语言开发CMake工程，并通过CodeArts IDE完成从工程创建、代码编写、运行调试到发布测试的全过程。基于插件扩展可以将个人开发者作业流集成其中，实现从需求到提交的全部过程，更可在业务中集成华为云所提供的的诸多能力，提升应用交付效率。

您将学到什么？

本实验将指导开发者通过CodeArts IDE for C/C++平台，在本地桌面实现华为云应用的快速开发。通过本实验您将体验到：

• 在CodeArts IDE for C/C++上进行基于CMake项目的本地编译构建
• 在CodeArts IDE上的调试和运行
• 结合华为云API接口，实现一个文字合成语音的应用，最终按照文本要求输出专属场景音色音频

2、前置条件

• 注册华为云账号并完成实名认证
• 下载并安装CodeArts IDE for C/C++到本地
• 使用前需获取账号的AK、SK、Project_Id和用户请求Token，获取指南详见步骤3。
• 注册Gitee账号，下载源代码并解压至本地

3、实验配置

配置前打开CodeArts IDE，点击“文件”，“打开文件夹”，找到代码包所在目录并打开。

3.1 配置AK/SK

访问语音合成API需要AK/SK，AK/SK在华为云“控制台”的右上方用户名下拉菜单中，点击“我的凭证”->“访问密钥”页面上创建，具体可参考文档。

将获取的AK/SK替换到代码code目录下MyWidget.cpp文件的ACCESS_KEY和SECRET_KEY中。

static const QString ACCESS_KEY = "<YOUR AK>"; 
static const QString SECRET_KEY = "<YOUR SK>";

3.2 配置语音合成API的请求URL

点击IDE左边栏的“华为云API”，找到语音合成接口RunTts，

复制文档中的URL。

示例URL：https://sis-ext.cn-east-3.myhuaweicloud.com/v1/{project_id}/tts

其中cn-east-3为区域，project_id是项目编号，需替换为用户自己的，获取方法可参见从控制台获取项目ID，注意，URL中对应的项目ID需对应所属区域，如华北-北京四（cn-north-4）。

将配置好的URL和所属区域替换到源代码code目录下的MyWidget.cpp中的TTS_REQUEST_URL和REGION。

static const QString REGION = "<YOUR URL REGION>"
static const QString TTS_REQUEST_URL = "<YOUR TTS REQUEST URL>";

3.3 配置获取用户Token的URL

Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。华为云提供了通过URL获取token的方式，可参考文档获取请求token的URL

其中的区域字段（如cn-north-4）需和语音合成API的请求URL区域字段相同。 源代码已内置了获取token的方法，只需替换源代码code目录下的TOKEN_REQUEST_URL即可自动获取token。

static const QString TOKEN_REQUEST_URL = "<YOUR TOKEN REQUEST URL>";

3.4 配置合成语音音色

华为云语音合成API提供了多种场景下的语音音色选择，默认为"chinese_xiaoyan_common"，如需更改请替换code目录下MyWidget.cpp文件中LANGUAGE_SPEAKER_DOMAIN的字段，具体可参考华为云API语音合成文档。

static const QString LANGUAGE_SPEAKER_DOMAIN = "chinese_xiaoyan_common";

4、编译构建与运行调试

4.1 编译构建

代码配置完成后，在IDE页面的右上角，点击构建项目按钮，或点击页面上方的“构建”->“构建项目”，CMake构建类型选择Debug。然后在弹窗中选择all META，当编译构建成功后，日志打印finished，并显示成功的图示。

4.2 调试和运行

构建成功后，在页面的右上角选择调试的目标，然后进行调试和运行。

更多信息请参考CodeArts IDE 用户指南

5、关键代码片段

// 创建语音合成应用及可视化界面
void MyWidget::TextToSpeech()
{
    m_playIconPath = QApplication::applicationDirPath() + "/asserts/play.png";
    m_pauseIconPath = QApplication::applicationDirPath() + "/asserts/pause.png";
    if (m_textInputEdit == nullptr) {
        m_textInputEdit = new QTextEdit(this);
        m_textInputEdit->setPlaceholderText("Enter Text (no more than 500 characters)");
        m_textInputEdit->setFixedHeight(300);
        m_textInputEdit->setFixedWidth(780);
    }
    m_layout->addWidget(m_textInputEdit); 

    QPushButton *convertButton = new QPushButton("Click to Convert", this);
    m_layout->addWidget(convertButton);

    m_playButton = new QPushButton(this);
    m_playButton->setFlat(true);
    m_playButton->setIcon(QPixmap(m_pauseIconPath));
    m_playButton->setIconSize(QSize(100, 100));

    m_layout->addWidget(m_playButton);
    m_layout->setAlignment(Qt::AlignCenter);
    m_widget->setLayout(m_layout);
    m_textInputEdit->show();
    m_textInputEdit->setFocus();

    connect(convertButton, &QPushButton::clicked, this, &MyWidget::ShowTextToSpeechResult);
    connect(m_player, &QMediaPlayer::stateChanged, this, &MyWidget::OnPlayerStateChanged);
    connect(m_playButton, &QPushButton::clicked, this, &MyWidget::OnPlayButtonClicked);
    return;
}

// 解码base64格式的音频数据并生成音频文件播放
void MyWidget::ShowTextToSpeechResult()
{
    // 获取语音合成API返回的响应Json数据
    QJsonDocument textToSpeechData = GetTextToSpeechResult();
    if (textToSpeechData.isNull()) {
        return;
    }
    QString encodedData = textToSpeechData.object()["result"].toObject()["data"].toString();
    QByteArray encodedDataBytes = encodedData.toLatin1();
    QByteArray decodedDataBytes = QByteArray::fromBase64(encodedDataBytes);
    
    // 生成.wav音频文件
    m_audioPath = QApplication::applicationDirPath() + "/asserts/audio.wav"; 
    QFile file(m_audioPath);
    if (file.exists()) {
        file.remove();
    }
    if (!file.open(QIODevice::WriteOnly)) {
        qDebug() << "Failed to open file for writing";
        return;
    }
    file.write(decodedDataBytes);
    file.close();
    isSetAudio = true;
    return;
}

// 生成语音合成API调用的http请求并发送，获取返回的响应数据
QJsonDocument MyWidget::GetTextToSpeechResult()
{
    QNetworkAccessManager manager;
    QNetworkRequest request;
    request.setUrl(QUrl(TTS_REQUEST_URL));
    request.setHeader(QNetworkRequest::ContentTypeHeader, "application/json");
    m_token = GetToken();
    request.setRawHeader("X-Auth-Token", m_token);
    QJsonObject requestBody;
    QJsonObject configSpeech;
    QString inputText = m_textInputEdit->toPlainText();
    requestBody["text"] = inputText;
    configSpeech["property"] = LANGUAGE_SPEAKER_DOMAIN;
    requestBody["config"] = configSpeech;
    QJsonDocument jsonDocument(requestBody);
    QByteArray requestData = jsonDocument.toJson();
    QNetworkReply *reply = manager.post(request, requestData);
    QEventLoop loop;
    QObject::connect(reply, &QNetworkReply::finished, &loop, &QEventLoop::quit);
    loop.exec();
    QJsonDocument jsonResponse;
    if (reply->error() == QNetworkReply::NoError) {
        QByteArray responseData = reply->readAll();
        jsonResponse = QJsonDocument::fromJson(responseData);
    } else {
        qDebug() << "Error:" << reply->errorString();
    }
    reply->deleteLater();
    return jsonResponse;
}

6、运行结果

输入文本，点击“Click to Convert”按钮，生成语音文件，语音文件默认存储在.exe程序目录下的asserts文件夹中，点击播放按钮播放合成语音。

运行结果如下图：

7、参考

本示例的代码工程仅用于简单演示，实际开发过程中应严格遵循开发指南。访问以下链接可以获取详细信息：开发指南

8、修订记录

发布日期	文档版本	修订说明
2023-09-07	1.0	文档首次发布