Configurar sons para notificações por push

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Adicione sons e tons a notificações por push para indicar aos usuários se uma mensagem é urgente ou apenas requer a atenção dos usuários.

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

    O JSON a seguir é um exemplo de como adicionar um toque à 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 anel adicionando o sufixo -Short. Você pode encurtar todos os tons, exceto NotificationAlert-5.caf.

    Exemplo de JSON 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 de 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:
    • O parâmetro critical 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.
    • O parâmetro volume define o volume do som de notificação. O intervalo é de 0,1 como o mais silencioso a 1,0 como o mais alto.
    • O parâmetro name é o nome do tom que é ativado quando uma notificação por push é enviada. Para alertas críticos, considerando os ritmos do usuário com um tom impactante.
      Nota:
      Se um valor name 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.

      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 anel adicionando o sufixo -Short. Você pode encurtar todos os tons, exceto NotificationAlert-5.caf.
      Valores de nome de arquivo aceitos Ritmo de 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 Impressionante, poderoso
      NotificationAlert-9-Short.caf Impressionante, poderoso
      NotificationAlert-10.caf Dramático, Suspense
      NotificationAlert-10-Short.caf Dramático, Suspense
      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.