DanmuManager 一个简单的弹幕工具
ErvinJobe
8年前
<p>DanmuManager 和 VideoDanmuManager 有不同的应用场景，后者用于视频弹幕。</p> <p>你可以运行项目中的测试，来了解二者的使用方法。</p> <h3>DanmuManager</h3> <ol> <li> <p>创建 DanmuManager</p> <pre> <code class="language-objectivec">let dm = DanmuManager(with: self.view) </code></pre> </li> </ol> <pre> <code class="language-objectivec">init` 方法允许自定义： - `top`、`bottom`弹幕显示在 `view` 中的上下位置范围; - `speed` 弹幕的速度; - `customFont` 弹幕字体（`UIFont`, 包括字体家族和大小，默认为系统字体，字号 20）。</code></pre> <ol> <li> <p>添加一条弹幕</p> <pre> <code class="language-objectivec">dm.add(with: “Wow so cool!!!”, at: 4) </code></pre> </li> </ol> <pre> <code class="language-objectivec">add` 方法有两个必传参数，`text`（弹幕文字） 和 `line`（弹幕所在行）;可选参数 `hasBorder` 用于设置该条弹幕是否有边框（默认 borderColor = UIColor.black.cgColor，borderWidth = 1）,默认值为 false;可选参数 `isAdvance` 用于设置该条弹幕是否开启高级功能（目前支持修改 文字颜色 和 背景颜色），默认值为 false。 如果需要弹幕出现在随机行，可以使用 `func addRandom(with text: String = "This is a test Danmu.", at line: Int = 0, hasBorder: Bool = false, isAdvanced: Bool = false)`。</code></pre> <ol> <li> <p>暂停/继续 弹幕</p> <pre> <code class="language-objectivec">dm.pause() dm.resume() </code></pre> </li> </ol> <pre> <code class="language-objectivec">你也可以使用 `dm.toggle()` 来快捷切换 暂停/继续。</code></pre> <h3>VideoDanmuManager</h3> <ol> <li> <p>创建 VideoDanmuManager</p> <pre> <code class="language-objectivec">let vdm = VideoDanmuManager(view: self.view, videoLength: 10, danmuData: [ (3.4, "3.4 Wowowowowowow!"), (3.4, "3.4 SOOOO COOOOOOOOOOL!"), (3.4, "3.4 Amazing!!!!"), (3.4, "3.4 I love you~"), (3.4, "3.4 MY BABY!!!!"), (1.1, "1.1 This is a test Danmu!!!"), (2.0, "2.0 Another test Danmu."), (4.1, "4.1 Amazing!!!!"), (6.1, "6.1 Test!!!!"), (8.1, "8.1 Test!!!!"), (9.1, "9.1 Test!!!!"), (10, "10 Test!!!!"), ], isSorted: false ) </code></pre> </li> </ol> <pre> <code class="language-objectivec">VideoDanmuManager` 的创建有三个必选参数，`view`（显示弹幕的视图），`videoLength`（视频时长，精确到 0.1 秒）和 `danmuData`（已经存在的弹幕列表）。 可选参数 `videoCurrent` 默认为 0，即开始时刻；你可以通过传入不同的时间值来设置显示弹幕的初始时间（比如在视频从 1 分 15 秒开始播放，则应设置 `videoCurrent` 为 75）。 可选参数 `isSorted` 默认为 true，即默认数据集已经按照弹幕显示时间从先到后排序；如传入 false，则将自动调用 `func sort()` 对数据进行排序。 可选参数 `top` 和 `bottom` 同 `DanmuManager`。</code></pre> <ol> <li> <p>开启弹幕</p> <pre> <code class="language-objectivec">vdm.start() </code></pre> </li> </ol> <pre> <code class="language-objectivec">你需要在视频开始播放的同时，手动开启弹幕。</code></pre> <ol> <li> <p>暂停/继续 弹幕</p> <pre> <code class="language-objectivec">vdm.pause() vdm.resume() </code></pre> </li> </ol> <pre> <code class="language-objectivec">你也可以使用 `vdm.toggle()` 来快捷切换 暂停/继续。</code></pre> <ol> <li> <p>中止弹幕</p> <pre> <code class="language-objectivec">vdm.stop() </code></pre> </li> </ol> <ol> <li> <p>重新开始弹幕</p> <pre> <code class="language-objectivec">vdm.restart() </code></pre> </li> </ol> <pre> <code class="language-objectivec">你也可以在指定时间点重新开始弹幕：</code></pre> <pre> <code class="language-objectivec">vdm.restart(at: 75) </code></pre> <h2>设计思路</h2> <p>DanmuManager 通过设置的字体大小计算文本显示高度 lineHeight ，通过 numberOfLines = Int(floor((bottom - top) / lineHeight)) 得到可以显示的弹幕行数；使用 inUsingLines ， enteringTimers 和 waitingQueues 来分别记录 正在使用的行（有尾部还没有完全进入视图的弹幕的行），正在进入视图的弹幕的计时器 和 正在等待进入的弹幕队列。</p> <p>为了防止弹幕重叠，只有当 当前行中前一条弹幕尾部进入视图 时（之后），下一条弹幕才可以发射。</p> <p>enteringTimers 中每一个 Timer 都对应一条正在进入视图的弹幕，当计时器结束时，通过 NotificationCenter 发通知将该弹幕所在的行的状态更改为 false。</p> <p>因为弹幕存在暂停状态，如果弹幕对应的 Timer 不同时暂停，将导致 弹幕所在行状态 提前更改为 false。为了解决这个问题，我参考他人的想法并改进后创建了 PauseableTimer，并在本项目中使用上了。我的另外一篇博客更详细地介绍了 PauseableTimer 。</p> <p>为了避免手动发射弹幕和自动发射队列中的弹幕出现冲突（弹幕重叠），所有弹幕通过 taskTimer 定时任务统一调度。</p> <h2>下一步 Next Step</h2> <p>现在流行的弹幕功能越来越复杂、高级，DanmuManager 只是完成了最基础的滚动文字弹幕功能。未来可能会学习常见的弹幕，添加一些更高级的功能，比如 对滚动弹幕的操作，居中弹幕 等。</p> <p> </p> <p>来自：http://chengkang.me/2017/01/05/DanmuManager 一个简单的弹幕工具/</p> <p> </p>