流程图
![](https://qcloudimg.tencent-cloud.cn/image/document/a725bafd1561f92c8cad64a2ba0d9777.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a725bafd1561f92c8cad64a2ba0d9777.png)
环境依赖
安装 JDK12 版本及以上,Java Downloads | Oracle 中国。
安装 Android Studio 等开发者工具,Download Android Studio & App Tools - Android Developers。
Android 4.0 或以上版本且支持音视频的 Android 设备。
跑通 DEMO
下载 demo
git clone https://github.com/TencentCloud/tencentcloud-sdk-android-soe.git
编译 demo
1. 双击打开 Android Studio 选择Projects,单击Open,选择 "tencentcloud-sdk-android-soe/TAIDemo" 目录,单击OK。
![](https://qcloudimg.tencent-cloud.cn/image/document/62f4c1f2200a577645ca9b63f4984086.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/62f4c1f2200a577645ca9b63f4984086.png)
2. 在弹框中选择 Trust Project 开始编译。
![](https://qcloudimg.tencent-cloud.cn/image/document/78b1ca6504306f3988f48b0e63c4effb.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/78b1ca6504306f3988f48b0e63c4effb.png)
填写密钥
注意:
实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密。
代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见 云 API 密钥安全方案推荐。
密钥可前往 官网控制台 进行获取。
![](https://qcloudimg.tencent-cloud.cn/image/document/a50c4860ba785cbea8c83b2d52479cde.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a50c4860ba785cbea8c83b2d52479cde.png)
版本设置
运行项目
连接手机,打开开发者模式,单击 Run 'app' 运行项目。下载 App 进行真机调试。
使用 demo
打开 App TAIDemo 选择口语评测。设置评测内容后,选择单击开始录音或者外部 MP3 文件。
![](https://qcloudimg.tencent-cloud.cn/image/document/9fc6735fbcb7a451baeef67289ee6ca0.gif)
![](https://qcloudimg.tencent-cloud.cn/image/document/9fc6735fbcb7a451baeef67289ee6ca0.gif)
集成 SDK
新建项目
1. 使用 Android Studio 选择 New Project 新建项目,已有项目选择 Open 打开已有项目。![](https://qcloudimg.tencent-cloud.cn/image/document/a02154617fe51e9a02e62d6c61068694.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/a02154617fe51e9a02e62d6c61068694.png)
2. 在 Phone and Tablet 中选择 Empty Activity 单击 Next。![](https://qcloudimg.tencent-cloud.cn/image/document/26f9d3f8476d0dc2d8d7fa8de4920d7a.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/26f9d3f8476d0dc2d8d7fa8de4920d7a.png)
3. 填入文件名,包名等信息。这里按需配置,如无特殊需求,可以使用默认值。单击 Finish 即完成创建。
![](https://qcloudimg.tencent-cloud.cn/image/document/ef364a361f8364b3188008611f1ad9b0.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/ef364a361f8364b3188008611f1ad9b0.png)
安装 SDK
方式一:自动集成
dependencies { ...... implementation 'com.tencent.edu:TAISDK:1.2.3.118' }
2. 单击文件上方 Sync Now 进行安装,或者选择 File > Sync Project with Gradle File。
![](https://qcloudimg.tencent-cloud.cn/image/document/224b3a23368e98b449c9f2f16d6d0269.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/224b3a23368e98b449c9f2f16d6d0269.png)
方式二:SDK 文件集成
![](https://qcloudimg.tencent-cloud.cn/image/document/24e6710391b5dad96f82735ecb13521d.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/24e6710391b5dad96f82735ecb13521d.png)
在 app/build.gradle 中的 dependencies 中引入"libs"下的所有 jar 文件。
dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) ...... }
单击文件上方 Sync Now 进行安装,或者选择 "File > Sync Project with Gradle Files"。![](https://qcloudimg.tencent-cloud.cn/image/document/5fec06568acd340d28738e387bd7eb0d.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/5fec06568acd340d28738e387bd7eb0d.png)
设置权限
使用 SDK 录音评测需要如下权限,需要在 "app/manifests/AndroidManifest.xml" 中,添加权限。
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.RECORD_AUDIO"/> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
注意:
由于 Android 6.0 在一些比较重要的权限上要求必须申请动态权限。所以需要设置动态权限。
if (ContextCompat.checkSelfPermission(this, android.Manifest.permission.RECORD_AUDIO) != PackageManager.PERMISSION_GRANTED) { ActivityCompat.requestPermissions(this, new String[]{android.Manifest.permission.RECORD_AUDIO, android.Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_EXTERNAL_STORAGE}, 12345); }
SDK 功能