Swift中如何从JPEG提取深度数据？代码返回nil求解决

我之前在处理iOS相册人像深度数据的时候，也踩过一模一样的坑——明明照片显示有深度信息，但代码走到guard let auxDepthInfo = ...就直接返回nil了。结合我的踩坑经验，给你几个排查方向：

1. 确认你请求的是正确的资源类型 #

相册里的深度数据通常是作为附属资源存在的，不是主图片资源本身。你不能直接从主图片里提取，得明确请求PHAssetResourceType.depthData类型的资源：

let resources = PHAssetResource.assetResources(for: targetAsset)
guard let depthResource = resources.first(where: { $0.type == .depthData }) else {
    print("未找到深度数据资源")
    return
}
// 之后可以用PHAssetResourceManager读取这个资源的数据

2. 检查相册访问权限 #

iOS对相册权限管控很严，尤其是iOS 14+之后，仅“添加照片”权限是读不到深度数据的，必须申请读写权限。

• 先确保Info.plist里添加了NSPhotoLibraryUsageDescription和NSPhotoLibraryAddUsageDescription字段，填写清楚权限用途；
• 代码里请求正确的权限：

PHPhotoLibrary.requestAuthorization(for: .readWrite) { authStatus in
    guard authStatus == .authorized else {
        print("权限不足，无法访问深度数据")
        return
    }
    // 在这里执行深度数据提取逻辑
}

3. 处理嵌入在元数据里的深度信息 #

有些人像照片的深度数据不是单独的附属资源，而是直接嵌入在主图片的元数据中（比如HEIC格式的照片）。这种情况可以尝试从CGImageSource读取辅助信息：

func extractDepthData(from imageData: Data) -> AVDepthData? {
    guard let imageSource = CGImageSourceCreateWithData(imageData as CFData, nil) else {
        return nil
    }
    guard let depthInfoDict = CGImageSourceCopyAuxiliaryDataInfoAtIndex(
        imageSource,
        0,
        kCGImageAuxiliaryDataTypeDepthData
    ) as? [String: Any] else {
        return nil
    }
    return try? AVDepthData(fromDictionaryRepresentation: depthInfoDict)
}

4. 检查PHImageManager的请求选项 #

如果你是用PHImageManager获取图片，默认配置不会返回深度数据相关的内容。记得设置这两个关键选项：

let requestOptions = PHImageRequestOptions()
requestOptions.isNetworkAccessAllowed = true // 若照片在iCloud上，必须开启
requestOptions.version = .current // 获取最新版本的照片，包含完整附属资源

PHImageManager.default().requestImageDataAndOrientation(for: targetAsset, options: requestOptions) { data, _, _, _ in
    guard let imageData = data else { return }
    if let depthData = extractDepthData(from: imageData) {
        // 成功拿到深度数据
    }
}

5. 用真实设备测试，排除模拟器问题 #

iOS模拟器对深度数据的支持一直不太完善，哪怕你导入带深度的照片，也可能读不到数据。建议直接在支持人像模式的真实iPhone设备（iPhone 7+及以上）上测试。

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