流程图
环境依赖
安装 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。
2. 在弹框中选择 Trust Project 开始编译。
填写密钥
注意:
实例化一个认证对象,入参需要传入腾讯云账户 SecretId 和 SecretKey,此处还需注意密钥对的保密。
代码泄露可能会导致 SecretId 和 SecretKey 泄露,并威胁账号下所有资源的安全性。以下代码示例仅供参考,建议采用更安全的方式来使用密钥,请参见 云 API 密钥安全方案推荐。
密钥可前往 官网控制台 进行获取。
版本设置
运行项目
连接手机,打开开发者模式,单击 Run 'app' 运行项目。下载 App 进行真机调试。
使用 demo
打开 App TAIDemo 选择口语评测。设置评测内容后,选择单击开始录音或者外部 MP3 文件。
集成 SDK
新建项目
1. 使用 Android Studio 选择 New Project 新建项目,已有项目选择 Open 打开已有项目。
2. 在 Phone and Tablet 中选择 Empty Activity 单击 Next。
3. 填入文件名,包名等信息。这里按需配置,如无特殊需求,可以使用默认值。单击 Finish 即完成创建。
安装 SDK
方式一:自动集成
dependencies { ...... implementation 'com.tencent.edu:TAISDK:1.2.3.118' }
2. 单击文件上方 Sync Now 进行安装,或者选择 File > Sync Project with Gradle File。
方式二:SDK 文件集成
在 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 功能