# 弹幕

## 功能介绍

POLYV播放器拥有弹幕功能，可以增加观看视频时的互动性

## 功能API

### 参数

| 参数名         | 类型      | 默认值     | 说明                               |
| ----------- | ------- | ------- | -------------------------------- |
| danmuEnable | boolean | `false` | 是否开启弹幕功能                         |
| showDanmu   | boolean | `true`  | 开启弹幕功能后，弹幕初始显示状态。false则一开始不显示弹幕。 |
| banDanmuBtn | boolean | `false` | 为true时不显示弹幕按钮                    |

参数设置示例

```javascript
var player = polyvLivePlayer({
  wrap: '#player',
  width: 800,
  height: 533,
  uid:'uid',
  vid:'vid',
  danmuEnable: true,
});
```

### 方法

| 方法名                    | 参数     | 返回值 | 说明                     |
| ---------------------- | ------ | --- | ---------------------- |
| j2s\_addBarrageMessage | Object | /   | 弹幕显示文案，支持内嵌图片，具体调用参考下方 |

方法详解

`j2s_addBarrageMessage`

| 参数名       | 类型     | 取值范围                  | 默认值      | 说明                                                        | 是否必须项 |
| --------- | ------ | --------------------- | -------- | --------------------------------------------------------- | ----- |
| msg       | string | /                     | /        | 弹幕内容，图片需要用\[\[...]]包含起来                                   | 是     |
| fontSize  | number | /                     | 30       | 字体大小                                                      | 否     |
| fontColor | string | 16进制颜色值               | 0x000000 | 字体颜色                                                      | 否     |
| fontMode  | string | roll \| top \| bottom | roll     | <p>显示方式：<br>roll 屏幕上自右向左滚动<br>top 固定顶部<br>bottom 固定底部</p> | 否     |

方法调用示例

`j2s_addBarrageMessage`

```javascript
// 文本弹幕
const danmuData = {
  msg: '这是文本弹幕数据',
  fontSize: 30,
  fontMode: 'roll',
  fontColor: '0x000000',
};
player.j2s_addBarrageMessage(danmuData);

// 文本内嵌图片弹幕，需要将图片地址用双中括号包裹使用
const danmuData = {
  msg: '这是图片[[http://www.mywebsite.com/1.jpg]]弹幕数据',
  fontSize: 30,
  fontMode: 'roll',
  fontColor: '0x000000',
};
player.j2s_addBarrageMessage(danmuData);
```
