uni-app视频播放器的配置技巧与兼容性处理

在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