【Android】灵云在线语义理解功能使用说明
2016-12-27 10:34
357 查看
注册
使用灵云的语义理解功能需要先在官网上进行注册应用。官网地址注册比较简单，就不做过多介绍了，注册完应用以后，在后台创建自己的应用，创建完应用以后需要给应用开通对应的语义理解能力。
capKey说明：
nlu.cloud 云端语义理解别功能
使用nlu.cloud功能时，需要勾选对应的领域，以下示例按照百科领域进行测试。
领域的介绍手册
集成
下载灵云的Android版本语义理解功能，下载地址源码
Github灵云在线语义理解功能
需要加入的so和jar包有：libhci_curl.so
libhci_sys.so
libhci_sys_jni.so
libhci_nlu.so
libhci_nlu_jni.so
libhci_nlu_cloud_recog.so
libstlport_shared.so
hcicloud-5.0.jar
需要使用的权限
<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" /> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
加载配置类
package com.miao.test.util;
/**
* 灵云配置信息
* Created by 10048 on 2016/12/3.
*/
public class ConfigUtil {
/**
* 灵云APP_KEY
*/
public static final String APP_KEY = "c85d54f1";
/**
* 开发者密钥
*/
public static final String DEVELOPER_KEY = "712ddd892cf9163e6383aa169e0454e3";
/**
* 灵云云服务的接口地址
*/
public static final String CLOUD_URL = "http://test.api.hcicloud.com:8888";
/**
* 需要运行的灵云能力
*/
// 云端语义理解
public static final String CAP_KEY_NLU_CLOUD_RECOG = "nlu.cloud";
}封装灵云系统的初始化功能
package com.e
d4fd
xample.sinovoice.util;
import android.content.Context;
import android.os.Environment;
import android.util.Log;
import com.sinovoice.hcicloudsdk.api.HciCloudSys;
import com.sinovoice.hcicloudsdk.common.AuthExpireTime;
import com.sinovoice.hcicloudsdk.common.HciErrorCode;
import com.sinovoice.hcicloudsdk.common.InitParam;
import java.io.File;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;
/**
* Created by miaochangchun on 2016/11/28.
*/
public class HciCloudSysHelper {
private static final String TAG = HciCloudSysHelper.class.getSimpleName();
private static HciCloudSysHelper mHciCloudSysHelper = null;
private HciCloudSysHelper(){
}
public static HciCloudSysHelper getInstance() {
if (mHciCloudSysHelper == null) {
return new HciCloudSysHelper();
}
return mHciCloudSysHelper;
}
/**
* 初始化函数
* @param context
* @return
*/
public int init(Context context){
//配置串参数
String strConfig = getInitParam(context);
int errCode = HciCloudSys.hciInit(strConfig, context);
if (errCode != HciErrorCode.HCI_ERR_NONE){
Log.e(TAG, "hciInit Failed and return errcode = " + errCode);
return errCode;
}
errCode = checkAuthAndUpdateAuth();
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "checkAuthAndUpdateAuth Failed and return errcode = " + errCode);
return errCode;
}
return HciErrorCode.HCI_ERR_NONE;
}
/**
* 获取授权
* @return
*/
private int checkAuthAndUpdateAuth() {
// 获取系统授权到期时间
AuthExpireTime objExpireTime = new AuthExpireTime();
int initResult = HciCloudSys.hciGetAuthExpireTime(objExpireTime);
if (initResult == HciErrorCode.HCI_ERR_NONE) {
// 显示授权日期,如用户不需要关注该值,此处代码可忽略
Date date = new Date(objExpireTime.getExpireTime() * 1000);
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd", Locale.CHINA);
Log.i(TAG, "expire time: " + sdf.format(date));
if (objExpireTime.getExpireTime() * 1000 > System.currentTimeMillis()) {
// 已经成功获取了授权,并且距离授权到期有充足的时间(>7天)
Log.i(TAG, "checkAuth success");
return initResult;
}
}
// 获取过期时间失败或者已经过期
initResult = HciCloudSys.hciCheckAuth();
if (initResult == HciErrorCode.HCI_ERR_NONE) {
Log.i(TAG, "checkAuth success");
return initResult;
} else {
Log.e(TAG, "checkAuth failed: " + initResult);
return initResult;
}
}
/**
* 获取配置传参数
* @param context
* @return
*/
private String getInitParam(Context context) {
InitParam initParam = new InitParam();
//灵云云服务的接口地址，此项必填
initParam.addParam(InitParam.AuthParam.PARAM_KEY_APP_KEY, ConfigUtil.APP_KEY);
//灵云云服务的接口地址，此项必填
initParam.addParam(InitParam.AuthParam.PARAM_KEY_DEVELOPER_KEY, ConfigUtil.DEVELOPER_KEY);
//灵云云服务的接口地址，此项必填
initParam.addParam(InitParam.AuthParam.PARAM_KEY_CLOUD_URL, ConfigUtil.CLOUD_URL);
String authPath = context.getFilesDir().getAbsolutePath();
//授权文件所在路径，此项必填
initParam.addParam(InitParam.AuthParam.PARAM_KEY_AUTH_PATH, authPath);
//日志数目，默认保留多少个日志文件，超过则覆盖最旧的日志
initParam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_COUNT, "5");
String logPath = Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator
+ "sinovoice" + File.separator
+ context.getPackageName() + File.separator
+ "log" + File.separator;
File file = new File(logPath);
if (!file.exists()) {
file.mkdirs();
}
//日志的路径，可选，如果不传或者为空则不生成日志
initParam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_PATH, logPath);
Log.d(TAG, "logPath = " + logPath);
//日志大小，默认一个日志文件写多大，单位为K
initParam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_SIZE, "1024");
//日志等级，0=无，1=错误，2=警告，3=信息，4=细节，5=调试，SDK将输出小于等于logLevel的日志信息
initParam.addParam(InitParam.LogParam.PARAM_KEY_LOG_LEVEL, "5");
return initParam.getStringConfig();
}
/**
* 反初始化
* @return
*/
public int release(){
return HciCloudSys.hciRelease();
}
}封装灵云语义理解功能
package com.example.sinovoice.util;
import android.util.Log;
import com.sinovoice.hcicloudsdk.api.nlu.HciCloudNlu;
import com.sinovoice.hcicloudsdk.common.HciErrorCode;
import com.sinovoice.hcicloudsdk.common.Session;
import com.sinovoice.hcicloudsdk.common.nlu.NluConfig;
import com.sinovoice.hcicloudsdk.common.nlu.NluInitParam;
import com.sinovoice.hcicloudsdk.common.nlu.NluRecogResult;
/**
* Created by miaochangchun on 2016/12/15.
*/
public class HciCloudNluHelper {
private static final String TAG = HciCloudNluHelper.class.getSimpleName();
private static HciCloudNluHelper mHciCloudNluHelper = null;
private HciCloudNluHelper(){
}
public static HciCloudNluHelper getInstance() {
if (mHciCloudNluHelper == null) {
return new HciCloudNluHelper();
}
return mHciCloudNluHelper;
}
/**
* nlu的初始化功能
* @return
*/
public int initNlu(){
NluInitParam nluInitParam = new NluInitParam();
nluInitParam.addParam(NluInitParam.PARAM_KEY_INIT_CAP_KEYS, ConfigUtil.CAP_KEY_NLU_CLOUD_RECOG);
nluInitParam.addParam(NluInitParam.PARAM_KEY_FILE_FLAG, "android_so");
// nluInitParam.addParam(NluInitParam.PARAM_KEY_DATA_PATH, dataPath);
int errCode = HciCloudNlu.hciNluInit(nluInitParam.getStringConfig());
return errCode;
}
/**
* nlu的识别功能
* @param text 要解析的文本
* @param intention 选择的领域信息
*/
public void recog(String text, String intention){
NluConfig nluConfig = new NluConfig();
nluConfig.addParam(NluConfig.SessionConfig.PARAM_KEY_CAP_KEY, ConfigUtil.CAP_KEY_NLU_CLOUD_RECOG);
//如果使用多个领域，可以以分号间隔
nluConfig.addParam(NluConfig.ResultConfig.PARAM_KEY_INTENTION, intention);
Session session = new Session();
int errCode = HciCloudNlu.hciNluSessionStart(nluConfig.getStringConfig(), session);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluSessionStart failed and return " + errCode);
return;
}
NluRecogResult nluRecogResult = new NluRecogResult();
errCode = HciCloudNlu.hciNluRecog(session, text, "", nluRecogResult);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluRecog failed and return " + errCode);
return;
}
errCode = HciCloudNlu.hciNluSessionStop(session);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluSessionStop failed and return " + errCode);
return;
}
}
/**
* nlu的反初始化功能
* @return
*/
public int releaseNlu(){
return HciCloudNlu.hciNluRelease();
}
}在MainActivity中使用语义理解的功能
package com.example.sinovoice.util;
import android.util.Log;
import com.sinovoice.hcicloudsdk.api.nlu.HciCloudNlu;
import com.sinovoice.hcicloudsdk.common.HciErrorCode;
import com.sinovoice.hcicloudsdk.common.Session;
import com.sinovoice.hcicloudsdk.common.nlu.NluConfig;
import com.sinovoice.hcicloudsdk.common.nlu.NluInitParam;
import com.sinovoice.hcicloudsdk.common.nlu.NluRecogResult;
/**
* Created by miaochangchun on 2016/12/15.
*/
public class HciCloudNluHelper {
private static final String TAG = HciCloudNluHelper.class.getSimpleName();
private static HciCloudNluHelper mHciCloudNluHelper = null;
private HciCloudNluHelper(){
}
public static HciCloudNluHelper getInstance() {
if (mHciCloudNluHelper == null) {
return new HciCloudNluHelper();
}
return mHciCloudNluHelper;
}
/**
* nlu的初始化功能
* @return
*/
public int initNlu(){
NluInitParam nluInitParam = new NluInitParam();
nluInitParam.addParam(NluInitParam.PARAM_KEY_INIT_CAP_KEYS, ConfigUtil.CAP_KEY_NLU_CLOUD_RECOG);
nluInitParam.addParam(NluInitParam.PARAM_KEY_FILE_FLAG, "android_so");
// nluInitParam.addParam(NluInitParam.PARAM_KEY_DATA_PATH, dataPath);
int errCode = HciCloudNlu.hciNluInit(nluInitParam.getStringConfig());
return errCode;
}
/**
* nlu的识别功能
* @param text 要解析的文本
* @param intention 选择的领域信息
*/
public void recog(String text, String intention){
NluConfig nluConfig = new NluConfig();
nluConfig.addParam(NluConfig.SessionConfig.PARAM_KEY_CAP_KEY, ConfigUtil.CAP_KEY_NLU_CLOUD_RECOG);
//如果使用多个领域，可以以分号间隔
nluConfig.addParam(NluConfig.ResultConfig.PARAM_KEY_INTENTION, intention);
Session session = new Session();
int errCode = HciCloudNlu.hciNluSessionStart(nluConfig.getStringConfig(), session);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluSessionStart failed and return " + errCode);
return;
}
NluRecogResult nluRecogResult = new NluRecogResult();
errCode = HciCloudNlu.hciNluRecog(session, text, "", nluRecogResult);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluRecog failed and return " + errCode);
return;
}
errCode = HciCloudNlu.hciNluSessionStop(session);
if (errCode != HciErrorCode.HCI_ERR_NONE) {
Log.e(TAG, "hciNluSessionStop failed and return " + errCode);
return;
}
}
/**
* nlu的反初始化功能
* @return
*/
public int releaseNlu(){
return HciCloudNlu.hciNluRelease();
}
}注：灵云的在线识别功能需要联网才能使用。
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- Android使用有道翻译API实现在线翻译功能
- Android开发，透明指示层、引导层、功能说明层的分享及使用
- Android 使用ViewPager结合PhotoView开源组件实现网络图片在线浏览功能
- Android中使用官方提供好的功能使用说明(比如系统图库获取)，也作为延生学习的学习文档
- 关于Android 使用MediaRecorder实现录制视频开始暂停和结束功能的说明
- 举例说明BroadcastReceiver的使用方法----实现android手机开机之后显示画面的功能
- Android 引导使用说明、标签功能的封装库
- 举例说明如何在android中实现设置黑名单的功能--AudioManager、PhoneStateListener的使用
- Android开发，MapBox的使用及部分功能实现（三）----- 重新理解MapBox
- Android 使用ViewPager结合PhotoView开源组件实现网络图片在线浏览功能
- [转载+实践理解]Android动画---如何正确使用平移动画（关于fillBefore和fillAfter的一点说明）（转载）
- 【Android】灵云在线语音识别使用说明
- ZendStudio调试功能使用说明
- 新视野大学英语在线教学系统使用说明
- 博客园功能使用说明
- 给公司的同学们写的Gmail的账户和导入功能使用说明
- javascript createAdder函数功能与使用说明
- ZendStudio调试功能使用说明
- MY文档管理器V4.0基础功能使用说明
- ZendStudio调试功能使用说明