モバイルアプリの画像
OneSignalダッシュボードまたはAPIを介してプッシュ通知に画像を追加できます。主に2つのタイプがあります：通知アイコン
- iOS：アプリアイコンを自動的に使用します。
- Android：カスタムの大きいアイコンと小さいアイコンを許可します。
- セットアップ手順については、通知アイコンを参照してください。
ビッグピクチャー画像（大きい形式）
- Android：ほとんどのデバイスでデフォルトで展開表示されます。
- iOS：ユーザーがスワイプダウンまたは長押しする必要があります。
- ダッシュボードの場合：Messages > New Push > 画像フィールドに「Upload」
- またはAPIパラメータを使用：
big_picture（Android）およびios_attachments（iOS）
OneSignalダッシュボードの「Image」フィールドから画像を追加します。
画像仕様
2:1のアスペクト比の横向き画像を使用してください。| iOS | Android | |
|---|---|---|
| ファイルタイプ | jpg, jpeg, png, gif | jpg, jpeg, png, gif* |
| 解像度 | 1:1アスペクト比または2:1アスペクト比（例：1038x1038pxまたは1024×512px）最大幅： 2000px 最小幅： 300px | 2:1アスペクト比（例：1024×512px）最大幅： 2000px 最小幅： 300px |
| APIパラメータ | ios_attachments | big_picture |
- *AndroidはアニメーションGIFをサポートしていません。
- アクションボタンを追加すると、画像表示領域が縮小される場合があります。
- 画像が表示されない場合は、通知画像が表示されないを参照してください。
OneSignalは5MBのアップロード制限を適用し、オーディオまたはビデオのアップロードはサポートしていません。ホストされた画像は33日後に期限切れになります。長期使用の場合は、独自の静的URLにアップロードするか、テンプレートを使用してください。
リッチ通知のカスタマイズ
OneSignalは、ネイティブプラットフォーム機能を使用して、より深い視覚的およびインタラクティブなカスタマイズをサポートします。Androidカスタム通知レイアウト
Android 12+は、カスタム通知にシステムテンプレートを適用します。ただし、Androidの標準通知スタイルを使用してレイアウトをカスタマイズできます。詳細については、動作変更を参照してください。 レイアウトをカスタマイズするには：- Androidのカスタム通知ガイドに従ってください
- 通知サービス拡張を介して変更を適用します
- 使用可能なカスタマイズについては、Notification.DecoratedCustomViewStyleを参照してください。
iOSコンテンツ拡張
iOSはUNNotificationContentExtensionを使用して、通知でリッチメディアとインタラクティブ性を有効にします。
サポートされている機能：
- 画像カルーセル
- 埋め込みビデオ再生
- カレンダーやチャットプレビューなどのカスタムビュー
サポートされているメディア添付ファイル
リッチメディアは、外部ホストコンテンツへのURLを介して追加できます。これは、iOSのUNNotificationContentExtensionで機能します。
- URLがファイルへの直接リンクであり、正しい拡張子で終わることを確認してください。そうでない場合は、クエリ（例：
?file=video.mp4）を追加して、SDKがメディアタイプを検出できるようにします。 - OneSignalは、アップロードされた画像に5MBの制限があります。ビデオとオーディオは外部にホストする必要があります。Webページではなく、メディアファイルに直接リンクしてください。
| 添付ファイル | ファイルタイプ | 最大サイズ | 要件 |
|---|---|---|---|
| オーディオ | aif, aiff, wav, mp3 | 5MB | なし |
| ビデオ | mp4, mpeg, mpeg2, mpeg4, avi | 50MB | UNNotificationContentExtension |
| 画像 | jpg, jpeg, png, gif | 10MB | OneSignalNotificationServiceExtension |
OneSignalNotificationServiceExtensionはOneSignal SDKに含まれており、画像サポート、配信追跡、およびバッジ更新に必要です。
テストのヒント
メディアがデバイス全体で正しく表示されることを確認してください：- 常に実際のデバイスでテストします（エミュレーターではありません）。
- iOSでは、リッチメディアを表示するために長押しまたはスワイプダウンが必要です。
- Androidのレンダリングは、デバイス、OSバージョン、およびアクションボタンの有無によって異なります。
- キャンペーンを開始する前に、OneSignalの**「Send Test」**ボタンを使用してください。
ユースケースの例
- カート放棄リマインダーに製品写真を表示する
- ビデオプレビュー（iOSのみ）で新しい映画の予告編を宣伝する
- フラッシュセール用のアニメーションバナーを送信する