# 图片模块

图片模块用于展示整张图片。建议需要着重展示的图片使用此模块,用户点击图片后可以查看大图。

为了保证图片在聊天窗口中呈现较高的清晰度和信噪比,建议上传的图片遵循以下规范:

  • 图片宽度接近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
最后更新于 : 9/14/2023, 5:33:24 PM