此项目已长期没有维护
原项目【bilichat】请查看bilichat分支
Comen是一个主要用于在网络直播中向观众展示当前直播间实时评论流的工具。
本项目主要技术栈为前端Angular+后端Nestjs,即完全使用TypeScript(JavaScript)实现。
本项目使用到了nx workspace作为管理代码的工具。本项目是一个monorepo的结构,所以任何本项目开源的部分都能在此仓库找到。
代码结构
- apps
- core --- 前端项目
- node-backend --- 后端的node(cli)包装
- libs
- backend-core --- 后端的可嵌入式实现
- common --- 常用与扩展代码
- gamma --- 兼容Youtube的评论栏渲染器(Angular组件库)
- isomorphic-danmaku --- 同构弹幕,实现了acfun、bilibili的ws连接
- isomprphic-danmaku-server --- 同构弹幕,服务端only部分
调试运行 拉取仓库后,首先安装项目依赖
npm install
然后分别打开前端与后端的dev-server
nx serve core
nx serve node-backend
现在可以对代码进行更改了。任何有关代码更改都会触发自动刷新。
我想贡献一些新功能/我想修复一些问题
本项目的主要目标是将一类实时/非实时评论流在任何兼容html5的平台上渲染出来。在抽象设计上,本项目可分成三大部分:评论源(source),过滤器(filter)和渲染器(renderer)
参考 apps/core/src/app/sources 下的文件。你需要实现MessageSource接口,其中connect方法就是返回一个生产Message的可观察对象。
参考 apps/core/src/app/common/filter.ts 。过滤器是通过rxjs的pipe实现的,强烈建议熟练掌握rxjs,或仅在现有的代码上修改。原理上有点类似于后端的middleware,但rxjs的可观察对象概念要复杂一些,涉及到错误处理,subscription和complete的处理。 另外你还可能需要参考各类Message对象的定义(common包的message.ts)。他们只是单纯的数据对象,不涉及到类也没有成员函数。这些类型定义可能并不稳定。Message由source生成,经过filter后最终流向renderer。但并不是所有类型(以type字段区分的类型)都会被renderer处理。filter也有可能在中间对类型对象数据进行转换/变更。
所有渲染相关代码都在libs/gamma包内。