Form事件

当用户不使用语音交互，而是从设备端的屏幕控制音频或视频的播放时，DuerOS会把用户操作的控件及含义通过Form事件上报给技能。本文首先介绍用户常用的控件类型，接下来介绍如何将这些控件上报给技能。

控件

设备端包含BUTTON和RADIO_BUTTON两种控件类型。

BUTTON控件

BUTTON控件指普通按钮控件，可以通过点击按钮执行命令。BUTTON控件可以渲染为选中状态和非选中两种状态。如音乐播放过程中的暂停、上一首、下一首、继续播放等都使用BUTTON控件。

BUTTON控件消息样例

{
    "type": "BUTTON",
    "name": "{{STRING}}",
    "enable": {{BOOLEAN}},
    "selected": {{BOOLEAN}}
}

参数说明

• type
  • 控件类型，这里取固定值BUTTON。
• name
  • 控件名字。
• enable
  • 按钮是否可点击，布尔类型，true表示按钮可以点击，false表示按钮不可点击。
• selected
  • 按钮是否要渲染为选中状态，布尔类型，true表示渲染为选中状态，false表示渲染为非选中状态。

RADIO_BUTTON控件

RADIO_BUTTON控件指单选按钮控件，支持通过点击来选择需要的选项。多个选项之间是互斥的，即一组选项中只能选择一个。例如音乐播放器的“循环模式切换”为单选按钮，用户可以从“单曲循环”、“随机播放”、“列表循环”三种模式中选择一种。

RADIO_BUTTON消息样例

{
    "type": "RADIO_BUTTON",
    "name": "{{STRING}}",
    "selectedValue": "{{STRING}}"
}

参数说明

• type
  • 控件类型，取固定值RADIO_BUTTON。
• name
  • 控件名称。
• selectedValue
  • 选中的选项值。

控件使用列表

介绍DuerOS支持的常用控件列表。音乐播放器在播放音乐过程中会使用以下控件。

视频播放器支持的控件列表

Form上报控件事件

Form.ButtonClicked事件

当用户在屏幕点击BUTTON按钮时，DuerOS会向技能发送Form.ButtonClicked事件。

消息样例

{
    ...
    "request": {
        "type": "Form.ButtonClicked",
        "name": "{{STRING}}",
        "requestId": "{{STRING}}",
        "timestamp": "{{STRING}}",
        "token": "{{STRING}}"
    }
    ...
}

参数说明

• type
  • 事件类型，取固定值Form.ButtonClicked。
• name
  • 控件名称。
• requestId
  • 标识本次请求的唯一ID。
• timestamp
  • 请求时间戳，单位是秒。
• token
  • 渲染此控件指令携带的token。

Form.RadioButtonClicked事件

当用户在屏幕点击RADIO_BUTTON按钮时，DuerOS会向技能发送Form.RadioButtonClicked事件。

消息样例

{
    ...
    "request": {
        "type": "Form.RadioButtonClicked",
        "name": "{{STRING}}",
        "requestId": "{{STRING}}",
        "timestamp": "{{STRING}}",
        "token": "{{STRING}}",
        "selectedValue": "{{STRING}}"
    }
    ...
}

参数说明

• type
  • 事件类型，取固定值Form.RadioButtonClicked。
• name
  • 控件名称。
• requestId
  • 标识本次请求的唯一ID。
• timestamp
  • 请求时间戳，单位是秒。
• token
  • 渲染此控件指令携带的token。
• selectedValue
  • 选中选项值。