プッシュ通知配信における音とステータスバーの調整方法


プッシュ通知の重要度

プッシュ通知を送るときに、重要度を設定することで、端末が受信するときの動作が変わります。たとえば:

  • ロック画面の表示
  • サウンドの有無
  • バイブレーションの有無

などです。

プッシュ通知の重要度

HMSのプッシュ通知はFCMのプッシュ通知と同じく、通知メッセージとデータメッセージがあります。

HMS通知メッセージ

API : https://push-api.cloud.huawei.com/v2/{projectid}/messages:send
APIに渡すリクエストボディの中で設定します。

例:

{
    "message": {
        "android": {
            "notification": {
                "//": "importanceの選択可能な値:HIGH | NORMAL | LOW",
                "importance": "HIGH",
                "title": "タイトル",
                "body": "本文",
                "click_action": {
                    "type": 1,
                    "intent": "#Intent;compo=com.rvr/.Activity;S.W=U;end"
                }
            }
        },
        "token": ["IQAAAACy0ZkDAACZ_VUOaDgQGI2CWnXnqyJuFO0HBhFSAMJ_e4Rxwz31DkS_MIeTskmoKdmJJlAkeAuXiVQXtnksy1unQTlBxhJsMqJiWuZVvws1zQ"]
    }
}
重要度 効果
HIGH 音が鳴り、ステータスバーにも表示されます。
NORMAL 音が鳴り、ステータスバーにも表示されます。
LOW 音は鳴らず、ステータスバーにも表示されません。

HMSデータメッセージと一般的なAndroidのプッシュ通知

通知チャンネルを作成時に重要度を設定します。

val channel = NotificationChannel(
            CHANNEL_ID,
            CHANNEL_NAME,
            {重要度}
        )
重要度 効果 パラメータ
緊急 音が鳴り、ヘッドアップ通知として表示されます。 NotificationManager.IMPORTANCE_HIGH
音が鳴ります。 NotificationManager.IMPORTANCE_DEFAULT
音は鳴りません。 NotificationManager.IMPORTANCE_LOW
音は鳴らず、ステータスバーにも表示されません。 NotificationManager.IMPORTANCE_MIN

詳しくは“HMSのプッシュ通知の受信方法とAndroidのプッシュ通知の表示方法の説明”をご参照ください。

参考