示例工程前端移動開發(fā)跨平臺【免費下載鏈接】uni-appA cross-platform framework using Vue.js項目地址https://gitcode.com/gh_mirrors/un/uni-app點擊查看免費下載uni-app x 在 Android 平臺上通過原生 SDK 打包時video組件由uni-video原生模塊提供底層能力。本文以官方文檔 docs/native/modules/android/uni-video.md 為核心骨架完整講解 HBuilderX 5.08 以上與 5.08 以下兩套集成方案本地依賴庫、線上 Maven 依賴、模塊依賴、組件注冊并結(jié)合倉庫源碼config.json、VideoImpl.kt深入剖析 AndroidX Media3/ExoPlayer 的底層實現(xiàn)。讀者閱讀完本文將掌握在 Android 主工程中完整接入uni-video模塊、正確注冊video組件并排查集成問題的全部實戰(zhàn)能力。一、uni-video 模塊與集成時機uni-video是 uni-app x 中video組件在 Android 端的原生實現(xiàn)模塊。當(dāng)你使用原生 SDK 方式打包而非云打包時若頁面中使用了video組件就必須在主工程中手動集成該模塊的依賴庫并完成組件注冊否則運行期將提示組件未注冊或直接渲染失敗。從當(dāng)前倉庫源碼看該模塊的 uts 插件源碼位于 src/uni_modules/uni-video 目錄其 Android 側(cè)配置 config.json 明確聲明了所依賴的線上庫{ dependencies: [ androidx.media3:media3-exoplayer:1.8.0, androidx.media3:media3-exoplayer-hls:1.8.0 ] }這印證了 5.08 之后 Android 端播放內(nèi)核全面切換到AndroidX Media3ExoPlayer的事實與集成文檔中的線上依賴完全一致。需要特別注意的是HBuilderX 5.08 是集成方式的版本分水嶺5.08 以上使用新的UTSEasyCom組件注冊機制與 Media3 播放內(nèi)核5.08 以下使用舊的UTSRegisterComponents注冊機制與 ijkplayer 播放內(nèi)核。請先確認你的 HBuilderX 版本再選擇對應(yīng)章節(jié)操作。二、HBuilderX 5.08 以上版本的集成配置2.1 本地依賴庫需要將本地依賴庫uni-video-release.aar復(fù)制到 app 項目的libs目錄下。名稱uni-video-release.aar該 aar 提供模塊的注冊類與組件類實現(xiàn)復(fù)制完成后需確保主模塊build.gradle中已通過fileTree方式引入 libs 目錄一般模板工程已默認配置dependencies { implementation fileTree(include: [*.aar], dir: libs) ... }2.2 線上依賴庫在 app 項目的build.gradle中聲明 Media3 播放內(nèi)核依賴。Groovy DSL 寫法dependencies { implementation androidx.media3:media3-exoplayer:1.8.0 implementation androidx.media3:media3-exoplayer-hls:1.8.0 }使用 Kotlin DSLbuild.gradle.kts的工程寫法dependencies { implementation(androidx.media3:media3-exoplayer:1.8.0) implementation(androidx.media3:media3-exoplayer-hls:1.8.0) }參數(shù)說明media3-exoplayerMedia3 的核心播放器ExoPlayer實現(xiàn)負責(zé)音視頻解碼、渲染與播放控制media3-exoplayer-hlsHLS 流媒體協(xié)議的支持庫用于播放 m3u8 直播/點播源版本號1.8.0由模塊 config.json 與官方文檔共同確認升級版本時需自行驗證兼容性。2.3 模塊依賴uni-video模塊運行時還依賴以下內(nèi)置模塊需要同步集成到 app 項目中集成方式可參考 docs/native/modules/android/others.md名稱uni-fileSystemManageruni-getSystemInfouni-screenBrightness特別說明蒸汽模式Vapor還需額外依賴uni-event模塊。Vapor 是 uni-app x 的輕量渲染模式詳見 docs/app-vapor.md其組件事件分發(fā)機制依賴事件總線因此必須補上uni-event。2.4 組件注冊將以下內(nèi)容添加到主模塊的build.gradle中具體原理詳見 根據(jù) configjson 配置應(yīng)用 的components一節(jié)。Groovy DSLVDOM 模式defaultConfig { buildConfigField String, UTSEasyCom, [{\class\:\uts.sdk.modules.DCloudUniVideo.UniVideoExtApiComponentsRegister\,\method\:\register\}] }Kotlin DSLVDOM 模式defaultConfig { buildConfigField(String, UTSEasyCom, \[{\\\class\\\:\\\uts.sdk.modules.DCloudUniVideo.UniVideoExtApiComponentsRegister\\\,\\\method\\\:\\\register\\\}]\) }配置要點UTSEasyCom是 5.08 之后新增的注冊字段注冊方式從聲明組件類演進為聲明 Register 類 register 方法由UniVideoExtApiComponentsRegister.register()在運行時完成video組件的注冊反斜杠轉(zhuǎn)義符不能刪減JSON 字符串格式必須嚴(yán)格一致否則運行時解析失敗若主模塊已存在UTSEasyCom字段需要將原有內(nèi)容與新增內(nèi)容合并為同一個 JSON 數(shù)組字符串后整體寫入暫不支持在 build.gradle 中設(shè)置applicationIdSuffix添加該配置會導(dǎo)致組件初始化失敗。三、HBuilderX 5.08 以下版本的集成配置如果你的 HBuilderX 版本低于 5.08請使用本節(jié)配置。該方案對應(yīng)舊的 ijkplayer 播放內(nèi)核與UTSRegisterComponents注冊機制。3.1 本地依賴庫需要將以下三個本地依賴庫全部復(fù)制到 app 項目的libs目錄下名稱uni-video-release.aarijkplayer.aarvideoplayer.aar其中ijkplayer.aar為 ijkplayer 播放內(nèi)核封裝videoplayer.aar為視頻播放器組件封裝三者缺一不可。3.2 線上依賴庫在 app 項目的build.gradle中添加以下線上依賴dependencies { implementation com.github.bumptech.glide:glide:4.9.0 implementation androidx.annotation:annotation:1.1.0 implementation androidx.core:core:1.1.0 }Kotlin DSL 寫法dependencies { implementation(com.github.bumptech.glide:glide:4.9.0) implementation(androidx.annotation:annotation:1.1.0) implementation(androidx.core:core:1.1.0) }參數(shù)說明glide:4.9.0圖片加載庫用于視頻封面poster等圖片資源的加載展示androidx.annotation:annotation:1.1.0與androidx.core:core:1.1.0舊版播放器依賴的 AndroidX 基礎(chǔ)庫。3.3 組件注冊舊版使用UTSRegisterComponents字段直接聲明video組件與實現(xiàn)類。Groovy DSLdefaultConfig { buildConfigField String, UTSRegisterComponents, \[{\\\name\\\:\\\video\\\,\\\class\\\:\\\uts.sdk.modules.DCloudUniVideo.VideoComponent\\\}]\ }Kotlin DSLdefaultConfig { buildConfigField(String, UTSRegisterComponents, \[{\\\name\\\:\\\video\\\,\\\class\\\:\\\uts.sdk.modules.DCloudUniVideo.VideoComponent\\\}]\) }配置要點name字段為video即頁面模板中使用的標(biāo)簽名class字段為組件實現(xiàn)類uts.sdk.modules.DCloudUniVideo.VideoComponent與 5.08 方案相同轉(zhuǎn)義符不可刪減JSON 格式必須嚴(yán)格一致若已有其他組件的UTSRegisterComponents配置需要將新舊條目合并到同一個 JSON 數(shù)組字符串中。四、兩種版本方案的對比與升級建議對比維度HBuilderX ≥ 5.08HBuilderX 5.08播放內(nèi)核AndroidX Media3ExoPlayer 1.8.0ijkplayer本地 aaruni-video-release.aaruni-video-release.aar、ijkplayer.aar、videoplayer.aar線上依賴media3-exoplayer、media3-exoplayer-hlsglide、androidx.annotation、androidx.core注冊字段UTSEasyComRegister 類 register 方法UTSRegisterComponents組件類直連注冊類UniVideoExtApiComponentsRegisterVideoComponent額外模塊依賴uni-fileSystemManager、uni-getSystemInfo、uni-screenBrightnessVapor 另需 uni-event—舊版接口從 docs/native/modules/ios/modules.md 的 iOS 側(cè)文檔同樣可以看到這一版本分界5.08 之前 uni-video 依賴IJKMediaFrameworkWithSSL5.08 之后改用基于UniVideoPlayerManager的全新播放器實現(xiàn)。Android 與 iOS 在 5.08 節(jié)點同步完成了播放內(nèi)核的升級升級 HBuilderX 后務(wù)必同步切換集成配置避免新舊 aar 混用導(dǎo)致類沖突。五、源碼級解析Media3/ExoPlayer 如何驅(qū)動 video 組件集成配置的背后是 VideoImpl.kt 對 Media3 ExoPlayer 的完整封裝。該文件位于 src/uni_modules/uni-video/utssdk/app-android/VideoImpl.kt是理解video組件底層行為的最佳入口。5.1 組件本質(zhì)TextureView ExoPlayer從源碼結(jié)構(gòu)看VideoImpl類繼承自TextureView并實現(xiàn)了TextureView.SurfaceTextureListener與Player.ListenerVideoImpl.kt。即 Android 端的video組件本質(zhì)上是一個綁定 ExoPlayer 輸出的 TextureView 原生視圖視頻幀直接渲染到紋理表面這也是它能與 uni-app x 的 VDOM/Vapor 渲染樹無縫結(jié)合的原因。5.2 屬性到播放器的映射源碼中多個屬性 setter 直接驅(qū)動 ExoPlayer 能力與 docs/component/video.md 中的組件屬性一一對應(yīng)autoplay設(shè)置player.playWhenReadyloop設(shè)置player.repeatMode為REPEAT_MODE_ONEmuted切換player.volume為 0 或 1playbackRate調(diào)用player.setPlaybackSpeed對應(yīng)組件的播放速率控制src非空且 surface 可用時調(diào)用setupSource裝載數(shù)據(jù)源。從源碼還可以看到播放器還使用了CacheDataSourceSimpleCacheLeastRecentlyUsedCacheEvictor淘汰策略來實現(xiàn)http-cache屬性VideoImpl.kt即對 http/https 視頻源的本地緩存能力同時通過DefaultRenderersFactory支持codec屬性的硬件/軟件解碼器切換。5.3 進度上報與事件回調(diào)源碼中使用主線程Handler周期性回調(diào)onTimeUpdate并在播放到userDuration終點時觸發(fā)onEndedVideoImpl.kt。這一機制支撐了組件層的timeupdate、ended等事件也解釋了duration屬性未指定時取播放器實際時長的行為。5.4 組件層封裝ut 組件層封裝位于 src/uni_modules/uni-video/components/video/video.uvue倉庫示例頁 src/pages/component/video/video.uvue 提供了video組件的完整使用示例含 src、autoplay、controls、object-fit 等屬性的典型組合。集成 uni-video 模塊后即可直接運行這些示例頁驗證效果。六、video 組件核心屬性速覽完成模塊集成與組件注冊后video組件即可在頁面中使用。其常用屬性詳見 docs/component/video.md包括屬性類型默認值說明srcstring—視頻資源地址autoplaybooleanfalse是否自動播放loopbooleanfalse是否循環(huán)播放mutedbooleanfalse是否靜音播放controlsbooleantrue是否顯示默認播放控件object-fitstringcontain視頻與容器尺寸不一致時的表現(xiàn)contain/fill/coverposterstring—視頻封面圖controlsfalse 時無效codecstringhardware解碼器選擇http-cachebooleanfalse是否對 http/https 視頻源開啟本地緩存initial-timenumber0指定視頻初始播放位置在 Android 端codec、http-cache等能力均已在 VideoImpl.kt 中有對應(yīng)的原生實現(xiàn)可直接放心使用。七、集成檢查清單與常見問題完成配置后建議按以下清單逐項自檢版本對齊確認 HBuilderX 版本選用 5.08± 對應(yīng)的整套配置新舊方案配置混用如同時出現(xiàn)UTSEasyCom與UTSRegisterComponents會導(dǎo)致組件重復(fù)注冊或注冊失敗aar 就位確認所有本地 aar 已復(fù)制到 app 項目的libs目錄且主模塊 build.gradle 已引入 libs 目錄轉(zhuǎn)義符完整buildConfigField中的反斜杠轉(zhuǎn)義符不可刪減JSON 格式必須嚴(yán)格一致字段合并多個模塊同時注冊組件時需將各自條目合并到同一個數(shù)組字符串而非覆蓋式寫入模塊依賴齊全確認 uni-fileSystemManager、uni-getSystemInfo、uni-screenBrightnessVapor 模式再加 uni-event均已按 docs/native/modules/android/others.md 完成集成禁止 applicationIdSuffix主模塊 build.gradle 中不要設(shè)置applicationIdSuffix否則組件初始化失敗事件與屬性驗證集成完成后使用 src/pages/component/video/video.uvue 示例頁驗證播放、進度上報、循環(huán)、靜音等行為是否符合預(yù)期。八、延伸閱讀uni-video 模塊官方集成文檔本文的配置依據(jù)原文含完整 gradle 代碼塊根據(jù) configjson 配置應(yīng)用UTSEasyCom/UTSRegisterComponents字段的通用配置規(guī)則與合并寫法video 組件完整文檔組件全部屬性、事件與兼容性說明Android 模塊總覽uni-video 所依賴的其它內(nèi)置模塊的集成方式iOS uni-video 集成參考5.08 版本分界在 iOS 側(cè)的對應(yīng)實現(xiàn)便于跨端對齊uni-video uts 插件源碼組件層與 Android 原生層完整實現(xiàn)包括 config.json 與 VideoImpl.kt。贊分享示例工程前端移動開發(fā)跨平臺【免費下載鏈接】uni-appA cross-platform framework using Vue.js項目地址https://gitcode.com/gh_mirrors/un/uni-app點擊查看免費下載相關(guān)推薦uni-app x Android 原生工程集成 uni-verify 一鍵登錄模塊依賴配置、應(yīng)用 ID 與插件注冊完整指南uni app x Android 原生工程集成 uni verify 一鍵登錄模塊依賴配置、應(yīng)用 ID 與插件注冊完整指南 uni app x 的 App示例工程前端移動開發(fā)跨平臺uni-app uni-oauth Android 集成指南微信登錄 SDK 依賴配置與插件注冊詳解uni app uni oauth Android 集成指南微信登錄 SDK 依賴配置與插件注冊詳解 本文是 uni app 開源倉庫中 Android 原生示例工程前端移動開發(fā)跨平臺uni-app x Android 實人認證原生模塊 uni-facialRecognitionVerify 集成指南uni app x Android 實人認證原生模塊 uni facialRecognitionVerify 集成指南 uni facialRecognitio示例工程前端移動開發(fā)跨平臺上一篇PaddleOCR 多場景模型推理部署指南Python / C / Serving / Paddle-Lite / ONNX 全鏈路方案解析下一篇DeepSpeedExamples目標(biāo)檢測YOLOv5分布式訓(xùn)練實戰(zhàn)創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考