乐乐语音电视场景化SDK开发手册

于冬冬2015-11-2乐乐语音乐视电视场景化SDK开发手册190681概述 3103031.1目的 3222411.2范围 3324232使用说明 325612.1开发说明 3181412.2开发前准备 3324462.3支持的平台 4107973环境搭建 449563.1电视系统源码编译. 4100593.2不依赖电视系统的独自编译. 518484初始化示例 5137495场景化SDK使用示例 669476场景化接口定义 7176876.1VoiceManger对象 7291096.1.1构造对象 72216.1.2设置语音场景提示词 759056.1.3设置回调监听 7167326.1.4设置场景类型 851086.1.5场景执行结果 879906.1.6判断是否是乐乐语音 9199676.1.7进入场景 97426.1.8退出场景 9183376.1.9添加View的方法,语音助手来触发点击 965446.1.10添加场景自定义命令 1092316.1.11判断是否在场景内 1085986.1.12清除场景化命令 11143746.1.13设置声纹回调监听. 11

概述目的本文档对乐乐语音针对乐视电视场景化SDK接口定义进行说明。文档读者为使用乐乐语音乐视电视定制方案SDK进行开发的产品设计师、软件工程师。范围本文档定义语音电视场景化方案SDK的使用说明、体系结构、API接口.使用说明开发说明本文档是乐视电视语音场景化SDK开发指南，本文属于入门级文档，旨在帮助开发者快速使用语音场景化SDK进行语音相关交互开发工作，开发者只需要关注文档中提及的相关功能接口的调用。开发前准备开发者要熟悉场景化SDK,首先要同步下载接口文档,如下图所示:支持的平台乐视电视/乐视盒子等系统版本在EUI5.0以上的平台环境搭建环境搭建分两种情况,针对各应用在电视平台的集成方式不同,分为以下两种电视系统源码编译.场景化接口源码在vender/letv/framework/base/java/letv/voice/目录下,以928平台为例,生成的jar包路径是:out/target/product/guava/system/framework/framework-letv.jar不依赖电视系统的独自编译.在使用接口之前,需要将classes.jar放到lib/目录下,解决编译问题.初始化示例初始化之后才可以使用相关接口,初始化代码如下：importletv.voice.VoiceManager;importcom.stv.voice.SceneProtocol;importletv.voice.OnSceneCodeListener;importletv.voice.SceneEvent;importletv.voice.SceneType;publicclassSceneActivityextendsActivity{//新建一个Manager对象protectedVoiceManagermVoiceManager=null;protectedToastmToast;@SuppressLint("ShowToast")@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);mVoiceManager=newVoiceManager(this);mToast=Toast.makeText(this,"",Toast.LENGTH_SHORT);}图STYLEREF1\s4SEQ图\*ARABIC\s11场景化SDK使用示例 publicclassSceneTypeSearchDemoextendsSceneActivity{@OverrideprotectedvoidonCreate(BundlesavedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.scene_search);mVoiceManager.addSceneType(SceneType.TYPE_SEARCH);mVoiceManager.setScenePrompt("相册","天气");mVoiceManager.setOnSceneCodeListener(newOnSceneCodeListener(){@OverridepublicvoidonSceneCode(intarg0,Stringarg1,Stringarg2){switch(arg0){caseSceneEvent.SCENE_SEARCH_TEXT:showMessage("结果("+arg1+")");break;default:break;}mVoiceManager.addSceneAnswer("已经为您打开:"+arg0);}});}}@OverridepublicvoidonResume(){super.onResume();mVoiceManager.enterScene();//重要:onResume的时候进入场景.}@OverridepublicvoidonPause(){super.onPause();mVoiceManager.exitScene();//重要:onPause的时候必须退出场景.}@OverridepublicvoidonDestroy(){mVoiceManager.exitScene();//重要:onDestroy的时候退出场景.super.onDestroy();}}}图STYLEREF1\s5SEQ图\*ARABIC\s11场景化接口定义VoiceManger对象构造对象//构造manager对象mVoiceManager=newVoiceManager(this);图STYLEREF1\s6SEQ图\*ARABIC\s11设置语音场景提示词//添加场景提示词,如果添加少于4个,全局命令提示词会自动补充.mVoiceManager.setScenePrompt("相册","天气");图STYLEREF1\s6SEQ图\*ARABIC\s12设置回调监听//设置回调监听mVoiceManager.setOnSceneCodeListener(newOnSceneCodeListener(){@OverridepublicvoidonSceneCode(intarg0,Stringarg1,Stringarg2){showMessage("code:"+arg0+"param1:"+arg1+"param2:"+arg2);switch(arg0){caseSceneEvent.SCENE_GRID_REVERSE_ROW_COLUMN://具体什么场景返回什么场景事件需要参考sceneType.javashowMessage("结果("+arg1+")");break;caseSceneEvent.SCENE_VIDEO_FFW://具体什么场景返回什么场景事件需要参考sceneType.javashowMessage("执行快进操作");break;default:break;}图STYLEREF1\s6SEQ图\*ARABIC\s13回调监听,是需要设置场景类型 //设置场景 mVoiceManager.addSceneType(SceneType.TYPE_GRID); mVoiceManager.addSceneType(SceneType.TYPE_LIST);图STYLEREF1\s6SEQ图\*ARABIC\s14具体场景类型定义请参考sceneType.java场景执行结果//填充场景执行结果,原则上场景命令执行成功与否都需要返回语音一个结果mVoiceManager.addSceneAnswer("已经为您打开:"+arg0);图STYLEREF1\s6SEQ图\*ARABIC\s15判断是否是乐乐语音/***判断是否是乐乐语音,乐乐语音返true,云知声返false* booleanret=mVoiceManager.isLeleVoice();*/publicbooleanisLeleVoice()图STYLEREF1\s6SEQ图\*ARABIC\s16进入场景 /***载入场景,在onResume的时候使用,跟exitScene必须一一对应*/publicvoidenterScene(){mSdk.enterScene(mContext);}图STYLEREF1\s6SEQ图\*ARABIC\s17退出场景/***退出场景,生命周期结束必须退出,一般onPause,onDestroy时候退出*/publicvoidexitScene(){mSdk.exitScene(mContext);}图STYLEREF1\s68添加View的方法,语音助手来触发点击 /***添加view的方法,参数一是view参数二:view上对应的文本.*/publicvoidaddView(Viewview,String...sceneCommands){mSdk.addView(view,sceneCommands);}图STYLEREF1\s69添加场景自定义命令/***添加自定义命令集合,根据各应用需要添加.*/publicvoidaddCustomCommands(String...fixedCommands){mSdk.addCustomCommands(fixedCommands);}图STYLEREF1\s610使用场景化自定义命令填充数据的话,监听回调函数,publicvoidonSceneCode(intarg0,Stringarg1,Stringarg2)返回的arg0为SCEN