중요 경보에 대한 코드 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 4분

    • 일부 JSON 코드를 추가하여 푸시 알림을 중요 경보로 만들 수 있습니다. 운영 체제 및 비즈니스 단위에 ITSM 대해 다양한 JSON 코드가 사용됩니다.iOSAndroid

    중요 경보 알림을 생성하려면 푸시 알림 메시지의 코드 구조와 알림을 중요 경보로 정의하는 필수 JSON 코드가 필요합니다. 푸시 메시지 내용 영역에 이 코드를 추가합니다. 자세한 내용은 모바일 중요 경보 문서를 참조하십시오.

    중요사항:

    Android 플랫폼에서 사용자가 특정 전화 유형에 대해 중요한 경보를 수신하면 다음과 같은 장치 동작이 발생할 수 있습니다.

    하드웨어 제어 벨소리 모드가 있는 OnePlus 장치:
    벨소리 모드가 물리적 스위치로 제어되는 OnePlus와 같은 장치에서 장치가 무음 또는 진동 모드로 설정된 경우 앱이 알림 사운드 볼륨을 재정의하지 못할 수 있습니다.
    OnePlus 또는 Oppo 장치 방해 금지 모드 동작:
    Oppo 및 OnePlus와 같은 특정 장치에서 방해 금지(DND) 모드가 활성화된 경우 중요한 알림음 재생이 완료될 때까지 DND 설정이 일시적으로 꺼질 수 있습니다.
    클라이언트 버전 20.0.0 이상에서는 Android 심각 경보가 다음에 대해 작동하지 않습니다.
    • 15 Android 에서 Android 도입된 비공개 공간 기능입니다.
    • Android MDM(모바일 장치 관리) 소프트웨어에서 관리하는 디바이스입니다. 예: Microsoft Intune.

    운영 체제를 활성화 Android 하기 위한 중요 경보 JSON

    다음 코드는 중요 경보를 트리거할 수 있도록 절전 모드 해제를 위해 장치를 활성화 Android 하기 때문에 JSON 코드에 추가해야 합니다.
    주:
    사용자가 및 Android 장치를 모두 iOS 사용하기 때문에 이 코드를 추가해야 합니다. 코드의 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 코드 블록 예

    다음은 및 iOS 장치에 대한 Android 중요 경보를 활성화하기 위해 추가하고 구성해야 하는 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 스크립트 포함

    푸시 메시지 콘텐츠 영역에는 비즈니스 단위에서 생성한 스크립트 포함 CriticalPushPayLoadBuilder를 포함하여 이전에 구성된 코드가 포함될 수 있습니다ITSM. 그렇다면 중요 경보에 대한 추가 구성이 필요하지 않습니다. 스크립트 포함은 기능 또는 클래스를 정의하는 재사용 가능한 서버측 스크립트 논리입니다. CriticalPushPayLoadBuilder 는 중요한 경보를 지원하는 기능이 포함된 스크립트 포함입니다. 스크립트 포함의 호출은 다음과 같습니다. CriticalPushPayloadBuilder (current, json, attributes).buildJSON()
    주:
    볼륨 또는 이름 매개변수의 값을 변경하거나 경보를 중요에서 중요하지 않음으로 변경해야 하는 경우 스크립트 포함이 입력으로 가져오는 함수 매개변수에 액세스해야 합니다.

    중요 경보 스크립트 포함의 값을 변경하면 스크립트 포함의 모든 ITSM 구현에 영향을 줍니다. 마찬가지로 플러그인 업그레이드는 ITSM 스크립트 포함에 대한 변경 사항을 재정의할 수 있습니다.