HarmonyOS技术社区 · 2021年02月25日

鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

鸿蒙入门指南,小白速来!0基础学习路线分享,高效学习方法,重点答疑解惑--->【课程入口】

目录:
一、弹幕库的基础知识
二、弹幕库的使用方法
三、sample解析
四、作者系列文章合集

前言
 基于github上哔哩哔哩开源项目(
       为了更加清晰的介绍弹幕库的作用和使用方法,本文将从基础知识、使用方法、 sample解析三个方面进行讲解。

鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

一、弹幕库的基础知识

      弹幕库是一个开源的三方库,在正式讲解弹幕库的使用之前,我们先来了解下第三方库的含义。

第三方库是指除本地类库、系统类库以外的类库,需要后来安装,才能调取使用。 简单来讲,相当于其他人写好了代码,实现了一些功能接口,我们直接调用这些接口,就可以实现一些我们想要的功能。举个例子:在一个应用中实现视频缓存功能(断网后可继续播放提前缓存的内容),如果想要自己实现的话,需要调用鸿蒙/安卓底层的方法,代码量非常大。如果已经有第三方库可以做到这点,并且开源了出来,那么你只需要引用他的第三方库,然后调用此库内公开的一些方法接口,简简单单的几行代码就可以实现缓存功能。
      了解了什么是第三方库,现在我们来看弹幕库组件。 看视频时,弹幕是必不可少的互动功能,这个功能就是调用了弹幕库组件来实现的。现在我们已经实现了弹幕库功能在鸿蒙平台的构建,接下来我们一起深入了解下鸿蒙平台的弹幕库吧!

二、弹幕库的使用方法

       关于弹幕库第三方组件的使用方法,我们准备了视频教学,大家可以下载使用哦\~

       视频教学版链接:https://www.bilibili.com/video/BV1Dy4y1i7cG/

三、sample解析

       导入弹幕库组件后,其整个项目的文件结构如下:

鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

        整个项目有2个module:entry和DanmakuFlameMaster。

        在这里大家可以简单的理解:

           ==》  “DanmakuFlameMaster”就是之前提到的【第三方库】,它里面实现了弹幕功能的 所有细节。

           ==》    entry就是一个具体的“客户端”module,它声明了在鸿蒙程序中的所有运行细节。

           ==》
 最后跑起来的程序就是entry,entry里面实现了所有功能,包括界面、按钮、功能等等,只不过entry调用了第三方库“DanmakuFlameMaster”,使用
                         了它的能力来实现了一些弹幕相关的功能。

      本篇文章主要介绍如何在已经构建好了“DanmakuFlameMaster”这个第三方库的基础上,来进行“entry”的开发。

     为了节省篇幅,此处我们使用一个已经开发完成了的sample,接下来以这个sample为例,向大家讲解弹幕库组件的应用及效果。

鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

      将entry展开之后,我们可以看到,真正的代码是真的很少,主要的功能都集中在MainAbility和MainAbilitySlice文件中,加起来的代码量也就不到1000行。

      接下面我们对这两个文件进行逐个解析。

       1、MainAbility,它是一切应用的入口。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)
根据鸿蒙能力,这里是可以通过setMainRoute()方法调用很多的Slice来进行功能的实现,上图标记的代码就是声明了MainRoute在MainAbilitySlice之中。

2、MainAbilitySlice,这个文件比较重要。

这个文件主要包括:import文件、初始化函数、功能实现函数三个部分。

(1)、import 文件

        此处import的文件可以分为三类:SDK文件、应用内文件和三方件文件。

        == 》 SDK文件: import后路径为ohos.....的。

        == 》应用内文件:import后路径为com.huawei......的。

        == 》三方库文件:import后路径为master.flame.danmuku......的。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)
 (2)、初始化函数:
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)
如图所示,初始化函数一共包含六个,我们将其分为五个部分,这五个部分与图中函数的顺序对应如下:UI初始化、视频源的设置与播放(2个函数)、输出系统内存信息、设置数据源(这里的数据指的是弹幕数据)以及弹幕输出。这五个部分之中,我们主要讲解其中的与弹幕库密切相关的部分:UI初始化、弹幕数据源与弹幕输出。
        1)onStart方法实现了UI初始化
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)
        以上代码构建了弹幕库的显示窗口 设置了屏幕参数的读取 。



      2)弹幕数据源和最终的弹幕输出

       这两个部分有强相关,我们放在一起来介绍。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

        第一步:声明全局变量 mParser用来承载弹幕数据。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

          第二步:在加载数据源处调用了我们的第三方库的BiliDanmukuParser类,然后从我们的resources中读取弹幕数据:
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)

        可以看到在datasource其实就是读取了这里的文件,大家可以自己点进去看一下这个文件内容,里面就是我们的“弹幕数据库”。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)





        第三步:将载入了弹幕的BaseDanmakuParser类对象,return给全局变量mParser(如果大家想找到这部分代码的话,可以到findview()中去寻找)。

3、功能实现函数
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)



         在UI上可见的一些按钮,每个按钮都对应一个callback函数,点击按钮,执行对应的函数体,实现相关功能。
鸿蒙开源第三方组件 ——B站开源弹幕库引擎的迁移(上)



          上图所示为点击不同的按钮,出现不同的弹幕效果,例如:隐藏弹幕、显示弹幕、暂停弹幕等。

项目贡献人
熊轶翔 郑森文 朱伟  陈美汝 吕泽
作者:小雪糕123
想了解更多内容,请访问: 51CTO和华为官方战略合作共建的鸿蒙技术社区https://harmonyos.51cto.com

21_9.jpg

推荐阅读
关注数
2957
内容数
446
华为鸿蒙相关技术,活动及资讯,欢迎关注及加入创作
目录
极术微信服务号
关注极术微信号
实时接收点赞提醒和评论通知
安谋科技学堂公众号
关注安谋科技学堂
实时获取安谋科技及 Arm 教学资源
安谋科技招聘公众号
关注安谋科技招聘
实时获取安谋科技中国职位信息