iMessage 链接预览无法正常工作或显示灰色气泡
“信息”应用会自行抓取网页,且不会运行 JavaScript。如果没有设置 og:image 和精美的图标,就只会显示一个仅带标题的普通灰色气泡。
最后更新
快速修复
使用元标记检查器检查页面。
添加宽度至少为 900 像素的 og:image 以及不包含您品牌名称的 og:title。
提供至少 108 像素的正方形图标,例如 apple-touch-icon。
带有查询字符串重新发送该链接以查看新的预览。
为什么 iMessage 预览为空或不显示
缺少
og:image。默认情况下,“信息”应用会显示一个带有标题、域名和小图标的灰色气泡。标签是通过 JavaScript 添加的。链接预览不会运行 JavaScript,因此元数据必须存在于 HTML 中。
页面使用了 Meta Refresh 重定向。“信息”应用不会跟随 Meta 重定向。服务器端重定向可以正常工作。
页面过大。主页面限制在 1 MB 以内,图标、图片和视频总计限制在 10 MB 以内。
移动端和桌面端获取的 HTML 不同。Apple 要求两者使用相同的元数据。
如何解决
使用meta 标签检查工具读取标签。
添加宽度至少为 900 像素的
og:image图片。避免在图片中包含文字,因为它可能会以较小尺寸显示。添加至少 108 像素的正方形图标。“信息”应用会使用 apple-touch-icon、favicon 或
<link rel>图标。可以使用 favicon 检查工具进行测试。将
og:title设置为不包含网站名称的页面标题,并将品牌名称放入og:site_name中。将所有 Meta Refresh 替换为服务器端重定向。
“信息”应用读取的标签
用于标题说明的
og:title用于图片的
og:image用于品牌的
og:site_name指向视频文件以供内嵌播放的
og:video或twitter:player:stream来自
apple-touch-icon或 favicon 的图标
图片尺寸规则
图片宽度至少 900 像素
宽度小于 150 像素的图片可能会被忽略或显示为图标
正方形图标,每边至少 108 像素
页面 HTML 最大 1 MB;所有图片、图标和视频总计最大 10 MB
Apple 将这些称为指导原则,并表示限制可能会发生变化。
如何强制刷新
“信息”应用没有刷新工具。发送带有查询字符串的 URL,例如 ?v=2。未经验证:Apple 未公开预览缓存的保留时间。刷新工具也适用于其他应用。
来源
常见问题
为什么 iMessage 只显示灰色的链接气泡?
该页面没有可用的 og:image,因此“信息”将使用标题、域名和图标作为后备显示。请添加一张宽度至少为 900 像素的图片。
iMessage 会运行 JavaScript 来生成预览吗?
不行。Apple 表示链接预览不会运行 JavaScript,也不会遵循 meta 重定向。相关标签必须直接包含在 HTML 中。
iMessage 使用什么尺寸的图标?
Apple 要求提供边长至少为 108 像素的正方形图标,例如 apple-touch-icon。
相关指南
WhatsApp 链接预览无法正常工作或未显示
WhatsApp 限制十分严格:head 必须位于 HTML 的前 300 KB 内,且图片大小必须在 600 KB 以下。只要漏掉其中一项,您就只能看到小图预览,甚至完全没有预览。
Slack 链接预览无法正常工作或未更新
Slack 通过机器人读取 oEmbed、Open Graph 和 Twitter Card 标签来展开链接预览。抓取结果会在 Slack 中缓存约 30 分钟。
X (Twitter) 卡片未显示或未更新
X 会优先根据 twitter: 标签生成卡片预览,如果不存在则会回退使用 og: 标签。现在已经不再提供可以刷新缓存的验证工具了,因此解决方法就是配置正确的标签,并使用一个全新的 URL。