Passer au contenu principal
Les sons personnalisés sont un moyen de fournir une expérience plus unique et de marque pour votre application. Vous pouvez ajouter un son personnalisé avec chaque notification que vous envoyez, ou vous pouvez ajouter des sons à certains types de notifications uniquement. Par exemple, un jeu comme “Jewel Breaker” peut souhaiter avoir un son de type bijou toujours joué lors de la réception de notifications. Pendant ce temps, un réseau social peut souhaiter jouer des sons uniquement lorsque l’utilisateur reçoit un message d’un autre utilisateur pour différencier ces notifications des notifications système plus génériques.
Pour les applications mobiles uniquement. Les sons personnalisés ne sont pas pris en charge sur le push web.

​
Configuration

​
Créer des fichiers audio

Assurez-vous de créer des fichiers audio selon les règles suivantes. Si l’appareil ne peut pas trouver le fichier en question, ou si le fichier n’est pas dans un format pris en charge, il reviendra au son de notification système par défaut.
Gardez les noms de fichiers audio en minuscules car certaines plateformes ignorent les lettres majuscules pour les fichiers audio. Au lieu de AwesomeSound.wav utilisez awesomesound.wav ou awesome_sound.wav.
PlateformeExtensionsNotes
iOS.wav .aiff .cafLes sons doivent être encodés en Linear PCM, MA4 (IMA/ADPCM), µLaw, ou aLaw. Doivent durer moins de 30 secondes.
Android.wav .mp3 .oggDurée recommandée inférieure à 30 secondes. Gardez la taille du fichier petite, les gros fichiers peuvent ne pas être lus sur certains appareils.
Huawei.wav .mp3 .wmaDurée recommandée inférieure à 30 secondes. Gardez la taille du fichier petite, les gros fichiers peuvent ne pas être lus sur certains appareils.
Amazon.wav .mp3 .oggDurée recommandée inférieure à 30 secondes. Gardez la taille du fichier petite, les gros fichiers peuvent ne pas être lus sur certains appareils.

​
Ajouter des fichiers audio à l’application

Pour ajouter des sons aux notifications, vous devez inclure les fichiers audio en tant que ressources dans votre application. Les URL externes ne sont pas prises en charge.
  • iOS
  • Android, Huawei et Amazon
Ajoutez des fichiers audio à l’emplacement approprié dans votre projet Xcode en fonction de votre SDK.
SDKDossier
iOS NativeAjoutez les fichiers à la racine du projet Xcode. Assurez-vous que Add to targets est sélectionné lors de l’ajout de fichiers afin qu’ils soient automatiquement ajoutés aux ressources du bundle.
Cordova, IonicAjoutez les fichiers au répertoire Resources dans le projet Xcode dans <project-root>/platforms/ios/project-name.xcodeproj.
UnityAjoutez des sons n’importe où dans votre projet Unity, compilez votre projet, puis déplacez ces sons à la racine du projet Xcode.

​
Envoyer des notifications

  • iOS
  • Android, Huawei et Amazon
  • API REST
Ajoutez l’extension de fichier lors du référencement de la ressource audio. Par exemple, explode_sound.wav. Définissez dans le tableau de bord lors de l’envoi de messages push ou utilisez la propriété ios_sound de l’API Créer une notification.Pour aucun son, passez nil au champ Sound.
Si vous avez très récemment ajouté une ressource audio à votre application, vous voudrez peut-être attendre quelques jours avant d’envoyer des notifications utilisant le son. C’est parce qu’il peut falloir de nombreux jours, voire des semaines, pour que la majorité de vos utilisateurs mettent à jour leurs applications vers la dernière version qui contient votre nouvelle ressource audio.Si un utilisateur a une version plus ancienne de votre application sans la ressource audio et reçoit une notification qui la référence, il n’entendra que le son de notification système par défaut.

​
FAQ

​
Puis-je définir un son par défaut ?

Utilisez un Modèle qui référence le son et/ou le canal de notification Android.

​
Pourquoi ma notification ne joue-t-elle pas le fichier audio personnalisé ?

Il y a plusieurs raisons pour lesquelles un son peut ne pas être lu.
  • Le fichier audio a une extension de fichier incorrecte
  • Le fichier audio n’est pas encodé dans un format pris en charge
  • Le fichier audio est au mauvais emplacement
  • Le fichier audio est trop long
Actuellement, OneSignal ne journalise pas les problèmes de ressources incorrectes, nous travaillons à ajouter cela à vos journaux. iOS - En savoir plus dans la documentation d’Apple pour des conseils sur la façon d’encoder les fichiers et de les tester. Android - Assurez-vous qu’il est intégré dans votre APK en l’extrayant et en vous assurant qu’il se trouve dans res/raw/. Si la réduction des ressources est activée, vous pouvez protéger les fichiers audio de la suppression en créant keep.xml dans res/raw/ avec le code suivant
xml
<resources xmlns:tools="http://schemas.android.com/tools"
tools:keep="@raw/sound_file"/>

​
Pourquoi ma notification joue-t-elle le fichier audio par défaut ?

Veuillez vous assurer que vous avez suivi attentivement les instructions de configuration et que le fichier audio est au bon emplacement pour le SDK.

​
Pourquoi le mauvais son est-il joué ?

Sur Android, les notifications seront regroupées après qu’un certain nombre ont été reçues par l’appareil sans les ouvrir. Les notifications regroupées jouent un son par défaut. Vous pouvez définir le son avec la GROUPKEY pour toutes vos notifications.