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

发布于 2021-2-25 11:04
浏览
2收藏

前言

         基于github上哔哩哔哩开源项目(https://github.com/bilibili/DanmakuFlameMaster),进行了鸿蒙化迁移和重构,可实现弹幕的隐藏、显示、暂停、继续、发送、定时发送弹幕等一系列的功能,代码已经开源到(https://gitee.com/isrc_ohos/danmaku-flame-master_ohos ),欢迎各位下载使用并提出宝贵意见!

       为了更加清晰的介绍弹幕库的作用和使用方法,本文将从基础知识、使用方法、 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站开源弹幕库引擎的迁移(上)-开源基础软件社区

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

项目贡献人
熊轶翔 郑森文 朱伟  陈美汝 吕泽

©著作权归作者所有,如需转载,请注明出处,否则将追究法律责任
已于2021-2-25 11:27:56修改
7
收藏 2
回复
举报
回复
添加资源
添加资源将有机会获得更多曝光,你也可以直接关联已上传资源 去关联
    相关推荐