在uni-app中實現穩定視頻播放需注意配置與兼容性。1. 使用原生video組件，確保src為網絡地址，慎用autoplay，并處理層級問題；2. 統一使用mp4+h.264格式以保證兼容性，必要時通過ffmpeg轉換；3. 自定義控制條時隱藏默認按鈕并封裝全屏切換方法適配各平臺；4. 多平臺測試必不可少，涵蓋微信小程序、h5、安卓和ios，驗證播放、全屏、緩沖等關鍵功能。做好這些細節可避免上線后出現問題。
在uni-app里實現一個穩定好用的視頻播放器，配置和兼容性處理是關鍵。很多開發者都遇到過“本地跑得好好的，一上線就出問題”的情況，其實大部分是因為沒有考慮到不同平臺的行為差異和細節設置。
下面從幾個實際開發中容易踩坑的地方入手，分享一些實用技巧。
1. 使用原生組件 video 是基礎
uni-app 提供了內置的 video 組件，支持大部分主流平臺（H5、微信小程序、App等）。雖然功能不算特別強大，但勝在兼容性較好。
使用時要注意以下幾點：
- src 屬性必須為網絡地址：不能直接使用本地路徑，否則在小程序端會無法播放。
- 自動播放慎用 autoplay：有些平臺默認禁止自動播放，尤其是帶聲音的視頻，建議用戶點擊后再播放。
- 注意層級問題：在某些平臺（如微信小程序），video 是原生組件，可能會蓋在自定義導航欄或彈窗之上，需要配合 z-index 或隱藏邏輯來處理。
2. 視頻格式與編碼要統一
不同平臺對視頻格式的支持程度不一致，這是最容易導致“有的手機播不了”的原因。
推薦使用 MP4 格式 + H.264 編碼，這是目前兼容性最好的組合。如果你上傳的是 MOV 或者 FLV 等格式，在部分 android 手機或者 H5 頁面上可能根本無法加載。
你可以通過工具如 ffmpeg 轉換視頻格式，例如：
ffmpeg -i input.mov -c:v libx264 -preset fast -crf 23 -c:a aac output.mp4
這樣轉換出來的 MP4 文件基本能在所有平臺正常播放。
3. 自定義控制條與全屏適配
uni-app 的 video 組件默認自帶控制條，但在某些場景下我們希望自定義 ui，比如加個下載按鈕、進度提示、倍速播放等。
這時候可以設置 show-play-btn, show-fullscreen-btn 等屬性為 false，然后自己實現播放/暫停、進度條等功能。
需要注意的是：
- 在 App 和小程序中，全屏播放行為不一致。微信小程序的全屏切換需要調用 API：videoContext.requestFullScreen()。
- H5 中可以通過監聽 webkitbeginfullscreen 等事件判斷是否進入全屏。
- 建議封裝一個通用的全屏切換方法，根據平臺做差異化處理。
4. 多平臺測試不可少
即使你寫好了代碼，也別急著上線。不同平臺對視頻播放的支持細節差異較大，比如：
- 某些安卓手機播放 MP4 也會卡頓，可能是硬件解碼不支持；
- 微信小程序首次加載大視頻會白屏幾秒；
- App 端如果使用了自定義打包，可能還需要配置域名白名單才能播放網絡視頻。
建議至少在以下平臺進行測試：
測試內容包括：自動播放、手動播放、橫豎屏切換、全屏退出、加載緩沖狀態等。
基本上就這些。視頻播放看似簡單，但要做到跨平臺穩定運行，還是得在配置和兼容性上下點功夫。別等到上線后才發現“怎么別人放得好好的，我這個就卡住”，提前把這些細節考慮進去，能省不少力氣。
