为儿子开发的SwiftUI App音频无法播放问题求助

此前在社区帮助下，我为儿子制作了一款他非常喜爱的App。因为儿子特别喜欢，我注册了开发者账号，想在陪他的间隙更新App，但之后App出了故障。希望能得到大家的帮助，可以是指出问题所在，也可以推荐可靠的学习资源，非常感谢。

1. 点击按钮时音频无法播放，代码没有报错或警告，而且音频文件在Xcode里能正常播放，没有损坏，这是为什么？
2. 音频文件存在App Bundle的audio文件夹里，按“颜色、数字、字母”等类别分文件夹存放，想确认是不是存在大小写敏感或者文件夹嵌套的问题？
3. 非紧急需求，但想优化实现方式：怎么修改SoundOption，不用枚举每个音频文件，让App根据图片名称自动找到对应的音频文件？
4. 如果有更优的实现方案，恳请赐教。目前我在学Apple官方的Swift教程，也希望能得到其他学习资源推荐，非常感谢。

以下是仅包含一个分类的代码：

import SwiftUI
import AVKit

class SoundManager{
    static let instance = SoundManager()
    var player: AVAudioPlayer?
    
    enum SoundOption: String {
        //Aircraft
        case airliner
        case biplane
        case bomber
        case cargoplane
        case fighterjet
        case glider
        case hangglider
        case helicopter
        case hotairballoon
        case parachute
        case privatejet
        case rocket
        case seaplane
        case spaceshuttle
        case tiltrotor
        case zeppelin
    }
    
    func playsound(sound: SoundOption){
        guard let url = Bundle.main.url(forResource: sound.rawValue, withExtension: ".m4a") else {return}
       
        do {
            player = try AVAudioPlayer(contentsOf: url)
            player?.play()
        } catch let error {
            print("Error playing sound. \(error.localizedDescription)")
        }
    }
}

    
struct ContentView: View {
    @State private var selectedImageName: String?
    private func gridButton(imageName: String, sound: SoundManager.SoundOption) -> some View {
        Button {
            SoundManager.instance.playsound(sound: sound)
            selectedImageName = imageName
        } label: {
            Image(imageName)
                .resizable()
                .aspectRatio(contentMode: .fit)
                .cornerRadius(15)
                .frame(width: 140, height: 140)
        }
    }

    var body: some View {
        VStack{
            Text("ACTION'S FAVORITE STUFF")
                .lineLimit(1)
                .padding(10)
                .font(.system(size: 500))
                .minimumScaleFactor(0.01)
                .frame(maxWidth: .infinity)
                .bold()
                .background(Color(red: 0.18 , green: 0.59 , blue: 0.65 ))
            HStack{
                ScrollView{
                    //Aircraft Start Here
                    Text("Aircraft")
                        .font(.largeTitle)
                        .bold()
                        .border(Color.black)
                        .cornerRadius(15)
                    Grid{
                        GridRow{
                            gridButton(imageName: "Airliner", sound: .airliner)
                            gridButton(imageName: "Bi-Plane", sound: .biplane)
                            gridButton(imageName: "Bomber", sound: .bomber)
                            gridButton(imageName: "Cargo Plane", sound: .cargoplane)
                        }
                        GridRow{
                            gridButton(imageName: "Fighter Jet", sound: .fighterjet)
                            gridButton(imageName: "Glider", sound: .glider)
                            gridButton(imageName: "Hang Glider", sound: .hangglider)
                            gridButton(imageName: "Helicopter", sound: .helicopter)
                        }
                        GridRow{
                            gridButton(imageName: "Hot Air Balloon", sound: .hotairballoon)
                            gridButton(imageName: "Parachute", sound: .parachute)
                            gridButton(imageName: "Private Jet", sound: .privatejet)
                            gridButton(imageName: "Rocket", sound: .rocket)
                        }
                        GridRow{
                            gridButton(imageName: "Seaplane", sound: .seaplane)
                            gridButton(imageName: "Space Shuttle", sound: .spaceshuttle)
                            gridButton(imageName: "Tilt Rotor", sound: .tiltrotor)
                            gridButton(imageName: "Zeppelin", sound: .zeppelin)
                        }
                    }
                }
                .background(Color.red)
                LazyVStack{
                    if let selectedImageName = selectedImageName {
                        VStack {
                            Image(selectedImageName)
                                .scaledToFit()
                                .cornerRadius(15)
                            
                            Text(selectedImageName)
                                .font(.largeTitle)
                        }
                    } else {
                        // Display a default image here
                        VStack{
                            Image("Elephant")
                                .scaledToFit()
                                .cornerRadius(15)
                            Text("My Family")
                                .font(.largeTitle)
                        }
                    }
                }
                .background(Color.blue)
            }
        }
    }
}

问题1&2：音频无法播放的原因与修复 #

核心问题是音频路径错误：你的代码调用Bundle.main.url时只传入了音频文件名，但实际音频存放在audio下的子文件夹中，系统找不到文件导致播放失败。另外，iOS/macOS的文件系统是大小写敏感的（Xcode预览时可能不敏感，但真机/模拟器严格遵循大小写匹配），文件名必须完全一致。

修复步骤：

1. 修改SoundManager的playsound方法，指定音频所在的子目录：

func playsound(sound: SoundOption, category: String) {
    guard let url = Bundle.main.url(
        forResource: sound.rawValue,
        withExtension: "m4a",
        subdirectory: "audio/\(category)"
    ) else {
        print("未找到音频文件：\(sound.rawValue).m4a")
        return
    }
    do {
        player = try AVAudioPlayer(contentsOf: url)
        player?.play()
    } catch let error {
        print("播放错误：\(error.localizedDescription)")
    }
}

2. 调用时传入分类名称，比如飞机类按钮：

gridButton(imageName: "Airliner", sound: .airliner, category: "Aircraft")

3. 检查音频文件的Target Membership是否勾选（Xcode右侧检查器中），确保文件被打包进App Bundle。

问题3：去掉枚举，自动匹配图片与音频 #

可以通过字符串转换，把图片名称转换成对应的音频文件名，无需维护枚举：

1. 新增字符串扩展，统一格式转换规则：

extension String {
    func toSoundFileName() -> String {
        // 去掉空格、连字符，转小写，匹配你的音频命名规则
        return self.lowercased()
            .replacingOccurrences(of: " ", with: "")
            .replacingOccurrences(of: "-", with: "")
    }
}

2. 修改SoundManager，直接接收文件名和分类：

class SoundManager{
    static let instance = SoundManager()
    var player: AVAudioPlayer?
    
    func playsound(fileName: String, category: String){
        guard let url = Bundle.main.url(
            forResource: fileName,
            withExtension: "m4a",
            subdirectory: "audio/\(category)"
        ) else {
            print("音频不存在：\(fileName).m4a")
            return
        }
        do {
            player = try AVAudioPlayer(contentsOf: url)
            player?.play()
        } catch let error {
            print("播放错误：\(error.localizedDescription)")
        }
    }
}

3. 简化按钮方法，不用传枚举：

private func gridButton(imageName: String, category: String) -> some View {
    Button {
        let soundFileName = imageName.toSoundFileName()
        SoundManager.instance.playsound(fileName: soundFileName, category: category)
        selectedImageName = imageName
    } label: {
        Image(imageName)
            .resizable()
            .aspectRatio(contentMode: .fit)
            .cornerRadius(15)
            .frame(width: 140, height: 140)
    }
}

之后新增图片和音频时，只要保证音频文件名是图片名称按规则转换后的结果，就能自动匹配，无需修改代码。

问题4：更优实现方案与学习资源 #

更优实现建议

• 预加载音频：如果音频文件较小，可在SoundManager初始化时预加载分类下的所有音频并存入字典，避免点击时的加载延迟。
• 改用AVPlayer：AVPlayer支持后台播放、流媒体等更多特性，适合长期维护的App。
• 数据驱动UI：把分类、图片列表做成JSON/plist配置文件，动态生成Grid布局，新增分类时只需修改配置文件，无需改动代码。示例配置：

{
  "categories": [
    {
      "name": "Aircraft",
      "items": [
        {"image": "Airliner"},
        {"image": "Bi-Plane"},
        {"image": "Bomber"}
      ]
    }
  ]
}

学习资源

• SwiftUI官方示例项目：比如Landmarks，深入学习能掌握SwiftUI的最佳实践。
• WWDC视频：每年的WWDC都会发布SwiftUI和AVFoundation的专题内容，能快速了解最新特性。
• SwiftUI进阶书籍：《SwiftUI for Masterminds》覆盖从入门到进阶的实战内容，适合系统学习。
• Apple Developer文档：官方文档的API说明和教程是最权威的参考资料。

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