PocketSphinx Android 示例项目教程

1. 项目目录结构及介绍

PocketSphinx Android 示例项目的目录结构如下：

pocketsphinx-android-demo/
├── app/
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── edu/
│   │   │   │       └── cmu/
│   │   │   │           └── pocketsphinx/
│   │   │   │               └── demo/
│   │   │   │                   └── PocketSphinxActivity.java
│   │   │   └── res/
│   │   │       ├── layout/
│   │   │       ├── values/
│   │   │       └── ...
│   │   └── test/
│   └── build.gradle
├── gradle/
│   └── wrapper/
├── models/
├── wear/
├── .gitignore
├── LICENSE
├── README.md
├── build.gradle
├── gradlew
├── gradlew.bat
└── settings.gradle

目录结构介绍

• app/: 包含应用程序的主要代码和资源文件。
  • src/main/java/: 包含应用程序的Java源代码。
    • edu/cmu/pocketsphinx/demo/PocketSphinxActivity.java: 应用程序的主Activity文件。
  • src/main/res/: 包含应用程序的资源文件，如布局、字符串等。
  • build.gradle: 应用程序模块的Gradle构建脚本。
• gradle/: 包含Gradle Wrapper的相关文件。
• models/: 包含用于语音识别的模型文件。
• wear/: 包含适用于Android Wear的代码和资源。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件。
• build.gradle: 项目的根Gradle构建脚本。
• gradlew: Gradle Wrapper的Unix脚本。
• gradlew.bat: Gradle Wrapper的Windows批处理脚本。
• settings.gradle: 项目的Gradle设置文件。

2. 项目的启动文件介绍

项目的启动文件是 PocketSphinxActivity.java，位于 app/src/main/java/edu/cmu/pocketsphinx/demo/ 目录下。

PocketSphinxActivity.java

PocketSphinxActivity.java 是应用程序的主Activity，负责初始化语音识别器并处理语音识别事件。以下是该文件的主要功能：

• onCreate(): 初始化Activity，检查并请求录音权限，启动语音识别器的初始化任务。
• onDestroy(): 在Activity销毁时停止并关闭语音识别器。
• onPartialResult(): 处理语音识别的中间结果，根据识别的关键词切换不同的识别模式。
• onResult(): 处理语音识别的最终结果。
• onError(): 处理语音识别过程中的错误。
• onTimeout(): 处理语音识别的超时事件。

3. 项目的配置文件介绍

build.gradle (项目根目录)

项目的根目录下的 build.gradle 文件用于配置整个项目的构建脚本。以下是该文件的主要内容：

// 项目使用的Gradle插件
plugins {
    id 'com.android.application' version '7.0.0' apply false
    id 'com.android.library' version '7.0.0' apply false
}

// 项目使用的仓库
repositories {
    google()
    mavenCentral()
}

// 项目依赖
dependencies {
    // 依赖配置
}

build.gradle (app模块)

app 模块下的 build.gradle 文件用于配置应用程序模块的构建脚本。以下是该文件的主要内容：

// 应用模块配置
android {
    compileSdkVersion 30
    defaultConfig {
        applicationId "edu.cmu.pocketsphinx.demo"
        minSdkVersion 16
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

// 模块依赖
dependencies {
    implementation 'edu.cmu.pocketsphinx:pocketsphinx-android:5prealpha'
    implementation 'androidx.appcompat:appcompat:1.3.1'
}

settings.gradle

settings.gradle 文件用于配置项目的模块。以下是该文件的主要内容：

// 包含的模块
include ':app'

通过以上配置文件，可以构建和运行PocketSphinx Android示例项目。