第39章 Metadata

文件元数据（metadata）用于记录文件的附加信息，例如音乐的歌手、专辑、流派、年份和封面；也可以记录一些可能影响文件行为和展示的辅助信息。元数据采用键值对格式，值的类型统一为字符串，键的命名格式为 `:`。本章介绍影响文件行为和展示的元数据。

分享链接快捷方式

当文件或目录带有 `sys:shared_redirect` 元数据时，表示该文件或目录是某个分享链接的快捷方式。打开或下载该文件时，应以 `sys:shared_redirect` 的值作为真实的文件 URI。

`sys:shared_owner` 用于记录分享链接创建者的 ID，可用于在文件图标左下角显示用户头像角标。

上传

`sys:upload_session_id` 用于记录文件上传的会话 ID，可用于识别仍在上传中的文件。

目录颜色

`customize:icon_color` 用于记录自定义目录的图标颜色，值为 Hex 颜色代码。

自定义 Emoji 图标

`customize:emoji` 用于记录以 Emoji 替换的自定义图标，值为 Emoji 字符串。

标签

`tag:` 用于记录文件标签，值为标签颜色的 Hex 颜色代码。

缩略图不可用

`thumb:disabled` 用于标识没有缩略图的文件，客户端不应再继续为该文件请求缩略图。

回收站文件

`sys:restore_uri` 用于记录回收站中文件的原始 URI，通过它可以获取文件的显示名称。

`sys:expected_collect_time` 用于记录回收站文件的预计清除时间，值为 Unix 时间戳（单位：秒）。

LivePhoto

`customize:live_photo` 用于标记文件是否为 LivePhoto，值为 `true` 或 `false`。要展示 LivePhoto，文件还需附带一个包含 MOV 视频的 LivePhoto Blob。

自定义属性

`props:` 用于记录文件的自定义属性，值为字符串。其中 `` 是自定义属性的 ID，可通过「Get site settings」接口的 explorer 部分获取，`custom_props` 字段包含了所有可用选项。