clone/afilmory
1
0
Fork 0
mirror of https://github.com/Afilmory/afilmory synced 2026-02-01 22:48:17 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
comment
afilmory/rss-spec.md

9.5 KiB
Raw Permalink Blame History

Afilmory RSS EXIF Extension Specification

概述

本规范定义了在 RSS 2.0 feeds 中包含摄影 EXIF 数据的标准方法，专为照片画廊网站设计。该扩展允许 RSS 阅读器和其他应用程序访问详细的摄影技术参数，并支持不同类型的图片展示。

协议版本

当前版本: 1.1
协议标识: afilmory-rss-exif

协议元数据

<exif:version>

描述: 协议版本号
位置: <channel> 元素内
格式: 语义化版本号
示例: <exif:version>1.1</exif:version>
必需: 是

<exif:protocol>

描述: 协议标识符
位置: <channel> 元素内
格式: 字符串标识符
示例: <exif:protocol>afilmory-rss-exif</exif:protocol>
必需: 是

EXIF 标签定义

相机设置参数 (basic)

<exif:aperture>

描述: 光圈值
格式: f/{数值}
示例: <exif:aperture>f/1.4</exif:aperture>
映射: EXIF FNumber 字段

<exif:shutterSpeed>

描述: 快门速度
格式:

  • 长曝光: {秒数}s
  • 短曝光: 1/{分母}s
    示例:
  • <exif:shutterSpeed>1/250s</exif:shutterSpeed>
  • <exif:shutterSpeed>2s</exif:shutterSpeed>
    映射: EXIF ExposureTime 字段

<exif:iso>

描述: ISO 感光度
格式: 整数
示例: <exif:iso>1000</exif:iso>
映射: EXIF ISOSpeedRatings 字段

<exif:exposureCompensation>

描述: 曝光补偿
格式: {±数值} EV
示例:

  • <exif:exposureCompensation>+0.7 EV</exif:exposureCompensation>
  • <exif:exposureCompensation>-1.3 EV</exif:exposureCompensation>
    映射: EXIF ExposureBiasValue 字段

镜头参数 (lens)

<exif:focalLength>

描述: 实际焦距
格式: {数值}mm
示例: <exif:focalLength>50mm</exif:focalLength>
映射: EXIF FocalLength 字段

<exif:focalLength35mm>

描述: 等效35mm焦距
格式: {数值}mm
示例: <exif:focalLength35mm>75mm</exif:focalLength35mm>
映射: EXIF FocalLengthIn35mmFilm 字段

<exif:lens>

描述: 镜头型号
格式: CDATA 包装的字符串
示例: <exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>
映射: EXIF LensModel 字段

<exif:maxAperture>

描述: 镜头最大光圈
格式: f/{数值}
示例: <exif:maxAperture>f/1.4</exif:maxAperture>
映射: EXIF MaxApertureValue 字段

设备信息 (basic)

<exif:camera>

描述: 相机品牌和型号
格式: CDATA 包装的字符串
示例: <exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>
映射: EXIF Make + Model 字段组合

图像属性 (basic)

<exif:imageWidth>

描述: 图像宽度（像素）
格式: 整数
示例: <exif:imageWidth>7728</exif:imageWidth>
映射: 来自图像处理系统的实际宽度

<exif:imageHeight>

描述: 图像高度（像素）
格式: 整数
示例: <exif:imageHeight>5152</exif:imageHeight>
映射: 来自图像处理系统的实际高度

<exif:dateTaken>

描述: 拍摄时间（原始时间戳）
格式: ISO 8601 格式
示例: <exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>
映射: EXIF DateTimeOriginal 字段

<exif:orientation>

描述: 图像方向 格式: 整数 (1-8) 示例: <exif:orientation>1</exif:orientation> 映射: EXIF Orientation 字段

图片展示 (media)

<enclosure>

描述: 缩略图 URL 位置: <item> 元素内 格式: 标准 RSS enclosure 元素 示例: <enclosure url="https://example.com/thumbnails/photo.webp" type="image/webp" length="0" /> 说明:

  • url: 缩略图的完整 URL，支持相对路径转换为绝对路径
  • type: MIME 类型，根据文件扩展名自动判断（webp/png/jpeg）
  • length: 文件大小（字节），可设为 0 表示未知

技术参数 (technical)

<exif:whiteBalance>

描述: 白平衡设置
格式: 枚举值
示例: <exif:whiteBalance>Auto</exif:whiteBalance>
映射: EXIF WhiteBalance 字段
可选值: Auto, Daylight, Cloudy, Tungsten, Fluorescent, Flash, Manual

<exif:meteringMode>

描述: 测光模式
格式: 枚举值
示例: <exif:meteringMode>Matrix</exif:meteringMode>
映射: EXIF MeteringMode 字段
可选值: Matrix, Center-weighted, Spot, Multi-spot, Pattern

<exif:flashMode>

描述: 闪光灯模式
格式: 枚举值
示例: <exif:flashMode>Off</exif:flashMode>
映射: EXIF Flash 字段
可选值: Off, On, Auto, Red-eye, Fill, Slow-sync

<exif:colorSpace>

描述: 色彩空间
格式: 枚举值
示例: <exif:colorSpace>sRGB</exif:colorSpace>
映射: EXIF ColorSpace 字段
可选值: sRGB, Adobe RGB, ProPhoto RGB, DCI-P3

高级参数 (advanced)

<exif:exposureProgram>

描述: 曝光程序
格式: 枚举值
示例: <exif:exposureProgram>Aperture Priority</exif:exposureProgram>
映射: EXIF ExposureProgram 字段
可选值: Manual, Program, Aperture Priority, Shutter Priority, Creative, Action, Portrait, Landscape

<exif:sceneMode>

描述: 场景模式
格式: CDATA 包装的字符串
示例: <exif:sceneMode><![CDATA[Portrait]]></exif:sceneMode>
映射: EXIF SceneCaptureType 字段

<exif:contrast>

描述: 对比度设置
格式: 枚举值
示例: <exif:contrast>Normal</exif:contrast>
映射: EXIF Contrast 字段
可选值: Low, Normal, High

<exif:saturation>

描述: 饱和度设置
格式: 枚举值
示例: <exif:saturation>Normal</exif:saturation>
映射: EXIF Saturation 字段
可选值: Low, Normal, High

<exif:sharpness>

描述: 锐度设置
格式: 枚举值
示例: <exif:sharpness>Normal</exif:sharpness>
映射: EXIF Sharpness 字段
可选值: Soft, Normal, Hard

完整示例

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:exif="https://afilmory.com/rss/exif">
  <channel>
    <title><![CDATA[我的风景摄影画廊]]></title>
    <link>https://example.com</link>
    <description><![CDATA[分享我的风景摄影作品]]></description>

    <!-- 协议元数据 -->
    <exif:version>1.1</exif:version>
    <exif:protocol>afilmory-rss-exif</exif:protocol>
 
    
    <item>
      <title><![CDATA[夕阳下的城市]]></title>
      <link>https://example.com/photo123</link>
      <guid isPermaLink="true">https://example.com/photo123</guid>
      <description><![CDATA[城市天际线在夕阳下的美丽景象]]></description>
      <pubDate>Thu, 05 Jun 2025 16:12:43 GMT</pubDate>
      <category><![CDATA[风景]]></category>
      <category><![CDATA[城市]]></category>
      <enclosure url="https://example.com/thumbnails/photo123.webp" type="image/webp" length="1024000" />
      
      <!-- 基础 EXIF 数据 -->
      <exif:aperture>f/1.4</exif:aperture>
      <exif:shutterSpeed>1/250s</exif:shutterSpeed>
      <exif:iso>1000</exif:iso>
      <exif:exposureCompensation>0 EV</exif:exposureCompensation>
      <exif:imageWidth>7728</exif:imageWidth>
      <exif:imageHeight>5152</exif:imageHeight>
      <exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>
      <exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>
      <exif:orientation>1</exif:orientation>
      
      <!-- 镜头信息 -->
      <exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>
      <exif:focalLength>50mm</exif:focalLength>
      <exif:focalLength35mm>75mm</exif:focalLength35mm>
      <exif:maxAperture>f/1.4</exif:maxAperture>

      <!-- 技术参数 -->
      <exif:whiteBalance>Auto</exif:whiteBalance>
      <exif:meteringMode>Matrix</exif:meteringMode>
      <exif:flashMode>Off</exif:flashMode>
      <exif:colorSpace>sRGB</exif:colorSpace>
    </item>
  </channel>
</rss>

兼容性和实现注意事项

向后兼容性

  • 标准的 RSS 2.0 阅读器将忽略不识别的命名空间元素
  • 核心 RSS 功能（标题、链接、描述等）保持完全兼容

可选字段

  • 除协议版本和图片展类型外，所有 EXIF 标签都是可选的
  • 如果某个 EXIF 数据不可用，应省略对应的标签而不是输出空值
  • 实现者可以根据 supportedFields 声明选择性实现字段集

数据验证

  • 实现者应验证 EXIF 数据的有效性
  • 对于无效或缺失的数据，建议静默跳过而不是输出错误值
  • 枚举类型字段应严格验证取值范围

性能考虑

  • EXIF 数据提取可能影响 RSS 生成性能
  • 建议在构建时预处理 EXIF 数据而非实时提取
  • 可根据 supportedFields 声明优化数据提取范围

字段集实现建议

  • basic 字段集适用于大多数基础应用
  • location 字段集需要考虑隐私保护
  • advanced 字段集适用于专业摄影应用
  • 实现者可以自定义字段集组合

版本历史

  • v1.1 (2025-01-19): 扩展规范

    • 添加协议版本号和标识符
    • 定义图片展类型系统
    • 引入EXIF字段集概念
    • 扩充EXIF字段定义
    • 添加位置信息、技术参数和高级参数字段集

  • v1.0 (2025-01-19): 初始规范发布

    • 定义核心 EXIF 标签集合
    • 建立命名空间约定
    • 提供完整实现示例

许可证

本规范基于 Creative Commons Attribution 4.0 International License 发布。

Reference in New Issue View Git Blame Copy Permalink