YAML格式错误排查与VR视频文件名特征分析

摘要：本文总结了YAML配置文件中因关键词大小写问题导致的解析错误，并提出了使用正则表达式或统一小写处理的解决方案。同时，详细列举了VR视频文件名常见的命名特征，帮助识别和分类VR内容。

YAML格式错误排查

      在解析YAML文件时，遇到了如下错误信息：

panic: compiler error at path '': error in keyword 'VR' at position 1: unexpected charact

      该错误提示表明在处理 keywords.vr 的某个关键字时，遇到了非法字符或格式错误。

错误分析

      原始YAML代码如下：

keywords:
  vr:
    - vr
    - VR

      问题可能出在 VR 这个关键字上，解析器可能对大小写敏感，或者期望的是更简单的扁平列表，而不是多个重复形式的大小写组合。

推荐修改方案

方案一：使用正则表达式（推荐）

      如果解析器支持正则表达式，可以将 vr 关键字改为包含忽略大小写的正则表达式：

keywords:
  vr:
    - (?i)vr

      其中 (?i) 表示忽略大小写匹配。

方案二：统一为小写

      若必须保留多个条目，建议统一为小写并确保在判断逻辑中进行统一处理：

keywords:
  vr:
    - vr

      并在条件判断中添加 .lower() 方法，以避免大小写问题：

condition: "([torrent.baseName] + torrent.files.map(f, f.basePath)).join(' ').lower().matches(keywords.vr)"

VR视频文件名特点

      VR视频文件名通常包含特定的关键词或标识，以便用户、平台和设备识别其内容是否支持VR播放（如360°视角、立体声效等）。

常见VR视频文件名特点

• 包含“VR”关键词：如 xxx_VR.mp4, video_vr.mkv 等。
• 包含“360”关键词：表示360度全景视频，如 Mountains_360.mp4, 360_skydive.mkv。
• 标明分辨率和画质：如 VR_4K_video.mp4, 360_8K_experience.mkv。
• 标明“立体视觉”相关关键词：如 VR_SBS.mp4, VR_TB.mp4。
• 标明用途或场景：如 VR_Gameplay.mp4, VR_Concert.mkv。

示例文件名参考

文件名	含义
Beach_Party_360VR_4K.mp4	4K 分辨率的 360° VR 视频，海滩派对场景
VR_Cinematic_SBS_1080p.mkv	左右分屏的 1080p VR 电影风格视频
Mountain_Hike_360_8K.mov	8K 超高清 360° 山地徒步视频
VR_Spacewalk_TB.mp4	上下分屏的太空行走 VR 视频

如何判断一个视频是否是VR视频

• 播放器识别：使用支持VR的播放器（如 VLC、Oculus Video、YouTube VR）打开，观察是否有360°控制或立体效果。
• 查看元数据：使用工具如 ffmpeg 查看视频的投影格式：

  ffmpeg -i video.mp4

  如果输出中有 spherical: equirectangular 或 stereo_mode，则可能是VR视频。
• 在线检测工具：访问 [https://www.vrchecker.net/](https://www.vrchecker.net/) 上传视频自动检测是否为VR视频。