@ray-js/ipc-player-integration 0.0.50-beta.2 → 0.0.50-beta.4

package/lib/iconfont/iconfont.css

@@ -1,8 +1,8 @@
 @font-face {
   font-family: "icon-panel"; /* Project id 4727767 */
-  src: url('iconfont.woff2?t=1787047721746') format('woff2'),
-       url('iconfont.woff?t=1787047721746') format('woff'),
-       url('iconfont.ttf?t=1787047721746') format('truetype');
+  src: url('iconfont.woff2?t=1787276656877') format('woff2'),
+       url('iconfont.woff?t=1787276656877') format('woff'),
+       url('iconfont.ttf?t=1787276656877') format('truetype');
 }
 
 .icon-panel {

package/lib/iconfont/iconfont.json

@@ -1463,7 +1463,7 @@
     },
     {
       "icon_id": "43222962",
-      "name": "one-way-intercom",
+      "name": "yuyin",
       "font_class": "yuyin",
       "unicode": "e63c",
       "unicode_decimal": 58940

package/lib/ui/ui.js

@@ -586,7 +586,10 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
     pageShownRef.current = true;
     // 回到前台时刷新画质（试用）状态（方法内部会按 hideSmartImageQualityState 自行短路）
     refreshSmartImageQuality();
+    // 从后台回来延续离开前的状态：不动 componentHideState，也不重置「用户已点过画面」
+    // 的标记 —— 切后台只是暂时离开，回来强行展示或重新常驻都显得突兀。
     // 已经在出流就直接启动；否则等 playState 变为 PLAYING 的 effect 再启动
+    // （用户从没点过画面时，startHideTimer 仍会跳过，控件保持常驻）
     if (playStateRef.current === PlayState.PLAYING) {
       eventRef.current.emit(startTimeToHideAllComponent);
     }
@@ -854,21 +857,36 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
     instance.changeStreamStatus(code);
   });
   const isHidingByTapRef = useRef(false);
+  /**
+   * 用户是否手势点击过播放器画面。
+   * 刚进入播放器时控件常驻、不走自动隐藏，等用户第一次点画面之后才启用倒计时 ——
+   * 一进来就 5s 消失，用户还没看清有哪些功能。
+   */
+  const hasUserTappedPlayerRef = useRef(false);
   const hasInitializedLandscapeMultiRef = useRef(false);
   const multiTapTimerRef = useRef(null);
   const prevSelectedIndexRef = useRef(selectedLenInfo.index);
   /**
-   * 展示所有组件，一段时间后自动关闭
+   * 启动自动隐藏倒计时的统一入口。
+   * 用户还没点过播放器画面时直接跳过 —— 控件常驻，直到用户第一次交互。
    */
-  const showComponents = () => {
+  const startHideTimer = useMemoizedFn(onTimeout => {
     if (timer.current) {
       clearTimeout(timer.current);
       timer.current = null;
     }
+    if (!hasUserTappedPlayerRef.current) return;
+    timer.current = setTimeout(onTimeout, HIDE_COMPONENT_TIME);
+  });
+
+  /**
+   * 展示所有组件，一段时间后自动关闭
+   */
+  const showComponents = () => {
     setComponentHideState(false);
-    timer.current = setTimeout(() => {
+    startHideTimer(() => {
       setComponentHideState(true);
-    }, HIDE_COMPONENT_TIME);
+    });
   };
   const triggerEvent = type => {
     if (prevTriggerEvent.current === type) return;
@@ -877,26 +895,20 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
       timer.current = null;
     }
     if (type === showAllComponent) {
-      // @ts-ignore
-      timer.current = setTimeout(() => {
+      startHideTimer(() => {
         triggerEvent(hideAllComponent);
-      }, HIDE_COMPONENT_TIME);
+      });
     }
     eventRef.current.emit(type);
   };
   const listenStart = useMemoizedFn(() => {
-    if (timer.current) {
-      clearTimeout(timer.current);
-      timer.current = null;
-    }
-    // 重新开始计时
-    // @ts-ignore
-    timer.current = setTimeout(() => {
+    // 重新开始计时（用户还没点过画面时不启动，见 startHideTimer）
+    startHideTimer(() => {
       // 定时器触发时从 store 读最新状态，避免启动时闭包拿到过期的 isVerticalFullLayout
       const store = getDefaultStore();
       if (store.get(instance.isVerticalFullLayout) && store.get(instance.screenType) === 'vertical') return;
       triggerEvent(hideAllComponent);
-    }, HIDE_COMPONENT_TIME);
+    });
   });
   const listenPause = useMemoizedFn(() => {
     timer.current && clearTimeout(timer.current);
@@ -1089,13 +1101,20 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
     onPlayerTap: data => {
       console.log('playerTap event');
       if (disablePlayerTap.current) {
-        console.log('playerTap 事件已禁止');
+        // 「禁用」只针对「点画面切换控件显隐」这件事（竖屏全屏下控件要常驻），
+        // 但用户确实点了画面这个事实仍要派发出去 —— 转盘、PTZ 这类浮层靠它收起。
+        // 不派发的话，竖屏全屏下点播放器关不掉转盘（普通竖屏可以，因为那时没禁用）。
+        console.log('playerTap 事件已禁止显隐切换，仅派发 tap 通知浮层');
+        eventRef.current.emit(playerTap);
         return;
       }
       console.log('res===on onVideoTap1', data);
+      // 这一下起，自动隐藏倒计时才开始生效
+      hasUserTappedPlayerRef.current = true;
       if (instance.multiCameraCtx.isSupport) {
         var _instance$multiCamera, _instance$multiCamera2;
         const preTapIndex = (_instance$multiCamera = (_instance$multiCamera2 = instance.multiCameraCtx.selectedLenInfoRef.current) === null || _instance$multiCamera2 === void 0 ? void 0 : _instance$multiCamera2.index) !== null && _instance$multiCamera !== void 0 ? _instance$multiCamera : prevSelectedIndexRef.current;
+        const wasHidden = componentHideState;
         instance.multiCameraCtx.selectVideoFiredRef.current = false;
         if (multiTapTimerRef.current) {
           clearTimeout(multiTapTimerRef.current);
@@ -1105,7 +1124,7 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
           const selectFired = !!instance.multiCameraCtx.selectVideoFiredRef.current;
           const currentIndex = (_instance$multiCamera3 = (_instance$multiCamera4 = instance.multiCameraCtx.selectedLenInfoRef.current) === null || _instance$multiCamera4 === void 0 ? void 0 : _instance$multiCamera4.index) !== null && _instance$multiCamera3 !== void 0 ? _instance$multiCamera3 : preTapIndex;
           if (selectFired && currentIndex === preTapIndex) {
-            if (componentHideState) {
+            if (wasHidden) {
               showComponents();
             } else {
               if (timer.current) {
@@ -1118,6 +1137,13 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
             // 点击不同镜头或非镜头区域时，保持现有行为
             showComponents();
           }
+          // 多镜头分支原先漏了这一发：转盘、PTZ、清晰度这些浮层都靠 playerTap 收起
+          // （见本函数顶部 disablePlayerTap 分支的注释），不派发的话多镜头设备上
+          // 点画面根本关不掉转盘。隐藏路径同样要加 isHidingByTapRef 保护，
+          // 免得浮层的 showAllComponent 把这次隐藏又顶回去。
+          isHidingByTapRef.current = !wasHidden;
+          eventRef.current.emit(playerTap);
+          isHidingByTapRef.current = false;
           prevSelectedIndexRef.current = currentIndex;
           multiTapTimerRef.current = null;
         }, 50);

package/lib/widgets/voiceIntercom/voiceIntercom.js

@@ -226,7 +226,12 @@ export const VoiceIntercom = /*#__PURE__*/forwardRef((props, ref) => {
       }, icon);
     }
     return /*#__PURE__*/React.createElement(View, {
-      className: clsx('icon-panel', 'icon-panel-one-way-intercom', mode === 'circle' && 'intercom-default-size', mode !== 'circle' && 'ipc-player-plugin-voice-small-intercom', iconClassName)
+      className: clsx('icon-panel',
+      // 类名按 iconfont 的 font_class 取，不是 name —— 图标库里这枚图标的
+      // name 是「one-way-intercom」（单向对讲）、font_class 是「yuyin」（unicode e63c），
+      // 而 CSS 类是按 font_class 生成的。曾经按 name 拼类名，字形永远找不到，
+      // 重新导出多少次都不会有那个类。别再"顺手改成语义化名字"。
+      'icon-panel-yuyin', mode === 'circle' && 'intercom-default-size', mode !== 'circle' && 'ipc-player-plugin-voice-small-intercom', iconClassName)
     });
   })());
 });

package/lib/widgets/zoomTurntable/constants.d.ts

@@ -27,14 +27,19 @@ export declare const zoomTurntableSwitching = "zoomTurntableSwitching";
 export declare const LONG_PRESS_MS = 500;
 /** 长按期间允许的位移容差（px），超出视为横滑并取消长按 */
 export declare const MOVE_TOLERANCE = 10;
-/** switchChannel 下发超时（ms）：回调始终不来时不知道切没切成，超时回滚读数 */
-export declare const SWITCH_LENS_TIMEOUT = 3000;
+/**
+ * switchChannel 下发超时（ms）：回调始终不来时不知道切没切成，超时回滚读数。
+ *
+ * 取 10s：设备切镜头本身就慢，回调回来得晚是常态；给短了会在回调还在路上时
+ * 先把读数回滚掉，随后回调又落地，反而多一次跳变。
+ */
+export declare const SWITCH_LENS_TIMEOUT = 10000;
 /**
  * switchChannel 已 success 后，等 channelChange 报「切到位」的时长（ms）。
  * 超时按下发结果自己收尾，**不回滚** —— 指令已被受理，物理镜头其实已经切了，
  * 回滚读数只会让读数和画面对不上。
  *
- * 取 10s，比 SWITCH_LENS_TIMEOUT 宽得多：设备真正切完镜头本身要一会儿，
+ * 取 10s，与 SWITCH_LENS_TIMEOUT 同档：设备真正切完镜头本身要一会儿，
  * 给短了会在事件晚到时提前自己收尾，等于白订阅。
  * 真机现状：设备侧暂未推 channelChange，切镜头基本都靠这条超时收尾。
  */
@@ -52,73 +57,233 @@ export declare const QUERY_LENS_TIMEOUT = 3000;
  * 待 APP 提供 zoomFree 的「手势是否结束」参数后可改为由该参数触发。
  */
 export declare const GESTURE_SWITCH_DEBOUNCE = 500;
+/**
+ * 切镜头到位后，补下发目标倍率（d > 1）的延时（ms）。
+ *
+ * 新镜头的流刚起来，立刻打 scaleMultiple 有被原生层吞掉的风险；这段延时里的中间态回读
+ * 由 settleApplyStore 挡住，读数不会先闪回镜头正倍数。归正倍数（d = 1）不走延时，与旧行为一致。
+ */
+export declare const POST_SWITCH_APPLY_DELAY = 200;
+/**
+ * 补差值下发后，等回读追上目标 d 的最长时间（ms）。
+ * 超时解除中间态屏蔽 —— 原生层没按目标值回读时（量化、失败），读数不能被永久冻住。
+ */
+export declare const SETTLE_APPLY_TIMEOUT = 3000;
+/**
+ * 触底判定：连续多少帧 d ≈ 1 才认为「用户还在继续往下缩」。
+ *
+ * 取 2：第一帧是「正常缩到该镜头的光学正倍数」，从第二帧起 d 已经夹在协议下限动不了，
+ * 却仍有回读推上来，说明手指还在往里收。取 1 会把正常的「缩到正倍数」误判成越界。
+ */
+export declare const FLOOR_HIT_COUNT = 2;
+/** 触底计数的有效窗口（ms）：两帧间隔超过它就不算连续，计数重置 */
+export declare const FLOOR_HIT_WINDOW = 1200;
+/**
+ * 切镜头收尾后的触底静默期（ms）。
+ * 收尾自身的 emit(setScaleMultipleEvent, 1.0) 会引发一到两帧 d = 1 回读，
+ * 不挡掉就会被算进触底计数，刚切上去又被切回来。
+ */
+export declare const FLOOR_HIT_SETTLE_GUARD = 800;
+/** 相邻两次「触底自动下切镜头」的冷却（ms）：一次长手势不该连着切两级 */
+export declare const DOWN_SWITCH_COOLDOWN = 800;
+/**
+ * 同一次自动切镜头的跨实例去重窗口（ms）。
+ * Entry / Dock 各跑一份 useLensZoom，都订阅 zoomLevelChange，会同时判出同一次切换 ——
+ * 不去重就是两发 switchChannel。
+ */
+export declare const SWITCH_DEDUPE_WINDOW = 300;
+/**
+ * 转盘拖动跨镜头临界后，手停住多久（ms）就地切镜头。
+ *
+ * 逐帧切不行（switchChannel 是 P2P，几百毫秒级，会把通道打爆），只等松手也不行
+ * （拖过界的一路上画面是「冻」的）。折中：过界后手停住这么久就切，画面跟着拖动走。
+ */
+export declare const DRAG_CROSS_SWITCH_DELAY = 600;
 /** dock 层级，需高于四角容器的 z-index: 100 */
 export declare const ZOOM_DOCK_Z_INDEX = 120;
 /**
- * 竖屏截取比例：从椭圆上弧顶往下截取多少。
- * 0.5 = 完整上半椭圆（截面底边落在最宽处）；> 0.5 会带出两侧下弯段。
- * 取 0.5 让背景一路铺到播放器底边、不留空隙，多出来的部分靠 ZOOM_DOCK_BOTTOM 探出被裁掉。
+ * 竖屏播放器高度：容器按 16:9 推导。
+ * 不用固定值，pad / 折叠屏 / 大屏机型上转盘才能始终占到 1/3。
+ */
+export declare const getVerticalPlayerHeight: () => number;
+/** 竖屏遮罩椭圆横半径：跟着容器宽度缩放，各机型弧形一致 */
+export declare const getEllipseRxBottom: () => number;
+/** 竖屏背景弧顶到播放器底边的可见高度：播放器高的 1/3（375 宽机型约 70px） */
+export declare const getZoomVisibleHeightBottom: () => number;
+/** 竖屏遮罩椭圆纵半径：跟着可见高度按 ELLIPSE_RY_TO_HEIGHT 缩放，各机型弯度一致 */
+export declare const getEllipseRyBottom: () => number;
+/**
+ * 竖屏截取比例：从椭圆上弧顶往下截多深。
+ *
+ * = 可见高度 / 椭圆全高 = 1 / (2 × ELLIPSE_RY_TO_HEIGHT) ≈ 0.273，与机型无关
+ * （可见高与纵半径同比例缩放）。**关键**：截面高度就等于要显示的高度，
+ * 不再靠「椭圆探出播放器底边、多出部分被裁」——
+ * CoverView 里 canvas 的负 margin 并不可靠，一旦不生效，探出去的那截就会原地显示出来，
+ * 表现就是转盘整体被顶高一截（实测占到播放器高的 1/2）、底边还留一条透明缝。
+ * 现在 canvas 底边 = 内容底边 = 播放器底边，不依赖负 margin 与裁切。
  */
-export declare const CROP_RATIO_BOTTOM = 0.5;
+export declare const CROP_RATIO_BOTTOM: number;
+/**
+ * 轨道虚线弧与外圈遮罩弧之间的等距间距（px，scale=1）。
+ *
+ * rjs 侧按「横纵半径各减同一个绝对值」内收，所以这个值就是两条弧线处处的间距，
+ * 两条弧因此弧度一致、看着是一对平行弧（旧的按比例内收会让弧顶间距远小于两侧）。
+ *
+ * 用绝对值而不是跟着带高缩放：竖屏背景带本身就只有 70px 上下，间距按比例缩会失真。
+ *
+ * 竖屏取 32：它同时决定「文案下缘到虚线弧顶」的距离 —— 文案占掉
+ * LABEL_TOP_GAP_BOTTOM + 字高（11 + 12 = 23px），剩下 9px 就是两者之间的留白，
+ * 与设计稿一致（28 时只剩 5px，文字贴着刻度线）。
+ * 横屏取 40，与改动前的弧顶间距（39.25）保持一致，横屏观感不变。
+ */
+export declare const TRACK_EDGE_INSET_BOTTOM = 32;
+export declare const TRACK_EDGE_INSET_RIGHT = 40;
+/**
+ * 竖屏刻度文案「顶边到背景弧」的留白（px，scale=1）。
+ *
+ * 文案位置以**遮罩弧**为基准、与它等距内收，而不是以轨道弧往外推：
+ * 这样调轨道间距（TRACK_EDGE_INSET_BOTTOM）文案不会跟着上下窜，
+ * 当前倍率（12px）与刻度数字（10px）两种字号的顶边也落在同一条线上。
+ *
+ * 取 11 = 最初的 6 再加 5：文字与外边缘贴太近显得局促。
+ */
+export declare const LABEL_TOP_GAP_BOTTOM = 11;
+/**
+ * 竖屏虚线弧「扎出播放器底边的位置」距左右边的距离（px）。
+ *
+ * 设计稿里刻度线两端是**插进播放器底部**的，而且插出去的位置离左右边还有一段距离 ——
+ * 不是贴着左右下角擦出去（那样看着就是「顶到最左最右」）。
+ */
+export declare const TRACK_SIDE_GAP_BOTTOM = 28;
+/**
+ * 竖屏轨道椭圆的横半径：由「虚线弧在距左右边 TRACK_SIDE_GAP_BOTTOM 处正好降到播放器底边」反推。
+ *
+ * 设 x = 屏幕半宽 − 留白、弧顶到底边的高度 h = 可见高 − 间距、纵半径 ry：
+ *   ry × (1 − √(1 − (x / rx)²)) = h  ⟹  rx = x / √(1 − (1 − h/ry)²)
+ *
+ * 算出来的 rx 比「遮罩横半径 − 间距」小一截，所以虚线弧比遮罩弧更弯 ——
+ * 两条弧只在弧顶附近保持 TRACK_EDGE_INSET_BOTTOM 的间距，往两侧虚线弧下坠得更快，
+ * 这正是设计稿的样子（背景横向铺满、刻度线扎进底部）。
+ */
+export declare const getTrackRxBottom: () => number;
 /**
  * 触摸响应余量：canvas 是唯一能收 touch 的元素，把它向外扩一圈，
  * **整个转盘范围（椭圆截面 + 上方文案区 + 两侧空白）都能拖动**，而不是只有刻度线那一带。
  *
- * 绘制坐标由 renderer 按同样的余量补偿，视觉不变；下面的 ZOOM_DOCK_BOTTOM /
- * ZOOM_DOCK_RIGHT 也都从「内容边距」反推，改这两个值不会让转盘位置偏移。
+ * 绘制坐标由 renderer 按同样的余量补偿，视觉不变；下面的 dock 位置也都从「内容边距」反推，
+ * 改这两个值不会让转盘位置偏移。
  */
 export declare const HIT_PADDING_X = 48;
 export declare const HIT_PADDING_Y = 56;
 /**
- * 竖屏 dock 高度：必须 >= canvas 实际高度（椭圆截面 + 上下触摸余量），
- * 否则承载它的 CoverView 会把转盘裁掉一截。随 CROP_RATIO_BOTTOM / HIT_PADDING_Y 自动跟随，留 8px 余量。
+ * 竖屏底部工具条高度的兜底值（px）：实测不到时用它。
+ * 对应 ui.tsx 里 `.ipc-player-bottom-content` 竖屏分支的 `height: '48px'`；
+ * `-full` 变体还叠了 safe-area 的 padding，所以正常路径走实测（measureBottomBarHeight）。
  */
-export declare const ZOOM_DOCK_HEIGHT: number;
+export declare const BOTTOM_BAR_HEIGHT_VERTICAL = 48;
 /**
- * 竖屏 dock 距播放器底边的距离，固定 0（贴底，不再探出）。
+ * 竖屏 dock 距播放器底边的距离（px 字符串）。
  *
- * 这里曾用负值让浮层整体下沉、把椭圆下半探出播放器底边。副作用是 CoverView 顶边
- * 跟着被压低，canvas 顶部（含刻度线那一带）露在 CoverView 之外被裁掉 —— 原生层裁掉的
- * 部分收不到 touch，表现就是「只有刻度尺下方能滑，上半部分直接拖到播放器」。
- * 实测：dock 可命中高度只有 155，而 canvas 高 287.5，顶部溢出 132.5。
- *
- * 现在改由 canvas 自己用负 margin 向下探出（见 ZOOM_CANVAS_OVERSHOOT_BOTTOM），
- * 浮层顶边因此上移，canvas 完整落在可命中区内，而内容视觉位置不变。
+ * - 竖屏全屏：**正值**，抬起一整条底部工具条的高度（优先用实测值，避免与 ui.tsx 写死的
+ *   48px 以及 `-full` 变体的 safe-area padding 不同步），于是 canvas 底边 = 工具条顶边；
+ * - 普通竖屏：**负值**，下沉一份底部触摸余量，让绘制内容底边正好落在播放器底边上。
+ *   （负 bottom 是生效的；canvas 的负 marginBottom 才是无效的那个，别再往回改。）
  */
-export declare const ZOOM_DOCK_BOTTOM = 0;
+export declare const getZoomDockBottom: (isVerticalFull: boolean, measuredBarHeight?: number | null) => string;
 /**
- * 竖屏 canvas 底边探出播放器底边的距离。
- * canvas 在 dock 内底部对齐，靠这个负 margin 下移，使绘制内容仍然铺到播放器底边：
- *   内容底探出 = ZOOM_CANVAS_OVERSHOOT_BOTTOM - HIT_PADDING_Y
- * 探出去的部分由 .ipc-player-content 的 overflow: hidden 裁掉，与改动前的观感一致。
+ * 竖屏 dock 高度（px 字符串）：必须 >= canvas 高度，否则承载它的 CoverView 会把转盘裁掉一截，
+ * 被裁掉的部分收不到 touch（「只有刻度尺下方能滑」/「手势完全不生效」都是它）。
+ * 普通竖屏还要把下沉的那一份底部余量算进来，所以 canvas 高本身就带两份余量。
  */
-export declare const ZOOM_CANVAS_OVERSHOOT_BOTTOM: number;
+export declare const getZoomDockHeight: (isVerticalFull: boolean) => string;
+/** 竖屏 canvas / dock 的 px 尺寸，仅用于布局诊断日志与文档核对 */
+export declare const getZoomLayoutDebugPx: (isVerticalFull: boolean) => {
+    可见高: number;
+    canvas高: number;
+    dock高: number;
+};
 /**
  * 拖动转盘时连续下发缩放的节流间隔（ms）。
  * 转盘每跨一个 step 就回调一次，不节流会把 setScaleMultiple 打爆；
  * 松手时 applyZoom 还会按最终值精确下发一次，所以这里丢掉尾值也没关系。
  */
 export declare const ZOOM_PREVIEW_THROTTLE = 80;
-/** 横屏 dock 距播放器右边的距离，负值时向右探出 */
-export declare const ZOOM_DOCK_RIGHT: number;
+/**
+ * 横屏 dock 距播放器右边的距离（px 字符串，负值向右探出）。
+ *
+ * 之前写的是裸数字、被当 rpx 解释，而横屏的 rpx 基准是屏幕**长边**、机型间差 150px 以上，
+ * 换算下来内容内缩量在 3.8~12.3px 之间飘（窄屏留明显缝、宽屏几乎贴边，
+ * 就是「有些机型右边有 1px 空白」的来源）。写成 px 之后各机型恒为 14px。
+ *
+ *   内容右边内缩 = 本函数的 px 值 + HIT_PADDING_Y = ZOOM_CONTENT_RIGHT_INSET = 14px
+ */
+export declare const getZoomDockRight: () => string;
 /** 横屏截取比例（右侧展示空间较窄，截得更深） */
 export declare const CROP_RATIO_RIGHT = 0.45;
+/**
+ * 横屏刻度与文案的整体下移量（角度不变，仅平移绘制坐标系）。
+ * 竖屏不用它（截面已精确等于可见区，再平移会把底边裁掉一截），固定传 0。
+ */
+export declare const CONTENT_OFFSET_Y = 10;
 /** 布局沉降兜底：onShow / onResize 后的重挂载延时 */
 export declare const RELAYOUT_DELAYS: number[];
-/** 刻度与文案整体下移量（角度不变，仅平移绘制坐标系） */
-export declare const CONTENT_OFFSET_Y = 10;
-/** 刻度与标记值向椭圆内侧收的距离，加大与遮罩边缘的间距 */
-export declare const TRACK_EDGE_INSET = 10;
-/** 竖屏样式微调 */
-export declare const STYLE_OPTIONS_BOTTOM: ZoomTurntableStyleOptions;
+/**
+ * 竖屏样式微调。纵向几何跟着容器 16:9 推导，所以是函数而不是常量对象。
+ *
+ * `contentOffsetY: 0`：椭圆截面已经精确等于可见高度，再整体下移会把底边那一截裁掉。
+ *
+ * 底部触摸余量按布局给：竖屏全屏传 0（canvas 底边就是工具条顶边，再留余量会盖住按钮
+ * 并吃掉它们的点击）；普通竖屏工具条已藏，保持上下对称、由 dock 的负 bottom 沉出去。
+ * （早先无条件设 0 时手势整体失灵，根因不在它，而是 rjs/index.js 漏读 ellipseRx/ellipseRy
+ * + absolutePosition 的 rpx 单位，两处都已修。）
+ */
+export declare const getStyleOptionsBottom: (isVerticalFull: boolean) => ZoomTurntableStyleOptions;
 /** 横屏样式微调：压小刻度、文字与指针，避免与右侧控件重叠 */
 export declare const STYLE_OPTIONS_RIGHT: ZoomTurntableStyleOptions;
 /**
- * 普通刻度震动节流（ms）。step=0.1 时整个区间有几十级，
- * 不节流会震得过密，反而糊成一片没有颗粒感。
+ * 普通刻度震动的最小间隔（ms）。
+ *
+ * 60ms 太密：拖得稍快时 onChange 就是逐帧回调，等于每秒震十几下，马达来不及回位，
+ * 手上是一片持续嗡鸣而不是逐格咔哒。取 110ms 接近人手能分辨两次震动的下限，
+ * 也和连续下发的节流（80ms）拉开，不至于两个节奏互相打架。
+ */
+export declare const VIBRATE_THROTTLE = 110;
+/**
+ * 判定「拖得很快」的跨格数：一次 onChange 跨过的刻度数超过它，就不再逐格震。
+ *
+ * 快速甩动时用户根本分辨不出逐格反馈，继续震只会糊成一片；这时只保留跨主刻度的
+ * medium 挡位感，反而更清楚自己甩过了哪几档。
+ */
+export declare const VIBRATE_FAST_STEPS = 3;
+/**
+ * 内部调试开关：置 true 时忽略「只提示一次」的本地记录，每次出流都展示圈选引导，
+ * 点「知道了」也不写入已读标记 —— 便于反复核对引导的位置与样式。
+ *
+ * 只在自测引导样式时临时打开，**提交前必须回到 false**。
+ * 与 useLensZoom 里的 USE_MOCK_ZOOM_SKILL 是两个独立开关：
+ * 设备没有 ipc_multi_zoom 时入口本身就不渲染，引导自然也不会出现，那种情况要一起打开。
+ */
+export declare const FORCE_SHOW_ZOOM_TIP = false;
+/**
+ * 圈选提示：圈选框在入口 rect 四周额外留的内边距。
+ * 入口是横向的倍率胶囊（宽度随镜头数变化），圈选框按实测 rect 自适应，
+ * 不能用固定尺寸 —— 固定值既框不住宽度，上下又会超出。
+ */
+export declare const TIP_RING_PADDING = 6;
+/** 圈选提示：圈选框圆角，与 multiCamera 的 tile-tip 保持一致 */
+export declare const TIP_RING_RADIUS = 12;
+/** 圈选提示：引线总长（虚线 17 + 末端圆点 4），比 multiCamera 短，文案更贴近圈选处 */
+export declare const TIP_LINE_TOTAL = 21;
+/** 圈选提示：文案 + 按钮的面板宽度与距播放器边缘的最小间距 */
+export declare const TIP_PANEL_WIDTH = 220;
+export declare const TIP_PANEL_EDGE_GAP = 16;
+/**
+ * 圈选提示：出流后延迟多久再测量并展示（ms）。
+ * 刚 PLAYING 时左下角元素还在陆续渲染、宽度还在长，等布局沉降再画圈才不会歪；
+ * 也顺带避免重连一恢复引导就弹出来。
  */
-export declare const VIBRATE_THROTTLE = 60;
-/** 圈选提示：圆环尺寸 */
-export declare const TIP_RING_SIZE = 44;
+export declare const TIP_RESHOW_DELAY = 500;
+/** 圈选提示：引线末端到文案面板的间距 */
+export declare const TIP_PANEL_LINE_GAP = 8;
 /** 可视区判定：避开左下角滚动容器右侧淡出带的安全距离 */
 export declare const FADE_SAFE_PADDING = 24;