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的实现步骤

Springboot启动原理和自动配置原理解析
这篇文章主要介绍了Springboot启动原理和自动配置原理解析，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
2023-04-04
IKAnalyzer使用不同版本中文分词的切词方式实现相同功能效果
今天小编就为大家分享一篇关于IKAnalyzer使用不同版本中文分词的切词方式实现相同功能效果，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2018-12-12
Java Swing JTextArea文本区域的实现示例
这篇文章主要介绍了Java Swing JTextArea文本区域的实现示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-12-12
Java两个变量的互换(不借助第3个变量)具体实现方法
这篇文章主要介绍了Java两个变量的互换(不借助第3个变量)具体实现方法,需要的朋友可以参考下
2014-02-02
基于springEL表达式详解及应用
这篇文章主要介绍了springEL表达式详解及应用，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-08-08
Junit单元测试框架架包的导入全过程
这篇文章主要介绍了Junit单元测试框架架包的导入全过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2024-04-04
intelij idea 2023创建java web项目的完整步骤
这篇文章主要给大家介绍了关于intelij idea 2023创建java web项目的完整步骤,该教学主要针对各位刚刚接触javaweb开发的小伙伴,各位学习java的朋友也难免会经历这个阶段,需要的朋友可以参考下
2023-10-10
Java实现简单密码加密功能
这篇文章主要为大家详细介绍了Java实现简单密码加密功能，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2020-03-03
Java数据结构中图的进阶详解
在Java学习与应用中，数据结构无疑是每个人都要接触的难点，为了更好的学习数据结构这一块内容，用图来理解便是最好的方式，让我们一起来了解本篇内容图的进阶
2022-01-01
hystrix服务降级方法使用介绍
什么是服务降级？当服务器压力剧增的情况下，根据实际业务情况及流量，对一些服务和页面有策略的不处理或换种简单的方式处理，从而释放服务器资源以保证核心交易正常运作或高效运作
2022-09-09