AVFoundation Swift：方法、示例、安装

AVFoundation 简介

\n\n

AVFoundation 是 Apple 提供的一个强大框架，用于在 iOS、macOS、tvOS 和 watchOS 平台上处理音频和视频。它为开发者提供了用于捕获、处理、播放和编辑多媒体内容的高级 API。与更底层的解决方案（例如 Core Audio 或 Video Toolbox）不同，AVFoundation 抽象了编解码器、容器和同步的复杂细节，让您可以专注于应用程序逻辑。

\n\n

为什么需要 AVFoundation？它可以解决广泛的任务：

播放： 播放音频文件（MP3、AAC、WAV）和视频文件（MP4、MOV、M4V），支持字幕和章节。
录制： 实时从摄像头捕获视频和从麦克风捕获音频。
编辑： 创建由多个轨道组成的合成、叠加效果、裁剪、变速。
处理： 提取元数据、处理音频样本、应用滤镜。
流媒体： 播放 HLS（HTTP Live Streaming）内容。

\n\n

AVFoundation 是 Apple 开发的事实标准。如果您正在编写一个需要播放音乐、录制视频或编辑播客的应用程序，您将使用这个框架。

\n\n

安装（连接到项目）

\n\n

AVFoundation 不能通过 pip 或 npm 安装，因为它是 Apple 的原生框架。它内置于 Xcode 和 SDK 中。要使用它，只需在 Swift 文件中导入模块即可。

\n\n

连接步骤：

在 Xcode 中打开您的项目。
在任何需要处理多媒体的 Swift 文件中，添加导入语句：

\n\n

import AVFoundation

\n\n

不需要任何额外操作。该框架自动适用于所有 iOS/macOS 项目。

\n\n

权限设置（iOS）

要使用摄像头和麦克风，您需要在 Info.plist 文件中添加以下键值：

NSCameraUsageDescription — 描述应用程序需要摄像头的理由。
NSMicrophoneUsageDescription — 描述应用程序需要麦克风的理由。

如果没有这些键，应用程序在尝试访问设备时会崩溃并报错。

\n\n

快速入门：播放音频

\n\n

最简单的示例是播放本地音频文件。创建一个 AVAudioPlayer 实例并调用 play() 方法。

\n\n

import AVFoundation\nimport UIKit\n\nclass ViewController: UIViewController {\n    var audioPlayer: AVAudioPlayer?\n\n    override func viewDidLoad() {\n        super.viewDidLoad()\n        \n        // 1. 在 Bundle 中找到文件路径\n        guard let path = Bundle.main.path(forResource: "sample", ofType: "mp3") else {\n            print("文件未找到")\n            return\n        }\n        \n        let url = URL(fileURLWithPath: path)\n        \n        do {\n            // 2. 初始化播放器\n            audioPlayer = try AVAudioPlayer(contentsOf: url)\n            // 3. 准备播放（可选，但推荐）\n            audioPlayer?.prepareToPlay()\n            // 4. 开始播放\n            audioPlayer?.play()\n            print("播放已开始")\n        } catch {\n            print("播放器初始化错误：\\(error.localizedDescription)")\n        }\n    }\n}

\n\n

这段代码创建了一个播放器，从应用程序资源中加载 sample.mp3 文件并开始播放。

\n\n