用途
该技能用于指导 AVFoundation 采集、播放、资源加载、读取器、写入器、导出和样本缓冲区管线的设计与修复。它负责确定媒体管线的结构、选择带类型的 AVFoundation 接口,以及制定背压(back-pressure)策略;音频会话策略、音频引擎图、Core Media 时序内部逻辑和 Xcode 执行则交由其他技能处理。
主要能力
覆盖 AVCaptureSession、采集输入输出、采集队列、AVPlayer、AVPlayerItem、AVAsset、AVURLAsset、AVAsyncProperty 异步资源加载、AVAssetReader、AVAssetWriter、导出、转码和样本缓冲区追加循环。
可用于修复以下常见问题:阻塞主线程、使用已废弃的 AVAsset 同步属性、误用 loadValuesAsynchronously(forKeys:)、追加样本缓冲区时不处理背压、混淆采集授权与麦克风权限,以及将采集、UI、写入器和播放器所有权混在同一个对象中。
使用方式
先对媒体管线进行分类:采集设置、播放器或播放状态、资源检查或异步加载、读取器或写入器循环、导出或转码、样本缓冲区追加或背压、现有实现修复。随后执行“文档优先”检查:阅读当前 AVFoundation 文档,说明所依赖的文档化行为,再按共享的类型所有权约定选择 Apple 与 Swift 媒体类型。接着明确管线所有者与队列,包括采集会话配置所有者、串行采集会话队列、播放器项与 UI 更新边界、异步资源加载边界、读取器与写入器队列,以及取消与拆除路径。最终输出一条建议,包含管线类别、所依赖的文档化行为、所有者、队列与异步加载方案、背压与取消方案、修复发现,以及验证与交接预期。
适用场景
适用于 iOS、macOS 或混合 Apple 平台上的媒体采集、播放、资源检查、读取、写入、导出、转码、样本缓冲区追加等任务,也适用于修复阻塞主线程或错误使用异步加载的现有代码。
限制与边界
不得在主队列上运行采集会话、媒体加载、导出或写入器循环;不得用自定义包装、字符串、字典或原始数值时序替换 AVFoundation 或 Core Media 管线类型,除非明确说明转换边界和丢失的媒体信息;不得在没有运行时证据的情况下声称采集、播放、导出、摄像头、麦克风或路由行为已经验证;不得吞并 Core Media 时间戳、样本缓冲区就绪或时基修复;不得将 UI 状态、采集配置、写入器循环和播放器所有权合并到一个对象中。当所需行为依赖不可用的摄像头、麦克风、文件、路由或设备证据时,应标记为 blocked。
相关技能交接
音频意图、麦克风权限、中断、路由等交由 avfaudio-session-workflow;摄像头设备、控制、照片、深度、校准等交由 camera-capture-depth-workflow;CMTime、格式描述、样本缓冲区附件、丢帧、同步等交由 coremedia-timing-samplebuffer-workflow;底层 VideoToolbox 编解码交由 video-codec-processing-workflow;PhotosUI 与 PhotoKit 交由 photos-library-editing-workflow;音频引擎图交由 avaudio-engine-workflow;构建运行交由 xcode-build-run-workflow;测试验证交由 xcode-testing-workflow;文档查找交由 explore-apple-swift-docs。