バッジ

​

Androidバッジ

​

Huaweiバッジ

​

Huaweiバッジの仕組み

• バッジは、ユーザーのデバイスレベルのバッジ表示設定（デバイスの設定 > 通知 > アプリアイコンバッジで制御）に応じて、数値カウントまたはドットとしてアプリアイコンに表示されます。APIコールは基礎となるカウントを制御し、デバイスが視覚的なスタイルを決定します。
• huawei_badge_classは、あらゆるバッジ操作に必須です。これは<package_name>.<ActivityName>形式（例：com.example.myapp.MainActivity）のアプリのエントリActivityの完全修飾クラス名です。これは、どのアプリアイコンにバッジを適用するかをHuaweiシステムに伝えます。
• 同じリクエストでhuawei_badge_set_numとhuawei_badge_add_numの両方を設定した場合、huawei_badge_set_numが優先されます。
• huawei_badge_set_numもhuawei_badge_add_numも指定されていない場合（ただしhuawei_badge_classは設定されている場合）、バッジカウントはデフォルトで1増加します。
• huawei_badge_set_numは0から99の値を受け付けます。0に設定するとバッジがクリアされます。
• huawei_badge_add_numは1から99の値を受け付けます。例えば、アプリが現在バッジ5を表示しており、huawei_badge_add_num: 3を送信すると、バッジは8になります。

​

バッジ付きHuaweiプッシュを送信

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_set_num": 5
}

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_add_num": 1
}

{
  "huawei_badge_class": "com.example.myapp.MainActivity",
  "huawei_badge_set_num": 0
}

​

バッジのクリア

• APIまたはダッシュボード経由：huawei_badge_set_numを0に設定した通知を送信します（またはダッシュボードで設定 > 0を使用）。目に見える通知を表示したくない場合は、データ/バックグラウンド通知を使用できます。
• クライアントサイドコード経由：アプリはHuaweiバッジAPIを使用してローカルでバッジをクリアできます。これにはAndroidManifest.xmlにcom.huawei.android.launcher.permission.CHANGE_BADGE権限が必要です。実装の詳細については、Huaweiバッジ開発ガイドを参照してください。

​

iOSバッジ

• OneSignalNotificationServiceExtension
• App Groups

1. アプリが開かれたときにアプリアイコンバッジをクリアします。
2. 通知センターから通知を削除します。

• アプリの起動または再開時にバッジをリセット
• フォアグラウンドで通知を受信したときにバッジを増加
• メッセージが読まれたり削除されたりしたときに減少
• App Groupsまたはバックエンドを介してデバイス間またはアプリ拡張機能間でバッジ状態を同期

​

自動通知とバッジクリアを無効にする

<key>OneSignal_disable_badge_clearing</key>
<true/>

​

iOSネイティブバッジ管理

import UserNotifications
import UIKit

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(5) { error in
    if let error = error {
      print("バッジ数の設定に失敗しました: \(error.localizedDescription)")
    } else {
      print("バッジ数が正常に更新されました。")
    }
  }
} else {
  UIApplication.shared.applicationIconBadgeNumber = 5
}

// 例：UserDefaultsを使用してバッジ数を保存および取得
let badgeCount = UserDefaults.standard.integer(forKey: "badgeCount")
// 必要に応じてバッジ数を更新
UserDefaults.standard.set(badgeCount, forKey: "badgeCount")

// 例：バッジ数を増加してシステムバッジを更新
let currentCount = UserDefaults.standard.integer(forKey: "badgeCount")
let updatedCount = max(0, currentCount + 1)
UserDefaults.standard.set(updatedCount, forKey: "badgeCount")

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(updatedCount)
} else {
  UIApplication.shared.applicationIconBadgeNumber = updatedCount
}

if #available(iOS 17.0, *) {
  UNUserNotificationCenter.current().setBadgeCount(0)
} else {
  UIApplication.shared.applicationIconBadgeNumber = 0
}

​

バッジ付きiOSプッシュを送信

• ダッシュボード
• API

1. Messages > PushまたはTemplatesに移動
2. Platform Settings > Send to Apple iOS > Badgesの下
3. 次のいずれかを選択：
   • 特定の数値に設定
   • 相対的な量で増加

Create message APIで次のパラメータを使用します：

• ios_badgeType - SetToまたはIncreaseに設定
• ios_badgeCount - 設定または増加する数値

コピー

AIに質問

{
  "ios_badgeType": "Increase",
  "ios_badgeCount": 1
}