# 技能服务接入简介
开发者可以将自己技能的相关信息提交给iFLYOS,并在自己的服务器上接入iFLYOS的协议,之后消费者即可通过入口词访问到你的技能服务。
# 谁可以使用内容信源服务接入
已经自有语义的技能开发者,基本要求如下:
- 了解语音技能的实现和交互逻辑,可查看如何制作技能
- 了解技术,能够实现iFLYOS技能接入协议,在接到IVS的请求后,向IVS回复正确的信息。
- 确保你或者你的公司对所提供的技能没有造成侵权。
- 使用HTTPS和iFLYOS进行数据传输。
# iFLYOS 技能使用场景
- 用户通过【入口词】(如“打开
技能名称
”,“启动技能名称
”等)来进入技能。 - 用户进入技能时,iFLYOS 将会向技能开发者发送
LaunchRequest
,技能开发者在接收到该请求后,即可为用户提供服务,此时我们建议技能开发者返回的Response
中包含技能的欢迎语和使用引导。 - 用户进入技能后,可根据引导持续与技能进行交互,iFLYOS将会向技能开发者发送
TextRequest
,请求中包含用于经过IVS理解的文本。技能开发者使用文本进行语义理解并提供技能服务。 - 用户将继续和技能进行交互,直到以下情况技能结束:
- 用户说出”退出“”关闭“”退出技能“”退出
技能名称
“等语句后; - 技能开发者返回的
Response
中,shouldEndSession
取值为true
。
- 用户说出”退出“”关闭“”退出技能“”退出
# 接入步骤
# 一、创建服务
在服务接入控制台,创建新服务,选择第三方技能服务,填写服务的名称。服务名称只支持中文,需要控制在10个中文字以内。填写完成点击【创建服务】进入服务配置。
注意
服务名称和类型一经填写不可修改
# 二、服务配置
在服务接入控制台中,填写相关信息。所需信息如下:
信息 | 描述 | 限制 |
---|---|---|
技能名 | 显示在技能商店中给用户看到的名称,入口词统一为“打开{技能名称}” | 10个中文字以内 |
技能icon | 显示在技能商店中给用户看到的icon,若涉及到模板下发,将在模板中展现icon | 尺寸 480 x 480 px |
技能结束语 | 用户退出技能时,你可以给用户回复一段结束语。 | 每段文本最多40字 |
技能描述 | 显示在技能商店中给用户看到的技能描述,主要描述该技能可以做什么。 | 100个中文字以内 |
技能示例 | 展示给用户看怎么和技能进行语音交互 | 至少3句技能的使用示例 |
技能开发者 | 开发者名称/公司名称 | 15个中文字以内 |
技能处理链接 | 用于接收iFLYOS发送的请求的链接地址 | https的url |
配置完成后可进行测试调试。
# 三、开发调试
我们的协议中包括iFLYOS发送给你的 Request
,及你在接到Request
之后进行处理并返回给iFLYOS服务器的Response
,iFLYOS会根据你返回的Response
向设备端发送相关指令,为消费者提供服务。
在开始开发之前,您需要准备:
- 了解iFLYOS技能设计规范
- 准备搭载iFLYOS的设备,或下载 (opens new window)模拟设备的APP。
- 下载 (opens new window)测试调试用的手机APP。
# 四、提交审核
当你完成了上述对接,并通过测试后,需要提交iFLYOS进行测试审核。点击查看审核规范
# 五、发布服务
审核通过后你将收到我们的短信提醒,审核通过后用户即可在小飞在线等设备关联APP上访问你的服务,也可通过语音访问你的服务。