# 图片模块
图片模块用于展示整张图片。建议需要着重展示的图片使用此模块,用户点击图片后可以查看大图。
为了保证图片在聊天窗口中呈现较高的清晰度和信噪比,建议上传的图片遵循以下规范:
- 图片宽度接近1160px,保证图片的清晰度(当图片宽度撑满卡片时,上传两倍图:580px*2=1160px;按实际宽度上传两倍图即可)
- 图片的高度与宽度比例不超过16:9,超高的图片将占用过多的窗口高度,降低了卡片的信噪比,建议不宜上传超高图片如果一定要上传超高图片,整体缩小图片比例
- 文件大小不超过5M,超过后图片将无法上传使用
# 字段属性说明
参数 | 是否必须 | 类型 | 示例值 | 说明 |
---|---|---|---|---|
tag | 是 | String | img | 模块标签,固定值img。 |
imgKey | 是 | String | 1. 图片资源的key值, 获取方法:在消息卡片搭建工具 (opens new window)中,hover到图片上时展示上传入口,上传成功后imgKey自动填充json。 ![]() 2. 使用图片上传接口获取的图片url填充imgKey: 如 https://hi.zhipin.com/api/media/download/TsD7SZo1E7Szgb1MD9-WQRboUJweItNLzmlHUutgu8gz5FB9RAtc1cqJWodzSKiPlr1ZTzbP2g~~__344x278_s300.jpg | |
alt | 否 | Struct | text结构体 | hover图片时弹出的说明文案。 |
title | 否 | Struct | text结构体 | 图片标题。 |
preview | 否 | Boolean | true | 点击后是否放大图片,默认为true。 如在配置card_link后可设置为false,使用户点击卡片上的图片也能响应card_link链接跳转。 |
# 卡片示例
# json示例
{
"modules":[
{
"tag":"img",
"title":{
"tag":"plain_text",
"content":"这是图片搭配文案"//这里指展示在图片上方的图片标题文案,如果不需要,可以删除title结构体
},
"img_key":"9f6**315",
"alt":{
"tag":"plain_text",
"content":"Hover图片后的tips提示"//这里指hover图片后的tips提示,如果不需要,可以删除alt结构体
},
"preview": true
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17