OhosVideoCache是一個支持邊播放邊緩存的庫，只需要將音視頻的url傳遞給OhosVideoCache處理之后再設置給播放器，
OhosVideoCache就可以一邊下載音視頻數據并保存在本地，一邊讀取本地緩存返回給播放器，使用者無需進行其他操作。

使用說明：

1. 進入頁面，自動播放視頻，點擊暫停，視頻停止播放，點擊播放，視頻繼續播放。
2. 視頻播放完成之后，點擊播放按鈕，視頻重新播放。

邊緩存播放功能主要是通過Xcomponent組件、@ohos.multimedia.media以及OhosVideoCache三方庫實現，XComponent組件主要用于繪制
視頻播放的窗口，頁面進來初始化服務器然后利用XComponent組件的onLoad函數來調用VideoPlayerManager
中的initPlayer方法創建一個音視頻管理實例，并通過setAVPlayerCallback函數和cacheAndPlayVideo函數來實現視頻狀態的監聽以及邊緩存邊播放功能。

1. XComponent組件繪制視頻播放窗口。源碼參考VideoCacheView.ets。

XComponent({id: 'xcomponent',type: 'surface',controller: this.componentController
}).height(`${this.xComponentHeight}px`).width(`${this.xComponentWidth}px`).onLoad(() => {// 設置XComponent持有Surface的寬度和高度this.componentController.setXComponentSurfaceSize({surfaceWidth: SURFACE_WIDTH,surfaceHeight: SURFACE_HEIGHT});this.surfaceId = this.componentController.getXComponentSurfaceId();// 創建音視頻播放實例AvPlayManager.getInstance().initPlayer(getContext(this) as common.UIAbilityContext, this.surfaceId, (avPlayer: media.AVPlayer) => {avPlayer.on('timeUpdate', (time: number) => {this.currentTime = time;});this.videoDuration = handleTime(avPlayer.duration);this.total = avPlayer.duration;})})

2. 初始化代理服務器，頁面一進來需要使用setServer方法來初始化代理服務器，以便后續調用此服務器處理url。源碼參考GlobalProxyServer.ets

import common from '@ohos.app.ability.common';
import { HttpProxyCacheServer } from '@ohos/video-cache';const CONTEXT_STR: string = 'context';
const SERVER_STR: string = 'server';export default class GlobalProxyServer {private static instance: GlobalProxyServer | null = null;private objects: Map<string, Object | null> = new Map<string, Object | null>();public static getInstance(): GlobalProxyServer {if (!GlobalProxyServer.instance) {GlobalProxyServer.instance = new GlobalProxyServer();}return GlobalProxyServer.instance;}/*** 獲取上下文信息* @returns*/getContext(): common.UIAbilityContext {return this.objects.get(CONTEXT_STR) as common.UIAbilityContext;}/*** 設置上下文信息* @param context*/setContext(context: common.UIAbilityContext): void {this.objects.set(CONTEXT_STR, context);}/*** 獲取服務器* @returns*/getServer(): HttpProxyCacheServer {return this.objects.get(SERVER_STR) as HttpProxyCacheServer;}/*** 設置服務器* @param objectClass*/setServer(objectClass: HttpProxyCacheServer): void {try {const currentServer: HttpProxyCacheServer = this.getServer();currentServer.shutdown();} catch (err) {}this.objects.set(SERVER_STR, objectClass);}
}

3. media.createAVPlayer()創建播放管理類，用于管理和播放媒體資源。源碼參考VideoPlayerManager.ets

  async initPlayer(context: common.UIAbilityContext, surfaceId: string,callback: (avPlayer: media.AVPlayer) => void): Promise<void> {logger.info(TAG, `initPlayer==initCamera surfaceId== ${surfaceId}`);this.surfaceID = surfaceId;try {// 創建avPlayer實例對象this.avPlayer = await media.createAVPlayer();// 創建狀態機變化回調函數await this.setAVPlayerCallback(callback);// 邊緩存邊播放this.cacheAndPlayVideo(context);} catch (err) {logger.error(TAG, `initPlayer initPlayer err：${JSON.stringify(err)}`);}}

4. 邊播放邊緩存，MyCacheListener監聽緩存進度，getProxyUrl(ORIGIN_URL)獲取視頻播放地址并設置給播放器。源碼參考VideoPlayerManager.ets

 /*** 邊緩存邊監聽函數* @param context 上下文信息* @returns*/async cacheAndPlayVideo(context: common.UIAbilityContext): Promise<void> {logger.info(TAG, `cacheAndPlayVideo start`);// TODO:知識點:監聽緩存進度class MyCacheListener implements CacheListener {onCacheAvailable(cacheFilePath: string, url: string, percentsAvailable: number): void {AppStorage.setOrCreate('currentCachePercent', percentsAvailable);}}GlobalProxyServer?.getInstance()?.getServer()?.registerCacheListener(new MyCacheListener(), ORIGIN_URL);// TODO:知識點:將原始的音視頻url交給OhosVideoCachelet proxyUrl: string | undefined = await GlobalProxyServer?.getInstance()?.getServer()?.getProxyUrl(ORIGIN_URL);// 由于avplayer不支持直接加載本地文件路徑 這里需要轉化為fd的路徑if (proxyUrl.startsWith(context.cacheDir)) {const file = fs.openSync(proxyUrl, fs.OpenMode.READ_ONLY);proxyUrl = `fd://${file.fd}`;}logger.info(TAG, `proxyUrl ${proxyUrl}`);// 將處理之后的url設置給播放器this.avPlayer.url = proxyUrl;}

不涉及。

videocache                                         // har類型
|---model
|   |---GlobalProxyServer.ets                      // 模型層-服務器管理
|   |---VideoPlayerManager.ets                     // 模型層-音視頻管理
|---utils
|   |---utils.ets                                  // 工具
|---view
|   |---VideoCacheView.ets                         // 視圖層-應用主頁面

1.應用基礎知識
2.配置文件
3.應用數據管理
4.應用安全管理
5.應用隱私保護
6.三方應用調用管控機制
7.資源分類與訪問
8.學習ArkTS語言
9.……