springboot项目接入天猫精灵语音功能

更新时间：2021年12月06日 09:34:45 作者：刘瑜澄

小编最近接手一个项目，涉及到天猫精灵的语音功能，今天小编通过本文给大家分享下springboot项目接入天猫精灵语音功能的详细过程及实例代码，感兴趣的朋友跟随小编一起看看吧

最近工作需要使用到天猫精灵的语音功能，大体是通过呼叫对应的“调用词”实现携带参数，然后调用我项目中的接口，以实现对应的业务。所以在此简单的记录下使用过程实际上：天猫精灵的官方文档记录的也很详细

重点参见自定义接入

1、创建语音技能

去创建

创建一个意图

先简单填入一个单轮对话，此时我设置了默认意图。所以我对天猫精灵说

天猫精灵热水用完了（调用词）或天猫精灵热水用完了吃了没（调用词+单轮对话）

都调用的是这个意图

创建实体，对于实体的创建，只有你在如下情况需要用到

天猫精灵热水用完了 {今天}的天气（调用词）+ 单轮对话<包含数据> 天猫精灵热水用完了放一首{周杰伦}的歌曲天猫精灵热水用完了我要去{19R}楼

像如上这些情况，考虑到{}中的数据是要作为参数传递给后端服务来进行操作的。所以需要创建对应实体。实体的作用就是为了在{}插槽的位置将你口述语音识别的内容转化为符合实体中设定的值的内容。

当然你也可以引用公共的实体（长度，任意数等），这里的@floor写的时候不需要加@，这个标识可以作为后面单论对话的插值,如我要去@{floor}楼

这里也创建一个带参的意图，创建单论对话的时候要选择“模板”

部署后端服务，可以为意图单独绑定服务，这里测试方便就绑定同一服务。这里的服务部署地址就是你为这个意图写的controller的路径，当然得是公网上的。我们先下载认证文件，将认证文件放到我们的springboot项目下，表示这个技能可与这个web service配对文档指向3

这里除了放在路径下，也可以直接写一个controller，如下。如果后面认证失败，可以试试

@PostMapping("/aligenie/6523cc2653ef3a0fed8证书.txt")
public String authentication(){
    return "Jfc4Z4Ur15JwUBuvUQD5wg7Nu8+l+HscqYlfofbyJdZPKKvjJdxxxxxxxBH+L5";//证书内容
}

2、一个SpringBoot项目

导入官方提供的依赖文档指向1

<dependency>
    <groupId>com.alibaba.da.coin</groupId>
    <artifactId>semantic-execute-meta</artifactId>
    <version>1.1.18-REALEASE</version>
</dependency>

便于操作，我就直接再控制层中写代码 , 大家可以直接去文档指向2查看官方提供的简单示例和呼叫天猫精灵时产生的请求头和请求正文。参照请求正文的格式，我们可以从传递过来的taskQuery取得正文中的任何数据

@RestController
@RequestMapping("/genie")
@Slf4j
public class GenieController {

    @PostMapping("/getGenieMsg")
    public ResultModel<TaskResult> bindingBuilding(@RequestBody String taskQuery) {
        log.info("天猫精灵测试 : leading:" + taskQuery);
        
        TaskQuery query = MetaFormat.parseToQuery(taskQuery);
        
        Map<String, String> requestData = query.getRequestData();
        log.info("requestData:" + requestData.toString());
        
        List<SlotEntity> slotEntities = query.getSlotEntities();
        if (slotEntities.size() > 0) {
        	log.info("slotEntities:" + slotEntities.get(0).getStandardValue());
    	}
		
		//返回数据
        ResultModel<TaskResult> resultModel = new ResultModel<TaskResult>();
        TaskResult result = new TaskResult();
        resultModel.setReturnCode("0");
        result.setReply("测试成功");
        result.setExecuteCode(ExecuteCode.SUCCESS);
        result.setResultType(ResultType.RESULT);
        resultModel.setReturnValue(result);
        return resultModel;
    }
}

然后将服务跑起来，采用花生壳的内网穿透将服务部署到公网上，这么用来测试很方便。不会可以参见这篇文章

3、后端部署

继续回到天猫精灵的控制台，将公网服务器地址加上Controller路径填上去，点击保存的时候他会判断你的web service有没有认证文件，如果点击报错报错，可以检查一下检查指向1

关于服务器SSL证书可参见文档指向4

4、测试

后端返回数据
2021-12-04 21:13:06.796  INFO 5388 --- [nio-8091-exec-2] c.a.s.demo.controller.GenieController    : 
天猫精灵测试 : leading:{
				"sessionId":"79c799a7-d4ee-495e-b472-0effa1c23fa3",
				"utterance":"热水用完了",
				"requestData"{}, //非真机，没有数据
				"botId":114376,
				"domainId":63502,
				"skillId":84340,
				"skillName":"TIAMTEst",
				"intentId":123759,
				"intentName":"天猫精灵测试",
				"slotEntities":[], //没有传参
				"requestId":"20211204211305435-225488739",
				"device":{},
				"skillSession":{
					"skillSessionId":"ae3fa617-ecf7-4c90-a2ac-8ba05038a24e",
					"newSession":true
				},
				"context":{
					"system":{
						"apiAccessToken":""
					}
				}
			}
2021-12-04 21:13:06.796  INFO 5388 --- [nio-8091-exec-2] c.a.s.demo.controller.GenieController    : 
requestData:{}

2021-12-04 21:29:51.463  INFO 5388 --- [nio-8091-exec-7] c.a.s.demo.controller.GenieController    : 
天猫精灵测试 : leading:{
				"sessionId":"206b0ee1-c4bf-4834-9caa-571960f2a9fc",
				"utterance":"热水用完了上K2楼",
				"requestData":{},
				"botId":114376,
				"domainId":63502,
				"skillId":84340,
				"skillName":"TIAMTEst",
				"intentId":123760,
				"intentName":"传参测试",
				"slotEntities":[
						{"intentParameterId":95268,
						"intentParameterName":"floor1",
						"originalValue":"K2",
						"standardValue":"k2",
						"liveTime":0,
						"createTimeStamp":1638624590055,
						"slotName":"floor1:floor",
						"slotValue":"k2"
						}],
				"requestId":"20211204212949987-504243894",
				device":{},
				"skillSession":{
					"skillSessionId":"1e66de8b-3c89-43c4-8af2-0536edda3f83",
					"newSession":false},
				"context":{"system":{"apiAccessToken":""}}}
2021-12-04 21:29:51.464  INFO 5388 --- [nio-8091-exec-7] c.a.s.demo.controller.GenieController    : 
requestData:{}
2021-12-04 21:29:51.464  INFO 5388 --- [nio-8091-exec-7] c.a.s.demo.controller.GenieController    : 
slotEntities:k2

然后就可以通过传递过来的设备号，参数等信息进行业务逻辑代码的编写

到此这篇关于springboot项目接入天猫精灵的文章就介绍到这了,更多相关springboot天猫精灵内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

SpringBoot项目接入Nacos的实现步骤

java实现微信公众号发送模版消息
这篇文章以订单推送为例，主要为大家详细介绍了java实现微信公众号发送模版消息，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-04-04
深入了解Spring中getBean()的五种方式
在本文中，我们将详细介绍从BeanFactory中获取bean的多种方式。简单地说，正如方法的名称所表达的，getBean（）负责从Spring IOC容器中获取bean实例，希望对大家有所帮助
2023-02-02
SpringMVC如何域对象共享数据
在Spring MVC中,可以使用域对象来共享数据,域对象是一个Map类型的对象,可以在请求处理方法之间共享数据,本文给大家介绍SpringMVC 域对象共享数据的示例代码,一起看看吧
2023-09-09
ssm项目session使用及其作用域问题
这篇文章主要介绍了ssm项目session使用及其作用域问题，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2018-03-03
SpringBoot获取yml和properties配置文件的内容
这篇文章主要为大家详细介绍了SpringBoot获取yml和properties配置文件的内容，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2017-04-04
Java png图片修改像素rgba值的操作
这篇文章主要介绍了Java png图片修改像素rgba值的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-11-11
Springmvc RequestMapping请求实现方法解析
这篇文章主要介绍了Springmvc RequestMapping请求实现方法解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-09-09
Java实现Excel表单控件的添加与删除
本文通过Java代码示例介绍如何在Excel表格中添加表单控件，包括文本框、单选按钮、复选框、组合框、微调按钮等，以及如何删除Excel中的指定表单控件，需要的可以参考一下
2022-05-05
springboot 实现记录业务日志和异常业务日志的操作
这篇文章主要介绍了springboot 实现记录业务日志和异常业务日志的操作，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-07-07
java中的forkjoin框架的使用
这篇文章主要介绍了java中的fork join框架的使用，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-03-03