From e0a5c0f7de44d8ce5d8d27321b030fd3917df3ec Mon Sep 17 00:00:00 2001 From: TianYuan Date: Wed, 30 Nov 2022 15:38:52 +0800 Subject: [PATCH] [TTS]add TTSAndroid demo (#2703) * add TTSAndroid demo --- demos/TTSAndroid/.gitignore | 13 + demos/TTSAndroid/README.md | 189 +++++++++ demos/TTSAndroid/app/.gitignore | 1 + demos/TTSAndroid/app/build.gradle | 108 +++++ demos/TTSAndroid/app/proguard-rules.pro | 21 + .../demo/tts/ExampleInstrumentedTest.java | 26 ++ .../app/src/main/AndroidManifest.xml | 27 ++ .../demo/tts/AppCompatPreferenceActivity.java | 122 ++++++ .../paddle/lite/demo/tts/MainActivity.java | 400 ++++++++++++++++++ .../baidu/paddle/lite/demo/tts/Predictor.java | 149 +++++++ .../lite/demo/tts/SettingsActivity.java | 111 +++++ .../com/baidu/paddle/lite/demo/tts/Utils.java | 155 +++++++ .../src/main/res/drawable/button_drawable.xml | 20 + .../app/src/main/res/drawable/logo.jpg | Bin 0 -> 9341 bytes .../main/res/drawable/paddlespeech_logo.png | Bin 0 -> 35393 bytes .../app/src/main/res/layout/activity_main.xml | 112 +++++ .../src/main/res/menu/menu_action_options.xml | 9 + .../app/src/main/res/values/arrays.xml | 44 ++ .../app/src/main/res/values/colors.xml | 6 + .../app/src/main/res/values/strings.xml | 12 + .../app/src/main/res/values/styles.xml | 16 + .../app/src/main/res/xml/settings.xml | 39 ++ .../paddle/lite/demo/tts/ExampleUnitTest.java | 17 + demos/TTSAndroid/build.gradle | 27 ++ demos/TTSAndroid/gradle.properties | 15 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 54329 bytes .../gradle/wrapper/gradle-wrapper.properties | 6 + demos/TTSAndroid/gradlew | 172 ++++++++ demos/TTSAndroid/gradlew.bat | 84 ++++ demos/TTSAndroid/settings.gradle | 1 + 30 files changed, 1902 insertions(+) create mode 100644 demos/TTSAndroid/.gitignore create mode 100644 demos/TTSAndroid/README.md create mode 100644 demos/TTSAndroid/app/.gitignore create mode 100644 demos/TTSAndroid/app/build.gradle create mode 100644 demos/TTSAndroid/app/proguard-rules.pro create mode 100644 demos/TTSAndroid/app/src/androidTest/java/com/baidu/paddle/lite/demo/tts/ExampleInstrumentedTest.java create mode 100644 demos/TTSAndroid/app/src/main/AndroidManifest.xml create mode 100644 demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/AppCompatPreferenceActivity.java create mode 100644 demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java create mode 100644 demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java create mode 100644 demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/SettingsActivity.java create mode 100644 demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Utils.java create mode 100644 demos/TTSAndroid/app/src/main/res/drawable/button_drawable.xml create mode 100644 demos/TTSAndroid/app/src/main/res/drawable/logo.jpg create mode 100644 demos/TTSAndroid/app/src/main/res/drawable/paddlespeech_logo.png create mode 100644 demos/TTSAndroid/app/src/main/res/layout/activity_main.xml create mode 100644 demos/TTSAndroid/app/src/main/res/menu/menu_action_options.xml create mode 100644 demos/TTSAndroid/app/src/main/res/values/arrays.xml create mode 100644 demos/TTSAndroid/app/src/main/res/values/colors.xml create mode 100644 demos/TTSAndroid/app/src/main/res/values/strings.xml create mode 100644 demos/TTSAndroid/app/src/main/res/values/styles.xml create mode 100644 demos/TTSAndroid/app/src/main/res/xml/settings.xml create mode 100644 demos/TTSAndroid/app/src/test/java/com/baidu/paddle/lite/demo/tts/ExampleUnitTest.java create mode 100644 demos/TTSAndroid/build.gradle create mode 100644 demos/TTSAndroid/gradle.properties create mode 100644 demos/TTSAndroid/gradle/wrapper/gradle-wrapper.jar create mode 100644 demos/TTSAndroid/gradle/wrapper/gradle-wrapper.properties create mode 100755 demos/TTSAndroid/gradlew create mode 100644 demos/TTSAndroid/gradlew.bat create mode 100644 demos/TTSAndroid/settings.gradle diff --git a/demos/TTSAndroid/.gitignore b/demos/TTSAndroid/.gitignore new file mode 100644 index 00000000..2b75303a --- /dev/null +++ b/demos/TTSAndroid/.gitignore @@ -0,0 +1,13 @@ +*.iml +.gradle +/local.properties +/.idea/caches +/.idea/libraries +/.idea/modules.xml +/.idea/workspace.xml +/.idea/navEditor.xml +/.idea/assetWizardSettings.xml +.DS_Store +/build +/captures +.externalNativeBuild diff --git a/demos/TTSAndroid/README.md b/demos/TTSAndroid/README.md new file mode 100644 index 00000000..d6013562 --- /dev/null +++ b/demos/TTSAndroid/README.md @@ -0,0 +1,189 @@ +# 语音合成 Java API Demo 使用指南 + +在 Android 上实现语音合成功能，此 Demo 有很好的的易用性和开放性，如在 Demo 中跑自己训练好的模型等。 + +本文主要介绍语音合成 Demo 运行方法。 + +## 如何运行语音合成 Demo + +### 环境准备 + +1. 在本地环境安装好 Android Studio 工具，详细安装方法请见 [Android Stuido 官网](https://developer.android.com/studio)。 +2. 准备一部 Android 手机，并开启 USB 调试模式。开启方法: `手机设置 -> 查找开发者选项 -> 打开开发者选项和 USB 调试模式`。 + +**注意**： +> 如果您的 Android Studio 尚未配置 NDK ，请根据 Android Studio 用户指南中的[安装及配置 NDK 和 CMake ](https://developer.android.com/studio/projects/install-ndk)内容，预先配置好 NDK 。您可以选择最新的 NDK 版本，或者使用 Paddle Lite 预测库版本一样的 NDK。 + +### 部署步骤 + +1. 用 Android Studio 打开 TTSAndroid 工程。 +2. 手机连接电脑，打开 USB 调试和文件传输模式，并在 Android Studio 上连接自己的手机设备（手机需要开启允许从 USB 安装软件权限）。 + +**注意：** +>1. 如果您在导入项目、编译或者运行过程中遇到 NDK 配置错误的提示，请打开 `File > Project Structure > SDK Location`，修改 `Andriod NDK location` 为您本机配置的 NDK 所在路径。 +>2. 如果您是通过 Andriod Studio 的 SDK Tools 下载的 NDK (见本章节"环境准备")，可以直接点击下拉框选择默认路径。 +>3. 还有一种 NDK 配置方法，你可以在 `TTSAndroid/local.properties` 文件中手动添加 NDK 路径配置 `nkd.dir=/root/android-ndk-r20b` +>4. 如果以上步骤仍旧无法解决 NDK 配置错误，请尝试根据 Andriod Studio 官方文档中的[更新 Android Gradle 插件](https://developer.android.com/studio/releases/gradle-plugin?hl=zh-cn#updating-plugin)章节，尝试更新 Android Gradle plugin 版本。 + +3. 点击 Run 按钮，自动编译 APP 并安装到手机。(该过程会自动下载 Paddle Lite 预测库和模型，需要联网) + 成功后效果如下： + - pic 1：APP 安装到手机。 + - pic 2：APP 打开后的效果，在下拉框中选择待合成的文本。 + - pic 3：合成后点击按钮播放音频。 + +

+ +## 更新预测库 + +* Paddle Lite + 项目：[https://github.com/PaddlePaddle/Paddle-Lite](https://github.com/PaddlePaddle/Paddle-Lite)。 + + +参考 [Paddle Lite 源码编译文档](https://www.paddlepaddle.org.cn/lite/v2.11/source_compile/compile_env.html)，编译 +Android 预测库。 + +* 编译最终产物位于 `build.lite.xxx.xxx.xxx` 下的 `inference_lite_lib.xxx.xxx` +* 替换 java 库 + * jar 包 + 将生成的 `build.lite.android.xxx.gcc/inference_lite_lib.android.xxx/java/jar/PaddlePredictor.jar` + 替换 Demo 中的 `TTSAndroid/app/libs/PaddlePredictor.jar`。 + * Java so + * arm64-v8a + 将生成的 `build.lite.android.armv8.gcc/inference_lite_lib.android.armv8/java/so/libpaddle_lite_jni.so` + 库替换 Demo 中的 `TTSAndroid/app/src/main/jniLibs/arm64-v8a/libpaddle_lite_jni.so`。 + +## Demo 内容介绍 + +先整体介绍下目标检测 Demo 的代码结构，然后介绍 Java 各功能模块的功能。 + +

+image +

+ +### 重点关注内容 + +1. `Predictor.java`： 预测代码。 + +```bash +# 位置： +TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java +``` + +2. `fastspeech2_csmsc_arm.nb` 和 `mb_melgan_csmsc_arm.nb`: 模型文件 (opt 工具转化后 Paddle Lite 模型) + ，分别来自 [fastspeech2_cnndecoder_csmsc_pdlite_1.3.0.zip](https://paddlespeech.bj.bcebos.com/Parakeet/released_models/fastspeech2/fastspeech2_cnndecoder_csmsc_pdlite_1.3.0.zip) + 和 [mb_melgan_csmsc_pdlite_1.3.0.zip](https://paddlespeech.bj.bcebos.com/Parakeet/released_models/mb_melgan/mb_melgan_csmsc_pdlite_1.3.0.zip)。 + +```bash +# 位置： +TTSAndroid/app/src/main/assets/models/cpu/fastspeech2_csmsc_arm.nb +TTSAndroid/app/src/main/assets/models/cpu/mb_melgan_csmsc_arm.nb +``` + +3. `libpaddle_lite_jni.so`、`PaddlePredictor.jar`：Paddle Lite Java 预测库与 jar 包。 + +```bash +# 位置 +TTSAndroid/app/src/main/jniLibs/arm64-v8a/libpaddle_lite_jni.so +TTSAndroid/app/libs/PaddlePredictor.jar +``` + +> 如果要替换动态库 so 和 jar 文件，则将新的动态库 so 更新到 `TTSAndroid/app/src/main/jniLibs/arm64-v8a/` 目录下 新的 jar 文件更新到 `TTSAndroid/app/libs/` 目录下 + +4. `build.gradle` : 定义编译过程的 gradle 脚本。（不用改动，定义了自动下载 Paddle Lite 预测和模型的过程） + +```bash +# 位置 +TTSAndroid/app/build.gradle +``` + +如果需要手动更新模型和预测库，则可将 gradle 脚本中的 `download*` 接口注释即可, 将新的预测库替换至相应目录下 + +### Java 端 + +* 模型存放，将下载好的模型解压存放在 `app/src/assets/models` 目录下。 +* TTSAndroid Java 包在 `app/src/main/java/com/baidu/paddle/lite/demo/tts` 目录下，实现 APP 界面消息事件。 +* MainActivity 实现 APP 的创建、运行、释放功能，重点关注 `onLoadModel` 和 `onRunModel` 函数，实现 APP 界面值传递和推理处理。 + + ```java + public boolean onLoadModel() { + return predictor.init(MainActivity.this, modelPath, AMmodelName, VOCmodelName, cpuThreadNum, + cpuPowerMode); + } + + public boolean onRunModel() { + return predictor.isLoaded() && predictor.runModel(phones); + } + ``` + +* SettingActivity 实现设置界面各个元素的更新与显示如模型地址、线程数、输入 shape 大小等，如果新增/删除界面的某个元素，均在这个类里面实现： + - 参数的默认值可在 `app/src/main/res/values/strings.xml` 查看 + - 每个元素的 ID 和 value 是对应 `app/src/main/res/xml/settings.xml` + 和 `app/src/main/res/values/string.xml` 文件中的值 + - 这部分内容不建议修改，如果有新增属性，可以按照此格式进行添加 + +* Predictor 使用 Java API 实现语音合成模型的预测功能，重点关注 `init`、和 `runModel` 函数，实现 Paddle Lite 端侧推理功能： + ```java + // 初始化函数，完成预测器初始化 + public boolean init(Context appCtx, String modelPath, String AMmodelName, String VOCmodelName, int cpuThreadNum, String cpuPowerMode); + // 模型推理函数 + public boolean runModel(float[] phones); + ``` + +## 代码讲解 （使用 Paddle Lite `Java API` 执行预测） + +Android 示例基于 Java API 开发，调用 Paddle Lite `Java API` 包括以下五步。更详细的 `API` +描述参考：[Paddle Lite Java API ](https://www.paddlepaddle.org.cn/lite/v2.11/api_reference/java_api_doc.html)。 + +## 如何更新模型和输入 + +### 更新模型 + +1. 将优化后的模型存放到目录 `TTSAndroid/app/src/main/assets/models/cpu/` + 下，可任意换成 [released_model.md](https://github.com/PaddlePaddle/PaddleSpeech/blob/develop/docs/source/released_model.md) + 中的 `*_pdlite_*.zip/*_arm.nb` + 格式的声学模型和声码器，注意更换声学模型需要对应修改 `TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java` + 中的 `sentencesToChoose` 数组。 +2. 如果模型名字跟工程中模型名字一模一样，即均是使用`fastspeech2_csmsc_arm.nb` （假设声学模型的 `phone_id_map.txt` + 也一样）和 `mb_melgan_csmsc_arm.nb` + ，则代码不需更新；否则，需要修改 `TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java` + 中的 `AMmodelName` 和 `VOCmodelName`： + +

+ +

+ +3. 如果更新模型的输入/输出 Tensor 个数、shape 和 Dtype + 发生更新，需要更新文件 `TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java`。 + +### 更新输入 + +**本 Demo 不包含文本前端模块**，通过下拉框选择预先设置好的文本，在代码中映射成对应的 phone_id，**如需文本前端模块请自行处理**，`phone_id_map.txt` +请参考 [fastspeech2_cnndecoder_csmsc_pdlite_1.3.0.zip](https://paddlespeech.bj.bcebos.com/Parakeet/released_models/fastspeech2/fastspeech2_cnndecoder_csmsc_pdlite_1.3.0.zip)。 + +## 通过 setting 界面更新语音合成的相关参数 + +### setting 界面参数介绍 + +可通过 APP 上的 Settings 按钮，实现语音合成 Demo 中参数的更新，目前支持以下参数的更新： +参数的默认值可在 `app/src/main/res/values/strings.xml` 查看 + +- CPU setting： + - power_mode 默认是 `LITE_POWER_HIGH` + - thread_num 默认是 1 + +### setting 界面参数更新 + +1. 打开 APP，点击右上角的 `:` 符合，选择 `Settings..` 选项，打开 setting 界面； +2. 再将 setting 界面的 Enable custom settings 选中☑️，然后更新部分参数； +3. 假设更新线程数据，将 CPU Thread Num 设置为 4，更新后，返回原界面，APP 将自动重新加载模型，在下拉框中选择文本会进行合成，合成结束后悔打印 4 线程的耗时和结果 + +## 性能优化方法 + +如果你觉得当前性能不符合需求，想进一步提升模型性能，可参考[性能优化文档](https://github.com/PaddlePaddle/Paddle-Lite-Demo#%E6%80%A7%E8%83%BD%E4%BC%98%E5%8C%96)完成性能优化。 + +## Release + +[2022-11-29-app-release.apk](https://paddlespeech.bj.bcebos.com/demos/TTSAndroid/2022-11-29-app-release.apk) + +## More +本 Demo 合并自 [yt605155624/TTSAndroid](https://github.com/yt605155624/TTSAndroid)。 diff --git a/demos/TTSAndroid/app/.gitignore b/demos/TTSAndroid/app/.gitignore new file mode 100644 index 00000000..796b96d1 --- /dev/null +++ b/demos/TTSAndroid/app/.gitignore @@ -0,0 +1 @@ +/build diff --git a/demos/TTSAndroid/app/build.gradle b/demos/TTSAndroid/app/build.gradle new file mode 100644 index 00000000..40ee5e12 --- /dev/null +++ b/demos/TTSAndroid/app/build.gradle @@ -0,0 +1,108 @@ +import java.security.MessageDigest + +apply plugin: 'com.android.application' + +android { + compileSdkVersion 28 + defaultConfig { + applicationId "com.baidu.paddle.lite.demo.tts" + minSdkVersion 15 + targetSdkVersion 28 + versionCode 1 + versionName "1.0" + testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" + } + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' + } + } +} + +dependencies { + implementation fileTree(include: ['*.jar'], dir: 'libs') + implementation 'com.android.support:appcompat-v7:28.0.0' + implementation 'com.android.support.constraint:constraint-layout:1.1.3' + implementation 'com.android.support:design:28.0.0' + testImplementation 'junit:junit:4.12' + androidTestImplementation 'com.android.support.test:runner:1.0.2' + androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2' + implementation files('libs/PaddlePredictor.jar') +} + +def paddleLiteLibs = 'https://paddlespeech.bj.bcebos.com/demos/TTSAndroid/paddle_lite_libs_68b66fd3.tar.gz' +task downloadAndExtractPaddleLiteLibs(type: DefaultTask) { + doFirst { + println "Downloading and extracting Paddle Lite libs" + } + doLast { + // Prepare cache folder for libs + if (!file("cache").exists()) { + mkdir "cache" + } + // Generate cache name for libs + MessageDigest messageDigest = MessageDigest.getInstance('MD5') + messageDigest.update(paddleLiteLibs.bytes) + String cacheName = new BigInteger(1, messageDigest.digest()).toString(32) + // Download libs + if (!file("cache/${cacheName}.tar.gz").exists()) { + ant.get(src: paddleLiteLibs, dest: file("cache/${cacheName}.tar.gz")) + } + // Unpack libs + if (!file("cache/${cacheName}").exists()) { + copy { + from tarTree("cache/${cacheName}.tar.gz") + into "cache/${cacheName}" + } + } + // Copy PaddlePredictor.jar + if (!file("libs/PaddlePredictor.jar").exists()) { + copy { + from "cache/${cacheName}/java/PaddlePredictor.jar" + into "libs" + } + } + if (!file("src/main/jniLibs/arm64-v8a/libpaddle_lite_jni.so").exists()) { + copy { + from "cache/${cacheName}/java/libs/arm64-v8a/" + into "src/main/jniLibs/arm64-v8a" + } + } + } +} +preBuild.dependsOn downloadAndExtractPaddleLiteLibs + +def paddleLiteModels = [['src' : 'https://paddlespeech.bj.bcebos.com/demos/TTSAndroid/fs2cnn_mbmelgan_cpu_v1.3.0.tar.gz', + 'dest': 'src/main/assets/models'],] +task downloadAndExtractPaddleLiteModels(type: DefaultTask) { + doFirst { + println "Downloading and extracting Paddle Lite models" + } + doLast { + // Prepare cache folder for models + String cachePath = "cache" + if (!file("${cachePath}").exists()) { + mkdir "${cachePath}" + } + paddleLiteModels.eachWithIndex { model, index -> + MessageDigest messageDigest = MessageDigest.getInstance('MD5') + messageDigest.update(model.src.bytes) + String cacheName = new BigInteger(1, messageDigest.digest()).toString(32) + // Download the target model if not exists + boolean copyFiles = !file("${model.dest}").exists() + if (!file("${cachePath}/${cacheName}.tar.gz").exists()) { + ant.get(src: model.src, dest: file("${cachePath}/${cacheName}.tar.gz")) + copyFiles = true // force to copy files from the latest archive files + } + // Copy model file + if (copyFiles) { + copy { + from tarTree("${cachePath}/${cacheName}.tar.gz") + into "${model.dest}" + } + } + } + } +} +preBuild.dependsOn downloadAndExtractPaddleLiteModels diff --git a/demos/TTSAndroid/app/proguard-rules.pro b/demos/TTSAndroid/app/proguard-rules.pro new file mode 100644 index 00000000..f1b42451 --- /dev/null +++ b/demos/TTSAndroid/app/proguard-rules.pro @@ -0,0 +1,21 @@ +# Add project specific ProGuard rules here. +# You can control the set of applied configuration files using the +# proguardFiles setting in build.gradle. +# +# For more details, see +# http://developer.android.com/guide/developing/tools/proguard.html + +# If your project uses WebView with JS, uncomment the following +# and specify the fully qualified class name to the JavaScript interface +# class: +#-keepclassmembers class fqcn.of.javascript.interface.for.webview { +# public *; +#} + +# Uncomment this to preserve the line number information for +# debugging stack traces. +#-keepattributes SourceFile,LineNumberTable + +# If you keep the line number information, uncomment this to +# hide the original source file name. +#-renamesourcefileattribute SourceFile diff --git a/demos/TTSAndroid/app/src/androidTest/java/com/baidu/paddle/lite/demo/tts/ExampleInstrumentedTest.java b/demos/TTSAndroid/app/src/androidTest/java/com/baidu/paddle/lite/demo/tts/ExampleInstrumentedTest.java new file mode 100644 index 00000000..d68e8d20 --- /dev/null +++ b/demos/TTSAndroid/app/src/androidTest/java/com/baidu/paddle/lite/demo/tts/ExampleInstrumentedTest.java @@ -0,0 +1,26 @@ +package com.baidu.paddle.lite.demo.tts; + +import android.content.Context; +import android.support.test.InstrumentationRegistry; +import android.support.test.runner.AndroidJUnit4; + +import org.junit.Test; +import org.junit.runner.RunWith; + +import static org.junit.Assert.*; + +/** + * Instrumented test, which will execute on an Android device. + * + * @see Testing documentation + */ +@RunWith(AndroidJUnit4.class) +public class ExampleInstrumentedTest { + @Test + public void useAppContext() { + // Context of the app under test. + Context appContext = InstrumentationRegistry.getTargetContext(); + + assertEquals("com.baidu.paddle.lite.demo", appContext.getPackageName()); + } +} diff --git a/demos/TTSAndroid/app/src/main/AndroidManifest.xml b/demos/TTSAndroid/app/src/main/AndroidManifest.xml new file mode 100644 index 00000000..1507c796 --- /dev/null +++ b/demos/TTSAndroid/app/src/main/AndroidManifest.xml @@ -0,0 +1,27 @@ + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/AppCompatPreferenceActivity.java b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/AppCompatPreferenceActivity.java new file mode 100644 index 00000000..5765dbec --- /dev/null +++ b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/AppCompatPreferenceActivity.java @@ -0,0 +1,122 @@ +/* + * Copyright (C) 2014 The Android Open Source Project + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +package com.baidu.paddle.lite.demo.tts; + +import android.content.res.Configuration; +import android.os.Bundle; +import android.preference.PreferenceActivity; +import android.support.annotation.LayoutRes; +import android.support.v7.app.ActionBar; +import android.support.v7.app.AppCompatDelegate; +import android.view.MenuInflater; +import android.view.View; +import android.view.ViewGroup; + +/** + * A {@link android.preference.PreferenceActivity} which implements and proxies the necessary calls + * to be used with AppCompat. + *

+ * This technique can be used with an {@link android.app.Activity} class, not just + * {@link android.preference.PreferenceActivity}. + */ +public abstract class AppCompatPreferenceActivity extends PreferenceActivity { + private AppCompatDelegate mDelegate; + + @Override + protected void onCreate(Bundle savedInstanceState) { + getDelegate().installViewFactory(); + getDelegate().onCreate(savedInstanceState); + super.onCreate(savedInstanceState); + } + + @Override + protected void onPostCreate(Bundle savedInstanceState) { + super.onPostCreate(savedInstanceState); + getDelegate().onPostCreate(savedInstanceState); + } + + public ActionBar getSupportActionBar() { + return getDelegate().getSupportActionBar(); + } + + + @Override + public MenuInflater getMenuInflater() { + return getDelegate().getMenuInflater(); + } + + @Override + public void setContentView(@LayoutRes int layoutResID) { + getDelegate().setContentView(layoutResID); + } + + @Override + public void setContentView(View view) { + getDelegate().setContentView(view); + } + + @Override + public void setContentView(View view, ViewGroup.LayoutParams params) { + getDelegate().setContentView(view, params); + } + + @Override + public void addContentView(View view, ViewGroup.LayoutParams params) { + getDelegate().addContentView(view, params); + } + + @Override + protected void onPostResume() { + super.onPostResume(); + getDelegate().onPostResume(); + } + + @Override + protected void onTitleChanged(CharSequence title, int color) { + super.onTitleChanged(title, color); + getDelegate().setTitle(title); + } + + @Override + public void onConfigurationChanged(Configuration newConfig) { + super.onConfigurationChanged(newConfig); + getDelegate().onConfigurationChanged(newConfig); + } + + @Override + protected void onStop() { + super.onStop(); + getDelegate().onStop(); + } + + @Override + protected void onDestroy() { + super.onDestroy(); + getDelegate().onDestroy(); + } + + public void invalidateOptionsMenu() { + getDelegate().invalidateOptionsMenu(); + } + + private AppCompatDelegate getDelegate() { + if (mDelegate == null) { + mDelegate = AppCompatDelegate.create(this, null); + } + return mDelegate; + } +} diff --git a/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java new file mode 100644 index 00000000..4156c361 --- /dev/null +++ b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/MainActivity.java @@ -0,0 +1,400 @@ +package com.baidu.paddle.lite.demo.tts; + +import android.Manifest; +import android.app.ProgressDialog; +import android.content.Intent; +import android.content.SharedPreferences; +import android.content.pm.PackageManager; +import android.media.MediaPlayer; +import android.os.Bundle; +import android.os.Environment; +import android.os.Handler; +import android.os.HandlerThread; +import android.os.Message; +import android.preference.PreferenceManager; +import android.support.annotation.NonNull; +import android.support.v4.app.ActivityCompat; +import android.support.v4.content.ContextCompat; +import android.support.v7.app.AppCompatActivity; +import android.text.method.ScrollingMovementMethod; +import android.util.Log; +import android.view.Menu; +import android.view.MenuInflater; +import android.view.MenuItem; +import android.view.View; +import android.widget.AdapterView; +import android.widget.ArrayAdapter; +import android.widget.Button; +import android.widget.Spinner; +import android.widget.TextView; +import android.widget.Toast; + +import java.io.File; +import java.io.IOException; + +public class MainActivity extends AppCompatActivity implements View.OnClickListener, MediaPlayer.OnPreparedListener, MediaPlayer.OnErrorListener, AdapterView.OnItemSelectedListener { + public static final int REQUEST_LOAD_MODEL = 0; + public static final int REQUEST_RUN_MODEL = 1; + public static final int RESPONSE_LOAD_MODEL_SUCCESSED = 0; + public static final int RESPONSE_LOAD_MODEL_FAILED = 1; + public static final int RESPONSE_RUN_MODEL_SUCCESSED = 2; + public static final int RESPONSE_RUN_MODEL_FAILED = 3; + public MediaPlayer mediaPlayer = new MediaPlayer(); + private static final String TAG = Predictor.class.getSimpleName(); + protected ProgressDialog pbLoadModel = null; + protected ProgressDialog pbRunModel = null; + // Receive messages from worker thread + protected Handler receiver = null; + // Send command to worker thread + protected Handler sender = null; + // Worker thread to load&run model + protected HandlerThread worker = null; + // UI components of image classification + protected TextView tvInputSetting; + protected TextView tvInferenceTime; + protected Button btn_play; + protected Button btn_pause; + protected Button btn_stop; + // Model settings of image classification + protected String modelPath = ""; + protected int cpuThreadNum = 1; + protected String cpuPowerMode = ""; + protected Predictor predictor = new Predictor(); + int sampleRate = 24000; + private final String wavName = "tts_output.wav"; + private final String wavFile = Environment.getExternalStorageDirectory() + File.separator + wavName; + private final String AMmodelName = "fastspeech2_csmsc_arm.nb"; + private final String VOCmodelName = "mb_melgan_csmsc_arm.nb"; + private float[] phones = {}; + private final float[][] sentencesToChoose = { + // 009901 昨日，这名“伤者”与医生全部被警方依法刑事拘留。 + {261, 231, 175, 116, 179, 262, 44, 154, 126, 177, 19, 262, 42, 241, 72, 177, 56, 174, 245, 37, 186, 37, 49, 151, 127, 69, 19, 179, 72, 69, 4, 260, 126, 177, 116, 151, 239, 153, 141}, + // 009902 钱伟长想到上海来办学校是经过深思熟虑的。 + {174, 83, 213, 39, 20, 260, 89, 40, 30, 177, 22, 71, 9, 153, 8, 37, 17, 260, 251, 260, 99, 179, 177, 116, 151, 125, 70, 233, 177, 51, 176, 108, 177, 184, 153, 242, 40, 45}, + // 009903 她见我一进门就骂，吃饭时也骂，骂得我抬不起头。 + {182, 2, 151, 85, 232, 73, 151, 123, 154, 52, 151, 143, 154, 5, 179, 39, 113, 69, 17, 177, 114, 105, 154, 5, 179, 154, 5, 40, 45, 232, 182, 8, 37, 186, 174, 74, 182, 168}, + // 009904 李述德在离开之前，只说了一句“柱驼杀父亲了”。 + {153, 74, 177, 186, 40, 42, 261, 10, 153, 73, 152, 7, 262, 113, 174, 83, 179, 262, 115, 177, 230, 153, 45, 73, 151, 242, 180, 262, 186, 182, 231, 177, 2, 69, 186, 174, 124, 153, 45}, + // 009905 这种车票和保险单捆绑出售属于重复性购买。 + {262, 44, 262, 163, 39, 41, 173, 99, 71, 42, 37, 28, 260, 84, 40, 14, 179, 152, 220, 37, 21, 39, 183, 177, 170, 179, 177, 185, 240, 39, 162, 69, 186, 260, 128, 70, 170, 154, 9}, + // 009906 戴佩妮的男友西米露接唱情歌，让她非常开心。 + {40, 10, 173, 49, 155, 72, 40, 45, 155, 15, 142, 260, 72, 154, 74, 153, 186, 179, 151, 103, 39, 22, 174, 126, 70, 41, 179, 175, 22, 182, 2, 69, 46, 39, 20, 152, 7, 260, 120}, + // 009907 观大势、谋大局、出大策始终是该院的办院方针。 + {70, 199, 40, 5, 177, 116, 154, 168, 40, 5, 151, 240, 179, 39, 183, 40, 5, 38, 44, 179, 177, 115, 262, 161, 177, 116, 70, 7, 247, 40, 45, 37, 17, 247, 69, 19, 262, 51}, + // 009908 他们骑着摩托回家，正好为农忙时的父母帮忙。 + {182, 2, 154, 55, 174, 73, 262, 45, 154, 157, 182, 230, 71, 212, 151, 77, 180, 262, 59, 71, 29, 214, 155, 162, 154, 20, 177, 114, 40, 45, 69, 186, 154, 185, 37, 19, 154, 20}, + // 009909 但是因为还没到退休年龄，只能掰着指头捱日子。 + {40, 17, 177, 116, 120, 214, 71, 8, 154, 47, 40, 30, 182, 214, 260, 140, 155, 83, 153, 126, 180, 262, 115, 155, 57, 37, 7, 262, 45, 262, 115, 182, 171, 8, 175, 116, 261, 112}, + // 009910 这几天雨水不断，人们恨不得待在家里不出门。 + {262, 44, 151, 74, 182, 82, 240, 177, 213, 37, 184, 40, 202, 180, 175, 52, 154, 55, 71, 54, 37, 186, 40, 42, 40, 7, 261, 10, 151, 77, 153, 74, 37, 186, 39, 183, 154, 52} + + }; + + @Override + public void onClick(View v) { + switch (v.getId()) { + case R.id.btn_play: + if (!mediaPlayer.isPlaying()) { + mediaPlayer.start(); + } + break; + case R.id.btn_pause: + if (mediaPlayer.isPlaying()) { + mediaPlayer.pause(); + } + break; + case R.id.btn_stop: + if (mediaPlayer.isPlaying()) { + mediaPlayer.reset(); + initMediaPlayer(); + } + break; + default: + break; + } + } + + private void initMediaPlayer() { + try { + File file = new File(wavFile); + // 指定音频文件的路径 + mediaPlayer.setDataSource(file.getPath()); + // 让 MediaPlayer 进入到准备状态 + mediaPlayer.prepare(); + // 该方法使得进入应用时就播放音频 + // mediaPlayer.setOnPreparedListener(this); + // prepare async to not block main thread + mediaPlayer.prepareAsync(); + } catch (Exception e) { + e.printStackTrace(); + } + } + + @Override + public void onPrepared(MediaPlayer player) { + player.start(); + } + + @Override + public boolean onError(MediaPlayer mp, int what, int extra) { + // The MediaPlayer has moved to the Error state, must be reset! + mediaPlayer.reset(); + initMediaPlayer(); + return true; + } + + @Override + protected void onCreate(Bundle savedInstanceState) { + requestAllPermissions(); + super.onCreate(savedInstanceState); + setContentView(R.layout.activity_main); + + // 初始化控件 + Spinner spinner = findViewById(R.id.spinner1); + // 建立数据源 + String[] sentences = getResources().getStringArray(R.array.text); + // 建立 Adapter 并且绑定数据源 + ArrayAdapter adapter = new ArrayAdapter(this, android.R.layout.simple_spinner_dropdown_item, sentences); + // 第一个参数表示在哪个 Activity 上显示，第二个参数是系统下拉框的样式，第三个参数是数组。 + spinner.setAdapter(adapter);//绑定Adapter到控件 + spinner.setOnItemSelectedListener(this); + + btn_play = findViewById(R.id.btn_play); + btn_pause = findViewById(R.id.btn_pause); + btn_stop = findViewById(R.id.btn_stop); + + btn_play.setOnClickListener(this); + btn_pause.setOnClickListener(this); + btn_stop.setOnClickListener(this); + + btn_play.setVisibility(View.INVISIBLE); + btn_pause.setVisibility(View.INVISIBLE); + btn_stop.setVisibility(View.INVISIBLE); + + + // Clear all setting items to avoid app crashing due to the incorrect settings + SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this); + SharedPreferences.Editor editor = sharedPreferences.edit(); + editor.clear(); + editor.commit(); + + // Prepare the worker thread for mode loading and inference + receiver = new Handler() { + @Override + public void handleMessage(Message msg) { + switch (msg.what) { + case RESPONSE_LOAD_MODEL_SUCCESSED: + pbLoadModel.dismiss(); + onLoadModelSuccessed(); + break; + case RESPONSE_LOAD_MODEL_FAILED: + pbLoadModel.dismiss(); + Toast.makeText(MainActivity.this, "Load model failed!", Toast.LENGTH_SHORT).show(); + onLoadModelFailed(); + break; + case RESPONSE_RUN_MODEL_SUCCESSED: + pbRunModel.dismiss(); + onRunModelSuccessed(); + break; + case RESPONSE_RUN_MODEL_FAILED: + pbRunModel.dismiss(); + Toast.makeText(MainActivity.this, "Run model failed!", Toast.LENGTH_SHORT).show(); + onRunModelFailed(); + break; + default: + break; + } + } + }; + + worker = new HandlerThread("Predictor Worker"); + worker.start(); + sender = new Handler(worker.getLooper()) { + public void handleMessage(Message msg) { + switch (msg.what) { + case REQUEST_LOAD_MODEL: + // Load model and reload test image + if (onLoadModel()) { + receiver.sendEmptyMessage(RESPONSE_LOAD_MODEL_SUCCESSED); + } else { + receiver.sendEmptyMessage(RESPONSE_LOAD_MODEL_FAILED); + } + break; + case REQUEST_RUN_MODEL: + // Run model if model is loaded + if (onRunModel()) { + receiver.sendEmptyMessage(RESPONSE_RUN_MODEL_SUCCESSED); + } else { + receiver.sendEmptyMessage(RESPONSE_RUN_MODEL_FAILED); + } + break; + default: + break; + } + } + }; + + // Setup the UI components + tvInputSetting = findViewById(R.id.tv_input_setting); + tvInferenceTime = findViewById(R.id.tv_inference_time); + tvInputSetting.setMovementMethod(ScrollingMovementMethod.getInstance()); + } + + @Override + protected void onResume() { + super.onResume(); + boolean settingsChanged = false; + SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(this); + String model_path = sharedPreferences.getString(getString(R.string.MODEL_PATH_KEY), + getString(R.string.MODEL_PATH_DEFAULT)); + + settingsChanged |= !model_path.equalsIgnoreCase(modelPath); + + int cpu_thread_num = Integer.parseInt(sharedPreferences.getString(getString(R.string.CPU_THREAD_NUM_KEY), + getString(R.string.CPU_THREAD_NUM_DEFAULT))); + settingsChanged |= cpu_thread_num != cpuThreadNum; + String cpu_power_mode = + sharedPreferences.getString(getString(R.string.CPU_POWER_MODE_KEY), + getString(R.string.CPU_POWER_MODE_DEFAULT)); + settingsChanged |= !cpu_power_mode.equalsIgnoreCase(cpuPowerMode); + + if (settingsChanged) { + modelPath = model_path; + cpuThreadNum = cpu_thread_num; + cpuPowerMode = cpu_power_mode; + // Update UI + tvInputSetting.setText("Model: " + modelPath.substring(modelPath.lastIndexOf("/") + 1) + "\n" + "CPU" + + " Thread Num: " + cpuThreadNum + "\n" + "CPU Power Mode: " + cpuPowerMode + "\n"); + tvInputSetting.scrollTo(0, 0); + // Reload model if configure has been changed + loadModel(); + } + } + + public void loadModel() { + pbLoadModel = ProgressDialog.show(this, "", "Loading model...", false, false); + sender.sendEmptyMessage(REQUEST_LOAD_MODEL); + } + + public void runModel() { + pbRunModel = ProgressDialog.show(this, "", "Running model...", false, false); + sender.sendEmptyMessage(REQUEST_RUN_MODEL); + } + + public boolean onLoadModel() { + return predictor.init(MainActivity.this, modelPath, AMmodelName, VOCmodelName, cpuThreadNum, + cpuPowerMode); + } + + public boolean onRunModel() { + return predictor.isLoaded() && predictor.runModel(phones); + } + + public boolean onLoadModelSuccessed() { + // Load test image from path and run model +// runModel(); + return true; + } + + public void onLoadModelFailed() { + } + + public void onRunModelSuccessed() { + // Obtain results and update UI + btn_play.setVisibility(View.VISIBLE); + btn_pause.setVisibility(View.VISIBLE); + btn_stop.setVisibility(View.VISIBLE); + tvInferenceTime.setText("Inference done！\nInference time: " + predictor.inferenceTime() + " ms" + + "\nRTF: " + predictor.inferenceTime() * sampleRate / (predictor.wav.length * 1000) + "\nAudio saved in " + wavFile); + try { + Utils.rawToWave(wavFile, predictor.wav, sampleRate); + } catch (IOException e) { + e.printStackTrace(); + } + if (ContextCompat.checkSelfPermission(MainActivity.this, + Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) { + ActivityCompat.requestPermissions(MainActivity.this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1); + } else { + // 初始化 MediaPlayer + initMediaPlayer(); + } + } + + public void onRunModelFailed() { + } + + + public void onSettingsClicked() { + startActivity(new Intent(MainActivity.this, SettingsActivity.class)); + } + + @Override + public boolean onCreateOptionsMenu(Menu menu) { + MenuInflater inflater = getMenuInflater(); + inflater.inflate(R.menu.menu_action_options, menu); + return true; + } + + @Override + public boolean onOptionsItemSelected(MenuItem item) { + switch (item.getItemId()) { + case android.R.id.home: + finish(); + break; + case R.id.settings: + onSettingsClicked(); + } + return super.onOptionsItemSelected(item); + } + + @Override + public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, + @NonNull int[] grantResults) { + + super.onRequestPermissionsResult(requestCode, permissions, grantResults); + if (grantResults[0] != PackageManager.PERMISSION_GRANTED) { + Toast.makeText(this, "Permission Denied", Toast.LENGTH_SHORT).show(); + } + } + + + @Override + protected void onDestroy() { + if (predictor != null) { + predictor.releaseModel(); + } + worker.quit(); + super.onDestroy(); + if (mediaPlayer != null) { + mediaPlayer.stop(); + mediaPlayer.release(); + } + } + + private boolean requestAllPermissions() { + if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) + != PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(this, + Manifest.permission.CAMERA) + != PackageManager.PERMISSION_GRANTED) { + ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, + 0); + return false; + } + return true; + } + + + @Override + public void onItemSelected(AdapterView parent, View view, int position, long id) { + if (position > 0) { + phones = sentencesToChoose[position - 1]; + runModel(); + } + + } + + @Override + public void onNothingSelected(AdapterView parent) { + + } +} diff --git a/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java new file mode 100644 index 00000000..edaec3d8 --- /dev/null +++ b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Predictor.java @@ -0,0 +1,149 @@ +package com.baidu.paddle.lite.demo.tts; + +import android.content.Context; +import android.util.Log; + +import com.baidu.paddle.lite.MobileConfig; +import com.baidu.paddle.lite.PaddlePredictor; +import com.baidu.paddle.lite.PowerMode; +import com.baidu.paddle.lite.Tensor; + +import java.io.File; +import java.util.Date; + + +public class Predictor { + private static final String TAG = Predictor.class.getSimpleName(); + public boolean isLoaded = false; + public int cpuThreadNum = 1; + public String cpuPowerMode = "LITE_POWER_HIGH"; + public String modelPath = ""; + protected PaddlePredictor AMPredictor = null; + protected PaddlePredictor VOCPredictor = null; + protected float inferenceTime = 0; + protected float[] wav; + + public boolean init(Context appCtx, String modelPath, String AMmodelName, String VOCmodelName, int cpuThreadNum, String cpuPowerMode) { + // Release model if exists + releaseModel(); + + AMPredictor = loadModel(appCtx, modelPath, AMmodelName, cpuThreadNum, cpuPowerMode); + if (AMPredictor == null) { + return false; + } + VOCPredictor = loadModel(appCtx, modelPath, VOCmodelName, cpuThreadNum, cpuPowerMode); + if (VOCPredictor == null) { + return false; + } + isLoaded = true; + return true; + } + + protected PaddlePredictor loadModel(Context appCtx, String modelPath, String modelName, int cpuThreadNum, String cpuPowerMode) { + // Load model + if (modelPath.isEmpty()) { + return null; + } + String realPath = modelPath; + if (modelPath.charAt(0) != '/') { + // Read model files from custom path if the first character of mode path is '/' + // otherwise copy model to cache from assets + realPath = appCtx.getCacheDir() + "/" + modelPath; + // push model to mobile + Utils.copyDirectoryFromAssets(appCtx, modelPath, realPath); + } + if (realPath.isEmpty()) { + return null; + } + MobileConfig config = new MobileConfig(); + config.setModelFromFile(realPath + File.separator + modelName); + Log.e(TAG, "File:" + realPath + File.separator + modelName); + config.setThreads(cpuThreadNum); + if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_HIGH")) { + config.setPowerMode(PowerMode.LITE_POWER_HIGH); + } else if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_LOW")) { + config.setPowerMode(PowerMode.LITE_POWER_LOW); + } else if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_FULL")) { + config.setPowerMode(PowerMode.LITE_POWER_FULL); + } else if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_NO_BIND")) { + config.setPowerMode(PowerMode.LITE_POWER_NO_BIND); + } else if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_RAND_HIGH")) { + config.setPowerMode(PowerMode.LITE_POWER_RAND_HIGH); + } else if (cpuPowerMode.equalsIgnoreCase("LITE_POWER_RAND_LOW")) { + config.setPowerMode(PowerMode.LITE_POWER_RAND_LOW); + } else { + Log.e(TAG, "Unknown cpu power mode!"); + return null; + } + return PaddlePredictor.createPaddlePredictor(config); + } + + public void releaseModel() { + AMPredictor = null; + VOCPredictor = null; + isLoaded = false; + cpuThreadNum = 1; + cpuPowerMode = "LITE_POWER_HIGH"; + modelPath = ""; + } + + public boolean runModel(float[] phones) { + if (!isLoaded()) { + return false; + } + Date start = new Date(); + Tensor am_output_handle = getAMOutput(phones, AMPredictor); + wav = getVOCOutput(am_output_handle, VOCPredictor); + Date end = new Date(); + inferenceTime = (end.getTime() - start.getTime()); + return true; + } + + public Tensor getAMOutput(float[] phones, PaddlePredictor am_predictor) { + Tensor phones_handle = am_predictor.getInput(0); + long[] dims = {phones.length}; + phones_handle.resize(dims); + phones_handle.setData(phones); + am_predictor.run(); + Tensor am_output_handle = am_predictor.getOutput(0); + // [?, 80] + // long outputShape[] = am_output_handle.shape(); + float[] am_output_data = am_output_handle.getFloatData(); + // [? x 80] + // long[] am_output_data_shape = {am_output_data.length}; + // Log.e(TAG, Arrays.toString(am_output_data)); + // 打印 mel 数组 + // for (int i=0;i preInstalledModelPaths = null; + List preInstalledCPUThreadNums = null; + List preInstalledCPUPowerModes = null; + + + @Override + public void onCreate(Bundle savedInstanceState) { + super.onCreate(savedInstanceState); + addPreferencesFromResource(R.xml.settings); + ActionBar supportActionBar = getSupportActionBar(); + if (supportActionBar != null) { + supportActionBar.setDisplayHomeAsUpEnabled(true); + } + + // Initialized pre-installed models + preInstalledModelPaths = new ArrayList(); + preInstalledCPUThreadNums = new ArrayList(); + preInstalledCPUPowerModes = new ArrayList(); + preInstalledModelPaths.add(getString(R.string.MODEL_PATH_DEFAULT)); + preInstalledCPUThreadNums.add(getString(R.string.CPU_THREAD_NUM_DEFAULT)); + preInstalledCPUPowerModes.add(getString(R.string.CPU_POWER_MODE_DEFAULT)); + + + // Setup UI components + lpChoosePreInstalledModel = (ListPreference) findPreference(getString(R.string.CHOOSE_PRE_INSTALLED_MODEL_KEY)); + String[] preInstalledModelNames = new String[preInstalledModelPaths.size()]; + for (int i = 0; i < preInstalledModelPaths.size(); i++) { + preInstalledModelNames[i] = preInstalledModelPaths.get(i).substring(preInstalledModelPaths.get(i).lastIndexOf("/") + 1); + } + lpChoosePreInstalledModel.setEntries(preInstalledModelNames); + lpChoosePreInstalledModel.setEntryValues(preInstalledModelPaths.toArray(new String[preInstalledModelPaths.size()])); + lpCPUThreadNum = (ListPreference) findPreference(getString(R.string.CPU_THREAD_NUM_KEY)); + lpCPUPowerMode = (ListPreference) findPreference(getString(R.string.CPU_POWER_MODE_KEY)); + cbEnableCustomSettings = (CheckBoxPreference) findPreference(getString(R.string.ENABLE_CUSTOM_SETTINGS_KEY)); + etModelPath = (EditTextPreference) findPreference(getString(R.string.MODEL_PATH_KEY)); + etModelPath.setTitle("Model Path (SDCard: " + Utils.getSDCardDirectory() + ")"); + } + + private void reloadPreferenceAndUpdateUI() { + SharedPreferences sharedPreferences = getPreferenceScreen().getSharedPreferences(); + boolean enableCustomSettings = sharedPreferences.getBoolean(getString(R.string.ENABLE_CUSTOM_SETTINGS_KEY), false); + String modelPath = sharedPreferences.getString(getString(R.string.CHOOSE_PRE_INSTALLED_MODEL_KEY), getString(R.string.MODEL_PATH_DEFAULT)); + int modelIdx = lpChoosePreInstalledModel.findIndexOfValue(modelPath); + if (modelIdx >= 0 && modelIdx < preInstalledModelPaths.size()) { + if (!enableCustomSettings) { + SharedPreferences.Editor editor = sharedPreferences.edit(); + editor.putString(getString(R.string.MODEL_PATH_KEY), preInstalledModelPaths.get(modelIdx)); + editor.putString(getString(R.string.CPU_THREAD_NUM_KEY), preInstalledCPUThreadNums.get(modelIdx)); + editor.putString(getString(R.string.CPU_POWER_MODE_KEY), preInstalledCPUPowerModes.get(modelIdx)); + editor.commit(); + } + lpChoosePreInstalledModel.setSummary(modelPath); + } + cbEnableCustomSettings.setChecked(enableCustomSettings); + etModelPath.setEnabled(enableCustomSettings); + lpCPUThreadNum.setEnabled(enableCustomSettings); + lpCPUPowerMode.setEnabled(enableCustomSettings); + modelPath = sharedPreferences.getString(getString(R.string.MODEL_PATH_KEY), getString(R.string.MODEL_PATH_DEFAULT)); + String cpuThreadNum = sharedPreferences.getString(getString(R.string.CPU_THREAD_NUM_KEY), getString(R.string.CPU_THREAD_NUM_DEFAULT)); + String cpuPowerMode = sharedPreferences.getString(getString(R.string.CPU_POWER_MODE_KEY), getString(R.string.CPU_POWER_MODE_DEFAULT)); + + etModelPath.setSummary(modelPath); + etModelPath.setText(modelPath); + lpCPUThreadNum.setValue(cpuThreadNum); + lpCPUThreadNum.setSummary(cpuThreadNum); + lpCPUPowerMode.setValue(cpuPowerMode); + lpCPUPowerMode.setSummary(cpuPowerMode); + } + + @Override + protected void onResume() { + super.onResume(); + getPreferenceScreen().getSharedPreferences().registerOnSharedPreferenceChangeListener(this); + reloadPreferenceAndUpdateUI(); + } + + @Override + protected void onPause() { + super.onPause(); + getPreferenceScreen().getSharedPreferences().unregisterOnSharedPreferenceChangeListener(this); + } + + @Override + public void onSharedPreferenceChanged(SharedPreferences sharedPreferences, String key) { + if (key.equals(getString(R.string.CHOOSE_PRE_INSTALLED_MODEL_KEY))) { + SharedPreferences.Editor editor = sharedPreferences.edit(); + editor.putBoolean(getString(R.string.ENABLE_CUSTOM_SETTINGS_KEY), false); + editor.commit(); + } + reloadPreferenceAndUpdateUI(); + } +} diff --git a/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Utils.java b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Utils.java new file mode 100644 index 00000000..163d387e --- /dev/null +++ b/demos/TTSAndroid/app/src/main/java/com/baidu/paddle/lite/demo/tts/Utils.java @@ -0,0 +1,155 @@ +package com.baidu.paddle.lite.demo.tts; + +import static java.lang.Math.abs; + +import android.content.Context; +import android.os.Environment; + +import java.io.BufferedInputStream; +import java.io.BufferedOutputStream; +import java.io.DataOutputStream; +import java.io.File; +import java.io.FileNotFoundException; +import java.io.FileOutputStream; +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; + +public class Utils { + public static void copyFileFromAssets(Context appCtx, String srcPath, String dstPath) { + if (srcPath.isEmpty() || dstPath.isEmpty()) { + return; + } + InputStream is = null; + OutputStream os = null; + try { + is = new BufferedInputStream(appCtx.getAssets().open(srcPath)); + os = new BufferedOutputStream(new FileOutputStream(new File(dstPath))); + byte[] buffer = new byte[1024]; + int length = 0; + while ((length = is.read(buffer)) != -1) { + os.write(buffer, 0, length); + } + } catch (FileNotFoundException e) { + e.printStackTrace(); + } catch (IOException e) { + e.printStackTrace(); + } finally { + try { + os.close(); + is.close(); + } catch (IOException e) { + e.printStackTrace(); + } + } + } + + public static void copyDirectoryFromAssets(Context appCtx, String srcDir, String dstDir) { + if (srcDir.isEmpty() || dstDir.isEmpty()) { + return; + } + try { + if (!new File(dstDir).exists()) { + new File(dstDir).mkdirs(); + } + for (String fileName : appCtx.getAssets().list(srcDir)) { + String srcSubPath = srcDir + File.separator + fileName; + String dstSubPath = dstDir + File.separator + fileName; + if (new File(srcSubPath).isDirectory()) { + copyDirectoryFromAssets(appCtx, srcSubPath, dstSubPath); + } else { + copyFileFromAssets(appCtx, srcSubPath, dstSubPath); + } + } + } catch (Exception e) { + e.printStackTrace(); + } + } + + + public static String getSDCardDirectory() { + return Environment.getExternalStorageDirectory().getAbsolutePath(); + } + + public static void rawToWave(String file, float[] data, int samplerate) throws IOException { + // creating the empty wav file. + File waveFile = new File(file); + waveFile.createNewFile(); + //following block is converting raw to wav. + DataOutputStream output = null; + try { + output = new DataOutputStream(new FileOutputStream(waveFile)); + // WAVE header + // chunk id + writeString(output, "RIFF"); + // chunk size + writeInt(output, 36 + data.length * 2); + // format + writeString(output, "WAVE"); + // subchunk 1 id + writeString(output, "fmt "); + // subchunk 1 size + writeInt(output, 16); + // audio format (1 = PCM) + writeShort(output, (short) 1); + // number of channels + writeShort(output, (short) 1); + // sample rate + writeInt(output, samplerate); + // byte rate + writeInt(output, samplerate * 2); + // block align + writeShort(output, (short) 2); + // bits per sample + writeShort(output, (short) 16); + // subchunk 2 id + writeString(output, "data"); + // subchunk 2 size + writeInt(output, data.length * 2); + short[] short_data = FloatArray2ShortArray(data); + for (int i = 0; i < short_data.length; i++) { + writeShort(output, short_data[i]); + } + } finally { + if (output != null) { + output.close(); + } + } + } + + private static void writeInt(final DataOutputStream output, final int value) throws IOException { + output.write(value); + output.write(value >> 8); + output.write(value >> 16); + output.write(value >> 24); + } + + private static void writeShort(final DataOutputStream output, final short value) throws IOException { + output.write(value); + output.write(value >> 8); + } + + private static void writeString(final DataOutputStream output, final String value) throws IOException { + for (int i = 0; i < value.length(); i++) { + output.write(value.charAt(i)); + } + } + + public static short[] FloatArray2ShortArray(float[] values) { + float mmax = (float) 0.01; + short[] ret = new short[values.length]; + + for (int i = 0; i < values.length; i++) { + if (abs(values[i]) > mmax) { + mmax = abs(values[i]); + } + } + + for (int i = 0; i < values.length; i++) { + values[i] = values[i] * (32767 / mmax); + ret[i] = (short) (values[i]); + } + return ret; + } + +} diff --git a/demos/TTSAndroid/app/src/main/res/drawable/button_drawable.xml b/demos/TTSAndroid/app/src/main/res/drawable/button_drawable.xml new file mode 100644 index 00000000..e2f6ba52 --- /dev/null +++ b/demos/TTSAndroid/app/src/main/res/drawable/button_drawable.xml @@ -0,0 +1,20 @@ + + + + + + + + + + + + + + + + + + + + diff --git a/demos/TTSAndroid/app/src/main/res/drawable/logo.jpg b/demos/TTSAndroid/app/src/main/res/drawable/logo.jpg new file mode 100644 index 0000000000000000000000000000000000000000..96a03119cbd92ed33f65cb9ccc2adfc100cbb734 GIT binary patch literal 9341 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 I&MBb@04xhm8vp + + + + + + + + + + + + + + + + +