Skip to main content
本指南说明如何使用 图像和富媒体 增强移动推送通知，包括 OneSignal 中的平台支持、技术限制和自定义选项。 其他渠道的图像指南：

Web Push

向网页推送通知添加图像。

设计您的应用内消息

应用内消息编辑器、块和轮播的完整参考。

Email

向邮件添加图像。

SMS

添加图像制作彩信消息。

​
移动应用图像

您可以通过 OneSignal 仪表板或 API 向推送通知添加图像。有两种主要类型：

​
通知图标

  • iOS：使用应用图标。您无法按消息设置图标。
  • Android：您可以设置自定义小图标和大图标。
更多信息请参见通知图标。

​
大图像（大格式）

  • Android：在大多数设备上默认显示展开。
  • iOS：需要用户向下滑动或长按。
添加图像：
  • 在仪表板中：消息 > 新推送 > 图像字段中的“上传”
  • 或使用 API 参数：big_picture (Android) 和 ios_attachments (iOS)

通过 图像 字段在 OneSignal 仪表板中添加图像。

​
图像规格

使用 2:1 纵横比的横向图像。
OneSignal 强制执行 5MB 上传限制，不支持音频或视频上传。托管的图像在 33 天后过期。对于长期使用，请上传到您自己的静态 URL 或使用模板。

​
富通知自定义

OneSignal 支持使用原生平台功能进行更深层次的视觉和交互自定义。

​
Android 自定义通知布局

Android 12+ 对自定义通知强制使用系统模板。但是，您仍然可以使用 Android 的标准通知样式自定义布局。详情请参见行为变更。 自定义您的布局：

​
iOS 内容扩展

iOS 使用 UNNotificationContentExtension 在通知中启用富媒体和交互性。 支持的功能：
  • 图像轮播
  • 嵌入式视频播放
  • 自定义视图，如日历或聊天预览
有关设置说明，请参见我们的 iOS 轮播指南。

​
支持的媒体附件

可以通过指向外部托管内容的 URL 添加富媒体。这在 iOS 上与 UNNotificationContentExtension 一起工作。
  • 确保您的 URL 是文件的直接链接并以正确的扩展名结尾。如果不是，请附加查询（例如，?file=video.mp4），以便 SDK 可以检测媒体类型。
  • OneSignal 对上传图像有 5MB 限制。视频和音频必须在外部托管。直接链接到媒体文件，而不是网页。
OneSignalNotificationServiceExtension 包含在 OneSignal SDK 中，是图像支持、送达跟踪和徽章更新所必需的。

​
测试提示

确保您的媒体在各种设备上正确显示：
  • 始终在真实设备上测试（而不是模拟器）。
  • iOS 需要长按或向下滑动才能显示富媒体。
  • Android 渲染因设备、操作系统版本和操作按钮的存在而异。
  • 在启动活动之前在 OneSignal 中使用 “发送测试” 按钮。

​
示例用例

  • 在废弃购物车提醒中显示产品照片
  • 通过视频预览推广新电影预告片（仅 iOS）
  • 为闪购发送动态横幅

​
故障排除

如果您的图像未按预期显示，请参阅 通知图像不显示 指南以了解常见原因和修复方法。