Android 架构 JAVA API,灵云SDK开发手册(Java API)

1. 兼容性

支持Android 2.1 及以上系统。

支持arm、arm-v7a、x86架构处理器。

2. 开发环境搭建

开发者可以自行选择Android开发环境，下面主要是针对Eclipse开发环境下进行编写的。

1) 安装JDK

编者采用的版本是jdk1.6.0_20，开发者可以从以下Oracle 官网下载所需的版本：http://www.oracle.com/technetwork/java/javase/downloads/index.html

2) 安装Eclipse Java IDE

编者采用的版本是Eclipse3.4，开发者可以从以下官网下载所需的版本：http://www.eclipse.org/

3) 安装Android SDK

编者采用的版本是Android 2.2，开发者可以去从以下Android 官方网站下载所需的版本：http://developer.android.com/sdk/

4) 安装ADT插件

启动Eclipse后，点击Eclipse的 Help->soft update->find and install->search for new features to install->new remote site->name: https://dl-ssl.google.com/android/eclipse/，完成安装后重启Eclipse；

5) 安装Android DDMS和Android Development Tools

至此，您已经完成了Android开发环境的搭建，更多Android了解请参考SDK的开发指导文档。

3. 引入SDK文件

在开发应用前，需要将灵云SDK中的Jar包文件(.jar)和相应的动态运行库(.so)引入到工程中。

1) 在工程中创建libs文件夹，将相应的jar文件拷贝到libs根目录下，将相应的so文件拷贝到libs\armeabi(或libs\armeabi-v7a)目录下。

2) 通过菜单 Project->Properties->Java Build Path->Libraries->Add JARS或ADD External JARS引入相应的Jar包。

具体需要引入的文件和开发者所需要使用的能力有关。

3.1 ASR能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_asr.so

libhci_asr_jni.so

云端识别

libhci_asr_cloud_recog.so

libjtspeex.so 或者 libjtopus.so (根据所使用的编解码格式进行选择)

本地语法识别

libhci_asr_local_recog.so

本地资源文件：

使用本地语音识别能力，需要相应的资源文件。具体可参照 ASR能力描述 进行选择。

使用ASR录音机，需要增加 jar包文件

hcicloud_recorder-5.0.0.jar

3.2 TTS能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_tts.so

libhci_tts_jni.so

云端合成

libhci_tts_cloud_synth.so

libjtspeex.so 或者 libjtopus.so (根据所使用的编解码格式进行选择)

本地合成

libhci_tts_local_synth.so

libhci_tts_local-v5_synth.so(不支持VFP选项适配版本)

本地资源文件：

使用本地语音合成能力，需要相应的资源文件。具体可参照 TTS能力描述 进行选择。

使用TTS播放器，需要增加 jar包文件

hcicloud_player-5.0.0.jar

3.3 HWR能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_hwr.so

libhci_hwr_jni.so

云端识别

libhci_hwr_cloud_recog.so

本地识别

libhci_hwr_local_recog.so

联想功能

libhci_hwr_associate.so

拼音功能

libhci_hwr_pinyin.so

笔形功能

libhci_hwr_penscript.so

本地资源文件：

使用本地手写识别能力，需要相应的资源文件。具体可参照 HWR能力描述 进行选择。

3.4 OCR能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libjtz.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_ocr.so

libhci_ocr_jni.so

云端识别

libhci_ocr_cloud_recog.so

本地识别

libhci_ocr_local_recog.so

本地模板识别

libhci_ocr_local_recog_template.so

本地名片识别

libhci_ocr_local_recog_bizcard.so

本地资源文件：

使用本地光学字符识别能力，需要相应的资源文件。具体可参照 OCR能力描述 进行选择。

如果使用拍图器，需要增加 jar包文件

hcicloud_capture-5.0.0.jar

3.5 MT能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_mt.so

libhci_mt_jni.so

云端识别

libhci_mt_cloud_trans.so

本地识别(暂不支持)

libhci_mt_local_trans.so

3.6 NLU能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_nlu.so

libhci_nlu_jni.so

云端识别

libhci_nlu_cloud_recog.so

本地识别(暂不支持)

libhci_nlu_local_recog.so

3.7 KB能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_kb.so

libhci_kb_jni.so

云端识别(暂不支持)

libhci_kb_cloud_recog.so

本地识别

libhci_kb_local_recog.so

3.8 VPR能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_vpr.so

libhci_vpr_jni.so

云端识别

libhci_vpr_cloud_recog.so

libjtspeex.so 或者 libjtopus.so (根据所使用的编解码格式进行选择)

3.9 VPR能力

jar包文件

hcicloud-5.0.0.jar

so文件

必选模块

libstlport_shared.so

libhci_curl.so

libhci_sys.so

libhci_sys_jni.so

libhci_fpr.so

libhci_fpr_jni.so

云端识别

libhci_fpr_cloud_recog.so

本地识别

libhci_fpr_local_recog.so

3.10 注意

如果能确认终端支持硬浮点 (armv7a以上CPU)版本sdk，可以使用armeabi-v7a目录替代armeabi目录， 并拷贝SDK中armeabi-v7a目录下的.so文件，这样速度会更快。SDK的armeabi-v7a目录中不存在的so文件需从armeabi目录拷贝。

armeabi和armeabi-v7a两个目录也可以都存在，在apk包安装时会自动根据终端的CPU架构进行安装最合适的库， 但是这样会造成apk包较大。

libjtopus.so是opus编码库，libjtspeex.so是speex编码库，仅在使用云端ASR或者TTS时候用于音频压缩。 应用可以根据需要的编码方式(请参 音频编解码库 )，选择其中合适的编码库，这样可以减少应用包的大小．

4. 配置Manifest

在工程AndroidManifest.xml文件中添加如下权限：

5. 本地资源文件

当使用本地能力时，需要在本地存放资源文件。并在能力初始化时通过指定dataPath告知资源所在路径。

每种本地能力，所需要的资源文件并不相同，在实际使用时，可以只拷贝所使用能力对应的资源文件， 这样可以减少所占用的外部存储空间。具体每种本地能力所需要的本地资源文件，请参见 能力列表 。

本地资源文件的存放有如下两种方法。

5.1 存放在外部存储上

此种方式是将资源文件存放在外部存储上，在能力初始化时指定dataPath参数为资源文件的存放目录。 以/mnt/sdcard/HciCloudTtsPlayerExample/tts/data目录为例，其下存放了本地能力(tts.local.xiaokun)所需要的TTS资源文件：

XiaoKun.voclib

Letter_XiaoKun.voclib

开发者可以将这些库文件作为assets中的资源，并在程序启动时拷贝到外部存储上；也可以在发布时不带这些资源文件， 而是在运行时让用户下载到外部存储上。

如果外部存储发生故障(例如sd卡被拔出)，则可能会影响对应本地能力的正常使用。

5.2 存放在内部存储上

为了便于应用的发布与管理，灵云SDK也支持将本地资源文件随应用安装在内部存储上， 但此种存放方法需要开发者满足以下要求，灵云SDK才能正常访问这些资源文件：

1) 对资源文件进行特殊命名。以本地能力(tts.local.xiaokun)所需要的TTS资源文件为例，以下示例了这种命名规则：

libXiaoKun.voclib.so(在原文件名前加lib前缀与.so后缀)

libLetter_XiaoKun.voclib.so(在原文件名前加lib前缀与.so后缀)

2) 将重新命名过的本地资源文件拷贝到libs根目录下。

3) 在能力初始化时，指定dataPath参数为 /data/data/appname/lib (appname为应用包的名称)

4) 在能力初始化时，指定fileFlag参数为android_so(默认为none)

所有需要的本地资源文件都需要按以上规则进行名字的改动，并拷贝到libs目录下。 通过这种方式，这些资源文件会被打包在APK中，并在安装时，被放在 /data/data/appname/lib 下。 通过指定fileFlag为android_so，灵云SDK就会按照特殊的命名方式来读取这些文件。