开发文档
总目录
接入常见问题
开发者平台使用帮助
HTTP API接口文档
Chatbot接口指令说明文档
Android SDK用户接入指南
微信公众号客服机器人接入教程
灵聚智能助理app开源说明文档
直播数字人系统用户评论回复接口开发文档
灵聚自定义对话训练API接口说明文档
本站点使用 MrDoc 构建
-
+
灵聚智能助理app开源说明文档
# 灵聚智能助理app开源说明文档 ## 前言 - 更新记录 |版本号|更新内容|更改人|审批|时间| |---|---|---|---|---| |v1\.0|初稿| | |2017\-07\-05| |v1\.1|新增APP功能结构图、功能指令效果图、源码及APP下载地址| | |2017\-08\-01| |v1\.2|添加有声内容考拉FM来源部分、电话短信 、导航场景指令说明| | |2017\-08\-26| - 源码及APP下载地址 1. [源码](https://github.com/LingjuAI/AssistantBySDK) 2. [APP下载地址](https://dl.lingju.ai/app/灵聚智能助理4.3.1.apk) ## 1\.概述 - 本文档是对广州灵聚信息科技有限公司开发的灵聚智能助理APP(简称:灵聚APP)的说明文档,旨在帮助开发者能快速了解灵聚智能助理的代码结构和功能划分,从而充分利用该APP进行二次开发。 - 灵聚APP是包括语义解析、语音交互、智能问答、音乐播放、提醒、记账等多个功能的智能工具类APP。APP集成的灵聚SDK是其核心依赖库。SDK快速的语义解析、覆盖了多个垂直领域的语义通用场景、百亿数量级大数据,并结合语音交互模块,让开发者能快速开发出一款智能语音交互APP。 - APP功能结构图  **备注:** APP的语音\+日常闲聊对话功能组成了最基本的智能语音助手框架,设置则是APP的一些必备的功能设置。而闹钟提醒备忘记账、电话短信、导航、音乐播放、有声内容等则是独立功能模块,开发者可以根据自身需求进行增减。 ## 2\.开发说明 ### 概要 - 本章节主要向开发者说明APP的开发环境、由签名文件造成的第三方SDK的appkey问题、与robot(灵聚智能引擎)的对话流程以及部分关键类。 ### 2\.1开发环境 - 开发平台:Android Studio 2\.x Gradle 2\.10\+ - 运行平台:Android 4\.0\+ - 开发语言:Java(JDK1\.7\+) ### 2\.2签名文件注意事项 - 由于APP中申请的第三方SDK的appkey与签名文件有关,而APP不提供签名文件,所以用户需要自定义一份签名文件,并根据该文件重新申请第三方SDK的appkey,替换到项目中。具体操作过程如下: #### 1\. 创建签名文件 打开cmd,输入以下指令: ``` keytool -genkey -v -keystore {FILENAME.keystore} -alias {ALIAS} -keyalg RSA -validity {DURATION} * {FILENAME.keystore} 为生成的KeyStore的文件名 * {ALIAS} 为生成的KeyStore文件的别名 * {DURATION} 为该KeyStore文件的过期时间 ``` #### 2\. 修改app/build\.gradle里android\.signingConfigs\.default\_config ``` android { signingConfigs { default_config { keyAlias '你的keyAlias' keyPassword '你的keyPassword' storeFile file('你的keystore文件路径') storePassword '你的storePassword' } } ... } ``` #### 3\. 申请第三方SDK的appkey 需要申请appkey的SDK如下: |第三方SDK|appkey申请地址| |---|---| |灵聚SDK(软件版)|http://dev\.lingju\.ai/| |讯飞语音|[http://www\.xfyun\.cn/index\.php/mycloud/app/create](http://www.xfyun.cn/index.php/mycloud/app/create)| |百度LBS|http://lbsyun\.baidu\.com/apiconsole/key/create| |新浪微博|http://open\.weibo\.com/apps/new?sort=mobile| |腾讯QQ|http://open\.qq\.com/| |微信|https://open\.weixin\.qq\.com/| |喜马拉雅(听书)|http://open\.ximalaya\.com/| - 注意:在申请灵聚SDK的appkey时,创建应用后,在该应用右侧的“接入”选项可查看appkey。  #### 4\. 在项目中替换新申请到的appkey 在app下的com\.lingju\.assistant\.social\.weibo\.Constants类中修改对应常量参数的值。 ``` /** 微博appkey */ String WEIBO_APPKEY = "你的appkey"; /** 微信 */ String WECHAT_APPID = "你的appid"; String WECHAT_AppSecret = "你的appSecret"; /** 腾讯qq*/ String TENCENT_APPID = "你的appid"; String TENCENT_AppSecret = "你的appSecret"; /**讯飞语音*/ String XUNFEI_APPID = "你的appid"; /**喜马拉雅*/ String XIMALAYA_APPKEY = "你的appkey"; String XIMALAYA_APPSECRET = "你的appSecret"; // 授权回调页,默认使用该URL(在开发平台创建应用时也要填入该URL) String XIMALAYA_REDIRECT_URL = "https://api.ximalaya.com/openapi-collector-app/get_access_token"; /** 灵聚SDK*/ String LINGJU_APPKEY = "你的appkey"; ``` - 特别的,百度LBS和喜马拉雅的appkey需要在AndroidManifest\.xml的application标签下声明: ``` <meta-data android:name="com.baidu.lbsapi.API_KEY" android:value="你的appkey"/> <meta-data android:name="app_key" android:value="你的appkey"/> ``` #### 5\. 在项目中替换对应的SDK - 由于讯飞语音应用申请的Appid和对应下载的SDK(包括jar和本地库)具有一致性,SDK不通用。开发者还需要在voicemodule/libs和voicemodule/src/main/jniLibs中替换自己的讯飞SDK。如下图所示:  - 另外,项目是使用了灵聚安卓版软件版(不允许在非手机环境下运行)SDK。如果开发者需要开发硬件产品,需要在灵聚开发者平台创建硬件类型应用,并下载硬件版SDK在voicemodule/libs中替换。如下图所示:  然后在AssistantService类的chatRobotInited\( \)方法的AndroidChatRobotBuilder初始化中加入“授权码”这一参数。  - 在灵聚开发者平台您创建的应用右侧的“接入”选项可查看授权码。  ### 2\.3Robot的对话与处理流程 - 对话是灵聚APP最基本的交互。用户输入文本发送给robot(灵聚智能引擎),robot则针对该输入进行快速分析并作出应答,从而完成一次对话交互。具体过程如下: #### 1\. 用户输入 - 键盘输入。触发MainActivity的sendMsg2Robot\( \)将输入框中的文本发送到APP的调度中心AssistantService,让其发送给robot。 ``` @OnClick(R.id.index_text_send_bt) void sendMsg2Robot() {...} ``` - 语音输入。在VoiceMediator的语音识别结果回调onRecognizeResult\(String\)中获得输入文本,通过VoiceInputListener的onInput\(String\)发送给AssistantService,让其发送给robot。 ``` public void onRecoginzeResult(String result) { ... if (!TextUtils.isEmpty(result) && !"。".equals(result)) { ... //将识别结果发送给机器人 if (inputListener != null) { inputListener.onInput(result); ... } } else { onRecognizeError(ErrorCode.MSP_ERROR_NO_DATA, ""); } } ``` #### 2\. Robot应答 robot对输入文本进行分析处理完毕后,会回调AssistantService\.RobotResponseCallBack的 ``` public void onResult(IChatResult r) { ... processors.get(?).handle(r.cmd(), text, type); ... } ``` 该方法会将robot返回的指令返回至方法中,开发者需在该方法中对应答指令进行分类,然后调用对应类型的Processor的指令处理方法 ``` /** * 处理Robot返回的指令 * * @param cmd 输出指令 * @param text 输出文本 * @param inputType 输入类型 */ public void handle(Command cmd, String text, int inputType); ``` 对指令再进行细分并解析、执行,同时将解析到的回复信息通过EventBus post到前端Activity展示(功能指令处理详见第4章)。 ### 2\.4关键类说明 AssistantService --- 该Service是APP常驻后台的调度中心,用于初始化资源,执行各项控制指令。开发者可以发送AssistantService\.ServiceCmd中定义的各种控制指令 ``` public interface ServiceCmd { /** * 语音设置部分 **/ int START_RECOGNIZE = 1; int STOP_RECOGNIZE = 2; int STOP_WAKEUP_LISTEN = 3; //仅关闭唤醒,不记录 int START_WAKEUP_MODE = 4; //开启唤醒模式,并记录 int CLOSE_WAKEUP_MODE = 5; //关闭唤醒模式,并记录 int STOP_VOICE_MODE = 16; //关闭语音模块(关闭识别、合成、唤醒) int HEADSET_RECOGNIZE = 18; int GET_HOOK = 19; /** * 音乐播放部分 **/ int PAUSE_PLAY = 6; //录音时停止播放 int PLAY_IN_BACKGROUND = 7; int TOGGLE_PLAY = 8; //暂停、播放 int NEXT_MUSIC = 9; //下一首 int CLOSE_PLAY_NOTIFICATION = 10; //关闭通知栏 int SEND_TO_ROBOT_FOR_END_TASK = 11; int SEND_TO_ROBOT = 12; //发送文本给robot ... } ``` 给该Service,而Service可以在 ``` public int onStartCommand(Intent intent, int flags, int startId){...} ``` 接收,提取Intent中携带的指令和信息并执行对应指令操作。同时,该Service还注册了以下几种广播接收者: ``` netWorkChangeReceiver:网络变化广播接收者 scrennReceiver:屏幕变化广播接收者 headSetInReceiver:耳机插拔广播接收者 blueConnectStateBroadcastReceiver:蓝牙设置连接状态广播接收者 smsReceiver:短信接收广播接收者 ``` 开发者可以根据需求在这些接收者中进行某些业务逻辑处理。 #### MainActivity --- 这是APP的主界面,其中嵌套了多个fragment子页面。其中包括: ``` GuideFragment:用户引导页(安装后第一次打开应用时出现) IntroduceFragment:快速入门页(展示应用支持的对话场景并提供了相关例句) PlayerHeaderFragment:头部音乐播放栏 PlayerListPagerFragment:歌曲列表页 ChatListFragment:聊天列表页 VoiceInputFragment:底部语音输入栏 ``` 其布局结构采用了DrawerLayout\+Toolbar\+NavigationView,因此可以通过响应侧边栏的点击事件进入相关功能模块页面。 ``` /* 设置侧边栏item点击监听 */ mNvLeftMenu.setNavigationItemSelectedListener(new NavigationView.OnNavigationItemSelectedListener() { ... }); ``` #### ChatListFragment,ChatListAdapter --- 由于需要进行多种场景的对话交互,所以ChatListFragment主要用于接收不同场景类型Processor发送过来的事件并提取回复信息进行展示。 ``` /** 接收聊天信息事件 */ public void addMessage(ChatMsgEvent msg){...} /** 接收语音合成动画事件 */ public void onSynthesizeEvent(SynthesizeEvent event){...} /** 接收闹钟状态变化事件 */ public void onAlarmSwitchEvent(AlarmStateEvent e){...} /** 接收拨号、发短信倒计时事件 */ public void onSeekBarUpdateEvent(UpdateWaittingSeekBarEvent e){...} /** 接收无限时录音结果事件 */ public void onLongRecordEvent(LongRecognizeEvent e){...} /** 接收刷新任务卡事件 */ public void refreshTaskCard(UpdateTaskCardEvent e){...} ``` 而ChatListAdapter则是聊天列表RecylerView的数据适配器,包含了以下几种视图类型: ``` /** 用户输入文本视图 */ private static final int REQ_VIEW = 0; /** 机器人回复文本视图 */ private static final int RESP_VIEW = 1; /** 提醒卡片视图 */ private static final int REMIND_CARD_VIEW = 2; /** 备忘卡片视图 */ private static final int MEMO_CARD_VIEW = 7; /** 闹钟卡片 */ private static final int ALARM_CARD_VIEW = 8; /** 账单卡片 */ private static final int ACCOUNTING_CARD_VIEW = 9; /** 电话短信视图 */ private static final int CALL_AND_SMS_VIEW = 10; /** 系统提示视图 */ private static final int SYS_TIPS_VIEW = 3; /** 备忘添加模式视图 */ private static final int MEMO_APPEND_VIEW = 4; /** 任务记录列表视图 */ private static final int CARD_LIST_VIEW = 5; /** 空视图,修正列表位置 */ private static final int EMPTY_VIEW = 6; /** 专辑列表视图 */ private static final int TING_ALBUM_VIEW = 11; /** 播放专辑视图 */ private static final int TING_PLAY_VIEW = 12; ``` 负责显示相应类型的视图,以及视图中的按键交互。 #### VoiceMediator --- 包含语音识别、合成、唤醒的语音控制器。主要包含了识别、合成过程的回调以及识别、唤醒的开关和合成的关闭等语音控制方法。 ``` /** 无限时识别结果回调,该模式下不需要将识别文本作为对话发送给robot */ public void onLongRecoginzeResult(String) /** 识别开始回调 */ public void onRecoginzeBegin() /** 识别时声音变化回调 */ public void onRecoginzeVolumeChanged(int) /** 识别结果回调 */ public void onRecoginzeResult(String) /** 识别出错回调 */ public void onRecognizeError(int, String) /** 合成初始化回调 */ public void onSynthesizerInited(int) /** 合成出错回调 */ public void onSynthesizerError(String) /** 识别开关 */ public void startRecognize() public voidstopRecognize() /** 进入/退出唤醒模式 */ public void setWakeUpMode(boolean flag) /** 打开唤醒 */ public void startWakeup() /** 停止唤醒 */ public void stopWakenup() /** 合成关闭 */ public void stopSynthesize() ``` #### LingjuAudioPlayer --- 音频播放控制器,与PlayerHeaderFragment、PlayerListPagerFragment结合对音乐播放模块进行播放控制和视图交互。 ## 3\.依赖库 ### 3\.1 灵聚SDK - 灵聚SDK是一套集语义解析、智能处理以及提供业务接入于一体的通用型SDK。为智能机器人、智能硬件类产品提供良好的人机自然交互能力,具有拟人化智能与思维能力。 #### 初始化 --- 调用AndroidChatRobotBuilder\.create\( \)设置各项参数,初始化灵聚智能引擎,及聊天机器人类ChatRobot的实例。 ``` AndroidChatRobotBuilder.create(Context, "appkey") .setMusicContext(musicContext) .setLocationAdapter(locationAdapter) .setNetworkAdapter(networkAdapter) .build(new ChatRobotBuilder.RobotInitListener() { @Override public void initComplete(int i) { if (i == 0) { //初始化成功 chat = AndroidChatRobotBuilder.get().robot(); if (AppConfig.NewInstallFirstOpen) //合并(更新)服务器数据 mergeServerData(); } } }); ``` 初始化参数说明: - appkey:本项目对于SDK的唯一标识,可到[灵聚开发者平台](http://open.lingju.ai)注册申请。 - MusicContext:音乐播放的上下文接口,该接口允许用户点播本地的歌曲及更智能地进行音乐播放的语音交互,如开发者无此需求则无需传入。 - LocationAdapter:定位适配,实时读取设备当前的位置,用于支持周边POI查询,出行查询,天气查询等,不传入则这一系列查询均无法正常使用。 - NetworkAdapter:网络监听适配,实时读取设备当前的网络状态,用于实时切换在线及离线引擎。 #### 对话 --- - 问题输入,使用IChatRobot的 ``` void process(String var1, ResponseCallBack var2) ``` 可向robot发送对话。 - 应答输出,在ResponseCallBack的 ``` public void onResult(IChatResult r) ``` 可获得robot的应答回复。 #### 数据同步更新上传操作(可选操作) --- - 数据同步更新上传是针对备忘、提醒、闹钟、记账、录音等功能的数据操作,对这些功能生成的对应的备忘数据、提醒数据、闹钟数据、记账数据、录音数据的新建、删除、修改、查询操作时需要将本地的数据与服务端的数据同步。备忘、提醒、闹钟、记账、录音在sdk中定义了相应的实体类,分别为MemoEntity、RemindEntity、AlarmClockEntity、BillEntity、TapeEntity。这些实体类都继承自SyncSegment。 SyncSegment中包含的同步属性(**本地记录上传时必须提供**)如下所示: ``` /** 服务端对应记录的ID */ protected String sid; /** 本地记录的ID */ protected int lid; /** 时间戳(服务端返回),版本号 */ protected long timestamp; /** 回收状态,0=可用,1=回收站 */ protected int recyle; /** 是否已经同步 */ protected transient boolean synced; ``` **同步更新上传示例:以提醒为例** 1. 定义一个类实现同步接口:interface SyncDao ``` /** * 提醒动作对象同步操作Dao实现 **/ public class RemindEntityDao implements SyncDao<RemindEntity> { @Override public int getTargetId() { //targetId:动作对象id,提醒(RemindEntity)为308。 return RobotConstant.ACTION_REMIND; } /** * 获取目前对象的实体类 */ @Override public Class<RemindEntity> getTargetClass() { return RemindEntity.class; } /** * 获取本地记录中最大的同步时间戳 */ @Override public long getLastTimestamp() { long t = 0; Remind remind = 以timestamp倒序排列,查找数据库第一条提醒记录; if (remind !=null) t = remind.getTimeStamp(); return t; } /** * 合并服务端的数据,合并策略(永远以服务端数据为优先): * 1.本地含有相同lid的记录:覆盖合并到本地记录; * 2.本地没有相同lid的记录,插入本地记录; * @return true:合并成功,false:SDK将会调用{@linkplain SyncDao#mergeServerData(List) mergeServerData(List)}处理 */ @Override public boolean mergeServerData(JsonArray jsonArray) { System.out.println("Remind mergeServerData>>" + jsonArray); return false; } /** * 合并服务端的数据,合并策略(永远以服务端数据为优先): * 1.本地含有相同lid的记录:覆盖本地记录; * 2.本地没有相同lid的记录,插入本地记录; * @param data * @return true:合并成功 */ @Override public boolean mergeServerData(List<RemindEntity> list) { if (list != null && list.size() > 0){ //TODO 第一步:本地合并服务端返回的数据 //第二步:由于服务器端一次最多只能合并100条数据,合并数据后需要再递归请求数据刷新,保证所有云端数据合并完毕 AndroidChatRobotBuilder.get().robot().actionTargetAccessor().syncUpdate(this); } return true; } /** * 查询未同步的本地记录 * @param size 返回的最大长度 * @return */ @Override public List<RemindEntity> getUnSyncLocalData(int size) { List<RemindEntity> list = new ArrayList<>(); //TODO 获取数据库所有记录,并将synced = false(未同步)的记录加入list中; //注意:由于服务器端有记录上传限制,所以list的最大容量建议<= 500。 return list; } /** * 查询未同步的本地记录的总数 * @return */ @Override public int getUnsyncLocalDataCount() { int c = 获取数据库中synced = false(即未同步)的记录总数; return c; } /** * 查询未同步的本地记录 * @param size 返回的最大长度 * @return null:SDK将会调用{@linkplain SyncDao#getUnSyncLocalData() getUnSyncLocalData()}查询 */ @Override public JsonArray getUnSyncLocalDataAsJsonArray(int size) { return null; } } ``` 1. 在需要同步的地方调用同步方法:ActionTargetAccessor类的 boolean sync\(SyncDao var1\); 例如,本地删除提醒记录(建立同步机制后,删除并非直接清除该记录,而是设置删除标记表示已删除)① 设置删除标记和待同步标记,保存记录(delRemind:要删除的提醒对象) ``` //synced:同步标记(true 已同步 false 待同步) delRemind.setSynced(false); //recyle:删除标记(0 有效记录 1 已删除记录) delRemind.setRecyle(1); //TODO 保存delRemind对象到本地数据库中,update方法需开发者实现 update(delRemind); ``` ② 本地保存后需更新同步到云端 ``` //同步方法,注意mRemindEntityDao所有查询相关的方法必须能够查询到最新状态的记录,否则该同步方法将失败 AndroidChatRobotBuilder.get().robot().actionTargetAccessor().sync(mRemindEntityDao); ``` ### 3\.2 voicemodule(语音模块) - voicemodule是app的外部依赖Module,包含有语音识别、合成、唤醒三大功能。灵聚APP当前使用的语音SDK是讯飞语音。 #### RecognizerBase:语音识别器(实现类:IflyRecognizer) --- 基类RecognizerBase定义了语音识别需要的基本通用方法(作用:当开发者想要替换语音SDK时,只需另外定义一个实现类实现这些方法即可,而不需要替换整个voicemodule),而实现类IflyRecognizer则是对讯飞语音识别的封装,并实现基类定义的方法。其中IflyRecognizer的两个变量long\_record\_mode,long\_time\_record控制着语音的识别模式。 |long\_record\_mode|long\_time\_record|识别模式| |---|---|---| |\-1(默认)|false(默认)|讯飞正常识别,本地不录音,不保存录音文件| |0(CREATE\_MEMO\_MODE)|true|无限时音频流识别,本地录音,不保存录音文件| |1(MODIFY\_MEMO\_MODE)|true|无限时音频流识别,本地录音,不保存录音文件| |2(DEFAULT\_TAPE)|true|讯飞正常录音,本地录音,保存录音文件| |3(LONG\_TAPE)|true|无限时音频流识别,本地录音,保存录音文件| 变量设置方法如下: ``` //设置long_record_mode public void setLong_record_mode(int) //设置long_time_record public void setRecognizeMode(boolean) ``` #### SynthesizerBase:语音合成器(实现类:IflySynthesizer) --- 基类和实现类的作用同上,不一样的是IflySynthesizer的语音合成方法是使用了RxJava的。其好处是使得语音合成在一个独立的线程进行,方便控制和管理,且不阻塞主线程。语音合成示例: ``` SpeechMsgBuilder builder = SpeechMsgBuilder.create("合成文本"); /*可选设置,设置合成后执行的语音动作 (SpeechMsg.CONTEXT_KEEP_RECOGNIZE:合成后自动开启识别 SpeechMsg.CONTEXT_KEEP_AWAKEN:合成后自动试图打开唤醒) */ //builder.setContextMode(SpeechMsg.CONTEXT_KEEP_RECOGNIZE); //合成声音 SynthesizerBase.get().startSpeakAbsolute(builder.build()) .doOnNext(new Consumer<SpeechMsg>() { @Override public void accept(SpeechMsg speechMsg) throws Exception { if (speechMsg.state() == SpeechMsg.State.OnBegin) { //发送合成动画开始事件 EventBus.getDefault().post(new SynthesizeEvent(SynthesizeEvent.SYNTH_START)); } } }) .doOnComplete(new Action() { @Override public void run() throws Exception { //发送合成动画结束事件 EventBus.getDefault().post(new SynthesizeEvent(SynthesizeEvent.SYNTH_END)); } }) .subscribeOn(Schedulers.io()) .observeOn(Schedulers.computation()) .subscribe(); ``` - SpeechMsgBuilder:合成信息建造者,包含了合成信息对象以及合成信息的来源、优先级、合成后动作等设置。 #### WakeupEngineBase:语音唤醒器(实现类:VoiceAwakener ) --- 特别的,唤醒属于讯飞语音的定制服务,需要开发者在[讯飞开放平台](http://www.xfyun.cn/services/awaken?type=awaken)购买服务并定制唤醒词。然后将讯飞SDK开发包的\\res\\ivw\\路径下的唤醒资源文件引入到 \\voicemodule\\src\\main\\assets\\ivw\\ 中,将讯飞appid填入\\voicemodule\\src\\main\\res\\values\\strings\.xml的app\_id中。如下图所示:   然后,通过语音控制类的VoiceMediator的 ``` /** 进入/退出唤醒模式 */ public void setWakeUpMode(boolean flag) /** 打开唤醒 */ public void startWakeup() /** 停止唤醒 */ public void stopWakenup() ``` 可以对语音唤醒进行控制。 ### 3\.3 lbsmodule(导航模块) 暂未开放 ### 3\.4 EventBus - EventBus是一款针对Android优化的发布/订阅事件总线。以观察者模式实现,用于简化程序的组件、线程通信,可以轻易切换线程、开辟线程。在APP的项目中,大量使用了EventBus进行Android组件间的数据传递。 以识别动画刷新事件为例: 1. 发送事件 ``` //开始识别时,发送RecordUpdateEvent.RECORDING EventBus.getDefault().post(new RecordUpdateEvent(RecordUpdateEvent.RECORDING)); //刚结束说话,讯飞仍未返回识别结果时,发送RecordUpdateEvent.RECOGNIZING EventBus.getDefault().post(new RecordUpdateEvent(RecordUpdateEvent.RECOGNIZING)); //识别结束,发送RECORD_IDLE_AFTER_RECOGNIZED EventBus.getDefault().post(new RecordUpdateEvent(RecordUpdateEvent.RECORD_IDLE_AFTER_RECOGNIZED)); ``` 1. 接收事件(此处是在VoiceInputFragment接收,还有其他地方接收该事件) ``` //处理识别动画刷新事件 public void onRecordUpdate(RecordUpdateEvent e){ switch (e.getState()) { case RecordUpdateEvent.RECORD_IDLE: case RecordUpdateEvent.RECORD_IDLE_AFTER_RECOGNIZED: voiceBt.setRecordIdleState(); mFbviTextInputBt.setVisibility(View.VISIBLE); mFvbiManualBt.setVisibility(View.VISIBLE); break; case RecordUpdateEvent.RECORDING: ((MainActivity) getActivity()).closeSlidingMenu(); ((MainActivity) getActivity()).scroll2LastPosition(); //判断是否展示话筒的波纹效果 boolean isShow = AppConfig.dPreferences.getBoolean("wave_show", true); if (isShow) { mFbviTextInputBt.setVisibility(View.GONE); mFvbiManualBt.setVisibility(View.GONE); voiceBt.setRecordStartState(); } break; case RecordUpdateEvent.RECOGNIZING: voiceBt.setRecognizeCompletedState(); break; } } ``` - 由于EventBus强解耦的特性,对数据的发送和接收都较难维护管理。因此在项目中,需要使用EventBus传递的数据都定义一个事件对象来封装,并且将所有事件都放在同一包下。项目中已定义的事件如下图所示:  ### 3\.5 其他 - 在项目中,除了EventBus,还有RxJava、GreenDao和ButterKnife这3个库被频繁使用。 #### RxJava --- - 在项目中,IflySynthesizer、LingjuAudioPlayer均使用了RxJava对业务方法进行了封装,而对于网络请求、加载数据库数据等耗时操作同样使用了RxJava进行子/主线程的线程切换。 以加载闹钟记录为例: ``` private void loadData() { Flowable.create(new FlowableOnSubscribe<Object>() { @Override public void subscribe(FlowableEmitter<Object> e) throws Exception { reset(); //TODO io线程加载数据库数据 ... e.onNext(0); } }, BackpressureStrategy.BUFFER) .subscribeOn(Schedulers.io()) //执行订阅(subscribe())所在线程 .doOnSubscribe(new Consumer<Subscription>() { @Override public void accept(Subscription subscription) throws Exception { //显示加载进度条 mCpbLoad.setVisibility(View.VISIBLE); } }) .subscribeOn(AndroidSchedulers.mainThread()) .observeOn(AndroidSchedulers.mainThread()) //响应订阅(Sbscriber)所在线程 .subscribe(new Consumer<Object>() { @Override public void accept(Object o) throws Exception { /* 回到主线程,隐藏进度条,刷新列表 */ mCpbLoad.setVisibility(View.GONE); mAdapter.notifyDataSetChanged(); } }); } ``` #### GreenDao --- - GreenDao是一个简化SQLite数据库创建和维护的轻量级的库。完成初始化配置之后只需要通过注解即可建表,通过该库提供的增删该查方法即可一句话操作数据库。 - 项目中创建的记录实体类放在com\.lingju\.model包下,而对应的数据操作对象则放在com\.lingju\.model\.dao包下。 以闹钟记录为例: 1. 新建一个实体类使用@entity设置表名和@Id设置主键ID ``` @Entity(nameInDb = "t_alarm") public class AlarmClock { @Id(autoincrement = true) private Long id; private int rtime; private int frequency; private int valid; private String ring; private String path; private Date created; private String item; //闹钟类型 private boolean repeat; //是否重复 private Date rdate; //以下与服务器同步标记 private String sid; //服务器记录id,该记录的唯一标示 private long timestamp; //时间戳,记录的时效性标记 private int recyle; //0:有效, 1:回收 private boolean synced = true; //false表示未同步,待更新 } ``` 1. 定义完该类并封装好属性后,Rebuild Project即可完成数据库表的创建。  1. 创建dao,封装数据访问方法 ``` //获取闹钟dao对象 mClockDao = DaoManager.get().getDaoSession().getAlarmClockDao(); /** * 插入一条闹钟记录 **/ public boolean insertAlarm(AlarmClock alarm) { if (alarm.getId() != null) alarm = findAlarmById(alarm.getId()); alarm.setRecyle(0); return mClockDao.insertOrReplace(alarm) > 0; } /** * 删除一条闹钟记录 **/ public void deleteAlarm(AlarmClock alarm) { alarm = findAlarmById(alarm.getId()); alarm.setRecyle(1); mClockDao.update(alarm); } /** * 修改一条闹钟记录 **/ public void updateAlarm(AlarmClock alarm) { AlarmClock realAlarm = findAlarmById(alarm.getId()); alarm.setTimestamp(realAlarm.getTimestamp()); alarm.setRecyle(0); mClockDao.update(alarm); } /** * 查询所有闹钟记录 **/ public List<AlarmClock> findAllAlarm() { return mClockDao.queryBuilder().where(AlarmClockDao.Properties.Recyle.eq(0)).list(); } ``` #### ButterKnife --- - ButterKnife是专门为Android View设计的绑定注解,专业解决各种findViewById和setOnClickListener。建议与AS插件Android ButterKnife Zelezny配合使用,大大省略了上述两种问题的无意义的代码编写时间。 以MainActivity为例: ``` public class MainActivity extends BaseActivity implements IAdditionAssist.AssistView { @BindView(R.id.index_text_editext) EditText editText; @BindView(R.id.index_bottom_box) FrameLayout bottomBox; @BindView(R.id.index_body) FrameLayout body; @BindView(R.id.index_chat_list_box) FrameLayout bodyChatList; @BindView(R.id.main_content_box) FrameLayout mMainContentBox; @BindView(R.id.index_text_input_box) LinearLayout mIndexTextInputBox; @BindView(R.id.fl_guide) FrameLayout mFlGuide; ... @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); //资源绑定 ButterKnife.bind(this); ... } //监听器绑定 @OnClick(R.id.index_text_send_bt) void sendMsg2Robot() { ... } } ``` 注意,在非Activity中使用绑定要使用ButterKnife\.bind\(Object, View\);多个点击监听绑定使用@OnClick\(\{resId, resId, resId\.\.\.\}\)。 ## 4\.功能指令实现 ### 概要 - 本章节主要向开发者说明不同类型的Processor对接收到的robot返回的应答指令(指令的格式和内容详见[聊天接口指令说明文档](/project-2/doc-8/#h2-聊天接口指令说明文档)进行解析和执行的过程。 - **应答指令对象Command的属性解释** |属性|数据类型|释义| |---|---|---| |rtext|String|回复文本| |synthetise|JsonArray|应答文本发音人信息| |ttext|String|robot提示语文本| |outc|int|输出语音控制码| |motions|JsonArray|AI动作集合| |actions|JsonArray|语义对象集合| ### 4\.1闲聊功能 - 闲聊功能包括有听新闻、问天气、讲笑话、问答游戏、以及闲聊百科等多个场景的应答回复。其对应的处理器是DefaultProcessor。 回复指令内容如下: ``` 输入:你好。 输出: { "actions": [], "motions": [ { "index": 4, "level": 1, "motion": 10002 }, { "index": 10, "level": 1, "motion": 30002 } ], "outc": "0", "rtext": "你好,有什么可以帮到你呢?", "synthetise": "", "ttext": "" } ``` - 页面效果图:    - 在该Processor中,基本只要将应答指令对象中的回复文本发送到前端ChatListFragment展示即可。特别的,需要判断outc(输出语音控制码)的值并进行对应设置。 ``` if ((cmd.getOutc() & OUTC_ASK) == OUTC_ASK) { //合成后自动开启识别 builder.setContextMode(SpeechMsg.CONTEXT_KEEP_RECOGNIZE); } else if ((cmd.getOutc() & OUTC_SYNTHESIZE_PRIORITY) == OUTC_SYNTHESIZE_PRIORITY) { //加权合成朗读,即使rtext合成被打断,打断后仍需朗读 builder.setPriority(SpeechMsg.PRIORITY_ABOVE_RECOGNIZE); } ``` - 同时,还要判断synthetise(发音人信息)是否有值。如果有,则需要进行变声处理。 ``` if (!TextUtils.isEmpty(cmd.getSynthetise())) { //(针对讲笑话)变声 synthesizer.setForceLocalEngine(false); try { responseMsg = new ResponseSetionsMsg(text); ((ResponseSetionsMsg) responseMsg).setSetions(new JSONArray(cmd.getSynthetise())); builder.setSections(((ResponseSetionsMsg) responseMsg).getSetions()); } catch (JSONException e) { e.printStackTrace(); } } ``` ### 4\.2音乐播放功能 - 音乐播放功能模块包含播放在线、收藏、本地歌曲、播放控制、音量调节等功能, 其对应的处理器是MusicPlayProcessor。由于灵聚提供的歌曲资源仅供演示(不对外提供),所以开发者需要接入第三方歌曲库。回复指令内容如下: ``` 输入:放首歌 开发者通用输出: { "actions": [ { "action": "QUERY", "target": { "id": 100, "recyle": 0, "release": 0, "type": "歌曲" } }, { "action": "SET", "target": { "control": "PLAY", "id": 300, "origin": "QUERY", "type": "AUDIO" } } ], "outc": "0", "rtext": "好的", "synthetise": "", "ttext": "" } 语义解析:查询(action1:“QUERY”)音频(动作id=100,type:“歌曲”),然后播放(control:“PLAY”)查询("origin": "QUERY")获得的歌曲。 ------------------------------------------------------------ 灵聚内部音乐场景输出: { "actions": [ { "action": "SET", "target": { "control": "PLAY", "id": 300, "object": [ ... ], "origin": "AUTO", "type": "AUDIO" } } ], "outc": "0", "rtext": "马上播放Twins的Talk To Me", "synthetise": "", "ttext": "" } 语义解析:播放(action:“PLAY”)灵聚提供("origin": "AUTO",)的(object中的)歌曲。 ``` - 页面效果图:   **应答指令属性说明** - control:播放控制,包括PLAY、PAUSE、RESUME、NEXT、PRE等。 - object:播放音频信息对象集合 - origin: 播放音频来源,QUERY(第三方库查询来源)、AUTO(灵聚在线来源)、LOCAL(本地来源)、COLLECT(收藏来源) --- - 开发者通过解析如上所示的应答内容,细分其中的动作指令,并结合音频播放器(LingjuAudioPlayer)即可执行对应动作,完成对话交互。 ### 4\.3音频文件操作及语音设置功能 - 该模块主要包含歌曲(取消)收藏,切换英文识别、变声、录音等语音引擎设置,其对应的处理器是MusicOptProcessor。开发者先通过动作对象id区分歌曲收藏操作还是语音引擎设置,然后根据action指令或动对象信息细分具体操作。 - 以收藏歌曲为例(最后一个action为目的动作): ``` 输入:收藏这首歌 输出: { "actions": [ { "action": "QUERY", "get": { "property": "object", "type": "VALUE" }, "size": 1, "target": { "id": 300, "type": "AUDIO" } }, { "action": "INSERT", "target": { "collected": 1499242633095, "collectobject": { "id": 300, "type": "AUDIO" }, "id": 305 } } ], "motions": [ ... ], "outc": "0", "rtext": "好的", "synthetise": "", "ttext": "" } 语义解析:收藏(动作id=305,action指令:“INSERT”)一个播放器(动作id=300)中的音频(type:“AUDIO”)。 ``` - 页面效果图:  - 语音引擎设置,以变声为例: ``` 输入:换个声音 输出: { "actions": [ { "action": "SET", "target": { "id": 311, "language": "CHINESE", "role": "RANDOM", "type": 1 } } ], "motions": [ ... ], "outc": "0", "rtext": "好的", "synthetise": "", "ttext": "" } 语义解析:语音引擎设置(动作id=311),随机(role:“RANDOM”)选择一个声音,永久(type=1)切换。 ``` - 页面效果图:  ### 4\.4提醒、闹钟、备忘、记账功能 - 该功能模块主要包含提醒、闹钟、备忘、记账四个功能,这四个功能都拥有新建、删除、撤销、修改、查询、播报操作,其对应的处理器是AssistProcessor和AssistPresenter。 - 开发者可以根据robot应答内容中的动作id区分是哪个功能,然后通过action指令确定是什么操作。 以闹钟为例: ``` 输入:中午12点半叫我起床 输出: { "actions": [ { "action": "CREATE", "target": { "created": 1499221259243, "frequency": 0, "id": 309, "item": "闹钟", "recyle": 0, "remindTime": 1499229000200, "scheduler": [ { "interval": 0, "when": 1499229000200 } ], "sid": "595c4d0bb2765b718de3cfb9", "terminalId": "df28f1f276ba5baa9d51d8d066bb61c1", "timestamp": 1499221259243, "valid": 1 } } ], "motions": [ ... ], "outc": "0", "rtext": "好的,中午12点半叫您", "synthetise": "", "ttext": "删除这个闹钟/改为下午3点/将工作日改为周末/念一下/关闭这个闹钟" } 语义解释:新建(action指令:CREATE)一个时间是12:30(when=1499229000200)且仅一次(interval=0)的闹钟(动作id=309)。 ``` - 页面效果图:   - 特别的,新建备忘时,需要将语音识别切换到无限时识别模式,进行长时间的备忘内容录入。并且在取消或完成备忘创建时,需要切换回讯飞正常识别模式,保证后续对话正常。AssistPresenter中设置识别模式的方法如下: ``` /** * 参数设置参照第3.2节-语音识别模块 */ public void switchRecordMode(boolean mode, int long_record_mode) ``` - 数据同步说明,在本功能模块主要是进行某个功能数据的增删改查操作。如果是对话发起,则是robot服务器端先进行数据的更新,然后再回复客户端,此时客户端只需显示视图并更新数据,不需要同步;而如果是通过视图手动触发操作,则是本地客户端先进行数据的更新,此时服务器端尚未得知数据已更新,所以需要同步上传,通知服务器端更新数据(具体同步上传操作见第 3\.1 节\-数据同步更新上传操作)。 ### 4\.5有声内容播放功能 - 有声内容播放功能与音乐播放类似,但其播放的不是歌曲,而是小说、相声、脱口秀、段子等有声音频。播放的处理器是TingPlayProcessor,而播放控制则在MusicPlayProcessor。开发者可以在[灵聚开发者平台](http://dev.lingju.ai)选择该场景的播放来源。若选择考拉FM则需要开发者自行到考拉FM开放平台申请appid、appSceret等,并将这些信息填入如下图所示的输入框中。    - 对接第三方资源 APP当前接入的第三方资源是喜马拉雅,因此需要开发者申请对应的appkey(见第 2\.2 节)。对话回复内容如下: ``` 输入:播放岳云鹏的相声 输出: { "actions": [ { "action": "QUERY", "target": { "id": 100, "recyle": 0, "release": 0, "singer": [ "岳云鹏" ], "type": "相声" } }, { "action": "SET", "target": { "control": "PLAY", "id": 300, "origin": "XIMALAYA", "type": "AUDIO" } } ], "motions": [ ... ], "outc": "1", "rtext": "好的", "synthetise": "", "ttext": "" } 语义解析:查询(action1:“QUERY”)singer是岳云鹏、type是相声的音频(动作id=100), 然后播放(action2的control:PLAY),来源是喜马拉雅(origin: “XIMALAYA“)。 ``` - 考拉FM ``` 输入:播放脱口秀 输出: { "actions": [ { "action": "VIEW", "target": { "albumId": 1100000000747, "coverUrl": "http://img.kaolafm.net/mz/images/201412/57027d68-bd12-45b1-97a3-d92daf5549a4/default.jpg", "episode": 1506, "hot": 109865766, "id": 316, "lastAudio": { "album": "1100000000747", "audioPic": "http://img.kaolafm.net/mz/images/201412/57027d68-bd12-45b1-97a3-d92daf5549a4/default.jpg", "created": 1503676800000, "duration": 293340, "episode": 1506, "id": 100, "musicId": "1000010006940", "name": "【七夕特别节目】请你过一个有烛光的情人节吧", "recyle": 0, "url": "http://image.kaolafm.net/mz/aac_32/201708/ab30ba30-57e0-4c04-b68d-77ce626078da.aac" }, "name": "情感治愈系", "recyle": 0, "singer": "寒霜", "tag": "情感 治愈 暖心故事 励志 寒霜" } }, ... ], "outc": 1, "rtext": "我帮你找到了一些专辑", "ttext": "第一个/第二个" } 语义解析:展示(action=“VIEW”)找到的多个专辑(动作id=316),并选择播放第几个。 ``` - 页面效果图:   ### 4\.6电话短信功能 - 电话短信功能包括语音拨号、短信编辑和发送以及来电、来信播报等,其对应的处理器是MobileCommProcessor和CallAndSmsPresenter。回复指令内容如下: - 打电话 ``` 输入:打电话给xxx 输出: { "actions": [ { "action": "CALL", "target": { "code": "136xxxxxx72", "handsFree": false, "id": 319, "name": "xxx" } } ], "outc": "0", "rtext": "明白,正在呼叫xxx。说取消或者连续摇晃手机可以取消拨打", "synthetise": "", "ttext": "说取消或者连续摇晃手机可以取消拨打" } 语义解析:呼叫(action="CALL")xxx,号码是136xxxxxx72。 ``` - 发短信 ``` 输入:发短信给xxx 输出: { "actions": [ { "action": "CREATE", "target": { "code": "136xxxxxx72", "content": "", "id": 320, "name": "xxx" } } ], "outc": "1", "rtext": "好的,发给xxx。你要对他说什么", "synthetise": "", "ttext": "告诉他早点回家/今晚回家吃饭" } 语义解析:新建(action="CREATE")短信(id=320),内容(content)是"",收件人是xxx,号码是136xxxxxx72。 ``` - 页面效果图:    - 而来电、来信播报则需要在设置页面中打开相关设置才能生效。如下图所示:  ### 4\.7导航功能 导航功能则包括出发点、途经点、终点的设置,以及路线规划、路线切换、导航中询问路况等功能,其对应的处理器是NaviProcessor。回复指令内容如下: - 以发起导航的任务流为例: ``` 输入:导航去白云山 输出: { "actions": [ { "action": "VIEW", "target": { "data": [ "白云山(山坡的山)", "白云尚(高尚的尚)" ], "id": 310, "label": "请选择一个地点", "type": "SINGLE" } } ], "outc": "1", "rtext": "我找到了2个同音的地点,第1个,白云山(山坡的山),第2个,白云尚(高尚的尚)。请选择一个地点", "synthetise": "", "ttext": "第一个/第二个" } 语义解析:以单项(type="SINGLE")对话框(id=310)的形式展示(action="VIEW")同音选点。 输入:第一个 输出: { "actions": [ { "action": "SELECT", "target": { "city": "广州市", "detailedaddress": "广园中路801号", "id": 325, "latitude": 23.186097, "longitude": 113.304073, "name": "白云山", "recyle": 0, "streetid": "550fd5f9e7230b04921fc9b2", "uid": "550fd5f9e7230b04921fc9b2" } }, ... ], "outc": "1", "rtext": "我找到了9个相关地点,第一个是白云山(广园中路801号)。你要去第几个呢?", "synthetise": "", "ttext": "第一个/第二个" } 语义解析:在多个相关地点(id=325)中选择(action="SELECT")一个作为终点。 输入:第一个 输出: { "actions": [ { "action": "QUERY", "target": { "endaddress": { "city": "广州市", "detailedaddress": "广园中路801号", "id": 325, "latitude": 23.186097, "longitude": 113.304073, "name": "白云山", "recyle": 0, "streetid": "550fd5f9e7230b04921fc9b2", "uid": "550fd5f9e7230b04921fc9b2" }, "id": 324, "recyle": 0, "type": "DRIVELIEN" } } ], "outc": "1", "rtext": "已为你规划路线,如需要其他路线请告诉我", "synthetise": "", "ttext": "" } 语义解析:查询(action="QUERY")终点为endaddress的驾车(type="DRIVELIEN")导航的路线(id=324)。 输入:开始导航 输出: { "actions": [ { "action": "SET", "target": { "id": 323, "status": "CONTINUE" } } ], "outc": "0", "rtext": "导航继续", "synthetise": "", "ttext": "" } 语义解析:开始/继续(status="CONTINUE")导航(id=323)。 ``` - 页面效果图:     ## 5\.UI设置 - 在项目中,对UI的控件大小、颜色、背景样式做了一些定义,在app/src/main/res目录下。以下是一些常用的UI设置值。 1. 大小(\.\./values/dimens\.xml) ``` <dimen name="resp_stroke_width">2dp</dimen> <dimen name="mini_margin">4dp</dimen> <dimen name="smaller_margin">6dp</dimen> <dimen name="base_margin_padding">8dp</dimen> <dimen name="dialog_margin">10dp</dimen> <dimen name="small_margin">12dp</dimen> <dimen name="normal_margin">16dp</dimen> <dimen name="large_margin">24dp</dimen> <dimen name="bigger_margin">32dp</dimen> <dimen name="dialog_left_right_margin">36dp</dimen> <dimen name="call_item_height">40dp</dimen> <dimen name="biggest_margin">48dp</dimen> <dimen name="item_height">56dp</dimen> <dimen name="item_chatlist_margin">80dp</dimen> <dimen name="dialog_normal_width">280dp</dimen> <dimen name="design_navigation_icon_size">20dp</dimen> <dimen name="mini">10sp</dimen> <dimen name="smaller">12sp</dimen> <dimen name="md_small">13sp</dimen> <dimen name="small">14sp</dimen> <dimen name="regular">15sp</dimen> <dimen name="medium">16sp</dimen> <dimen name="md_big">17sp</dimen> <dimen name="big">18sp</dimen> <dimen name="bigger">22sp</dimen> <dimen name="large">24sp</dimen> <dimen name="biggest">32sp</dimen> <dimen name="small_title_size">21sp</dimen> ``` 1. 颜色(\.\./values/color\.xml) ``` //主色 <color name="base_blue">#33A868</color> <color name="bar_color">#FF128446</color> <color name="base_blue_translucent">#a033A868</color> <color name="base_blue_qtr_transparent">#4033A868</color> //辅主色 <color name="second_base_color">#FFA300</color> //字体颜色 <color name="new_text_color_first">#DD000000</color> //字体辅色 <color name="new_text_color_second">#8A000000</color> //黑色下划线 <color name="new_line_black_border">#1f000000</color> <color name="new_line_white_border">#1fFFFFFF</color> <color name="status_bar_bg">#33000000</color> <color name="forbid_click_color">#61000000</color> <color name="input_bg">#3AC077</color> <color name="progressbar_bg">#E2F5EA</color> <color name="progressbar_progress">#8ADBAE</color> <color name="progressbar_thumb_first">@color/progressbar_progress</color> <color name="progressbar_thumb_second">#808ADBAE</color> <color name="sliding_menu_bg">#373E39</color> ``` 1. 背景样式(\.\./drawable、\.\./drawable\-v21) ① drawable |引用文件|释义| |---|---| |account\_btn\.xml|主色弧角背景| |circle\_translucent\_bg\.xml|圆形主色半透明背景| |white\_oval\_bg\.xml\.xml|圆形白色背景| |green\_et\_border\.xml|白黄下划线selector| |seekbar\_music\_style\.xml|歌曲进度条样式| |seekbar\_style\.xml|其他SeekBar进度条样式| |seekbar\_thumb\.xml|SeekBar拖动点样式| |c\_back\_down\.xml|回退键样式| ②drawable\-v21,该目录下是针对Android 5\.0\+做的设配 |引用文件|释义| |---|---| |selector\_view\_bg\.xml|半透明主色矩形波纹效果| |selector\_view\_bg\_white\.xml|白色矩形波纹效果| |selector\_circle\_view\_bg\.xml|半透明主色圆形波纹效果| |selector\_white\_circle\_view\_bg\.xml|白色圆形波纹效果| - 另外,还有一些常用的自定义View放在com\.lingju\.assistant\.view包下。 |名称|释义| |---|---| |VoiceWaveComponent|主界面话筒| |VoiceInputComponent|备忘、提醒功能页话筒| |VoiceComponent|导航页面话筒| |CommonDialog|通用对话框| |CommonEditDialog|编辑对话框| |LingjuSwipeRefreshLayout|上、下拉刷新控件| |com\.lsjwzh\.widget\.materialloadingprogressbar\.CircleProgressBar|环形进度条| |com\.wdullaer\.materialdatetimepicker\.date\.DatePickerDialog|日期选择器| |com\.wdullaer\.materialdatetimepicker\.time\.TimePickerDialog|时间选择器| --- - **关于手机头部状态栏** 由于在values\-v21/styles\.xml设置了true, 会使页面内容延伸到状态栏。所以当开发者新建一个Activity页面时,若页面浸入了状态栏,需要在Activity的布局文件中,在最顶部设置一个View。 ``` <View android:id="@+id/status_bar" android:layout_width="match_parent" android:layout_height="25dp" android:background="@color/bar_color"/> ``` 然后在Activity的onCreate\( \)中,setContentView\( \)之后,动态设置该View的高度模拟状态栏。 ``` //设置模拟状态栏的高度 ViewGroup.LayoutParams layoutParams = mStatusBar.getLayoutParams(); layoutParams.height = ScreenUtil.getStatusBarHeight(this); mStatusBar.setLayoutParams(layoutParams); ``` ## 6\.常见问题 ### 音频、视频场景无回复或回复暂不支持 --- **1\.“唱首歌”、“播放电影”等播放指令没有回复或回复“抱歉,我暂时未接入第三方资源库,还不能为您执行该功能。** - 在音频、视频场景中,对外提供的场景输出内容是自行对接第三方资源库,所以需要开发者接入资源库,并根据robot应答指令执行对应动作。 **2\.“最近有什么好看的电影”、“最近有什么新歌”无回复** - APP暂时只针对灵聚内部提供音频资源作出了应答,没有对使用第三方资源库的动作指令进行处理,开发者可以根据自身需求实现相关查询资源指令。 ### 关于同步 --- **1\.如何获取服务器的所有数据记录** - 以提醒为例,当用户清空本地数据后或第一次安装打开应用时,调用同步方法即可。 ``` //获取服务所有提醒记录 AssistEntityDao.RemindEntityDao remindDao = AssistEntityDao.create().getDao(AssistEntityDao.RemindEntityDao.class); AndroidChatRobotBuilder.get().robot().actionTargetAccessor().sync(remindDao); ``` **2\.重复同步某一条数据** - 上传数据时需要将本地记录ID上传,方便合并服务数据时更新该ID的记录;若无本地ID,则每次合并数据都是本地新建一条记录,原待同步记录一直未更新,则会重复提交同步。 ### 关于手机头部状态栏 --- 由于在values\-v21/styles\.xml设置了true, 会使页面内容延伸到状态栏。所以当开发者新建一个Activity页面时,若页面浸入了状态栏,需要在Activity的布局文件中,在最顶部设置一个View。 ``` <View android:id="@+id/status_bar" android:layout_width="match_parent" android:layout_height="25dp" android:background="@color/bar_color"/> ``` 然后在Activity的onCreate\( \)中,setContentView\( \)之后,动态设置该View的高度模拟状态栏。 ``` //设置模拟状态栏的高度 ViewGroup.LayoutParams layoutParams = mStatusBar.getLayoutParams(); layoutParams.height = ScreenUtil.getStatusBarHeight(this); mStatusBar.setLayoutParams(layoutParams); ``` ### 关于GreenDao --- **1\.设置主键id自增长** - 必须使用Long类型(int、long都不行),@Id\(autoincrement = true\)才会生效。 **2\.数据库升级** - 当新版本的APP涉及到数据库表或表字段的增减,在覆盖旧版本安装后打开应用时,需要先进行数据库的升级。数据的备份和表的更新操作已封装在SQLiteOpenHelper和MigrationHelper中。开发者只需要修改app/build\.gradle里android\.greendao的schemaVersion值即可(修改后的值 \> 原来的值)。 ``` android { ... greendao { schemaVersion 1(默认值) } } ``` ## 7\.联系方式 - 点击添加[「灵聚开发者服务群」](/project-2/doc-5/) - 联系邮箱:ling@lingjutech\.com
lingju.ai
2026年10月20日 17:19
转发文档
收藏文档
上一篇
下一篇
手机扫码
复制链接
手机扫一扫转发分享
复制链接
Markdown文件
PDF文档(打印)
分享
链接
类型
密码
更新密码