技能后处理协议：Response_v2.1协议

<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
	<h3 style="margin: 0 0 6px 0; font-weight: 600;">注意：</h3>
        <p style="margin: 0; font-size: 0.95rem;">协议v2.1比v2.0协议，存在字段增删，和支持取值的增加。</p>
    </div>
</div>

在你处理完技能发送的请求后，你需要给用户发送回复。回复可以是：
- 技能请求处理完成回复用户TTS
- 播放一些和技能相关的提示音

## HTTP头

```js
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length:
```

## body示例

```json
{
  "version": "2.1",
  "sessionAttributes": {
    "key": "value"
  },
  "response": {
    "outputSpeech": {
      "type": "PlainText",
      "text": "Plain text String to speak"
    },
    "reprompt": {
      "outputSpeech": {
        "type": "PlainText",
        "text": "Plain text String to speak"
      }
    },
    "card": {
      "type": "Standard",
        "title": {
          "size":"LARGE|SMALL",
          "text":"20~32℃"
      },
        "content":"2018-08-27 | 广州",
        "imageUrl":"https://carfu.com/resources/card-images/race-car-small.png",
        "link": {
          "url":"example.iflyos.cn/",
          "text":"点击查看"
      }
    },
     "directives": [
    {
      "type": "AudioPlayer.Play",
      "playBehavior": "ENQUEUE",
      "audioItem": {
        "stream": {
          "type": "AUDIOH",
          "url": "https://example.com/audiofile.mp3",
          "token": "S0wiXQZ1rVBkov...",
          "expectedPreviousToken": "f78b7d68...",
          "offsetInMilliseconds": 0
        },
        "metadata": {
          "title": "《十年》",
          "subtitle": "陈奕迅",
          "art": {
            "sources": [
              {
                "url": "https://example.com/brie-album-art.png"
              }
            ]
          }
        }   
      }
    }
  ],
    "expectSpeech": true,
    "shouldEndSession": true
  }
}
```

响应正文参数说明

| 参数              | 描述                                                                           | 类型   | 必须出现 |
| ----------------- | ------------------------------------------------------------------------------ | ------ | -------- |
| version           | 版本，取值2.1                                                                  | String | 是       |
| sessionAttributes | 需要放入下一次请求的`session{attributes{}}`中回传至技能的属性。包含key， value | Object    | 否       |
| response          | 返回内容。                                                                     | Object | 是       |

### 标准响应中的对象

| 参数             | 描述                                                                                                                                                                                                                                                                    | 类型                                                             | 必须出现 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | -------- |
| outputSpeech     | 操作返回的语音文本<br>- type: 输出语音类型，**取值：**`PlainText`，纯文本<br>- text: 文本内容，type取值为`PlainText`时需要出现该字段。<br>                                                                                                                                  | Object                                                           | 否       |
| reprompt         | 若该技能回复需要打开录音收听用户的语音回复，当用户在8秒内没有说话时，设备将推送该语音文本，用于再次提示用户输入。<br>推送后设备再打开录音8s。若用户依旧没有说话，则会话结束。<br>- type: 输出语音类型，**取值：**`PlainText`，纯文本<br>- text: 文本内容，type取值为`PlainText`时需要出现该字段。 | Object                                                           | 否       |
| card | 用于向设备的关联APP推送消息。支持三种卡片类型：Simple、Standard、List。<br>- [点击查看详情](./display_card.md) | Object | 否 |
| directives       | 一组指令，用于指定使用特定接口进行设备级别的操作。目前支持以下指令：<br>- AudioPlayer指令   <br>- Playback指令 <br>- Dialog指令<br>- Display指令                                                             | Array                                                            | 否       |
| expectSpeech | 该返回是否需要设备打开麦克风进行追问。true代表要追问，默认取值为false | Boolean | 否 |
| shouldEndSession | 该返回是否为会话的终点。true表示会话在响应后结束；false表示会话保持活动状态。如果未提供，则默认为true。我们约定：若回复中包含`AudioPlayer`，且技能没有过多交互，此处取值必须为`true`                                                              | Boolean                                                          | 否       |

### 针对不同请求的响应