2.1.3语义对象
# 2.1.3 语义对象(Action)
语义对象主要用于控制终端显示卡片、播放音视频、机器人做动作等一系列指令,不同的指令通过语义动作目标对象进行区分。详细数据结构及取值见下方说明。
</br>
## Action对象数据结构
| 字段名称 | 数据类型 | 是否非空 | 释义 |
|----------|----------|----------|--------------------------------------------------------------------------------|
| action | String | 非空 | 执行动作 |
| target | Object | 非空 | 目标对象 |
| hints | Object | | 动作执行结果提示建议 |
| etime | Scheduler | | 动作执行时间,无此属性或为空代表马上执行 |
</br>
## Action对象字段说明
### action字段取值说明:
| 属性 | 取值 | 取值释义 |
|----------|-----------|-----------------------------------------------------------|
| action | VIEW | 查看/展示,用于:闲聊输出、AI能够处理的查询请求的结果输出 |
| | QUERY | 查询,由开发者通过第三方接口查询 |
| | SEND | 发送 |
| | CALL | 拨打 |
| | ANSER | 接听 |
| | HANG | 挂断 |
| | DOACTION | 做出一类肢体动作(表情也归类到动作) |
| | CREATE | 新建 |
| | INSERT | 插入 |
| | RESTART | 重启 |
| | CANCEL | 取消 |
| | RETURN | 返回 |
| | MODIFY | 编辑 |
| | DELETE | 删除 |
| | COPY | 复制 |
| | PASTE | 粘贴 |
| | MOVE | 剪切/移动 |
| | ROLL | 滚动 |
| | OPEN | 打开 |
| | CLOSE | 关闭 |
| | REFRESH | 刷新 |
| | SET | 设置 |
| | SHARE | 分享 |
| | RECOMMEND | 推荐 |
| | DOWNLOAD | 下载 |
| | SELECT | 选择 |
| | CLEAR | 清空 |
| | TRANSLATE | 翻译 |
| | SUBSCRIBE | 预约/订阅 |
| | BOOK | 预订/订购 |
| | ORDER | 购买/下单 |
| | APPEND | 追加/附加 |
| | READ | 朗读/播报 |
</br>
### target字段数据结构:
该字段涉及的对象较多,不同对象的数据结构有所不同,详细说明见3.语义动作目标对象
</br>
### hints字段数据结构:
| 字段名称 | 数据类型 | 是否非空 | 释义 |
|----------|----------|----------|--------------------------------------------------------------------------------|
| success | Hint | | 动作执行成功时的合成文本或音频 |
| failure | Hint | | 动作执行失败时的合成文本或音频 |
| donebefore | Hint | | 指令下发前动作已经执行时的合成文本或音频 |
| notfound | Hint | | 未找到目标对象时的合成文本或音频 |
| notsupport | Hint | | 客户端不支持该动作的合成文本或音频 |
| gtmax | Hint | | 大于最大值时的合成文本或音频 |
| ltmin | Hint | | 小于最小值时的合成文本或音频 |
#### Hint对象数据结构:
| 字段名称 | 数据类型 | 是否非空 | 释义 |
|----------|----------|----------|--------------------------------------------------------------------------------|
| text | String | | 合成的文本 |
| audio | String | | text对应的音频url |
</br>
### etime字段说明:
取值为Scheduler对象,Scheduler对象说明详见附录4.2中的<a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">Scheduler对象</a>