安裝阿里云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，即可直接運行。