Configurar sons para notificações por push

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • Adicione sons e tons às notificações por push para indicar aos usuários se uma mensagem é urgente ou apenas requer atenção dos usuários.

    JSON de exemplo para adicionar som a notificações por push

    O JSON a seguir é um exemplo de como adicionar um tom à sua notificação por push. O nome do tom usado no exemplo é NotificationAlert-2".
    json["aps"]["sound"] = "NotificationAlert-2.caf";

    A tabela no final deste tópico lista todos os tons disponíveis. Para ouvir o tom de cada som, você deve configurar uma notificação com o parâmetro de som de destino.

    Nota:
    Para cada tom, você tem a opção de encurtar o comprimento do toque adicionando o sufixo - Curto . Você pode encurtar todos os tons, exceto NotificationAlert-5.caf .

    JSON de exemplo para alertas críticos, incluindo som

    O JSON a seguir é um exemplo de como o parâmetro de som é definido para alertas críticos. Para obter mais informações sobre alertas críticos, consulte Alertas críticos para dispositivos móveis.

    json["aps"]["sound"] = { 
              "critical": 1, 
              "name": "NotificationAlert-3-Short.caf", 
              "volume": 1.0 
          }; 
    
    Os parâmetros no código JSON de amostra são os seguintes:
    • . criticalo parâmetro define a notificação como um alerta crítico. 1 significa que o alerta crítico está ativo, 0 significa que o alerta crítico está inativo.
    • . volumeo parâmetro define o volume do som de notificação. O intervalo é de 0,1 mais silencioso para 1,0 mais alto.
    • . nameo parâmetro é o nome do tom que é ativado quando uma notificação por push é enviada. Para alertas críticos, considere os ritmos do usuário com um tom dramático.
      Nota:
      Se for um nameo valor não está definido, o sistema usa o toque padrão da aplicação. Se uma aplicação não tiver um toque definido, o sistema usará o toque padrão do dispositivo.

      Para ouvir o tom de cada som, você deve configurar uma notificação com o parâmetro de som de destino.

      Os valores aceitos são listados na tabela.
      Nota:
      Para cada tom, você tem a opção de encurtar o comprimento do toque adicionando o sufixo - Curto . Você pode encurtar todos os tons, exceto NotificationAlert-5.caf .
      Valores de nome de arquivo aceitos Ritmo do tom
      NotificationAlert-1.caf Suave, relaxante, lento
      NotificationAlert-1-Short.caf Suave, relaxante, lento
      NotificationAlert-2.caf Dramático
      NotificationAlert-2-Short.caf Dramático
      NotificationAlert-3.caf Dramático
      NotificationAlert-3-Short.caf Dramático
      NotificationAlert-4.caf Suave, relaxante, lento
      NotificationAlert-4-Short.caf Suave, relaxante, lento
      NotificationAlert-5.caf Suave, relaxante, lento
      NotificationAlert-6.caf Festivo, feliz
      NotificationAlert-6-Short.caf Festivo, feliz
      NotificationAlert-7.caf Festivo, feliz
      NotificationAlert-7-Short.caf Festivo, feliz
      NotificationAlert-8.caf Festivo, feliz
      NotificationAlert-8-Short.caf Festivo, feliz
      NotificationAlert-9.caf Poderoso, dramático
      NotificationAlert-9-Short.caf Poderoso, dramático
      NotificationAlert-10.caf Suspensivo, dramático
      NotificationAlert-10-Short.caf Suspensivo, dramático
      NotificationAlert-11.caf Dramático
      NotificationAlert-11-Short.caf Dramático
      NotificationAlert-12.caf Dramático
      NotificationAlert-12-Short.caf Dramático
      NotificationAlert-13.caf Dramático
      NotificationAlert-13-Short.caf Dramático
      NotificationAlert-14.caf Dramático
      NotificationAlert-14-Short.caf Dramático
    Nota:
    Se um valor de nome não estiver definido, o sistema usará o toque padrão da aplicação. Se uma aplicação não tiver um toque definido, o sistema usará o toque padrão do dispositivo.