Ana içeriğe atla
Özel sesler, uygulamanız için daha benzersiz, markalı bir deneyim sağlamanın bir yoludur. Gönderdiğiniz her bildirime özel bir ses ekleyebilir veya yalnızca belirli bildirim türlerine ses ekleyebilirsiniz. Örneğin, “Jewel Breaker” gibi bir oyun, bildirim alırken her zaman mücevher benzeri bir sesin çalınmasını isteyebilir. Bu arada, bir sosyal ağ, kullanıcı başka bir kullanıcıdan mesaj aldığında, bu bildirimleri daha genel sistem bildirimlerinden ayırt etmek için yalnızca ses çalmak isteyebilir.
Yalnızca mobil uygulamalar için. Özel sesler web push’ta desteklenmez.

​
Kurulum

​
Ses dosyaları oluşturma

Ses dosyalarını aşağıdaki kurallara göre oluşturduğunuzdan emin olun. Cihaz söz konusu dosyayı bulamazsa veya dosya desteklenen bir formatta değilse, varsayılan sistem bildirim sesine geri dönecektir.
Bazı platformlar ses dosyaları için büyük harfleri görmezden geldiğinden ses dosyası adlarını küçük harfle tutun. AwesomeSound.wav yerine awesomesound.wav veya awesome_sound.wav kullanın.
PlatformUzantılarNotlar
iOS.wav .aiff .cafSesler Linear PCM, MA4 (IMA/ADPCM), µLaw veya aLaw olarak kodlanmalıdır. 30 saniyeden kısa olmalıdır.
Android.wav .mp3 .oggÖnerilen uzunluk 30 saniyeden az. Dosya boyutunu küçük tutun, büyük dosyalar bazı cihazlarda çalmayabilir.
Huawei.wav .mp3 .wmaÖnerilen uzunluk 30 saniyeden az. Dosya boyutunu küçük tutun, büyük dosyalar bazı cihazlarda çalmayabilir.
Amazon.wav .mp3 .oggÖnerilen uzunluk 30 saniyeden az. Dosya boyutunu küçük tutun, büyük dosyalar bazı cihazlarda çalmayabilir.

​
Uygulamaya ses dosyaları ekleme

Bildirimlere ses eklemek için, ses dosyalarını uygulamanız içinde kaynak olarak eklemelisiniz. Harici URL’ler desteklenmez.
  • iOS
  • Android, Huawei ve Amazon
SDK’nıza bağlı olarak Xcode projenizde uygun konuma ses dosyaları ekleyin.
SDKKlasör
iOS NativeDosyaları Xcode proje köküne ekleyin. Dosyaları eklerken Add to targets seçildiğinden emin olun, böylece bundle kaynaklarına otomatik olarak eklenir.
Cordova, IonicDosyaları <project-root>/platforms/ios/project-name.xcodeproj içindeki Xcode projesinde Resources dizinine ekleyin.
UnitySesleri Unity projenizde herhangi bir yere ekleyin, projenizi oluşturun ve ardından bu sesleri Xcode proje köküne taşıyın.

​
Bildirim gönderme

  • iOS
  • Android, Huawei ve Amazon
  • REST API
Ses kaynağına referans verirken dosya uzantısını ekleyin. Örneğin, explode_sound.wav. Push mesajları gönderirken dashboard’da ayarlayın veya Create Notification API ios_sound özelliğini kullanın.Ses olmaması için, Sound alanına nil değerini girin.
Uygulamanıza çok yakın zamanda bir ses kaynağı eklediyseniz, sesi kullanarak bildirim göndermeden önce birkaç gün beklemek isteyebilirsiniz. Bunun nedeni, kullanıcılarınızın çoğunluğunun yeni ses kaynağınızı içeren en son sürüme uygulamalarını güncellemeleri günler hatta haftalar alabilir.Bir kullanıcının ses kaynağı olmayan uygulamanızın eski bir sürümü varsa ve buna referans veren bir bildirim alırsa, yalnızca varsayılan sistem bildirim sesini duyacaktır.

​
SSS

​
Varsayılan bir ses ayarlayabilir miyim?

Sese ve/veya Android Bildirim Kanalına referans veren bir Şablon kullanın.

​
Bildirimim neden özel ses dosyasını çalmıyor?

Bir sesin çalmamasının birkaç nedeni olabilir.
  • Ses dosyasının yanlış bir dosya uzantısı var
  • Ses dosyası desteklenen bir formatta kodlanmamış
  • Ses dosyası yanlış konumda
  • Ses dosyası çok uzun
Şu anda OneSignal kaynak yanlış sorunlarını günlüğe kaydetmiyor, bunu günlüklerinize eklemeye çalışıyoruz. iOS - Dosyaları nasıl kodlayacağınız ve test edeceğiniz hakkında ipuçları için Apple’ın dokümantasyonunu okuyun. Android - APK’nıza oluşturulduğundan emin olun, onu çıkararak ve res/raw/ içinde bulunduğundan emin olarak kontrol edin. Kaynakları küçültme etkinse, res/raw/ içinde aşağıdaki kodla keep.xml oluşturarak ses dosyalarını kaldırılmaktan koruyabilirsiniz
xml
<resources xmlns:tools="http://schemas.android.com/tools"
tools:keep="@raw/sound_file"/>

​
Bildirimim neden varsayılan ses dosyasını çalıyor?

Lütfen kurulum talimatlarını dikkatlice takip ettiğinizden ve ses dosyasının SDK için doğru konumda olduğundan emin olun.

​
Neden yanlış ses çalıyor?

Android’de, cihaz tarafından belirli bir miktar açılmadan alındıktan sonra bildirimler birlikte gruplanacaktır. Gruplanmış bildirimler varsayılan bir ses çalar. Tüm bildirimleriniz için GROUPKEY ile sesi ayarlayabilirsiniz.