CGImageMetadataSetTagWithPath添加HDR增益映射标签失败问题咨询

问题核心原因 #

你添加HDR标签失败的直接问题是标签与路径不匹配：

• 你创建的是HDRGainMapHeadroom标签，但设置路径时写的是HDRGainMap:HDRGainMapVersion，路径指向的是另一个标签的位置，导致系统无法匹配，因此返回false。
• 另外，Apple的HDRGainMap元数据属于私有命名空间，需要保证元数据结构层级正确，不能随意通过路径直接添加。

修正后的代码示例 #

方法1：直接添加标签（更可靠） #

// 创建可变元数据实例
let mutableMetadata = CGImageMetadataCreateMutable()

// 创建HDRGainMapVersion标签并添加
let versionTag = CGImageMetadataTagCreate(
    "http://ns.apple.com/HDRGainMap/1.0/" as CFString,
    "HDRGainMap" as CFString,
    "HDRGainMapVersion" as CFString,
    .default,
    131072 as CFNumber
)
CGImageMetadataAddTag(mutableMetadata, nil, versionTag)

// 创建HDRGainMapHeadroom标签并添加
let headroomTag = CGImageMetadataTagCreate(
    "http://ns.apple.com/HDRGainMap/1.0/" as CFString,
    "HDRGainMap" as CFString,
    "HDRGainMapHeadroom" as CFString,
    .default,
    3.56 as CFNumber
)
CGImageMetadataAddTag(mutableMetadata, nil, headroomTag)

方法2：路径匹配标签（需严格对应） #

如果坚持使用CGImageMetadataSetTagWithPath，必须保证路径与标签的key完全一致：

let mutableMetadata = CGImageMetadataCreateMutable()

let headroomTag = CGImageMetadataTagCreate(
    "http://ns.apple.com/HDRGainMap/1.0/" as CFString,
    "HDRGainMap" as CFString,
    "HDRGainMapHeadroom" as CFString,
    .default,
    3.56 as CFNumber
)
// 路径需与标签key严格对应
let path = "HDRGainMap:HDRGainMapHeadroom" as CFString
let success = CGImageMetadataSetTagWithPath(mutableMetadata, nil, path, headroomTag)

关于HDRGainMap是否为Apple私有字典 #

是的，http://ns.apple.com/HDRGainMap/1.0/是Apple定义的私有命名空间，对应的HDR增益映射元数据属于Apple私有字典的一部分。这类元数据是Apple专为HEIC格式的HDR图片设计，用于存储增益映射版本、动态范围等专属信息，不属于通用XMP标准元数据范畴。

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