# 技能服务接入简介

开发者可以将自己技能的相关信息提交给iFLYOS,并在自己的服务器上接入iFLYOS的协议,之后消费者即可通过入口词访问到你的技能服务。

# 谁可以使用内容信源服务接入

已经自有语义的技能开发者,基本要求如下:

  • 了解语音技能的实现和交互逻辑,可查看如何制作技能
  • 了解技术,能够实现iFLYOS技能接入协议,在接到IVS的请求后,向IVS回复正确的信息。
  • 确保你或者你的公司对所提供的技能没有造成侵权。
  • 使用HTTPS和iFLYOS进行数据传输。

# iFLYOS 技能使用场景

  1. 用户通过【入口词】(如“打开技能名称”,“启动技能名称”等)来进入技能。
  2. 用户进入技能时,iFLYOS 将会向技能开发者发送LaunchRequest,技能开发者在接收到该请求后,即可为用户提供服务,此时我们建议技能开发者返回的Response中包含技能的欢迎语和使用引导。
  3. 用户进入技能后,可根据引导持续与技能进行交互,iFLYOS将会向技能开发者发送TextRequest,请求中包含用于经过IVS理解的文本。技能开发者使用文本进行语义理解并提供技能服务。
  4. 用户将继续和技能进行交互,直到以下情况技能结束:
    • 用户说出”退出“”关闭“”退出技能“”退出技能名称“等语句后;
    • 技能开发者返回的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向设备端发送相关指令,为消费者提供服务。

查看协议详情:RequestResponse

在开始开发之前,您需要准备:

  1. 了解iFLYOS技能设计规范
  2. 准备搭载iFLYOS的设备,或下载 (opens new window)模拟设备的APP。
  3. 下载 (opens new window)测试调试用的手机APP。

# 四、提交审核

当你完成了上述对接,并通过测试后,需要提交iFLYOS进行测试审核。点击查看审核规范

# 五、发布服务

审核通过后你将收到我们的短信提醒,审核通过后用户即可在小飞在线等设备关联APP上访问你的服务,也可通过语音访问你的服务。