https://github.com/zsxsoft/danmu-client

A cross-platforms danmaku client that supports transparency which based on canvas + WebSocket. 多用跨平台透明弹幕客户端，支持图文弹幕，基于canvas + WebSocket。
https://github.com/zsxsoft/danmu-client

danmaku danmu electron javascript

Last synced: 3 months ago
JSON representation

A cross-platforms danmaku client that supports transparency which based on canvas + WebSocket. 多用跨平台透明弹幕客户端，支持图文弹幕，基于canvas + WebSocket。

• Host: GitHub
• URL: https://github.com/zsxsoft/danmu-client
• Owner: zsxsoft
• Created: 2015-03-07T15:16:18.000Z (over 9 years ago)
• Default Branch: electron
• Last Pushed: 2017-08-20T06:31:09.000Z (about 7 years ago)
• Last Synced: 2024-05-27T12:01:30.664Z (5 months ago)
• Topics: danmaku, danmu, electron, javascript
• Language: JavaScript
• Homepage:
• Size: 429 KB
• Stars: 150
• Watchers: 13
• Forks: 30
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

• awesome - zsxsoft/danmu-client - A cross-platforms danmaku client that supports transparency which based on canvas + WebSocket. 多用跨平台透明弹幕客户端，支持图文弹幕，基于canvas + WebSocket。 (JavaScript)

README

        
danmu-client

==========

[![Github All Releases](https://img.shields.io/github/downloads/zsxsoft/danmu-client/total.svg)](https://github.com/zsxsoft/danmu-client/releases)

[![David deps](https://david-dm.org/zsxsoft/danmu-client.svg)](https://david-dm.org/zsxsoft/danmu-client)

这是一个独立的弹幕客户端，其服务端项目见[danmu-server](https://github.com/zsxsoft/danmu-server)。屏幕截图见[Release](https://github.com/zsxsoft/danmu-client/releases)。

**欲使用此项目，服务端需要使用对应的版本。[已发布的客户端](https://github.com/zsxsoft/danmu-client/releases)均已写明对应的服务端版本号，开发分支内的客户端版本仅对应开发分支的服务端。**

## 功能特色

- 以``WebSocket``作为通讯协议，用``Canvas``作为弹幕的画布；

- 可在桌面任何位置显示弹幕，可与其他程序（如PowerPoint、视频播放器等）共同工作；

- 窗口置于最前，完全透明可穿透，能与其他程序正常交互；

- 提供紧急清空弹幕池、停止接收弹幕等功能，可删除单条弹幕；

- 支持图片弹幕。

### 适用场景

- 数十人至千人集会（如学校活动、电影放映会）的实时互动

- 大型活动实时公告信息显示

- 欲在桌面显示实时吐槽

## 最低系统要求

Windows 7 / macOS 10.9 (x64) / Ubuntu 12.04 / Fedora 21 / Debian 8

## 使用预编译版本

1. 打开[Release](https://github.com/zsxsoft/danmu-client/releases)下载已经编译好的程序包并解压到某目录。

2. 双击目录下的``danmu-client``，启动成功。

## 从源码启动

1. 下载并安装[Nodejs](https://nodejs.org)，并检查[node-gyp](https://github.com/nodejs/node-gyp)的依赖环境。

2. ``npm install``

3. ``npm start``

## 打包发布

``npm run build``

## 配置说明

根目录``config.js``下有配置，以下是说明

    socket: {

        url: "弹幕服务器开启的IP与端口（如使用反代，需要确认反代支持WebSocket连接）",

        password: "弹幕服务器连接密码",

        room: "选择连接弹幕服务器的某间房间",

        heartbeat: 心跳包发送间隔

    },

    display: {

        comment: {

            animationStyle: "默认弹幕样式（支持scroll、reversescroll、staticdown、staticup）",

            fontStyle: "默认字体样式",

            fontColor: "默认颜色",

            lifeTime: 每条弹幕的基本存活时间,

            height: 每条弹幕占据高度

        }, 

        image: 图片弹幕开关

    }, 

    image: {

        regex: 图片判断正则，勿动

        whitelist: [

            "图片弹幕允许加载的网络图片白名单。", 

            "不支持通配符，必须一条一条手动添加。", 

            "请确认图片可以正常被打开。"

        ], 

        preload: 网络图片是否预读缓存

    }

## 图片弹幕

打开图片弹幕开关后，弹幕内含相关内容的将被解析为图片。图片必须可以正常打开，调用代码如：``[IMG WIDTH=24]danmu-24.png[/IMG]``。格式：``[IMG WIDTH=图片宽度]图片地址（支持HTTP）[/IMG]``

为了保证安全与稳定，图片弹幕有防火墙机制。只有在弹幕程序目录及子目录下存在的图片才可被加载。引用网络图片，必须手动修改``config.js``添加白名单规则。如果被过滤，则程序不会有任何提示，该弹幕也不会被显示。

## 自定义弹幕

需要在服务器打开相应开关后，才允许使用自定义弹幕功能。自定义弹幕必须返回一个函数（或类），继承自``lib/danmu/sprite.js``中的``Sprite``，并需要实现``updateLifeTime``方法和``draw``方法，有``alive``属性。__为确保效率，自定义弹幕未加入错误捕捉。一旦函数出错，则弹幕系统停止接受新弹幕。__

示例代码如下（生成一个颜色随机、在屏幕上晃来晃去的玩意）：

### 最新版示例代码 

```javascript

return (() => {

    'use strict';

    const Sprite = require('./lib/danmu/sprite');

    let canvasWidth = 0;

    let canvasHeight = 0;

    class Comment extends Sprite {

        constructor(param) {

            super(param.id, param.x, param.y, param.width, param.height, param.speed, param.lifeTime);

            this.text = param.text || ""; //文字内容

            this.lifeTime = param.lifeTime || config.display.comment.lifeTime;

            this.font = param.font || config.display.comment.fontStyle;

        }

        draw(canvasContext) {

            if (canvasWidth === 0) canvasWidth = canvasContext.canvas.width;

            if (canvasHeight === 0) canvasHeight = canvasContext.canvas.height;

            canvasContext.fillStyle = `rgb(${parseInt(Math.random() * 255)}, ${parseInt(Math.random() * 255)}, ${parseInt(Math.random() * 255)})`;

            canvasContext.font = this.font;

            canvasContext.fillText(this.text, parseInt(Math.random() * canvasWidth), parseInt(Math.random() * canvasHeight));

        }

        updateLifeTime() {

            this.lifeTime--; //每刷新一帧，存活时间-1

            this.alive = (this.lifeTime >= 0);

        };

    }

    return Comment;

})();

```

## 开源协议

The MIT License (MIT)

## 博文

[弹幕服务器及搭配之透明弹幕客户端研究结题报告](https://blog.zsxsoft.com/post/15)

[弹幕服务器及搭配之透明弹幕客户端研究中期报告](https://blog.zsxsoft.com/post/14)

[弹幕服务器及搭配之透明弹幕客户端研究开题报告](https://blog.zsxsoft.com/post/13)

## 开发者

zsx - https://www.zsxsoft.com / 博客 - https://blog.zsxsoft.com

## 感谢

[DDPlayer](https://github.com/dpy1123/ddplayer) by dpy1123