展现卡片

在有屏设备上，您的技能在回复用户时，可以通过使用卡片展现更生动、丰富的内容。常用的展现卡片类型有文本卡片、标准卡片、标准列表卡片、图片卡片。展现卡片随Response消息一起发送给DuerOS。

文本卡片

文本卡片仅包含文本信息。

文本卡片格式

"card": {
    "type":"txt",
    "token":"{{STRING}}",
    "content":"{{STRING}}",
    "url":"{{STRING}}",
    "anchorText": "{{STRING}}",
    "cueWords":[
        "{{STRING}}",
        "{{STRING}}",
        "{{STRING}}",
        ...
    ]
}

文本卡片参数说明

应用举例

在companion app上文本卡片的展现示例。

在其他设备端屏幕上展现示例。

标准卡片

标准卡片包含图片和对应的文本信息。

标准卡片格式

"card": {
    "type":"standard",
    "token":"{{STRING}}",
    "title": "{{STRING}}",
    "content": "{{STRIGN}}", 
    "image": "{{STRING}}",
    "url":  "{{STRING}}",
    "anchorText": "{{STRING}}",
    "cueWords":[
        "{{STRING}}",
        "{{STRING}}",
        "{{STRING}}",
        ...
    ]
}

标准卡片参数说明

应用举例

在companion app上标准卡片的展现示例。

在其他设备端屏幕上展现示例。

标准列表卡片

标准列表卡片是多个标准卡片的集合，包含多张图片和图片相应的文本信息。

标准列表卡片格式

"card": {
    "type":"list",
    "token":"{{STRING}}",
    "list":[
        {
            "title": "{{STRING}}",
            "content": "{{STRIGN}}", 
            "image": "{{STRING}}",
            "url":  "{{STRING}}"
        },
        {
            "title": "{{STRING}}",
            "content": "{{STRIGN}}", 
            "image": "{{STRING}}",
            "url":  "{{STRING}}"
        },
        {...}
    ],
    "url":"{{STRING}}",
    "anchorText": "{{STRING}}",
    "cueWords":[
        "{{STRING}}",
        "{{STRING}}",
        "{{STRING}}",
        ...
    ]
}

标准列表卡片参数说明

应用举例

在companion app上标准卡片列表的示例。

在其他设备端屏幕上展现示例。

图片卡片

图片卡片就是一系列图片集合，在仅展示图片的场景下，建议使用图片卡片模式。

图片卡片格式

"card": {
    "type": "image",
    "token":"{{STRING}}",
    "list": [
        {
            "src":"{{STRING}}",
            "thumb":"{{STRING}}"
        },
        {
            "src":"{{STRING}}",
            "thumb":"{{STRING}}"
        },
        {...}
    ],
    "cueWords":[
        "{{STRING}}",
        "{{STRING}}",
        "{{STRING}}",
        ...
    ]
}

图片卡片参数说明

应用举例

在companion app上图片卡片列表的示例。

在其他设备端屏幕上展现示例。

Screen.LinkClicked事件

在有屏设备端（companion app除外），如果卡片或者卡片列表配置了URL地址，当用户点击卡片或者卡片列表时，DuerOS会向技能发送Screen.LinkClicked事件，技能收到该事件后会返回需要展现的内容。

消息样例

{
    "type": "Screen.LinkClicked",
    "url": "{{STRING}}",
    "requestId": "{{STRING}}",
    "timestamp": {{INT32}}
    "token": "{{STRING}}"
}

参数说明

帐号关联卡片

帐号关联卡片用于有自己的帐号体系的技能。在用户使用技能过程中，如果技能需要用户登录，就可以返回这个卡片引导用户登录。 卡片会在设备对应的展示屏幕中展现登录链接，当用户登录成功后，DuerOS会获取到用户帐号对应的授权accessToken。此后，DuerOS在访问技能时，都会携带该用户账户对应的accessToken。帐号的登录授权通过标准OAuth 2.0协议完成，请参考账户关联了解更多内容。

消息样例

"card": {
    "type": "LinkAccount"
    "token": "{{STRING}}"
}

参数说明

LinkAccountSucceeded事件

当用户使用帐号关联卡片进行账户登录并成功授权时，DuerOS会向技能上报该事件。

消息样例

{
    "type": "Connections.Response",
    "name": "LinkAccountSucceeded",
    "requestId": "{{STRING}}",
    "timestamp": {{INT32}},
    "token": "{{STRING}}"
}

参数说明