安装SDK

安装阿里云SDK

本产品（听悟/2022-09-30及听悟/2023-09-30）两个版本的OpenAPI接口形式均采用ROA签名风格，签名细节参见ROA风格请求体&签名机制。您可以从这里听悟OpenAPI SDK下载听悟基于OpenAPI封装后的SDK。当然您也可以从这里阿里云SDK下载各种语言的阿里云OpenAPI原生SDK。

需要注意的是，在使用API前，您需要准备好身份账号及访问密钥（AccessKey），才能有效通过客户端工具（SDK、CLI等）访问API。细节请参见创建AccessKey。以下简单介绍主流常见开发语言如何安装使用阿里云SDK的步骤。

Java

通过以下方式将阿里云SDK添加到您的Java工程，也可以下载完整Java示例代码继续集成。

    <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>the-latest-version</version>
    </dependency>

// see https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core
implementation group: 'com.aliyun', name: 'aliyun-java-sdk-core', version: 'the-latest-version'

Python

执行以下命令，使用pip安装aliyun-python-sdk-core。

pip install aliyun-python-sdk-core

Go

阿里云Go SDK支持Go 1.7及以上版本，您可以通过如下方式安装。

使用glide方式安装：

glide get github.com/aliyun/alibaba-cloud-sdk-go

使用go vendor方式安装：

go get -u github.com/aliyun/alibaba-cloud-sdk-go/sdk

C++

您可以通过以下命令安装阿里云C++ SDK，当然您也可以直接参考阿里云SDK文档自行安装。

git clone https://github.com/aliyun/aliyun-openapi-cpp-sdk.git
cd aliyun-openapi-cpp-sdk
sudo sh easyinstall.sh core

编译完成之后，您可以下载完整C++ 示例代码继续集成。

安装智能语音交互实时转写SDK

当您使用实时记录时，除需要使用从阿里云OpenAPI接口创建实时任务、查询任务状态、结束实时任务外，您还需要实时采集音频流、推送、识别，此时您可以通过以下实时转写（不含音频采集功能）SDK完成。

Java

通过以下方式将智能语音交互实时转写SDK添加到您的Java工程。

<dependency>    
      <groupId>com.alibaba.nls</groupId>  
      <artifactId>nls-sdk-transcriber</artifactId>   
      <version>2.2.9</version>
</dependency>

Go

通过以下方式将智能语音交互实时转写SDK添加到您的Go工程。

使用glide方式安装：

glide get github.com/aliyun/alibaba-cloud-nls-go-sdk

使用go vendor方式安装：

go get -u github.com/aliyun/alibabacloud-nls-go-sdk

Python

通过下载nls-1.1.0-py3-none-any.whl并进行pip安装，获取智能语音交互实时转写SDK。

pip install nls-1.1.0-py3-none-any.whl

C++

我们已将听悟实时转写所依赖的C++ SDK预编译并放置在示例代码的压缩包中，您可以直接使用。当然您也可以直接下载该SDK的开源代码自行编译。

Android

1. 下载Android推流SDK和示例代码。

2. 解压ZIP包，在app/libs目录下获取AAR格式的SDK包，将AAR包集成到您的工程项目中进行依赖。如果需要Android CPP接入方式，可在ZIP包的android_libs和android_include中获得动态库和头文件。

3. 使用Android Studio打开此工程查看参考代码实现，其中实时语音识别示例代码为RealtimeMeetingActivity.java文件，替换url后可直接运行。

iOS

说明：为方便集成，2.5.14版本后iOS接口使用纯Object-C接口，不再使用C++混合接口。

1. 下载iOS推流SDK和示例代码。

2. 解压ZIP包，将ZIP包中的nuisdk.framework添加到您的工程中，并在工程Build Phases的Link Binary With Libraries中添加nuisdk.framework

3. 使用Xcode打开此工程，工程中提供了参考代码以及一些直接可使用的工具类，例如音频播放录制和文件操作，您可以直接复制源码到您的实际工程进行使用。其中实时转写示例代码为RealtimeMeetingViewController。替换url后可直接运行。

Harmony

1. 下载harmony推流SDK和示例代码。

2. 以arkts HAR包的形式进行集成。解压ZIP包，其中nuisdk-release/neonui.har 是SDK生成的HAR包文件，在用户工程项目中导入调用即可。如果需要HarmonyOS Next CPP接入方式，可在ZIP包的harmonyos_libs和harmonyos_include中获得动态库和头文件。

   1. har包导入方式：

      1. har包放入工程目录下。以entry模块调用为例，存放路径为 entry/libs/neonui.har。

      2. 修改entry模块的oh-package.json5内容，在"dependencies"字段增加neonui.har包的依赖。

         "dependencies": {
           "package": "file:libs/neonui.har" 。 
         }                                       

      3. 在entry模块目录下，执行命令安装依赖包

          cd entry
          ohpm install

      4. 对工程进行重新编译。

3. 使用DevEco Studio打开harmony_nlsdemo目录下工程查看参考代码实现，其中实时推流示例代码为RealtimeMeeting.ets文件，替换其中的url，即可直接运行。