akmon/MULTIMEDIA_SYSTEM_EXTENSION.md

多媒体内容管理系统扩展说明

新增功能概述

在原有视频系统基础上，现已扩展支持音频和图片内容，形成完整的多媒体内容管理系统。

内容类型支持

1. 视频 (video)

• ✅ 视频播放和控制
• ✅ 弹幕系统
• ✅ 播放记录追踪
• ✅ 多画质支持

2. 音频 (audio) 🆕

• ✅ 音频播放和控制
• ✅ 弹幕系统（支持音频弹幕）
• ✅ 播放记录追踪
• ✅ 音质和编码信息
• ✅ 音频封面图

3. 图片 (image) 🆕

• ✅ 图片展示和缩放
• ✅ 智能标签系统
• ✅ 浏览记录追踪
• ✅ 多格式支持
• ✅ 无障碍访问支持

4. 文章 (article)

• ✅ 原有文章功能保持不变

新增数据库表结构

图片标签表 (ak_image_tags)

-- 用于图片分类和搜索
CREATE TABLE ak_image_tags (
    content_id UUID,           -- 关联图片内容
    tag_name VARCHAR(50),      -- 标签名称
    tag_type VARCHAR(20),      -- 标签来源：user/auto/ai
    confidence DECIMAL(3,2),   -- AI标签置信度
    created_at TIMESTAMPTZ
);

图片浏览记录表 (ak_image_view_records)

-- 图片浏览行为记录
CREATE TABLE ak_image_view_records (
    content_id UUID,           -- 关联图片内容
    user_id UUID,              -- 用户ID
    view_duration INTEGER,     -- 浏览时长
    zoom_level DECIMAL(4,2),   -- 缩放级别
    device_type VARCHAR(20),   -- 设备类型
    created_at TIMESTAMPTZ
);

扩展字段说明

ak_contents 表新增字段

音频相关

• audio_url - 音频文件URL
• audio_duration - 音频时长（秒）
• audio_size - 文件大小（字节）
• audio_format - 音频格式（mp3, wav, flac等）
• audio_bitrate - 比特率（kbps）
• audio_sample_rate - 采样率（Hz）
• audio_cover - 音频封面图

图片相关

• image_url - 图片文件URL
• image_width - 图片宽度
• image_height - 图片高度
• image_size - 文件大小（字节）
• image_format - 图片格式（jpg, png, webp等）
• image_quality - 图片质量（original, compressed, thumbnail）
• image_alt_text - Alt文本（无障碍访问）

通用字段

• media_metadata - JSONB格式的额外元数据

查询视图更新

1. 通用多媒体视图

-- 查询所有类型内容
SELECT * FROM vw_media_content_detail;

-- 查询特定类型内容
SELECT * FROM vw_video_content_detail;   -- 视频
SELECT * FROM vw_audio_content_detail;   -- 音频
SELECT * FROM vw_image_content_detail;   -- 图片（包含标签）

2. 新增专用视图

-- 热门图片标签
SELECT * FROM vw_popular_image_tags;

-- 用户多媒体消费统计
SELECT * FROM vw_user_media_stats;

使用示例

音频内容插入

INSERT INTO ak_contents (
    title, content_type, audio_url, audio_duration, 
    audio_format, audio_bitrate, audio_cover
) VALUES (
    '示例音频', 'audio', 'https://example.com/audio.mp3',
    180, 'mp3', 320, 'https://example.com/cover.jpg'
);

图片内容插入

INSERT INTO ak_contents (
    title, content_type, image_url, image_width, 
    image_height, image_format, image_alt_text
) VALUES (
    '示例图片', 'image', 'https://example.com/image.jpg',
    1920, 1080, 'jpg', '美丽的风景照片'
);

添加图片标签

INSERT INTO ak_image_tags (content_id, tag_name, tag_type)
VALUES 
    ('image-uuid', '风景', 'user'),
    ('image-uuid', '自然', 'ai');

前端集成建议

1. 音频播放器页面

// 参考video-player.uvue，创建audio-player.uvue
// 支持音频弹幕、播放控制、音质选择等功能

2. 图片查看器页面

// 创建image-viewer.uvue
// 支持缩放、标签展示、浏览记录等功能

3. 统一媒体播放器

// 创建media-player.uvue
// 根据content_type自动选择合适的播放器组件

多语言支持

需要在现有i18n文件中添加：

// 音频相关
"audio": {
  "play": "播放",
  "pause": "暂停", 
  "quality": "音质",
  "bitrate": "比特率"
}

// 图片相关  
"image": {
  "zoom": "缩放",
  "tags": "标签",
  "addTag": "添加标签",
  "download": "下载"
}

性能优化建议

1. 图片懒加载

• 实现图片懒加载和预加载
• 根据设备和网络条件选择合适的图片质量

2. 音频预加载

• 实现音频预加载机制
• 支持音频格式自适应

3. 缓存策略

• 多媒体文件CDN缓存
• 标签和元数据本地缓存

扩展功能建议

1. AI功能

• 图片自动标签识别
• 音频内容转录和搜索
• 智能推荐系统

2. 社交功能

• 图片/音频评论
• 多媒体内容分享
• 用户创建的播放列表

3. 管理功能

• 批量上传和处理
• 内容审核系统
• 存储空间管理

总结

通过这次扩展，系统现在支持：

• ✅ 4种内容类型（文章、视频、音频、图片）
• ✅ 统一的用户交互系统（点赞、收藏、分享）
• ✅ 完整的评论系统
• ✅ 弹幕系统（视频+音频）
• ✅ 智能标签系统（图片）
• ✅ 详细的用户行为追踪
• ✅ 灵活的权限控制

这为构建一个全功能的多媒体内容平台奠定了坚实的基础。