将 Text-to-Speech API 与 Node.js 搭配使用

1. 概览

借助 Google Cloud Text-to-Speech API，开发者可以在其应用中将自然发音的合成人类语音添加为可播放音频。Text-to-Speech API 可将文本或语音合成标记语言 (SSML) 输入转换为音频数据，例如 MP3 或 LINEAR16（WAV 文件中使用的编码）。

在此 Codelab 中，您将重点了解如何将 Text-to-Speech API 与 Node.js 搭配使用。您将学习如何列出可用的语音，以及如何将文字合成音频。

学习内容

• 如何使用 Cloud Shell
• 如何启用 Text-to-Speech API
• 如何对 API 请求进行身份验证
• 如何安装适用于 Node.js 的 Google Cloud 客户端库
• 如何列出可用的语音
• 如何从文本合成音频

所需条件

• 一个 Google Cloud Platform 项目
• 一个浏览器，例如 Chrome 或 Firefox
• 熟悉如何使用 Node.js

调查问卷

您将如何使用本教程？

仅阅读教程内容 阅读并完成练习

您如何评价自己使用 Node.js 的体验？

新手水平 中等水平 熟练水平

您如何评价自己在使用 Google Cloud Platform 服务方面的经验水平？

<ph type="x-smartling-placeholder"></ph> 新手 中级 熟练

2. 设置和要求

自定进度的环境设置

1. 登录 Cloud 控制台，然后创建一个新项目或重复使用现有项目。 （如果您还没有 Gmail 或 G Suite 账号，则必须创建一个。）

注意：通过记住 Cloud Console 的网址 (console.cloud.google.com)，您可以轻松访问 Cloud Console。

请记住项目 ID，它在所有 Google Cloud 项目中都是唯一的名称（上述名称已被占用，您无法使用，抱歉！）。它稍后将在此 Codelab 中被称为 PROJECT_ID。

注意：如果您使用的是 Gmail 账号，可以将默认位置设置为无组织。如果您使用的是 G Suite 账号，请选择对贵组织来说合理的位置。

2. 接下来，您需要在 Cloud 控制台中启用结算功能，才能使用 Google Cloud 资源。

运行此 Codelab 应该不会产生太多的费用（如果有费用的话）。请务必按照“清理”部分部分，其中会指导您如何关停资源，以免产生超出本教程范围的结算费用。Google Cloud 的新用户符合参与 $300 USD 免费试用计划的条件。

启动 Cloud Shell

虽然可以通过笔记本电脑对 Google Cloud 进行远程操作，但在此 Codelab 中，您将使用 Google Cloud Shell，这是一个在云端运行的命令行环境。

激活 Cloud Shell

1. 在 Cloud Console 中，点击激活 Cloud Shell。

如果您以前从未启动过 Cloud Shell，将看到一个中间屏幕（在折叠下面），描述它是什么。如果是这种情况，请点击继续（您将永远不会再看到它）。一次性屏幕如下所示：

预配和连接到 Cloud Shell 只需花几分钟时间。

这个虚拟机已加载了您需要的所有开发工具。它提供了一个持久的 5GB 主目录，并且在 Google Cloud 中运行，大大增强了网络性能和身份验证。只需使用一个浏览器或 Google Chromebook 即可完成本 Codelab 中的大部分（甚至全部）工作。

在连接到 Cloud Shell 后，您应该会看到自己已通过身份验证，并且相关项目已设置为您的项目 ID：

2. 在 Cloud Shell 中运行以下命令以确认您已通过身份验证：

gcloud auth list

命令输出

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

注意：gcloud 命令行工具是 Google Cloud 中一款强大的统一命令行工具。它预先安装在 Cloud Shell 中。您会注意到，它支持 Tab 键补全功能。如需了解详情，请参阅 gcloud 命令行工具概览。

gcloud config list project

命令输出

[core]
project = <PROJECT_ID>

如果不是上述结果，您可以使用以下命令进行设置：

gcloud config set project <PROJECT_ID>

命令输出

Updated property [core/project].

3. 启用 Text-to-Speech API

您必须先启用 Text-to-Speech API，然后才能开始使用该 API。您可以在 Cloud Shell 中使用以下命令启用该 API：

gcloud services enable texttospeech.googleapis.com

注意：如果此命令出错，请检查当前项目 ID 是否与您的 Codelab 项目 ID 匹配。

使用以下命令查找 Cloud Shell 当前使用的项目 ID：

gcloud info | grep "project"

如果项目 ID 不正确，请使用以下命令以利用正确的项目 ID：

gcloud config set project <PROJECT_ID>

将 <PROJECT_ID> 替换为正确的项目 ID。

4. 对 API 请求进行身份验证

要向 Text-to-Speech API 发出请求，您需要使用服务账号。服务账号属于您的项目，供 Google Client Node.js 库用来发出 Text-to-Speech API 请求。与任何其他用户账号一样，服务账号由电子邮件地址表示。在本部分中，您将使用 Cloud SDK 创建服务账号，然后创建以该服务账号的身份进行身份验证所需的凭据。

首先，使用 GOOGLE_CLOUD_PROJECT 设置一个环境变量，您将在此 Codelab 中一直使用该变量：

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value core/project)

接下来，使用以下命令创建新的服务账号来访问 Text-to-Speech API：

gcloud iam service-accounts create my-text-to-speech-sa \
  --display-name "my text-to-speech codelab service account"

接下来，创建 Node.js 代码将用于以新服务账号身份登录的凭据。创建这些凭据并将其保存为 JSON 文件“~/key.json”创建 Deployment

gcloud iam service-accounts keys create ~/key.json \
  --iam-account  my-text-to-speech-sa@${GOOGLE_CLOUD_PROJECT}.iam.gserviceaccount.com

最后，设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量（下一步中将介绍 Text-to-Speech API Node.js 库）查找您的凭据。应使用以下命令将环境变量设置为您创建的凭据 JSON 文件的完整路径：

export GOOGLE_APPLICATION_CREDENTIALS="/home/${USER}/key.json"

5. 安装 Node.js 版 Google Cloud Text-to-Speech API 客户端库

首先，创建一个用于运行此 Text-to-Speech API 实验的项目，在您选择的文件夹中初始化一个新的 Node.js 软件包：

npm init

NPM 会询问一些有关项目配置的问题，例如名称和版本。对于每个问题，请按 ENTER 接受默认值。默认入口点是一个名为 index.js 的文件。

接下来，将 Google Cloud Speech 库安装到项目中：

npm install --save @google-cloud/text-to-speech

如需详细了解如何为 Google Cloud 设置 Node.js 开发，请参阅设置指南。

现在，您可以使用 Text-to-Speech API 了！

6. 列出可用语音

在本部分中，您将首先以英语列出可用于音频合成的所有语音。

找到其中的 index.js 文件，并将代码替换为以下代码：

'use strict';

/**
 * Lists available voices for the specified language.
 *
 * @param {string} languageCode - The language code.
 */
async function listVoices(languageCode) {
  const textToSpeech = require('@google-cloud/text-to-speech');

  const client = new textToSpeech.TextToSpeechClient();

  const [result] = await client.listVoices({languageCode});
  const voices = result.voices;

  voices.forEach((voice) => {
    console.log(`${voice.name} (${voice.ssmlGender}): ${voice.languageCodes}`);
  });
}

listVoices('en');

花一两分钟时间研究一下代码。运行应用：

node . 

您应该会看到以下输出内容：

en-US-Standard-A (MALE): en-US
en-US-Standard-B (MALE): en-US
en-US-Standard-C (FEMALE): en-US
en-US-Standard-D (MALE): en-US
en-US-Standard-E (FEMALE): en-US
en-US-Standard-F (FEMALE): en-US
...

注意：如果此 Node.js 代码不起作用，请验证您在对 API 请求进行身份验证步骤中执行的说明。

使用以下命令验证 GOOGLE_APPLICATION_CREDENTIALS 环境变量的值：

echo GOOGLE_APPLICATION_CREDENTIALS

它应该会输出值 "~/key.json".

如果已创建，则接下来使用以下命令检查是否已创建服务账号，以及该账号位于 "~/key.json" 位置：

cat "~/key.json"

您应该会看到类似如下内容：

{

"type": "service_account",

"project_id": "PROJECT_ID",

"private_key_id": "ff31939192529e07f42e4535fb20bb029def1276",

"Private_key":...

如果没有，请重新执行对 API 请求进行身份验证步骤。

7. 将文字合成为音频

您可以使用 Text-to-Speech API 将字符串转换为音频数据。您可以通过多种方式配置语音合成的输出，包括选择独特的语音或调制输出的音高、音量、语速和采样率。

导航到 index.js 文件，并附加以下代码：

/**
 * Sythesizes sample text into an .mp3 file.
 */
async function synthesize() {
  const textToSpeech = require('@google-cloud/text-to-speech');
  const fs = require('fs');
  const util = require('util');

  const client = new textToSpeech.TextToSpeechClient();

  const text = 'This is a demonstration of the Google Cloud Text-to-Speech API';

  const request = {
    input: {text: text},
    voice: {languageCode: 'en-US', ssmlGender: 'NEUTRAL'},
    audioConfig: {audioEncoding: 'MP3'},
  };

  const [response] = await client.synthesizeSpeech(request);
  // Write the binary audio content to a local file
  const writeFile = util.promisify(fs.writeFile);
  await writeFile('output.mp3', response.audioContent, 'binary');
  console.log('Audio content written to file: output.mp3');
}

synthesize();

花一两分钟时间研究一下代码，看看如何使用它根据文本创建音频文件。

node .

您应该会看到以下输出内容：

Audio content written to file "output.mp3"

8. 恭喜！

您已了解如何使用 Node.js 使用 Text-to-Speech API 对音频文件执行不同类型的转写！

清理

为避免系统因本快速入门中使用的资源向您的 Google Cloud Platform 账号收取费用，请执行以下操作：

• 前往 Cloud Platform Console。
• 选择要关停的项目，然后点击“删除”顶部：这会安排删除项目。

了解详情

• Google Cloud Text-to-Speech API：https://cloud.google.com/text-to-speech/docs
• Google Cloud Platform 上的 Node.js：https://cloud.google.com/nodejs/
• Google Cloud Node.js 客户端：https://googlecloudplatform.github.io/google-cloud-node/

许可

此作品已获得 Creative Commons Attribution 2.0 通用许可授权。