FCM自定义声音通知在iOS端Xcode环境下不生效问题咨询

• 音效文件引入错误
  确认自定义音效文件已被添加到主Target的Copy Bundle Resources列表中，操作路径：Xcode > 项目根目录 > 选中主Target > 打开Build Phases标签 > 展开Copy Bundle Resources，如果你的音效文件不在列表内，点击+号手动添加，仅拖入项目文件夹不会自动打包进App包。
• 音效规格不符合要求
  iOS通知音效仅支持时长≤30秒的aiff、wav、caf格式文件，格式不匹配、时长超标都会触发系统自动回退到默认音效。
• FCM推送payload配置错误
  iOS端sound字段值必须和音效文件的全名（包含后缀）完全一致，比如你的文件名为notice_alert.caf，payload的sound字段就要写notice_alert.caf，不能省略后缀。
• 通知声音权限未申请
  确认你申请通知权限时已经开启了声音权限，Flutter侧firebase_messaging权限申请示例：

NotificationSettings settings = await FirebaseMessaging.instance.requestPermission(
  alert: true,
  badge: true,
  sound: true, // 必须为true
);

• 基础推送能力配置缺失
  确认Xcode的Signing & Capabilities标签下已添加两个配置项：Push Notifications、Background Modes（Background Modes下需勾选Remote notifications），同时Firebase控制台已正确上传APNs认证密钥/推送证书。
• 前台触发场景注意
  iOS默认不会在App前台运行时展示系统通知、播放通知音效，该场景需要你自行监听FirebaseMessaging.onMessage事件，手动调用音效播放插件实现自定义音效。

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