# 概览
精简协议对于AIUI原始的语义协议做了一定程度上的规整与精简。适用于无屏设备，特别是无屏的RTOS小算力设备。
针对是原始的AIUI语义协议，设备端拿到语义结果后标准的处理方式是：
解析service（技能信息）
解析intent（意图信息）
根据service解析data.result（内容信源数据）
其中data.result内容与技能与意图相关，不同的技能与意图，result字段略有差异，如新闻的返回结果中资源地址可能是audiopath，而故事技能的返回结果中资源地址可能是url，这给设备端的解析造成较大不便。同时，开发者接入了多少个技能就有可能需要解析多少个技能的service。
AIUI原始的语义协议解析处理比较复杂，内容数据中也有很多无屏设备无需关心的信息被返回，RTOS设备的内存可能不足以支持接入原始的语义协议解析。为了结局原始协议解析复杂且消耗占用内存的两个问题，AIUI团队特地推出了精简协议。使用该协议后开发者的无屏设备可在三天内完成语义的解析接入。
# 精简协议内容
精简协议规整了媒资类和播报类两大类技能，其中媒资类技能指的是需要从data.result字段中拿到播放的url进行播放，而播报类技能则指的是只需要播报answer中内容的技能。
一、媒资类技能中的协议改变如下：
新增service_pkg字段，表示技能的精简协议类型，将AIUI平台常见的28个官方媒资类技能统一打包，通过 service_pkg="media"标识；客户端只需要判断该字段即可对媒资类技能统一处理；
针对媒资类技能，data.result字段只保留4个，分别是：
| 字段 | 类型 | 说明 |
|---|---|---|
| itemid | String | 资源ID |
| uni_url | String | 资源地址 |
| duration | String | 资源播放持续时间 |
| name | String | 资源名称 |
- 针对媒资类技能，data.result数组长度由以前的最多返回20条数据，缩减到5条。
二、播报类技能中的协议改变如下：
新增service_pkg字段，表示技能的精简协议类型，将AIUI平台常见的49个官方播报类技能统一打包，通过 service_pkg="broadcast"标识；客户端只需要判断该字段即可对播报类技能统一处理；
针对播报类技能，data.result数组中不再返回数据。
三、建议客户端对于精简协议的处理流程为：
# 精简协议技能列表
一、媒资类技能列表：
| service | 中文名 | 类型 |
|---|---|---|
| AIUI.audioBook | 有声书 | 媒资类 |
| AIUI.Bible | 圣经 | 媒资类 |
| AIUI.chCultivation | 儿童兴趣培养 | 媒资类 |
| AIUI.chDevelopment | 儿童学堂 | 媒资类 |
| AIUI.chLiterature | 国学 | 媒资类 |
| AIUI.chSong | 儿歌 | 媒资类 |
| AIUI.meditationTime | 冥想时刻 | 媒资类 |
| AIUI.ocularGym | 眼保健操 | 媒资类 |
| AIUI.sleepWell | 好好睡觉 | 媒资类 |
| AIUI.smarter | 越听越聪明 | 媒资类 |
| AIUI.whiteNoise | 白噪音 | 媒资类 |
| animalCries | 动物叫声 | 媒资类 |
| crossTalk | 相声小品 | 媒资类 |
| drama | 戏曲 | 媒资类 |
| englishEveryday | 英语每日一句 | 媒资类 |
| health | 健康讲座 | 媒资类 |
| history | 历史 | 媒资类 |
| KLLI3.studyPinYin | 我想学拼音 | 媒资类 |
| LEIQIAO.funnyPassage | 搞笑段子 | 媒资类 |
| LEIQIAO.openClass | 公开课 | 媒资类 |
| LEIQIAO.speech | 名人演讲 | 媒资类 |
| musicX | 音乐 | 媒资类 |
| musicX_dialect | 音乐方言版 | 媒资类 |
| news | 新闻 | 媒资类 |
| novel | 有声小说 | 媒资类 |
| radio | 广播电台 | 媒资类 |
| story | 故事 | 媒资类 |
| storyTelling | 评书 | 媒资类 |
二、播报类技能列表：
| service | 中文名 | 类型 |
|---|---|---|
| KLLI3.FamilyNames | 百家姓 | 播报类 |
| baike | 百科 | 播报类 |
| AIUI.2bd672cefd | 猜数字 | 播报类 |
| lottery | 彩票 | 播报类 |
| cookbook | 菜谱 | 播报类 |
| AIUI.e09af9377o | 成语接龙 | 播报类 |
| wordsDictionary | 词典 | 播报类 |
| AIUI.unitConversion | 单位换算 | 播报类 |
| translation | 翻译 | 播报类 |
| college | 高校查询 | 播报类 |
| AIUI.collegeScore | 高校分数线 | 播报类 |
| KLLI3.powerScaler | 功率换算 | 播报类 |
| stock | 股票 | 播报类 |
| LEIQIAO.cityOfPro | 国内城市查询 | 播报类 |
| AIUI.forex | 汇率 | 播报类 |
| AIUI.f65cf38453 | 会说话的小鹦鹉 | 播报类 |
| AIUI.calc | 计算器 | 播报类 |
| LEIQIAO.relationShip | 家族关系神器 | 播报类 |
| holiday | 假期安排 | 播报类 |
| AIUI.cd756aff0p | 剪刀石头布 | 播报类 |
| petrolPrice | 今日油价 | 播报类 |
| KLLI3.numberScaler | 进制转换 | 播报类 |
| AIUI.famousQuotes | 经典名句 | 播报类 |
| LEIQIAO.timesTable | 九九乘法表 | 播报类 |
| AIUI.85beebdd4t | 口算挑战 | 播报类 |
| garbageClassify | 垃圾分类 | 播报类 |
| LEIQIAO.historyToday | 历史上的今天 | 播报类 |
| AIUI.b1ed7474c9 | 谜语 | 播报类 |
| AIUI.20aafd8b1r | 脑筋急转弯 | 播报类 |
| AIUI.ac140b7894 | 抛硬币 | 播报类 |
| carNumber | 汽车尾号限行 | 播报类 |
| chineseZodiac | 生肖运势 | 播报类 |
| ZUOMX.queryCapital | 省会查询 | 播报类 |
| poetry | 诗词 | 播报类 |
| AIUI.179c5b26by | 诗词挑战 | 播报类 |
| datetimePro | 时间日期查询 | 播报类 |
| AIUI.WorldCup | 世界杯 | 播报类 |
| KLLI3.captialInfo | 首都查询 | 播报类 |
| LEIQIAO.BMI | 体重指数查询 | 播报类 |
| weather | 天气 | 播报类 |
| weather_dialect | 天气方言版 | 播报类 |
| AIUI.114c02b04p | 跳数字 | 播报类 |
| calendar | 万年历 | 播报类 |
| joke | 笑话 | 播报类 |
| AIUI.virusSearch | 新冠疫情查询 | 播报类 |
| constellation | 星座 | 播报类 |
| dream | 周公解梦 | 播报类 |
| EGO.healthKnowledge | 健康知识 | 播报类 |
| EGO.foodsCalorie | 食物热量 | 播报类 |
← WebSocket API接入 集成方式 →