Advanced Emulator Launcher (AEL) 元数据与资源文件技术解析

Advanced Emulator Launcher (AEL) 元数据与资源文件技术解析

plugin.program.AEL.dev Emulator frontend and app launcher for Kodi 项目地址: https://gitcode.com/gh_mirrors/pl/plugin.program.AEL.dev

前言

Advanced Emulator Launcher (AEL) 是一个功能强大的前端解决方案，它为Kodi环境下的游戏提供了完整的元数据管理和资源文件支持系统。本文将深入解析AEL的元数据模型和资源文件体系，帮助开发者更好地理解其内部工作机制。

核心概念解析

虚拟分类与虚拟启动器

AEL采用了一套灵活的虚拟分类系统，主要包括：

• ROM集合：游戏ROM的集合分类
• 浏览方式：提供多种ROM浏览方式
• 离线数据浏览：支持AEL和LaunchBox两种离线数据源

虚拟启动器则包括：

• 收藏夹
• 最近游玩记录
• 最常游玩记录
• 各分类下的具体集合

元数据类型

AEL定义了三种主要元数据类型：

1. 类别元数据：用于分类和虚拟分类
2. 启动器元数据：用于启动器和虚拟启动器
3. ROM元数据：用于具体游戏ROM

元数据标签详解

类别元数据标签

当选择类别或虚拟类别时，AEL会设置以下元数据标签：

| 元数据名称 | AEL字段 | setInfo()标签 | 类型 | |------------|---------|---------------|------| | 标题 | m_name | title | 字符串 | | 类型 | m_genre | genre | 字符串 | | 描述 | m_plot | plot | 字符串 | | 评分 | m_rating | rating | 0-10字符串 |

启动器元数据标签

对于启动器或虚拟启动器，AEL设置了更丰富的元数据：

| 元数据名称 | AEL字段 | setInfo()标签 | 类型 | |------------|---------|---------------|------| | 标题 | m_name | title | 字符串 | | 年份 | m_year | year | 字符串 | | 类型 | m_genre | genre | 字符串 | | 描述 | m_plot | plot | 字符串 | | 制作商 | m_studio | studio | 字符串 | | 评分 | m_rating | rating | 0-10字符串 | | 平台 | platform | (通过setProperty) | 字符串 |

ROM元数据标签

游戏ROM拥有最完整的元数据集：

| 元数据名称 | AEL字段 | setInfo()标签 | 类型 | |------------|---------|---------------|------| | 标题 | m_name | title | 字符串 | | 年份 | m_year | year | 字符串 | | 类型 | m_genre | genre | 字符串 | | 描述 | m_plot | plot | 字符串 | | 制作商 | m_studio | studio | 字符串 | | 评分 | m_rating | rating | 0-10字符串 | | 玩家人数 | m_nplayers | (通过Property) | - | | 分级 | m_esrb | (通过Property) | - | | 平台 | platform | (通过Property) | 字符串 |

资源文件系统

类别资源文件

AEL为类别提供了多种资源文件类型：

| 资源类型 | AEL字段 | setArt()标签 | 默认值 | |----------|---------|--------------|--------| | 图标 | s_icon | icon | DefaultFolder.png | | 背景图 | s_fanart | fanart | - | | 横幅 | s_banner | banner | - | | 海报 | s_flyer | poster | - | | 透明标志 | s_clearlogo | clearlogo | - | | 视频 | s_trailer | (通过setInfo) | - |

ROM资源文件

游戏ROM拥有最丰富的资源文件类型：

| 资源类型 | AEL字段 | setArt()标签 | MAME映射 | |----------|---------|--------------|----------| | 标题图 | s_title | title | title | | 截图 | s_snap | snap | snap | | 背景图 | s_fanart | fanart | fanart | | 横幅 | s_banner | banner | marquee | | 透明标志 | s_clearlogo | clearlogo | clearlogo | | 盒装正面 | s_boxfront | boxfront | cabinet | | 盒装背面 | s_boxback | boxback | cpanel | | 卡带图 | s_cartridge | cartridge | pcb | | 海报 | s_flyer | poster | flyer | | 地图 | s_map | map | - | | 手册 | s_manual | - | manual | | 视频 | s_trailer | (通过setInfo) | trailer |

资源文件存储策略

AEL采用了一套规范的资源文件存储方案：

1. ROM资源文件存储在专门的资源目录中，按类型分子目录：

   ~/Artwork/SNES/titles/游戏名.png
   ~/Artwork/SNES/snaps/游戏名.png
   ~/Artwork/SNES/fanarts/游戏名.png
   

2. 启动器/类别资源文件存储在插件数据目录中：

   ADDON_DATA_DIR/asset-categories/类别名/fanart1.png
   ADDON_DATA_DIR/asset-launchers/启动器名/fanart1.png
   

兼容性与迁移

AEL为保持兼容性，提供了从其他系统迁移的路径：

• AL的thumb资源将映射为AEL的title资源
• AL的fanart资源将直接对应AEL的fanart资源

但建议用户重新组织资源文件结构以充分利用AEL的高级功能。

最佳实践建议

1. 资源文件组织：按照AEL推荐的目录结构组织资源文件，便于管理和维护
2. 元数据完整性：尽可能填写完整的元数据，提升用户体验
3. 资源文件选择：根据目标平台特性选择合适的资源文件类型
4. 迁移策略：对于大型游戏库，建议分批迁移并验证

通过深入理解AEL的元数据和资源文件系统，开发者可以构建更加丰富和专业的游戏前端体验。

plugin.program.AEL.dev Emulator frontend and app launcher for Kodi 项目地址: https://gitcode.com/gh_mirrors/pl/plugin.program.AEL.dev