快速入门

最近更新时间:2024-07-25 11:17:31

我的收藏

流程图





环境依赖

安装 JDK12 版本及以上,Java Downloads | Oracle 中国
安装 Android Studio 等开发者工具,Download Android Studio & App Tools - Android Developers
Android 4.0 或以上版本且支持音视频的 Android 设备。

跑通 DEMO

下载 demo

前往 GitHub 或者Gitee下载最新代码,或者在终端执行 git 命令:
git clone https://github.com/TencentCloud/tencentcloud-sdk-android-soe.git

编译 demo

1. 双击打开 Android Studio 选择Projects,单击Open,选择 "tencentcloud-sdk-android-soe/TAIDemo" 目录,单击OK。



2. 在弹框中选择 Trust Project 开始编译。




填写密钥

测试接入阶段可以在 "app/java/com.tencent.taidemo/PrivateInfo" 下填写密钥信息。参数参考参数说明
注意:
实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密。
代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见 云 API 密钥安全方案推荐
密钥可前往 官网控制台 进行获取。





版本设置

demo 中需要修改版本可以在 Gradle Scripts/build.grade 中修改依赖包 SDK 版本信息



运行项目

连接手机,打开开发者模式,单击 Run 'app' 运行项目。下载 App 进行真机调试。

使用 demo

打开 App TAIDemo 选择口语评测。设置评测内容后,选择单击开始录音或者外部 MP3 文件




集成 SDK

新建项目

1. 使用 Android Studio 选择 New Project 新建项目,已有项目选择 Open 打开已有项目。


2. Phone and Tablet 中选择 Empty Activity 单击 Next。


3. 填入文件名,包名等信息。这里按需配置,如无特殊需求,可以使用默认值。单击 Finish 即完成创建。




安装 SDK

方式一:自动集成

1. 打开 Maven 仓库 选择需要集成的版本。在 build.gradle 文件,在 dependencies 中添加 SDK。可在 版本信息 中查看具体更新内容。
dependencies { ...... implementation 'com.tencent.edu:TAISDK:1.2.3.118' }
2. 单击文件上方 Sync Now 进行安装,或者选择 File > Sync Project with Gradle File。




方式二:SDK 文件集成

打开 Maven 仓库 选择需要集成的版本,下载 arr 文件。然后将 arr 文件中的内容解压到 app/libs 中。



在 app/build.gradle 中的 dependencies 中引入"libs"下的所有 jar 文件。
dependencies { implementation fileTree(dir: 'libs', include: ['*.jar']) ...... }
单击文件上方 Sync Now 进行安装,或者选择 "File > Sync Project with Gradle Files"。



设置权限

使用 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 功能

SDK 内部提供录音,如需进行录音评测,可以参考 录音评测说明。如果需要对音频文件评测或者传输音频数据,可以参考 音频数据评测说明