Configurer les sons pour les notifications push

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • Ajoutez des sons et des tonalités aux notifications push pour indiquer aux utilisateurs si un message est urgent ou nécessite simplement l’attention des utilisateurs.

    Exemple de JSON pour l’ajout de son aux notifications push

    Le JSON suivant est un exemple de la façon d’ajouter une tonalité à votre notification push. Le nom de la tonalité utilisée dans l’exemple est NotificationAlert-2". 
    json["aps"]["sound"] = "NotificationAlert-2.caf";

    Le tableau à la fin de cette rubrique répertorie toutes les tonalités disponibles. Pour écouter la tonalité de chaque son, vous devez configurer une notification avec le paramètre de son cible.

    Remarque :
    Pour chaque tonalité, vous avez la possibilité de raccourcir la longueur de la sonnerie en ajoutant le suffixe -Short. Vous pouvez raccourcir toutes les tonalités à l’exception de NotificationAlert-5.caf.

    Exemple de JSON pour les alertes critiques, y compris le son

    Le JSON suivant est un exemple de la façon dont le paramètre sonore est défini pour les alertes critiques. Pour en savoir plus sur les alertes critiques, reportez-vous à Alertes critiques mobiles.

    json["aps"]["sound"] = { 
          "critical": 1, 
          "name": "NotificationAlert-3-Short.caf", 
          "volume": 1.0 
      };
    Les paramètres dans l'exemple de code JSON sont les suivants :
    • Le critical paramètre définit la notification comme une alerte critique. 1 signifie que l’alerte critique est active, 0 signifie que l’alerte critique est inactive.
    • Le volume paramètre définit le volume du son de la notification. La plage est de 0,1 pour le plus faible à 1,0 pour le plus fort.
    • Le name paramètre correspond au nom de la tonalité qui est activée lors de l’envoi d’une notification push. Pour les alertes critiques, en tenant compte des rythmes de l’utilisateur avec un ton dramatique.
      Remarque :
      Si une name valeur n’est pas définie, le système utilise la sonnerie par défaut de l’application. Si une application n’a pas de sonnerie définie, le système utilise la sonnerie par défaut de l’appareil.

      Pour écouter la tonalité de chaque son, vous devez configurer une notification avec le paramètre de son cible.

      Les valeurs acceptées sont répertoriées dans la table.
      Remarque :
      Pour chaque tonalité, vous avez la possibilité de raccourcir la longueur de la sonnerie en ajoutant le suffixe -Short. Vous pouvez raccourcir toutes les tonalités à l’exception de NotificationAlert-5.caf.
      Valeurs de nom de fichier acceptées Rythme de tonalité
      AlerteNotification-1.caf Moelleux, Relaxant, Lent
      AlerteNotification-1-Short.caf Moelleux, Relaxant, Lent
      AlerteNotification-2.caf Dramatique
      AlerteNotification-2-Short.caf Dramatique
      AlerteNotification-3.caf Dramatique
      AlerteNotification-3-Short.caf Dramatique
      AlerteNotification-4.caf Moelleux, Relaxant, Lent
      AlerteNotification-4-Short.caf Moelleux, Relaxant, Lent
      NotificationAlert-5.caf Moelleux, Relaxant, Lent
      NotificationAlert-6.caf Festif, Heureux
      NotificationAlert-6-Short.caf (en anglais seulement) Festif, Heureux
      NotificationAlert-7.caf Festif, Heureux
      AlerteNotification-7-Short.caf Festif, Heureux
      NotificationAlert-8.caf Festif, Heureux
      NotificationAlert-8-Short.caf (en anglais seulement) Festif, Heureux
      NotificationAlert-9.caf Spectaculaire, puissant
      NotificationAlert-9-Short.caf (en anglais seulement) Spectaculaire, puissant
      NotificationAlert-10.caf Dramatique, plein de suspense
      AlerteNotification-10-Short.caf Dramatique, plein de suspense
      NotificationAlert-11.caf Dramatique
      AlerteNotification-11-Short.caf Dramatique
      NotificationAlert-12.caf Dramatique
      AlerteNotification-12-Short.caf Dramatique
      NotificationAlert-13.caf Dramatique
      AlerteNotification-13-Short.caf Dramatique
      NotificationAlert-14.caf Dramatique
      AlerteNotification-14-Short.caf Dramatique
    Remarque :
    Si une valeur de nom n’est pas définie, le système utilise la sonnerie par défaut de l’application. Si une application n’a pas de sonnerie définie, le système utilise la sonnerie par défaut de l’appareil.