Configuração de som para notificações por push

  • Versão de lançamento: Washingtondc
  • Atualizado 4 de mar. de 2024
  • 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 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 -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 para dispositivos móveis.

    json["aps"]["sound"] = { 
          "critical": 1, 
          "name": "NotificationAlert-3-Short.caf", 
          "volume": 1 
      };
    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 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, considere os ritmos do usuário com um tom impactante.
      Nota:
      Se um valor name não for definido, o sistema usará o toque padrão do aplicativo. 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 -Short. Você pode encurtar todos os tons, exceto NotificationAlert-5.caf.
      Valores de nome de arquivo aceitos Ritmo de tom
      AlertaDeNotificação-1.caf Suave, Relaxante, Lento
      NotificationAlert-1-Short.caf Suave, Relaxante, Lento
      AlertaDeNotificação-2.caf Drenagem
      NotificationAlert-2-Short.caf Drenagem
      AlertaDeNotificação-3.caf Drenagem
      NotificationAlert-3-Short.caf Drenagem
      AlertaDeNotificação-4.caf Suave, Relaxante, Lento
      NotificationAlert-4-Short.caf Suave, Relaxante, Lento
      AlertaDeNotificação-5.caf Suave, Relaxante, Lento
      AlertaDeNotificação-6.caf Festivo, feliz
      NotificationAlert-6-Short.caf Festivo, feliz
      AlertaDeNotificação-7.caf Festivo, feliz
      NotificationAlert-7-Short.caf Festivo, feliz
      AlertaDeNotificação-8.caf Festivo, feliz
      NotificationAlert-8-Short.caf Festivo, feliz
      AlertaDeNotificação-9.caf Drenagem, poderosa
      NotificationAlert-9-Short.caf Drenagem, poderosa
      AlertaDeNotificação-10.caf Drenagem, Suspense
      NotificationAlert-10-Short.caf Drenagem, Suspense
      AlertaDeNotificação-11.caf Drenagem
      NotificationAlert-11-Short.caf Drenagem
      AlertaDeNotificação-12.caf Drenagem
      NotificationAlert-12-Short.caf Drenagem
      AlertaDeNotificação-13.caf Drenagem
      NotificationAlert-13-Short.caf Drenagem
      AlertaDeNotificação-14.caf Drenagem
      NotificationAlert-14-Short.caf Drenagem