让弹幕飞一会儿！一个轻量级iOS弹幕库的实现与使用

🚀 让弹幕飞一会儿！一个轻量级iOS弹幕库的实现与使用

本文完整源码地址：github.com/chengshixin...

🎯 前言

"前方高能！"、"233333"、"awsl"... 这些熟悉的弹幕是不是让你想起了在B站追番的快乐时光？弹幕已经成为现代视频应用的标配功能，它不仅能够增强用户互动，还能创造独特的社区氛围。

今天，我要为大家介绍一个我自己开发的轻量级iOS弹幕库------BarrageView！这个库不仅功能丰富，而且代码优雅，绝对是你在iOS应用中集成弹幕功能的不二之选！

✨ 功能特色

🎮 四大弹幕方向

从右到左：经典模式，B站同款
从左到右：反向思维，别具一格
从上到下：竖屏专属，瀑布流效果
从下到上：逆流而上，视觉冲击

🔄 两种播放模式

单次播放：适合展示重要信息
循环播放：营造持续的热闹氛围

🎨 全面自定义

字体大小、颜色随心配
背景透明度自由调节
移动速度精准控制
弹幕间距智能避让

🛠 快速上手

基本使用

swift 复制代码

// 创建弹幕视图
let barrageView = BarrageView(frame: CGRect(x: 0, y: 100, width: view.bounds.width, height: 200))

// 设置弹幕数据
barrageView.setBarrageData([
    "前方高能预警！",
    "这个功能太棒了！",
    "iOS开发者福音",
    "已star，感谢作者"
])

// 开始播放
barrageView.startBarrage()

高级配置

swift 复制代码

// 自定义样式和效果
barrageView.setDirection(.rightToLeft)
barrageView.setPlayMode(.loop)
barrageView.setSpeed(80.0)
barrageView.setFontSize(18.0)
barrageView.setTextColor(.red)
barrageView.setTextBackgroundColor(UIColor.black.withAlphaComponent(0.8))

🔧 核心实现原理

🎪 弹幕调度机制

BarrageView采用定时器+动画的双重调度机制：

swift 复制代码

// 定时器负责生成新弹幕
timer = Timer.scheduledTimer(withTimeInterval: 2.0, repeats: true) { [weak self] _ in
    self?.createBarrageLabel()
}

// UIView动画负责移动效果
UIView.animate(withDuration: duration, delay: 0, options: .curveLinear) {
    label.frame.origin = endPoint
}

🚦 智能避让算法

为了防止弹幕重叠，我们实现了智能的位置检测：

swift 复制代码

private func isYPositionOccupied(y: CGFloat, labelHeight: CGFloat) -> Bool {
    for label in activeLabels {
        let labelMinY = label.frame.minY - 10  // 预留安全间距
        let labelMaxY = label.frame.maxY + 10
        
        if y > labelMinY && y < labelMaxY {
            return true  // 位置被占用
        }
    }
    return false  // 位置可用
}

⏸️ 流畅的暂停恢复

通过CALayer扩展实现精准的动画控制：

swift 复制代码

extension CALayer {
    func pauseAnimation() {
        let pausedTime = convertTime(CACurrentMediaTime(), from: nil)
        speed = 0.0
        timeOffset = pausedTime
    }
    
    func resumeAnimation() {
        let pausedTime = timeOffset
        speed = 1.0
        timeOffset = 0.0
        beginTime = 0.0
        let timeSincePause = convertTime(CACurrentMediaTime(), from: nil) - pausedTime
        beginTime = timeSincePause
    }
}

🎨 自定义扩展指南

添加弹幕边框

swift 复制代码

// 在createLabel方法中扩展
label.layer.borderWidth = 1.0
label.layer.borderColor = UIColor.orange.cgColor

实现渐变背景

swift 复制代码

let gradientLayer = CAGradientLayer()
gradientLayer.colors = [UIColor.red.cgColor, UIColor.blue.cgColor]
gradientLayer.frame = label.bounds
label.layer.insertSublayer(gradientLayer, at: 0)

添加弹幕阴影

swift 复制代码

label.layer.shadowColor = UIColor.black.cgColor
label.layer.shadowOffset = CGSize(width: 2, height: 2)
label.layer.shadowOpacity = 0.5

📱 实际应用场景

🎥 视频播放器

swift 复制代码

// 在视频播放时启动弹幕
func videoDidStartPlaying() {
    barrageView.startBarrage()
}

func videoDidPause() {
    barrageView.pauseBarrage()
}

func videoDidResume() {
    barrageView.resumeBarrage()
}

🎮 直播互动

swift 复制代码

// 收到新消息时实时添加弹幕
func didReceiveNewMessage(_ message: String) {
    var currentData = barrageView.barrageTexts
    currentData.append(message)
    barrageView.setBarrageData(currentData)
}

🎉 活动庆典

swift 复制代码

// 节日特效弹幕
func setupFestivalBarrage() {
    barrageView.setTextColor(.red)
    barrageView.setFontSize(20)
    barrageView.setBarrageData(festivalWishes)
}

🚀 性能优化技巧

内存管理

使用weak self避免循环引用
及时移除完成动画的标签
合理控制同时显示的弹幕数量

动画优化

使用curveLinear保证匀速运动
避免频繁创建销毁对象
复用UILabel减少内存分配

🔮 未来规划

💫 结语

BarrageView不仅仅是一个工具库，更是我对iOS动画和用户体验的一次深度探索。通过这个项目，我学习到了：

🎯 精准的动画控制：如何让弹幕平滑移动又不失性能
🧠 智能的布局算法：如何避免弹幕间的"交通事故"
🎨 优雅的代码设计：如何构建可扩展、易维护的架构

如果你对这个项目感兴趣，欢迎：

⭐ Star → github.com/chengshixin...

🐛 提交Issue → 反馈bug或提出新功能建议

🔀 Pull Request → 一起让这个项目变得更好

让我们的应用也拥有B站一样的弹幕文化吧！ 🎊

"弹幕虽小，却能承载万千情感；代码虽简，却能创造无限可能。"

本文由BarrageView作者撰写，转载请注明出处。