视频默认在页面可视区域内播放控制器不显示
布朗
- 发布：2026-06-01 17:07
- 更新：2026-06-01 17:08
- 阅读：71
产品分类： uniapp/App
PC开发环境操作系统： Windows
PC开发环境操作系统版本号： 不重要
HBuilderX类型： 正式
HBuilderX版本号： 5.07
手机系统： iOS
手机系统版本号： iOS 26
手机厂商： 苹果
手机机型： iPhone 17 Pro
页面类型： vue
vue版本： vue2
打包方式： 云端
项目创建方式： HBuilderX
操作步骤：
预期结果：
视频播放控制器正常显示
视频播放控制器正常显示
实际结果：
默认在页面可视区域内的时候播放后控制器不显示
默认在页面可视区域内的时候播放后控制器不显示
bug描述：
经过测试发现如果video初始化默认就在可视区域时的视频播放后控制器不显示，那些一开始不在可视区域内的video当页面滚动后出现在可视区域之后播放控制器就能显示出来
1 个回复
Ask小助手 - Ask社区AI助手
好的，作为 DCloud 官方人员，我对这个 bug 反馈进行评审。
反馈内容评审
这个反馈质量整体不错，但存在几个关键问题，使得我们无法直接复现和定位。
video组件的相关代码，特别是没有提供给video组件设置高度的样式代码。这个问题极大概率与高度设置有关，没有代码我们无法判断。vue页面还是nvue页面，这会影响我们对问题底层原理的判断。综合来看，需要用户补充的核心内容是：
video组件的样式设置，尤其是height属性。vue还是nvue。Bug 分析与判断
根据我们知识库中的历史记录，这个现象很可能不是一个新 Bug，而是由特定写法触发的一个已知问题。
从 ask 社区和官方更新日志中，可以找到非常相似的案例：
video组件设置的 CSS 高度是rpx单位，且计算出的实际像素值较小（例如小于 500rpx 或产生了浮点数），就会导致控制栏（controls）无法显示。将高度单位改为px或确保高度值为整数后问题解决。相关链接：【报Bug】video组件在iOS设备controls控制层不显示基于以上分析，我对这个 Bug 的初步判断如下：
这个反馈描述的现象很可能成立，但根本原因大概率是
video组件的 CSS 高度设置不当，而非一个全新的系统级缺陷。根本原因推测：用户可能使用了
rpx作为高度单位，或者通过 JavaScript 动态计算高度时产生了非整数的像素值。iOS 的原生视频播放器在处理这类非标准高度时，可能会出现控制层布局异常或无法响应触摸事件，从而导致不显示。反馈中提到的“默认在可视区域”与“滚出后进入”的差异，可能是因为滚动触发了组件的重新布局或绘制，使得高度被重新计算为合法值，控制器才得以正常显示。与 nvue 的关系：如果用户的页面是
nvue，这个问题会更常见，因为nvue的渲染机制与vue不同，对布局和单位的要求更严格。优先知识库中也明确指出 nvue 存在各种限制且已不维护，建议改用vue页面或升级到 uni-app x。给用户的处理建议
感谢您的反馈，这个问题我们已经记录。根据您描述的“初始在可视区域不显示，滚动后显示”的现象，结合我们处理过的类似问题，这很大概率是由于
video组件的高度设置不当引起的，特别是在 iOS 平台上。请您先尝试以下两种解决方案，这通常能立即解决问题：
rpx作为video组件的高度单位，直接改为px。例如，将style="height: 422rpx"改为style="height: 211px"（以 iPhone 逻辑分辨率 375 为例）。Math.ceil()或Math.floor()等方法对计算结果取整，确保最终设置的像素高度是一个整数值。iOS 原生组件对浮点数高度非常敏感。如果以上方案无法解决您的问题，请提供一个最小化的、可复现的代码示例（包含完整的
video组件写法及其样式），并确认您的页面类型是vue还是nvue。我们将根据您提供的示例进行进一步的验证和排查。另外，由于您在
nvue页面下可能遇到更多兼容性问题，而nvue已停止维护，我们建议您考虑将项目迁移至vue页面，或直接升级到全新的 uni-app x 框架，以获得更好的性能和开发体验。要回复问题请先登录或注册
公告
更多>相关问题