通过快速开始,您将了解 JS SDK 的完整使用流程。

安装依赖

需要在项目根目录执行 npm 安装命令,这样就可以在项目中使用 JS SDK。

  1. npm i ali-nls

创建客户端

在项目中引入 JS SDK 后,需要实例化 SDK 客户端,客户端是调用所有服务的基础,有了客户端才能调用 JS SDK 提供的对应功能。

import NlsClient from 'ali-nls';

// 创建 SDK 客户端
const client = new NlsClient({
  appkey: 'xxxxxx', // 应用的 AppKey
  /** 方式1. 直接使用 AccessToken */
  accessToken: 'xxxxxx',
  /** 方式2. 通过接口获取 AccessToken */ 
  // accessToken: async () => {
  //   const token = await getToken();
  //   return token;
  // },
});

使用语音识别

使用语音识别,首先要获取语音识别实例。

// 实例化语音识别
const instance = client.initRecognition();

然后监听语音识别提供的相关事件。

// 第 index 句话结束,收到识别文案 result
instance.on('sentenceEnd', (index, result) => {});

接下来,调用开始识别,然后对麦克风说话,对应的事件将会收到对应的识别结果。

instance.start();

识别完成后,可以调用结束识别,来停止识别任务。

instance.stop();

使用语音合成

使用语音合成,首先要先获取语音合成实例。

// 实例化语音合成
const instance = client.initSynthesis();

然后使用需要合成的文案调用开始合成,就可以听到播放的合成声音。

// 合成指定文案
instance.start('你好,世界');

以上是 JS SDK 最简单的调用方式,你可以继续阅读接下来的 API 文档,来获取更多的详细使用方式。