使用FCM发送APNS关键告警时Volume属性无效的技术咨询

你使用FCM推送关键告警时，默认会以最大音量播放，但尝试在APNs负载中添加volume属性调整音量却没有效果，希望找到无需修改所有音频文件就能指定音量的替代方法，当前负载格式如下：

apns: {
  payload: {
    aps: {
      'interruption-level': 'critical',
      sound: user.sound,
      volume: 0.3,
      critical: 1,
      // 此处省略其他属性
    }
  }
}

问题原因 #

APNs的volume属性对**关键告警（critical interruption level）**不生效——苹果官方明确规定，关键告警会忽略系统音量设置和推送负载中的volume参数，强制以最大音量播放，这是为了保证紧急通知不会被用户错过。

无需修改音频文件的替代方案 #

1. 调整sound字段结构，传入带音量的配置对象

不要直接传递音频文件名，而是传一个包含文件名、音量和critical标识的JSON对象，示例负载如下：

apns: {
  payload: {
    aps: {
      'interruption-level': 'critical',
      sound: {
        name: user.sound,
        volume: 0.3,
        critical: 1
      },
      // 此处省略其他属性
    }
  }
}

注意：这个特性要求iOS版本至少为10.0，同时要确保你的应用能正确解析这种格式的sound配置。另外你之前的负载中critical字段是和aps同级的，正确位置应该是在sound对象内部。

2. 在应用端接收通知时动态调整音量

通过应用代码在本地控制音频会话的音量，完全绕过APNs的限制。比如在iOS的通知代理方法中处理：

func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    // 从推送负载中读取自定义音量参数
    if let aps = notification.request.content.userInfo["aps"] as? [String: Any],
       aps["interruption-level"] as? String == "critical",
       let customVolume = aps["custom_volume"] as? Float {
        do {
            let audioSession = AVAudioSession.sharedInstance()
            try audioSession.setCategory(.playback)
            try audioSession.setActive(true)
            // 设置音量
            audioSession.outputVolume = customVolume
        } catch {
            print("调整音量失败: \(error)")
        }
    }
    completionHandler([.sound, .alert])
}

这种方式更灵活，你可以在推送负载中自定义一个字段（比如custom_volume），然后在应用端读取并设置音量，不受APNs的限制。

注意事项 #

• 关键告警的设计初衷是确保用户能感知到紧急通知，部分iOS版本或设备可能仍会有强制最大音量的逻辑，建议在不同设备上测试验证效果。
• 如果使用第一种方案，要确认你的应用支持解析嵌套结构的sound配置。

内容的提问来源于stack exchange，提问作者Medic305