> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bildirim sesleri

> iOS, Android, Huawei ve Amazon uygulamalarına özel bildirim sesleri ekleyin — dosya formatları, SDK kurulumu ve API parametreleri dahil.

Ö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.

<Warning>
  Yalnızca mobil uygulamalar için. Özel sesler web push'ta desteklenmez.
</Warning>

## 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.

<Note>
  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.
</Note>

| Platform | Uzantılar             | Notlar                                                                                                     |
| -------- | --------------------- | ---------------------------------------------------------------------------------------------------------- |
| iOS      | `.wav` `.aiff` `.caf` | Sesler 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.

<Tabs>
  <Tab title="iOS">
    SDK'nıza bağlı olarak Xcode projenizde uygun konuma ses dosyaları ekleyin.

    | SDK            | Klasör                                                                                                                                                    |
    | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | iOS Native     | Dosyaları 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, Ionic | Dosyaları `<project-root>/platforms/ios/project-name.xcodeproj` içindeki Xcode projesinde `Resources` dizinine ekleyin.                                   |
    | Unity          | Sesleri Unity projenizde herhangi bir yere ekleyin, projenizi oluşturun ve ardından bu sesleri Xcode proje köküne taşıyın.                                |
  </Tab>

  <Tab title="Android, Huawei ve Amazon">
    SDK'nıza bağlı olarak ses dosyalarını projenizde uygun klasöre ekleyin. **Klasör yoksa, oluşturun.**

    | SDK                            | Klasör                                                                                                                                                         |
    | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | Android, Huawei, Amazon Native | `res/raw`                                                                                                                                                      |
    | React Native                   | `<project-root>/android/app/src/main/res/raw`                                                                                                                  |
    | Cordova                        | `<project-root>/platforms/android/res/raw/`                                                                                                                    |
    | Ionic                          | `/android/app/src/main/res/raw/`                                                                                                                               |
    | Unity                          | `Assets/Plugins/Android/OneSignalConfig/res/raw` *NOT: Ses ve simge dosya adlarınız küçük harf olmalı ve alt çizgi ve sayılar dışında başka bir şey içeremez.* |
    | Flutter                        | `main/res/raw`                                                                                                                                                 |
    | .NET                           | `<project-root>/Platforms/Android/Resources/raw/`                                                                                                              |
  </Tab>
</Tabs>

### Bildirim gönderme

<Tabs>
  <Tab title="iOS">
    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](/reference/create-message) API `ios_sound` özelliğini kullanın.

    Ses olmaması için, **Sound** alanına `nil` değerini girin.

    <Frame caption="OneSignal dashboard'da iOS için özel ses ayarlama.">
      <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/a05af7e-Screenshot_2023-02-28_at_3.16.55_PM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=9d33c9837ac9f67b0d6c6a7a87d03212" alt="OneSignal dashboard push composer showing the iOS Sound field" width="423" height="606" data-path="images/docs/a05af7e-Screenshot_2023-02-28_at_3.16.55_PM.png" />
    </Frame>
  </Tab>

  <Tab title="Android, Huawei ve Amazon">
    Android 8+ bildirim seslerini özelleştirmek için kurulması gereken [Bildirim Kategorilerini](./android-notification-categories) tanıttı. OneSignal, Android'in tüm sürümleri için Bildirim Kanalında yapılandırılan sesi kullanır.

    **Settings > Push & In-App > Android Notification Channels** bölümünde grup ve kanalı oluşturun.

    <Frame caption="Bir bildirim kanalı oluşturun.">
      <img src="https://mintcdn.com/onesignal/tc0EvmtSSX56SX0c/images/docs/8f39237-Screenshot_2023-02-28_at_3.11.52_PM.png?fit=max&auto=format&n=tc0EvmtSSX56SX0c&q=85&s=b18a97c1706dde194bd4e5c13cd9f593" alt="OneSignal dashboard showing the notification channel creation form" width="877" height="487" data-path="images/docs/8f39237-Screenshot_2023-02-28_at_3.11.52_PM.png" />
    </Frame>

    * Ses çalmak için **Importance** değerini "Urgent" veya "High" olarak ayarlayın.
    * İhtiyaçlarınıza göre **Sound** değerini "Default" veya "Custom" olarak ayarlayın. Ses kaynağına referans verirken dosya uzantısını **eklemeyin** (ör. `cat_meow_sound`).
    * Ses olmaması için, **Importance** değerini "Urgent" veya "High" ve **Sound** değerini "Off" olarak ayarlayın. Veya ses olmaması için **Importance** değerini "Medium" veya "Low" olarak ayarlayabilirsiniz.

    <Frame caption="Bir bildirim kanalı için ses ayarlama.">
      <img src="https://mintcdn.com/onesignal/KSCNwSpBCNSQ8xdF/images/docs/f7950b6-Screenshot_2023-02-28_at_3.11.03_PM.png?fit=max&auto=format&n=KSCNwSpBCNSQ8xdF&q=85&s=88d88df41d360b190b4c083709e8119c" alt="OneSignal notification channel settings showing sound configuration options" width="429" height="498" data-path="images/docs/f7950b6-Screenshot_2023-02-28_at_3.11.03_PM.png" />
    </Frame>

    Ardından push mesajları gönderirken dashboard'da kategori adını ayarlayabilir veya [Create Notification](/reference/create-message) API `android_channel_id` ve `huawei_channel_id` özelliklerini kullanabilirsiniz. Kategoride ayarlanan ses, Android'in tüm sürümleri için çalışır.

    <Frame caption="Push composer'da bildirim kategorisi seçimi.">
      <img src="https://mintcdn.com/onesignal/jFWn5xzleD8du3j6/images/docs/5e8625c-Screenshot_2023-02-28_at_3.15.19_PM.png?fit=max&auto=format&n=jFWn5xzleD8du3j6&q=85&s=c02f9a68fcb73b913a1de93e01d0f4aa" alt="OneSignal push composer showing the notification category dropdown" width="423" height="517" data-path="images/docs/5e8625c-Screenshot_2023-02-28_at_3.15.19_PM.png" />
    </Frame>
  </Tab>

  <Tab title="REST API">
    Her platform için uygun parametreyi kullanarak REST API aracılığıyla sesli bildirimler gönderebilirsiniz. Tüm ayrıntılar için [Create Notification API referansına](/reference/push-notification) bakın.

    | Platform | API Parametresi                                                                                                                                                                                                                        | Ayrıntılar                                                                                                 |
    | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
    | iOS      | `ios_sound`                                                                                                                                                                                                                            | Dosya uzantısını dahil edin. Örnek: `"ios_sound": "explode_sound.wav"`. Ses yok için `nil` değerini girin. |
    | Android  | `android_channel_id` — OneSignal Dashboard'da [Bildirim Kategorileri](./android-notification-categories) aracılığıyla kanal oluşturduysanız kullanın. `existing_android_channel_id` — Kanalı başka bir yerde oluşturduysanız kullanın. | [Bildirim Kategorilerinin](./android-notification-categories) kullanılması önerilir.                       |
    | Huawei   | `huawei_channel_id` — OneSignal Dashboard'da [Bildirim Kategorileri](./android-notification-categories) aracılığıyla kanal oluşturduysanız kullanın. `huawei_existing_channel_id` — Kanalı başka bir yerde oluşturduysanız kullanın.   | [Bildirim Kategorilerinin](./android-notification-categories) kullanılması önerilir.                       |
    | Amazon   | `adm_sound`                                                                                                                                                                                                                            | Dosya uzantısını dahil etmeyin. Örnek: `"adm_sound": "explode_sound"`.                                     |
  </Tab>
</Tabs>

<Warning>
  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.
</Warning>

***

## SSS

### Varsayılan bir ses ayarlayabilir miyim?

Sese ve/veya Android Bildirim Kanalına referans veren bir [Şablon](./templates) 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](./add-user-data-tags) saklayın, ardından ses değeri başına bir istek gönderin.

<CodeGroup>
  ```json Request 1 — "chime" users theme={null}
  {
    "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"}
    ]
  }
  ```

  ```json Request 2 — "bell" users theme={null}
  {
    "app_id": "YOUR_APP_ID",
    "contents": {"en": "You have a new message!"},
    "ios_sound": "bell.wav",
    "android_channel_id": "BELL_CHANNEL_ID",
    "include_filters": [
      {"field": "tag", "key": "preferred_sound", "relation": "=", "value": "bell"}
    ]
  }
  ```
</CodeGroup>

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](https://developer.apple.com/documentation/usernotifications/unnotificationsound?language=objc) 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:

```xml theme={null}
<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ı](https://developer.android.com/training/notify-user/group) ile sesi ayarlayabilirsiniz.

***

## İlgili sayfalar

<Columns cols={2}>
  <Card title="Bildirim kategorileri" icon="layer-group" href="./android-notification-categories">
    Ses, titreşim ve önemi kontrol etmek için Android bildirim kanallarını ayarlayın.
  </Card>

  <Card title="Şablonlar" icon="file-lines" href="./templates">
    Önceden tanımlanmış seslerle yeniden kullanılabilir bildirim şablonları oluşturun.
  </Card>

  <Card title="Create Notification API" icon="code" href="/reference/push-notification">
    ios\_sound, android\_channel\_id ve adm\_sound parametreleri için API referansı.
  </Card>

  <Card title="Bildirim ikonları" icon="image" href="./notification-icons">
    Mobil uygulamanız için bildirim ikonlarını özelleştirin.
  </Card>
</Columns>