푸시 알림에 대한 소리 구성

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 3분
  • 푸시 알림에 소리와 신호음을 추가하여 메시지가 긴급하거나 사용자의 주의가 필요한 경우 사용자에게 알립니다.

    푸시 알림에 소리를 추가하기 위한 JSON 예

    다음 JSON은 푸시 알림에 신호음을 추가하는 방법의 예입니다. 예에 사용된 신호음의 이름은 NotificationAlert-2"입니다.
    json["aps"]["sound"] = "NotificationAlert-2.caf";

    이 항목의 끝에 있는 표에는 사용 가능한 모든 신호음이 나열됩니다. 각 소리의 톤을 들으려면 대상 소리 매개변수를 사용하여 알림을 구성해야 합니다.

    주:
    각 톤에 대해 접미사 -Short를 추가하여 링의 길이를 줄이는 옵션이 있습니다. NotificationAlert-5.caf를 제외한 모든 신호음을 단축할 수 있습니다.

    소리를 포함한 중요 경보에 대한 JSON 예

    다음 JSON은 중요 경보에 대해 sound 매개변수를 정의하는 방법의 예입니다. 중요 경보에 대한 자세한 내용은 다음 문서를 참조하십시오 모바일 중요 경보.

    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-3-Short.caf", 
              "volume": 1.0 
          }; 
    
    샘플 JSON 코드의 매개변수는 다음과 같습니다.
    • 매개변수는 critical 알림을 심각 경보로 정의합니다. 1 은 중요 경보가 활성 상태임을 의미하고, 0 은 중요 경보가 비활성 상태임을 의미합니다.
    • 매개변수는 volume 알림 소리의 볼륨을 정의합니다. 범위는 가장 조용한 0.1 에서 가장 큰 1.0 까지입니다.
    • 매개변수는 name 푸시 알림이 전송될 때 활성화되는 신호음의 이름입니다. 중요한 경보의 경우 극적인 톤으로 사용자 리듬을 고려합니다.
      주:
      name 값이 정의되지 않은 경우 시스템은 애플리케이션의 기본 신호음을 사용합니다. 응용프로그램에 정의된 신호음이 없는 경우 시스템은 장치의 기본 신호음을 사용합니다.

      각 소리의 톤을 들으려면 대상 소리 매개변수를 사용하여 알림을 구성해야 합니다.

      수락된 값이 테이블에 나열됩니다.
      주:
      각 톤에 대해 접미사 -Short를 추가하여 링의 길이를 줄이는 옵션이 있습니다. NotificationAlert-5.caf를 제외한 모든 신호음을 단축할 수 있습니다.
      수락된 파일 이름 값 톤 리듬
      NotificationAlert-1.caf 부드럽고, 편안하고, 천천히
      NotificationAlert-1-Short.caf 부드럽고, 편안하고, 천천히
      NotificationAlert-2.caf 극적인
      NotificationAlert-2-Short.caf 극적인
      NotificationAlert-3.caf 극적인
      NotificationAlert-3-Short.caf 극적인
      NotificationAlert-4.caf 부드럽고, 편안하고, 천천히
      NotificationAlert-4-Short.caf 부드럽고, 편안하고, 천천히
      NotificationAlert-5.caf 부드럽고, 편안하고, 천천히
      NotificationAlert-6.caf 축제, 행복
      NotificationAlert-6-Short.caf 축제, 행복
      NotificationAlert-7.caf 축제, 행복
      NotificationAlert-7-Short.caf 축제, 행복
      NotificationAlert-8.caf 축제, 행복
      NotificationAlert-8-Short.caf 축제, 행복
      NotificationAlert-9.caf 극적이고 강력함
      NotificationAlert-9-Short.caf 극적이고 강력함
      NotificationAlert-10.caf 드라마틱하고 긴장감 넘치는
      NotificationAlert-10-Short.caf 드라마틱하고 긴장감 넘치는
      NotificationAlert-11.caf 극적인
      NotificationAlert-11-Short.caf 극적인
      NotificationAlert-12.caf 극적인
      NotificationAlert-12-Short.caf 극적인
      NotificationAlert-13.caf 극적인
      NotificationAlert-13-Short.caf 극적인
      NotificationAlert-14.caf 극적인
      NotificationAlert-14-Short.caf 극적인
    주:
    이름 값이 정의되지 않은 경우 시스템은 애플리케이션의 기본 벨소리를 사용합니다. 응용프로그램에 정의된 신호음이 없는 경우 시스템은 장치의 기본 신호음을 사용합니다.