重要なアラートのコードの構成

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • JSON コードを追加して、プッシュ通知を重大なアラートにすることができます。iOS オペレーティングシステムとAndroidオペレーティングシステム、およびITSM事業部門では、異なる JSON コードが使用されます。

    重大なアラート通知を作成するときは、プッシュ通知メッセージのコード構造と、通知を重大なアラートとして定義する必須の JSON コードが必要です。このコードは、[プッシュ メッセージ コンテンツ] 領域に追加します。詳細については、「モバイルの重要なアラート」を参照してください。

    重要:

    Android プラットフォームでは、ユーザーが特定の電話タイプで重大なアラートを受信すると、次のデバイス動作が発生する可能性があります。

    ハードウェア制御の呼び出し音モードを備えた OnePlus デバイス:
    着信音モードが物理スイッチによって制御される OnePlus などのデバイスでは、デバイスがサイレント モードまたはバイブレーション モードに設定されている場合、アプリが通知音の音量をオーバーライドできない場合があります。
    OnePlus または Oppo デバイスの応答不可モードの動作:
    Oppo や OnePlus などの特定のデバイスでは、サイレント (DND) モードが有効になっている場合、重要な通知音の再生が完了するまで DND 設定が一時的にオフになる場合があります。
    バージョン 20.0.0 以降の Android クライアントでは、重大なアラートは以下では機能しません。
    • Android 15 で導入された Android Private Space 機能。
    • Android モバイルデバイス管理 (MDM) ソフトウェアによって管理されているデバイス。Microsoft Intune など。

    Androidオペレーティングシステムをアクティブ化するための重要なアラート JSON

    次のコードは、重大なアラートをトリガーできるように、デバイスのウェイクアップをアクティブ化するため Android JSON コードに追加する必要があります。
    注:
    ユーザーは iOS デバイスと Android デバイスの両方を使用しているため、このコードを追加する必要があります。コード内の JSON エントリは、スクリプトから返された辞書名の値です。
     
    
    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
    

    すべてのオペレーティングシステムの重要なアラート JSON

    通知が重大なアラートとして動作するように、次の JSON を追加する必要があります。

    var json = {};
    json["aps"] = { 
    "sound": {
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
    }
          };
    
    サンプル JSON コードのパラメーターは次のとおりです。
    • critical パラメーターでは、通知を重大なアラートとして定義します。1 は重要なアラートがアクティブであることを意味し、0 は重要なアラートが非アクティブであることを意味します。
    • nameパラメーターは、重大なアラートが送信されたときにアクティブになるトーンの名前です。重要なアラートのトーンの一部が表にリストされています。完全なリストについては、「 プッシュ通知のサウンドの構成」を参照してください。
      使用できるファイル名の値 トーンリズム
      NotificationAlert-2.caf 劇的
      NotificationAlert-2-Short.caf 劇的
      NotificationAlert-9.caf ドラマチックでパワフル
      NotificationAlert-9-Short.caf ドラマチックでパワフル
      NotificationAlert-10.caf ドラマチック、サスペンスフル
      NotificationAlert-10-Short.caf ドラマチック、サスペンスフル
      注:
      name値が定義されていない場合は、アプリケーションのデフォルトの着信音が使用されます。アプリケーションに着信音が定義されていない場合は、デバイスのデフォルトの着信音が使用されます。
    • volume パラメーターは、重大なアラート音の音量を定義します。範囲は、最も静かな 0.1 から最も大きな 1.0 までです。

    重大なアラートの JSON コードブロックの例

    以下は、 Android および iOS デバイスの重大なアラートをアクティブ化するために追加および構成する必要がある JSON コードの完全なサンプルです。

    json["sncGoogleKeys"] = { 
              "android": { 
                  "priority": "high" 
              }, 
              "priority": "high" 
          }; 
      
    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-1.caf", 
              "volume": 1.0 
          };

    IT Service Management (ITSM) CriticalPushPayloader スクリプトインクルード

    プッシュメッセージコンテンツ領域には、ITSM事業部門によって作成されたスクリプトインクルード CriticalPushPayLoadBuilder を含む、以前に構成されたコードが含まれている場合があります。その場合、重要なアラートに対する追加の構成は必要ありません。スクリプトインクルードは、関数またはクラスを定義する再利用可能なサーバーサイドのスクリプトロジックです。 CriticalPushPayLoadBuilder は、重大なアラートをサポートする関数を含むスクリプトインクルードです。スクリプトインクルードの呼び出しは次のようになります 。CriticalPushPayloadBuilder (current, json, attributes).buildJSON()
    注:
    [ボリューム] パラメーターまたは [名前] パラメーターの値を変更する必要がある場合、またはアラートを重大から重大でないに変更する必要がある場合は、スクリプトインクルードが入力として取得する関数パラメーターにアクセスする必要があります。

    重要なアラートスクリプトインクルードの値を変更すると、スクリプトインクルードのすべての ITSM 実装に影響します。同様に、 ITSM プラグインのアップグレードによって、スクリプトインクルードへの変更が上書きされる場合があります。