投屏画面正常,点击却偏了?检查缩放、黑边与横竖屏坐标

区分坐标偏移与反馈延迟,用简单几何示例说明图片留白、浏览器缩放和屏幕旋转为何会影响点击位置,以及如何提交有效排障信息。

画面能显示,不代表鼠标位置已经正确换算成手机触摸位置。 如果越靠边点得越偏,或只在调整窗口、浏览器缩放、横竖屏切换后出现偏移,应先核对坐标映射,而不是先提高帧率。

本文面向网页投屏与控制界面的排障,依据 2026 年 9 月 16 日核对的浏览器文档。以下是原理分析与建议测试方法,不是某款投屏软件的实测结论。

先做一个不涉及业务操作的对照

在自己的测试设备上选一个不会提交、删除或付款的页面,对比中心和四角附近的位置。每次只改变一个条件:窗口大小、页面缩放,或手机方向。记录预期位置与实际落点。

现象 优先检查的方向
整体向同一方向错开 图片起点、边框、工具栏或留白是否被算进触摸区
中心接近正确,越靠边误差越大 显示尺寸与输入尺寸的比例
滚动页面后才偏 是否继续使用旧的位置测量值
旋转后偏,重开后正常 帧尺寸、方向和控制坐标是否同步更新

这些是排查线索,不是仅凭现象就能确认的根因。若点击位置正确、只是反馈晚,应另查投屏延迟与 RTT。

黑边不属于手机屏幕

图片采用 object-fit: contain 时保留完整比例,容器比例不同时会留白;cover 则可能裁掉部分内容。因此“卡片有多大”不能直接等于“手机画面有多大”。MDN 图片适配说明

给开发者一个计算示例:帧为 1080×2400,放进 300×600 的无边框、无内边距区域,居中完整显示。比例为 min(300/1080, 600/2400)=0.25,实际图像是 270×600,左右各留 15。区域内的点 (150,300) 对应帧坐标 (540,1200);左侧留白中的点击应被拒绝,而不是挤到手机左边缘。

通用计算是:

s = min(boxWidth/frameWidth, boxHeight/frameHeight)
leftGap = (boxWidth-frameWidth*s)/2
topGap = (boxHeight-frameHeight*s)/2
frameX = (localX-leftGap)/s
frameY = (localY-topGap)/s

这只是居中、等比完整显示、没有额外旋转或透视变换时的几何示例。先排除画面外的点,再换算;控制接口若使用另一套逻辑尺寸,还需按其约定继续映射。裁剪、非居中显示及旋转不能直接照搬公式。

浏览器缩放不要硬补一个 0.9

clientX 是相对视口的位置;getBoundingClientRect() 也给出相对视口的矩形。两者可以在同一坐标系中相减,但返回的矩形包含边框与内边距,开发者应测量真正的画面区域。事件坐标、元素矩形

devicePixelRatio 描述物理像素与 CSS 像素的比值,并可能随页面缩放变化。它不是“鼠标坐标统一乘一下就正确”的校正值。MDN 像素比例

我们的建议是:显示、命中检测与控制发送共用同一份几何信息;窗口、滚动、帧尺寸或方向变化后及时更新。不要只针对当前 90% 缩放写死修正系数。横竖屏切换时,确认控制端所需的是旋转前还是旋转后的坐标,避免两端重复旋转。

报告这些信息,比“点不准”更有用

给维护者提供浏览器版本、缩放比例、手机方向、是否有黑边,以及一次脱敏的预期点/实际点对照。说明问题是否随窗口大小变化、重新打开后是否消失。开发者再补充帧尺寸、显示矩形、归一化坐标和最终发送值即可。

不需要附调试端口、账号或完整业务截图。先把坐标错位与延迟分开,才能判断应修显示区域、换算逻辑,还是控制链路。

参考来源