Ana içeriğe atla
Özel sesler, uygulamanızda daha benzersiz ve markalı bir deneyim sunmanızı sağlar. Her bildirime özel bir ses ekleyebilir veya yalnızca belirli türdeki bildirimlere ses ekleyebilirsiniz. Örneğin, bir sosyal uygulama sistem bildirimlerinden ayırt etmek için yalnızca doğrudan mesajlarda farklı bir ses çalabilir.
Yalnızca mobil uygulamalar için. Özel sesler web push’ta desteklenmez.

Kurulum

Ses dosyaları oluşturma

Ses dosyalarını aşağıdaki platform gereksinimlerine göre oluşturun. Cihaz belirtilen dosyayı bulamazsa veya dosya formatı desteklenmiyorsa, 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

Ses dosyaları uygulamanız içinde kaynak olarak bulunmalıdır. Harici URL’ler desteklenmez.
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

Ses kaynağına referans verirken dosya uzantısını ekleyin (ör. explode_sound.wav). Push mesajları gönderirken dashboard’da sesi ayarlayın veya Create Notification API ios_sound özelliğini kullanın.Ses olmaması için, Sound alanına nil değerini girin.
OneSignal dashboard push composer showing the iOS Sound field
Uygulamanıza yakın zamanda bir ses kaynağı eklediyseniz, bu sesi kullanan bildirimler göndermeden önce birkaç gün beklemeyi düşünün. Kullanıcıların çoğunluğunun yeni ses dosyasını içeren en son uygulama sürümüne güncellemesi günler veya 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. Bu şablonla gönderilen her bildirim, yapılandırılmış sesi otomatik olarak kullanır.

Farklı kullanıcılara farklı bildirim sesleri gönderebilir miyim?

ios_sound ve android_channel_id parametreleri istek düzeyindedir — o API çağrısının tüm alıcılarına uygulanır. Tek bir istekte farklı kullanıcılar için farklı sesler belirtemezsiniz. Farklı kullanıcılara farklı sesler iletmek için fan-out deseni kullanın: her ses varyantı için ayrı API çağrıları yapın, kullanıcıları etiket veya segmente göre hedefleyin. Örneğin, her kullanıcının tercih ettiği sesi preferred_sound gibi bir etikette saklayın, ardından ses değeri başına bir istek gönderin.
{
  "app_id": "YOUR_APP_ID",
  "contents": {"en": "You have a new message!"},
  "ios_sound": "chime.wav",
  "android_channel_id": "CHIME_CHANNEL_ID",
  "include_filters": [
    {"field": "tag", "key": "preferred_sound", "relation": "=", "value": "chime"}
  ]
}
Her istek yalnızca preferred_sound etiketi eşleşen kullanıcıları hedefler, böylece her grup kendi sesini duyar. İhtiyacınız kadar varyant ekleyin — ses başına bir API çağrısı.

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

Birkaç yaygın neden vardır:
  • Ses dosyasının yanlış bir dosya uzantısı var
  • Ses dosyası desteklenen bir formatta kodlanmamış
  • Ses dosyası projede yanlış konumda
  • Ses dosyası 30 saniyeden uzun
iOS — Kodlama ve test kılavuzu için Apple’ın dokümantasyonunu okuyun. Android — APK’yı çıkararak ve res/raw/ dizininde bulunduğunu doğrulayarak ses dosyasının APK’ya dahil edildiğini kontrol edin. Kaynakları küçültme etkinse, res/raw/ içinde keep.xml oluşturarak ses dosyalarını kaldırılmaktan koruyun:
<resources xmlns:tools="http://schemas.android.com/tools"
  tools:keep="@raw/sound_file"/>

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

Kurulum talimatlarını takip ettiğinizden ve ses dosyasının SDK için doğru konumda olduğundan emin olun. Dosya adının büyük-küçük harf kullanımını kontrol edin — bazı platformlar büyük harfleri yok sayar.

Neden yanlış ses çalıyor?

Android’de, belirli sayıda bildirim açılmadan alındığında bildirimler birlikte gruplanır. Gruplanmış bildirimler varsayılan bir ses çalar. Tüm bildirimleriniz için grup anahtarı ile sesi ayarlayabilirsiniz.

İlgili sayfalar

Bildirim kategorileri

Ses, titreşim ve önemi kontrol etmek için Android bildirim kanallarını ayarlayın.

Şablonlar

Önceden tanımlanmış seslerle yeniden kullanılabilir bildirim şablonları oluşturun.

Create Notification API

ios_sound, android_channel_id ve adm_sound parametreleri için API referansı.

Bildirim ikonları

Mobil uygulamanız için bildirim ikonlarını özelleştirin.