CommentCoreLibrary数据格式完全指南：AcFun、Bilibili、CommonDanmaku格式解析

CommentCoreLibrary数据格式完全指南：AcFun、Bilibili、CommonDanmaku格式解析

【免费下载链接】CommentCoreLibraryJavascript Live Comment (Danmaku) Engine Implementation. JS弹幕模块核心，提供从基本骨架到高级弹幕的支持。项目地址: https://gitcode.com/gh_mirrors/co/CommentCoreLibrary

CommentCoreLibrary是一款强大的Javascript弹幕引擎，提供从基本骨架到高级弹幕的全面支持。本文将详细解析AcFun、Bilibili和CommonDanmaku三种主流弹幕数据格式，帮助开发者轻松集成弹幕功能到自己的项目中。

弹幕数据格式概述

弹幕系统的核心在于数据交换与解析，CommentCoreLibrary通过解析器（Parsers）将不同平台的弹幕文件转换为统一的抽象对象，再交由CommentManager处理和展示。目前CCL已将解析器整合到Providers（供应源）中，具体实现可参考CommentProvider文档。

图：CommentCoreLibrary弹幕管理流程示意图，展示了弹幕从加载到显示的完整生命周期

AcFun弹幕JSON格式详解

AcFun弹幕格式采用JSON结构，分为普通弹幕和高级弹幕两种类型，目前存在v1和v2两个版本。

基础结构

v1版本示例：

{ "c": [...], "m": "弹幕文本" 或 JSON.stringify({...}) }

v2版本示例：

{ "mode": ..., "color": ..., "size": ..., "user": ..., "stime": ..., "time": ..., "message": "弹幕文本" 或 JSON.stringify({...}) }

核心字段解析

• 普通弹幕字段：

  • c：属性序列，包含开始时间、颜色、模式、大小、HASH和发送时间
  • m/message：弹幕文字内容（mode=7时为高级弹幕JSON对象）

• 高级弹幕(mode=7)专属属性：

  • l：弹幕生存时间（0-999秒）
  • p：x,y坐标（-2000至2000，单位为百分比/1000）
  • rx/k/r：三个坐标轴的旋转角度（-3600至3600度）
  • e/f/sz：三个方向的拉伸比例（-50至50）
  • c：锚点位置（0-8，对应从左上到右下的9个位置）

• 移动参数z：数组形式，定义弹幕的动态变化，包含坐标、旋转、拉伸、透明度等随时间变化的属性。

• 样式属性w：定义字体和滤镜效果，支持模糊、发光、投影、斜角等多种视觉效果。

Bilibili弹幕XML格式解析

Bilibili弹幕采用XML格式，结构清晰，支持普通弹幕和高级弹幕（mode≥7）。

基础结构

<?xml version="1.0" encoding="UTF-8"?> <i> <chatserver>chat.bilibili.tv</chatserver> <chatid>91236</chatid> <source>k-v</source> <d p="##,#,##,######,######,#,....,########">弹幕内容</d> </i>

核心字段解析

• d标签属性p：逗号分隔的参数序列，依次为：

  1. stime：弹幕出现时间（秒）
  2. mode：弹幕类型（<7为普通弹幕）
  3. size：字号
  4. color：文字颜色
  5. date：发送时间戳
  6. pool：弹幕池ID
  7. author：发送者ID
  8. dbid：数据库记录ID

• 高级弹幕内容：当mode≥7时，d标签内文本为JSON数组，包含：

  • 坐标属性：x、y（整数为绝对坐标，浮点数为相对坐标）
  • 显示效果：alpha透明度渐变、duration生存周期
  • 3D效果：rotation Y/Z坐标轴旋转
  • 动画属性：target X/Y目标坐标、animation duration动画时间
  • 路径属性：path动画路径定义

CCLNative通用JSON格式

CCLNative是CommentCoreLibrary原生支持的现代化JSON格式，专为HTML5弹幕插件设计，注重JS读取效率和可扩展性。

根结构

{ "v": 1, "len": 10, "offset": 0, "socket": "", "alias": {}, "timeline": [ // 弹幕对象数组 ] }

核心字段解析

• 版本控制：v字段指定格式版本，确保兼容性
• 弹幕总数：len表示弹幕总数，若大于timeline长度则表示为部分加载
• 别名映射：alias字段提供属性别名映射，增强灵活性
• 时间轴数据：timeline数组包含所有弹幕对象，无固定顺序

弹幕格式兼容性处理

解析器通过网络资源和反向工程实现，受限于各平台格式差异和可能的语法错误，无法保证100%还原度。开发者可参考以下实现代码进行兼容性处理：

• Bilibili格式解析：src/parsers/BilibiliFormat.js
• Acfun格式解析：src/parsers/AcfunFormat.js
• 通用格式解析：src/parsers/CommonDanmakuFormat.js

图：CommentCoreLibrary脚本解析流程，展示了从脚本引擎到渲染引擎的完整处理链条

总结与最佳实践

选择合适的弹幕格式对于项目开发至关重要：

• 对接现有平台选择对应格式（AcFun/Bilibili）
• 自有项目推荐使用CCLNative格式，获得最佳兼容性和扩展性
• 高级弹幕功能需注意性能优化，避免过度复杂的动画效果

通过本文的解析，相信您已对CommentCoreLibrary支持的弹幕数据格式有了全面了解。如需进一步学习，可参考项目完整文档：docs/CommentCoreLibraryAPI.md。

【免费下载链接】CommentCoreLibraryJavascript Live Comment (Danmaku) Engine Implementation. JS弹幕模块核心，提供从基本骨架到高级弹幕的支持。项目地址: https://gitcode.com/gh_mirrors/co/CommentCoreLibrary