iOS 遠程推送提示音配置全攻略：服務端字段與客戶端音頻文件匹配

APNs Payload 中的 sound 字段

{
  "aps": {
    "alert": "新消息",
    "sound": "custom.caf",  // 文件名，需放在 App Bundle 根目錄
    "badge": 1
  }
}

客戶端音頻要求

• 格式：.caf, .aiff, .wav（推薦 .caf）。
• 時長：≤ 30 秒，超過系統將播放默認聲音。
• 位置：放在 Xcode 專案 Bundle Resources 中（Target → Build Phases → Copy Bundle Resources）。
• 命名：sound 字段值需與文件名完全一致（含擴展名）。

系統默認聲音

若 sound 字段缺失或文件不存在，系統播放默認三聲提示音。也可顯式指定 "sound": "default"。

常見問題排查

1. 後台/未啟動無聲音：確認服務端確實下發了 sound 字段，且客戶端 Bundle 包含該文件。
2. 免打擾模式：用戶開啟「勿擾」或 App 通知權限關閉「聲音」，系統會靜音。
3. AudioServicesPlaySystemSound 僅適用前台播放短音效，遠程推送聲音完全由系統根據 Payload 控制。