DuerOSCapacity能力介绍

DuerOSCapacity是DuerOS对外输出能力列表，合作方通过调用 BotSdk.triggerDuerOSCapacity(DuerOSCapacity, String)方法触发DuerOS的能力。

对于部分能力，如果需要结果返回，合作方会异步收到HandleIntentPayload指令,应用程序中通过IBotMessageListener.onHandleIntent回调进行相应处理。

回调中重点关注两个参数 botIntent，以及customData

botIntent包含意图名称和槽位参数，customData是各能力自定义数据格式，具体参见下文描述。

如果触发的能力需要携带参数，请将参数格式化为json传入triggerDuerOSCapacity方法的param参数。

序号	名称
0	AI_DUER_SHOW_INTERRPT_TTS
5	AI_DUER_SHOW_GET_CAMERA_STATE
6	AI_DUER_SHOW_REQUEST_ENABLE_CAMERA
7	AI_DUER_SHOW_INTERRPT_LISTEN
14	AI_DUER_SHOW_GET_DCS_CONNECTION_STATE
16	AI_DUER_SHOW_GESTURE_REGISTER
17	AI_DUER_SHOW_UPDATE_BOT_STATUS
18	AI_DUER_SHOW_OPEN_FACE_UNLOCK
19	AI_DUER_SHOW_UPDATE_BOTAPP_CUSTOM_CLIENTCONTEXT

AI_DUER_SHOW_INTERRPT_TTS

说明

打断TTS播报

AI_DUER_SHOW_GET_CAMERA_STATE

说明

获取Camera当前状态

返回

• BotIntent
  • name: com.baidu.duer.cameraStateChanged
• customData
  • ENABLED 启用 / DISABLED 禁用

AI_DUER_SHOW_REQUEST_ENABLE_CAMERA

说明

申请启用Camera

返回

• BotIntent
  • name: com.baidu.duer.cameraStateChanged
• customData ENABLED 启用 / DISABLED 禁用

AI_DUER_SHOW_INTERRPT_LISTEN

说明

打断聆听状态

AI_DUER_SHOW_GET_DCS_CONNECTION_STATE

说明

获取当前DCS长连接状态

返回

• BotIntent
  • name: com.baidu.duer.dcsConnectionStateChanged
• customData
  • CONNECTED / DISCONNECTED / PENDING / UNKNOWN

AI_DUER_SHOW_GESTURE_REGISTER

说明

注册手势能力

参数

• enabledGestures: 支持的手势类型，空列表时将清空手势。参见 BotMessageProtocol.AiDuerGesture

返回

• BotIntent
  • name: AI_DUER_SHOW_GESTURE_RECOGNIZED
  • slots
    • name: recognizedGestureName
    • value: 手势类型枚举，参见 BotMessageProtocol.AiDuerGesture

AI_DUER_SHOW_UPDATE_BOT_STATUS

说明

容器类型技能更新技能状态（例如小程序中技能跳转，需要上报新技能的信息，用于更新端状态）

参数

• botAppId: 技能ID
• botStatus: 状态枚举，参见 BotMessageProtocol.BotStatus

AI_DUER_SHOW_OPEN_FACE_UNLOCK

说明

请求DuerOS打开人脸解锁页面

参数

• requestId

AI_DUER_SHOW_UPDATE_BOTAPP_CUSTOM_CLIENTCONTEXT

说明

更新业务相关端状态

参数

• app的业务相关端状态。例如：页面展现的资源的id，或者当前App的状态等。数据格式由app和bot单独约定

BotMessageProtocol.AiDuerGesture

序号	名称	说明
0	GESTURE_OK	OK的手势
1	GESTURE_PALM	单手掌向前的手势
2	GESTURE_LEFT	拇指向左（用户视角）的手势
3	GESTURE_RIGHT	拇指向右（用户视角）的手势
4	GESTURE_DISS	拇指向下的手势
5	GESTURE_LIKE	拇指向上的手势
6	GESTURE_BIXIN	单手比心的手势
7	GESTURE_REDHEART	双手比心，拇指在下的手势
8	GESTURE_BLUEHEART	双手比心，拇指在上的手势
9	GESTURE_TWO	数字二的手势

BotMessageProtocol.BotStatus

序号	名称	说明
0	BOT_LAUNCHED	技能启动
1	BOT_RESUMED	技能进入前台
2	BOT_PAUSED	技能进入后台
3	BOT_STOPPED	技能退出