使用AVAudioPlayer添加游戏背景音乐时遇Expected declaration错误求解决

嘿，我看到你在给SpriteKit游戏加背景音乐时碰到了这个语法错误，咱们来拆解问题根源，再一步步修复代码～

错误原因 #

你在类的属性定义区域直接写了这行代码：

ButtonAudioPlayer = AVAudioPlayer(contentsOfURL: ButtonAudioURL, error: nil)

在Swift中，类的顶层（属性声明的地方）只能做属性声明，不能直接执行初始化赋值的逻辑代码——编译器不知道该在什么时候执行这个语句，所以抛出了"Expected declaration"的错误。另外，你用的contentsOfURL:error:是Objective-C风格的旧写法，Swift现在推荐用抛出错误的API。

修复后的完整代码 #

我帮你调整了代码结构，同时优化了错误处理逻辑，避免潜在崩溃：

import SpriteKit
import GameplayKit
import AVFoundation
import UIKit

class GameScene: SKScene {
    private var label : SKLabelNode?
    private var spinnyNode : SKShapeNode?
    
    // 先声明可选类型的音频URL和播放器，避免提前初始化的问题
    var buttonAudioURL: URL?
    var buttonAudioPlayer: AVAudioPlayer?
    
    var gameArea: CGRect?
    
    enum gameState {
        case preGame
        case inGame
        case endGame
    }
    
    var currentGameState = gameState.preGame
    
    override init(size:CGSize) {
        let maxAspectRatio: CGFloat = 16.0/9.0
        let playableWidth = size.height / maxAspectRatio
        let margin = (size.width - playableWidth) / 2
        gameArea = CGRect(x: margin, y:0, width: playableWidth, height: size.height)
        
        super.init(size: size)
        // 在初始化方法里调用音频设置逻辑
        setupBackgroundAudio()
    }
    
    required init?(coder aDecoder: NSCoder) {
        super.init(coder: aDecoder)
        setupBackgroundAudio()
    }
    
    // 单独封装音频初始化逻辑，两个初始化方法都能复用
    private func setupBackgroundAudio() {
        // 安全获取音频文件路径，避免找不到文件导致崩溃
        guard let audioPath = Bundle.main.path(forResource: "HomeSoundtrack", ofType: "m4a") else {
            print("⚠️ 找不到HomeSoundtrack.m4a文件，请检查文件名是否正确，或是否已添加到项目中")
            return
        }
        
        buttonAudioURL = URL(fileURLWithPath: audioPath)
        
        // 用Swift标准的do-catch处理音频播放器初始化的错误
        do {
            buttonAudioPlayer = try AVAudioPlayer(contentsOf: buttonAudioURL!)
            buttonAudioPlayer?.prepareToPlay() // 提前加载音频，避免播放延迟
            buttonAudioPlayer?.numberOfLoops = -1 // 如果需要循环播放，打开这行注释
        } catch {
            print("❌ 音频播放器初始化失败：\(error.localizedDescription)")
        }
    }
    
    override func didMove(to view: SKView) {
        // 场景加载完成后播放音乐
        buttonAudioPlayer?.play()
    }
}

关键修复点说明 #

• 把初始化逻辑移到方法/初始化器中：将音频播放器的初始化代码放到专门的setupBackgroundAudio()方法里，在两个初始化器中调用，确保无论场景怎么初始化，音频逻辑都能正确执行。
• 安全处理可选值：用guard语句检查音频文件路径，避免找不到文件时出现崩溃，同时打印清晰的错误提示。
• 使用Swift风格的错误处理：替换了过时的error:nil写法，用do-catch捕获初始化时可能出现的错误。
• 优化播放体验：调用prepareToPlay()提前加载音频，消除播放时的延迟；如果需要循环播放，只需打开numberOfLoops = -1的注释。

额外注意事项 #

别忘了确认你的HomeSoundtrack.m4a文件已经正确添加到Xcode项目中：

1. 检查文件是否在项目导航栏里显示
2. 选中文件，查看右侧属性面板的"Target Membership"，确保勾选了你的游戏Target

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