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

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:4分
  • JSON コードを追加して、重要なアラートにプッシュ通知することができます。iOSAndroid のオペレーティングシステム、および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 サービス管理 (ITSM) CriticalPushPayloader スクリプトインクルード

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

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