HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存


目錄:

1、引言

2、功能介紹

3、VideoCache使用指南

4、VideoCache開發指南

5、《HarmonyOS三方件開發指南》系列文章合集

 

引言

對於視頻播放器這個app大家都不陌生,在我們日常生活中隨處可見,但對於用戶而言,最重要的就是如何能節約流量,使用簡單,觀看視頻流暢等體驗。對於Android VideoCache 在各大網站的學習文檔、教程已經很多,而且層出不窮,但是對於鴻蒙來講,還是一個新的領域,因此,鴻蒙版的VideoCache 順勢而為,華麗的誕生了。

功能介紹

鴻蒙VideoCache視頻緩存組件,主要功能包括:視頻緩沖,在線播放視頻,邊下載邊緩存,緩沖進度和播放進度同時進行,拖動播放,橫豎屏切換,音量調節等主要功能。模擬機效果圖如下:

1.豎屏狀態:

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

2.橫屏狀態

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

接下來得內容就是重中之重,對於開發者來講,如何簡單並且快速的使用該VideoCache視頻緩存組件,這才是開發者最關注的問題。下面則詳細介紹VideoCache的使用以及開發指南。

VideoCache使用指南

Ø 新建工程, 添加組件Har包依賴

在應用模塊中添加HAR,只需要將videocachelibrary-debug.har復制到entry\libs目錄下即可

Ø 修改配置文件

1. 在entry下面的build.gradle添加library 的依賴,如圖所示:

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

1. 修改代碼中的配置:

a. 在基類中實例化代理服務,核心代碼如下:

httpProxyCacheServer =
                new HttpProxyCacheServer.Builder(theApplication).headerInjector(new UserAgentHeadersInjector())
                .maxCacheSize(1024 * 1024 * 1024)// 1 Gb for cache
                .singleFileBandwidth(600)//單位KB,https需要1.5倍左右
                .build();

b.在使用的地方初始化播放器,並調用代理服務將新生成的路徑傳入播放器,代碼如下:

proxyUrl = BaseSlice.getProxy().getProxyUrl("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4");
    BaseSlice.getProxy().registerCacheListener(mCacheListener, proxyUrl);//緩存監聽
    playerVideo = new PlayerVideo(this, proxyUrl, this, layout);
    playerVideo.setDisplayMath(0, 1000);

c.其他相關設置方法,代碼如下:

* 設置播放器的寬高
 dependentLayout.setWidth(width);
     dependentLayout.setHeight(height);
或者:
dependentLayout.setWidth(ComponentContainer.LayoutConfig.MATCH_PARENT);
        dependentLayout.setHeight(ComponentContainer.LayoutConfig.MATCH_PARENT);
    
 * 設置播放器的橫豎屏
//橫屏
abilitySlice.getAbility().setDisplayOrientation(AbilityInfo.DisplayOrientation.LANDSCAPE);
//豎屏
abilitySlice.getAbility().setDisplayOrientation(AbilityInfo.DisplayOrientation.PORTRAIT);
//系統判斷
abilitySlice.getAbility().setDisplayOrientation(AbilityInfo.DisplayOrientation.UNSPECIFIED);
//跟隨棧中應用
abilitySlice.getAbility().setDisplayOrientation(AbilityInfo.DisplayOrientation.FOLLOWRECENT);


 * 初始化播放器
player = new Player(context);
    surfaceProvider.pinToZTop(false);
    java.util.Optional<ohos.agp.graphics.SurfaceOps> optional = surfaceProvider.getSurfaceOps();
    SurfaceOps surfaceOps = optional.get();
    surfaceOps.addCallback(new VideoSurfaceCallback(surfaceOps, loadUrl,
            player, this
    ));

 * 播放方法
 player.play();

 * 暫停播放方法
 player.pause();

VideoCache開發指南

      在上述中,已經大概說了VideoCache 的功能點,視頻緩沖,在線播放視頻,邊下載邊緩存,緩沖進度和播放進度同時進行,拖動播放,橫豎屏切換,音量調節等主要功能,接下來一 一說明主要實現方法。

在視頻播放器中,最常見的就是緩沖進度條,進度條用戶可以很直觀的看到目前已經緩沖的視頻有多少,緩沖了多長時間,進度條設置代碼如下:

     progressBar.setMaxValue(100);
     progressBar.setMinValue(0);
     progressBar.setProgressValue(cacheProgress);

      通過根據已經緩沖的字節,即可計算出cacheProgress

MaxValue 值不是固定的100,也可以按照視頻的時長、字節等設置,然后計算百分比即可,根據具體需求設計。

MinValue設置progress 的起始點,最初的起始點肯定是0,但是當視頻在播放中途,暫停,在開始的時候,則需要設置為暫停時的值,這樣不至於又回到0來觀看視頻。

        最后,既然是視頻緩存組件,那么重中之重就是如何緩存,接下來重點介紹

        VideoCache主要通過代理策略將網絡請求代理到本地服務,本地在決定是從本地緩存拿數據還是發起網絡請求,如果發起網絡請求就先將數據寫入緩存,再從本地提供視頻數據給視頻播放器,參考下圖【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

這樣就達到了邊播放邊緩存的策略。

具體步驟如下:

1.在項目的基類初始化一個全局的代理服務HttpProxyCacheServer,【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

2.生成緩存文件名,默認是使用的 MD5 方式生成 key,考慮到一些業務邏輯,我們也可以繼承一個 FileNameGenerator 來實現自己的策略,具體代碼如下:【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

3.本地代理實現策略,首先是構造一個本地127.0.0.1的ServerSocker,隨機分配了一個端口,然后啟動一個線程去執行WaitRequestsRunnable,在這里面執行 waitForRequest,通過 accept() 方法監聽這個服務器 socket 的入站連接,accept() 方法會一直阻塞,直到有一個客戶端嘗試建立連接。【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

1. FileCache類

      類中規定了緩存文件的命名格式(后加.download)和存儲的路徑,完成了緩存文件的創建。

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

2. Files類

      此類是對JAVA中原有的File類的封裝,原File類僅可處理一個文件,Files類可同時對多個文件進行處理。

      如下代碼中,getLruListFiles()方法的參數是一個directory,在方法中對directory(文件夾路徑)下的所有文件進行拆分,返回了一個File參數類型的List列表,后續可對列表中的各個File文件進行處理。【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

3. LruDiskUsage類

此類主要用於控制緩存文件的大小,它與Videocache平行開了一個線程,實時記錄緩存文件的數量、大小、存儲空間等,超過預設的閾值時,執行特定的優化操作。【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

4. Md5FileNameGenerator類

此類實現了為輸入文件路徑,生成對應的MD5值的功能。MD5值是一種被"壓縮"的保密格式,可以確保信息完整傳輸。

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

5. TotalCountLruDiskUsage類、TotalSizeLruDiskUsage類和UnlimitedDiskUsage類

          LruDiskUsage類是標題中前兩個類的父類,同時控制緩存文件的大小和數量,需要判斷當前緩存文件的(總大小 & 總數量)未超過閾值時,才會緩存新的文件。   TotalCountLruDiskUsage類和TotalSizeLruDiskUsage類分別只對緩存文件總數量或者緩存文件總大小進行限制,滿足一個條件便可以緩存新的文件。

         TotalCountLruDiskUsage類和TotalSizeLruDiskUsage類各有兩個方法:一個方法用於設定緩存文件的閾值;一個方法用於判斷當前緩存數據是否超過了設定的閾值。

       當不需要進行磁盤的緩存限制時使用UnlimitedDiskUsage類,其本身是一個空的類,不對緩存文件的數量和大小做任何限制。【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

【軟通動力】HarmonyOS三方件開發指南(16)-VideoCache 視頻緩存

更多原創,請關注"軟通動力HarmonyOS學院https://harmonyos.51cto.com/column/30

作者:軟通田可輝

想了解更多內容,請訪問51CTO和華為合作共建的鴻蒙社區:harmonyos.51cto.com


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM