Android notification categories

Android通知カテゴリ（別名：通知チャネル）は、Android 8.0（Oreo）で導入され、ユーザーがアプリからの通知をどのように受信するかをより詳細に制御できるようになりました。これにより、通知を分類し、表示動作、サウンド、バイブレーション、バッジ、ロック画面の表示など、さまざまな体験を定義できます。 たとえば、速報ニュース通知がある場合、それ用のカテゴリを作成し、「緊急」の重要度とカスタムサウンドを設定して、ミュートされたりデフォルトサウンドが使用される可能性のあるあまり重要でない通知とは対照的に、目立つように表示されるようにできます。 OneSignalを使用すると、ダッシュボード内で直接これらのカテゴリを簡単に作成および管理できます。または、アプリ内でプログラムで定義することもできます。Androidの通知チャネル作成ガイドを参照してください。

---

​

デフォルト通知カテゴリ

OneSignalは自動的に2つのデフォルトカテゴリを作成します：

​

Miscellaneous

カテゴリが設定されていない場合に使用されます。

• Importance: High
• Sound: Default
• Vibration: Default
• Badges: 有効
• Lockscreen: Private

​

Restored

アプリが強制終了されて再度開かれたときに使用されます。アプリが強制終了されたときに通知センターにプッシュ通知がある場合、それらはデバイスから削除されます。アプリを再度開くと、これらの通知が再作成（復元）されます。当社のSDKは、カテゴリを自動的に「Restored」に設定し、以下の設定を使用して、サウンドやポップアップを伴う複数の通知がアプリから届くことによる望ましくない動作や潜在的な顧客の不満を防ぎます。

• Importance: Low
• Sound: Off
• Vibration: Off
• Badges: 無効
• Lockscreen: Private

​

Huawei固有の動作

Huaweiデバイスでは、OneSignalはデフォルトカテゴリを設定しません。含めない場合、HuaweiはデフォルトでHigh重要度を適用します。

---

​

OneSignalでAndroid通知カテゴリを作成する

1. OneSignalダッシュボードでSettings > Push & In-App > Android Notification Channelsに移動します。
2. Add Groupをクリックしてカテゴリを整理します（例：「ニュース更新」、「ソーシャルアクティビティ」）。
3. グループ内でAdd Channelをクリックして新しいカテゴリを作成します。

以下を定義するように求められます：

​

Name

*ユーザーに表示されます。*明確で説明的なものにしてください。

​

Description

*ユーザーに表示されます。*このカテゴリが処理する通知のタイプを簡潔に説明します。

​

Importance

通知の表示方法と割り込み度を制御します：

• **Low：**無音、アラートなし
• **Medium：**サウンド/バイブレーションなし、最小限の視覚的割り込み
• **High：**サウンドを再生またはバイブレーション、画面ポップアップなし
• **Urgent：**サウンドを再生し、ヘッズアップまたはバナースタイルの通知として表示

​

Sound

• **Off：**サウンドなし
• **Default：**デバイスのデフォルト通知音
• **Custom：**カスタムサウンドをアップロードして参照します（ファイル拡張子なし）。 例：alert_beep（alert_beep.wavではない） セットアップ手順については、Notification Soundsを参照してください。

​

Vibration

• **Off：**バイブレーションなし
• **Default：**デバイスのバイブレーションパターンを使用
• **Custom：**パターンを使用して独自のものを定義します（ミリ秒単位）。 例：0, 300, 500, 300 → 0ms待機、300msバイブレーション、500ms一時停止、300msバイブレーション。

​

LED Color

一部のAndroidデバイスはLEDインジケーターをサポートしています：

• **Off：**LEDなし
• **Default：**デバイスのデフォルト
• **Custom：**ARGB 16進値（例：青の場合はFF0000FF）

​

Badges

アプリアイコンにバッジカウントを表示します：

• **Enabled：**バッジが表示されます
• **Disabled：**バッジは表示されません

​

Lockscreen visibility

• **Public：**完全なコンテンツが表示されます
• **Private：**アプリ名のみ、コンテンツは非表示
• **Secret：**ロック画面に通知が表示されません

---

​

カテゴリの更新

デバイスがカテゴリから通知を受信した後、Androidはそのカテゴリの動作をロックします。重要度、サウンド、バイブレーション、その他の設定への変更は遡及的に適用されません。たとえば、「High」の重要度とサウンドを使用するカテゴリでプッシュ通知を送信し、その後、重要度を「Urgent」に変更して別のサウンドファイルを使用した場合、同じカテゴリを使用して同じデバイスに送信される次のプッシュ通知には、「Urgent」の重要度や新しいサウンドは適用されません。 オプション：

• **動作を更新するには：**新しいカテゴリを作成します。
• **変更をテストするには：**アプリデータをクリアするか、アプリをアンインストールして再インストールします。

更新できるもの：

• チャネル名
• チャネルグループ名

これらは、更新されたチャネルを使用して次の通知が受信されたときに、Androidの通知設定で更新されます。

---

​

カテゴリの削除

削除されたカテゴリをユーザーのデバイスから削除するには：

1. OneSignalダッシュボードからカテゴリを削除します。
2. Notification Centerからすべての通知がクリアされていることを確認します。
3. ユーザーに以下を実行してもらいます：
   • アプリを60秒以上バックグラウンドに置く
   • 再度開く（SDK同期をトリガー）

SDKが再同期し、削除されたカテゴリをAndroid設定から削除します。

---

​

通知にカテゴリを追加する

Androidカテゴリの作成方法とメッセージの送信方法に応じて、プッシュ通知でカテゴリを参照する方法は次のとおりです。

​

OneSignalダッシュボードから送信する

1. テンプレートまたはプッシュメッセージコンポーザー内で、Android設定に移動します。
2. Categoryの下で、OneSignalダッシュボードで作成した場合はカテゴリを選択し、アプリ内でプログラムで作成した場合は**（Created in App）**を選択します。
   • プログラムで作成した場合は、Existing Channelフィールドもコードで定義された名前に設定します。

​

REST APIを使用して送信する

OneSignalダッシュボードでカテゴリを作成した場合は、Create message APIリクエストでandroid_channel_idを使用します。Channel IDはAndroidカテゴリ設定画面で確認できます。 独自にプログラムで作成したAndroidチャネルを使用している場合は、Create message APIリクエストでexisting_android_channel_idパラメータを使用し、コードで定義された名前に設定します。

---

​

FAQとトラブルシューティング

​

カテゴリはおやすみモード（DND）でサウンドを再生できますか？

いいえ。OneSignalはカテゴリにsetBypassDndを設定しません。DNDをオーバーライドするには、プログラムで独自のチャネルを作成し、この設定を有効にします。setBypassDndを参照してください。

​

カテゴリ名または説明をローカライズできますか？

いいえ。OneSignalはカテゴリの複数言語をサポートしていません。ローカライズをサポートするには、独自のAndroidチャネルを定義し、プッシュAPIリクエストでexisting_android_channel_idを介してそれらを参照します。

​

Androidカテゴリが機能しないのはなぜですか？

Androidカテゴリが期待どおりに機能しない理由はいくつかあります。トラブルシューティングを行うには、以下を確認してください：

• 何が機能していませんか？
  • サウンドファイルが再生されませんか？
  • デバイスに表示されませんか？
  • Android通知設定にカテゴリが表示されませんか？
• カテゴリはどのように作成されましたか？
  • OneSignalダッシュボードで作成した場合は、設定が期待どおりに定義されていることを確認してください。
  • アプリ内でプログラムで作成した場合は、コードを確認してください。Androidの通知チャネル作成ガイドを参照してください。
• カテゴリ設定を確認してください：
  • 設定が期待どおりに定義されていることを確認してください。
  • サウンドファイルが正しく参照されていますか？上記のSoundセクションを参照してください。
  • メッセージを送信するときにカテゴリ名またはIDが正しく参照されていますか？
• 通知を送信した後に設定を更新しましたか？
  • 通知を送信した後に設定を更新した場合、Androidはそれらの更新をデバイスに適用しません。上記のカテゴリの更新を参照してください。
• OneSignal SDKの初期化を確認してください：
  • OneSignalがActivityではなくApplicationクラスで初期化されていることを確認してください。Android SDK Setupを参照してください。

---