发布时间：2026/6/18 1:28:41
在小程序开发中视频播放是一个高频需求。无论是短视频 feed 流、在线课程还是产品宣传都需要一套稳定、灵活且安全的播放方案。本文将结合前面的内容——JSON 数据处理用于配置播放参数、CSS 格式化和美化用于定制播放器外观以及JS 加密解密用于保护视频源地址——从零开始解析小程序视频播放的实现细节并提供可直接运行的代码示例。一、小程序视频播放基础组件video微信小程序提供了原生video组件支持网络视频、本地视频和直播流RTMP、HLS。其核心属性包括属性类型说明srcString视频资源地址支持 http、https、云开发 fileIDcontrolsBoolean是否显示默认播放控件进度条、播放按钮等autoplayBoolean是否自动播放注意部分系统限制loopBoolean是否循环播放mutedBoolean是否静音object-fitString填充模式contain/fill/coverbindplay/bindpause/bindendedEventHandle播放、暂停、结束事件回调一个最简单的视频播放页面只需要几行代码xml复制下载运行!-- pages/video/video.wxml -- video srchttps://example.com/sample.mp4 controls autoplay/video但在真实项目中我们往往需要动态管理视频源、自定义 UI 风格、防止盗链。下面逐一深入。二、结合 JSON 工具动态配置视频参数实际开发中视频的src、封面图、标题等信息通常来自后端 API 或本地配置文件。利用JSON 格式来管理这些数据并通过工具进行格式化验证是保证数据可靠性的第一步。示例视频信息 JSON 结构json复制下载{ videoList: [ { id: v001, title: 小程序入门实战, url: https://cdn.example.com/course1.mp4, poster: https://cdn.example.com/poster1.jpg, duration: 365, encrypted: false }, { id: v002, title: 高级加密技术解析, url: AES:BASE64:密文数据, poster: https://cdn.example.com/poster2.jpg, duration: 480, encrypted: true } ] }在开发阶段我们可以使用JSON 在线格式化工具如 JSON.cn检查数据结构是否正确上线前则通过压缩工具去掉多余空格节省网络流量。小程序中读取 JSON 配置javascript复制下载// pages/video/video.js Page({ data: { currentVideo: null, videoUrl: }, onLoad() { // 假设配置存储在本地或通过 wx.request 获取 const config require(../../config/videos.json); this.setData({ currentVideo: config.videoList[0] }); this.resolveVideoUrl(this.data.currentVideo); }, resolveVideoUrl(video) { if (!video.encrypted) { this.setData({ videoUrl: video.url }); } else { // 需要解密处理见后文“加密解密”部分 this.decryptVideoUrl(video.url); } } });三、CSS 美化定制播放器外观与布局小程序原生video组件自带一套默认样式但通常无法满足品牌需求。虽然不能直接修改内部控件样式但我们可以通过外层容器、自定义控件覆盖默认控件以及 CSS 格式化技巧来打造独特视觉效果。1. 设置视频容器比例常见的视频展示比例是 16:9 或 4:3。使用view包裹video配合 CSS 美化工具如 CleanCSS生成的样式css复制下载/* pages/video/video.wxss */ .video-container { width: 100%; position: relative; background-color: #000; } .video-container video { width: 100%; height: auto; display: block; } /* 16:9 比例自适应 */ .aspect-16-9 { aspect-ratio: 16 / 9; }2. 自定义播放按钮与遮罩如果需要完全自定义控件可以设置video的controls{{false}}然后使用cover-view和cover-image绘制悬浮按钮因为它们可以覆盖在原生组件上方。xml复制下载运行view classvideo-wrapper video idmyVideo src{{videoUrl}} object-fitcontain binderroronError controls{{false}}/video cover-view classplay-btn bindtapplayVideo wx:if{{!isPlaying}} cover-image src/images/play.png/cover-image /cover-view /view对应 CSS使用在线 CSS 美化工具统一缩进和排序后css复制下载.video-wrapper { position: relative; width: 100%; border-radius: 16rpx; overflow: hidden; box-shadow: 0 4rpx 20rpx rgba(0,0,0,0.1); } .play-btn { position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); width: 96rpx; height: 96rpx; background: rgba(0,0,0,0.6); border-radius: 50%; display: flex; align-items: center; justify-content: center; } .play-btn cover-image { width: 48rpx; height: 48rpx; }3. 使用 CSS 压缩提升性能生产环境下通过在线 CSS 压缩工具如 cssminifier.com将上述样式压缩为一行可减少包体积。但需注意保留必要的兼容前缀。四、JS 加密解密保护视频源地址视频 URL 如果明文写在代码或 API 返回中容易被爬虫或第三方盗链。虽然小程序前端代码无法绝对隐藏但可以通过对称加密如 AES增加破解成本。结合之前讨论的JS 加密解密库例如小程序可用的 CryptoJS 或内置wx.getFileSystemManager配合云函数可以实现以下流程后端返回加密的视频 URL例如 AES-CBC 加密的 Base64 字符串。小程序端使用预先约定的密钥可通过云函数动态获取解密得到真实地址。将解密后的src设置给video组件。代码示例使用 CryptoJS 在小程序中解密首先在小程序项目中引入crypto-js库通过 npm 安装或直接下载核心文件。javascript复制下载// utils/crypto.js const CryptoJS require(../libs/crypto-js); const AES_KEY CryptoJS.enc.Utf8.parse(0123456789abcdef0123456789abcdef); // 32字节 const AES_IV CryptoJS.enc.Utf8.parse(abcdef9876543210); function decryptVideoUrl(encryptedBase64) { const decrypted CryptoJS.AES.decrypt(encryptedBase64, AES_KEY, { iv: AES_IV, mode: CryptoJS.mode.CBC, padding: CryptoJS.pad.Pkcs7 }); const originalUrl decrypted.toString(CryptoJS.enc.Utf8); if (!originalUrl) throw new Error(解密失败); return originalUrl; } module.exports { decryptVideoUrl };然后在页面中调用javascript复制下载// video.js const { decryptVideoUrl } require(../../utils/crypto); Page({ data: { videoUrl: }, onLoad(options) { const encrypted options.encryptedUrl; // 从路径或请求得到密文 try { const realUrl decryptVideoUrl(encrypted); this.setData({ videoUrl: realUrl }); } catch (e) { wx.showToast({ title: 视频地址无效, icon: none }); } } });注意密钥绝不能硬编码在前端上述仅为演示。实际生产中应通过云函数或后端接口动态下发临时密钥并使用 HTTPS 保障传输安全。五、完整的小程序视频播放页面示例结合上述所有技术点我们构建一个功能完整、安全可控的视频播放页面。1. 页面结构video.wxmlxml复制下载运行view classvideo-page !-- 视频容器 -- view classvideo-container aspect-16-9 video idmainVideo src{{videoUrl}} poster{{videoInfo.poster}} controls{{showDefaultControls}} bindplayonPlay bindpauseonPause bindendedonEnded binderroronVideoError object-fitcontain /video !-- 自定义加载遮罩 -- cover-view classloading-mask wx:if{{isLoading}} cover-image src/images/loading.gif/cover-image /cover-view /view !-- 视频信息区域 -- view classinfo-panel text classtitle{{videoInfo.title}}/text text classduration时长{{videoInfo.duration}}秒/text /view !-- 操作按钮 -- view classaction-buttons button bindtaptogglePlay{{isPlaying ? 暂停 : 播放}}/button button bindtapreplay重播/button /view /view2. 页面逻辑video.jsjavascript复制下载Page({ data: { videoUrl: , videoInfo: { title: , poster: , duration: 0 }, isPlaying: false, isLoading: true, showDefaultControls: true }, videoContext: null, onLoad(options) { const videoId options.id; this.fetchVideoConfig(videoId); }, async fetchVideoConfig(videoId) { // 模拟请求后端加密的配置 wx.showLoading({ title: 加载中 }); try { const res await wx.request({ url: https://api.example.com/video/config?id${videoId}, // 实际开发中需要正确配置 request 合法域名 }); const { title, poster, duration, encryptedUrl } res.data; // 解密 URL前面实现的 decryptVideoUrl 函数 const realUrl this.decryptVideoUrl(encryptedUrl); this.setData({ videoUrl: realUrl, videoInfo: { title, poster, duration }, isLoading: false }); this.videoContext wx.createVideoContext(mainVideo); } catch (err) { wx.hideLoading(); wx.showToast({ title: 获取视频失败, icon: none }); } finally { wx.hideLoading(); } }, decryptVideoUrl(encrypted) { // 调用加密解密模块 return require(../../utils/crypto).decryptVideoUrl(encrypted); }, togglePlay() { if (this.data.isPlaying) { this.videoContext.pause(); } else { this.videoContext.play(); } this.setData({ isPlaying: !this.data.isPlaying }); }, replay() { this.videoContext.seek(0); this.videoContext.play(); this.setData({ isPlaying: true }); }, onPlay() { this.setData({ isPlaying: true }); }, onPause() { this.setData({ isPlaying: false }); }, onEnded() { this.setData({ isPlaying: false }); }, onVideoError(e) { console.error(视频播放错误, e.detail); wx.showToast({ title: 视频加载失败, icon: none }); } });3. 样式文件video.wxss——经过 CSS 美化工具格式化css复制下载.video-page { background-color: #f5f5f5; min-height: 100vh; } .video-container { position: relative; background: #000; } .aspect-16-9 { aspect-ratio: 16 / 9; } .loading-mask { position: absolute; top: 0; left: 0; right: 0; bottom: 0; background: rgba(0,0,0,0.5); display: flex; align-items: center; justify-content: center; } .info-panel { padding: 30rpx; background: white; margin: 20rpx; border-radius: 16rpx; box-shadow: 0 2rpx 12rpx rgba(0,0,0,0.05); } .title { font-size: 36rpx; font-weight: bold; display: block; margin-bottom: 12rpx; } .duration { font-size: 26rpx; color: #666; } .action-buttons { display: flex; gap: 30rpx; justify-content: center; margin-top: 40rpx; } .action-buttons button { width: 200rpx; background-color: #07c160; color: white; border-radius: 48rpx; }六、开发与调试建议使用 JSON 工具验证数据结构在开发初期将视频配置 JSON 粘贴到在线验证器如 JSONLint避免语法错误导致解析失败。CSS 格式化与压缩在提交代码前使用 WebFormatter 或 CleanCSS 在线工具统一团队的样式风格发布前使用 cssnano 压缩以减小体积。加密调试在模拟器中调试解密逻辑时可借助 CyberChef 在线解密对比结果确保算法参数IV、填充模式一致。真机测试注意 iOS 和 Android 对video自动播放策略的差异建议始终绑定用户手势如点击按钮后再播放。七、总结本文从零开始解析了小程序视频播放的完整流程并有机地融入了之前讨论的三大工具JSON 工具用于结构化存储视频元数据方便维护和校验CSS 格式化/美化/压缩提升播放器界面质量和加载性能JS 加密解密保护视频源地址防止简单盗链。通过一个完整的示例页面读者可以掌握从小程序原生video组件使用到数据解密、自定义控件再到样式美化的所有技能。在实际项目中请务必根据业务需求调整安全策略例如升级为非对称加密、配合 token 过期机制并始终坚持 HTTPS 与后端二次鉴权。希望这篇文章能成为你开发小程序视频功能时的实用手册。
