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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：4分

    • JSON コードを追加して、プッシュ通知を重大なアラートにすることができます。iOSおよびAndroidオペレーティングシステムとITSM事業部門では、異なる JSON コードが使用されます。

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

    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 プラグインをアップグレードすると、スクリプトインクルードへの変更が上書きされる可能性があります。