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

package/lib/features/initPlayerWidgets/index.d.ts

@@ -14,7 +14,8 @@ export type InitPlayerWidgetsOptions = {
     showRealTimeMagnification?: boolean;
     /**
      * 允许展示焦距转盘入口（长按图标弹出转盘）。
-     * 仅为功能开关；实际渲染还要 ipc_multi_zoom 解析出 cnt > 1，单镜头设备传 true 也不出现。
+     * 仅为功能开关；实际渲染还要宿主提供 ty.ipc.switchChannel、且 ipc_multi_zoom 解析出 cnt > 1，
+     * 单镜头设备与老宿主上传 true 也不出现。
      */
     showZoomTurntable?: boolean;
     directionControlProps?: Partial<React.ComponentProps<typeof FullScreen>['directionControlProps']>;

package/lib/features/initPlayerWidgets/index.js

@@ -53,7 +53,8 @@ export async function initPlayerWidgets(ctx, options) {
     }
   }
   // 焦距转盘入口：这里只放开占位，真正是否渲染由 widget 内部按
-  // ipc_multi_zoom 上报值解析出的 cnt > 1 决定（单镜头设备不出现）
+  // 「宿主有 ty.ipc.switchChannel」+「ipc_multi_zoom 解析出 cnt > 1」决定
+  // （单镜头设备、不支持切镜头的老宿主都不出现）
   if (options.showZoomTurntable) {
     const zoomTurntableIndex = newDefaultBottomLeftContent.findIndex(item => item.id === 'ZoomTurntableEntry');
     if (zoomTurntableIndex !== -1) {

package/lib/ui/bottomLeftContent.js

@@ -27,6 +27,12 @@ const VERTICAL_PEEK_WIDTH = 34;
 // 平铺档内容与右下角按钮之间的最小安全间距
 const VERTICAL_FLAT_SAFE_GAP = 8;
 
+// 收紧态（.ipc-player-bottom-left-content-container-tight）下每项省下的宽度：
+// 竖屏 item 左右 padding 由 12px 收到 10px，中间项左右各省 2px；
+// 首项只省右侧 2px —— 左侧 16px 是内容起始留白，要和其余三个角落对齐，不能动。
+const TIGHT_SAVE_FIRST = 2;
+const TIGHT_SAVE_OTHER = 4;
+
 // 左下角子元素统一类名（由 ui.tsx 渲染时挂上），用于 selectAll 逐项测量
 const ITEM_CLASS = 'bottom-left-item-container';
 const BottomLeftContent = _ref => {
@@ -113,13 +119,16 @@ const BottomLeftContent = _ref => {
   // 这类变化 bottomLeftContent.length 捕获不到，由 widget 主动 emit。
   const [resizeSignal, setResizeSignal] = useState(0);
 
+  // 是否收紧 item 间距（窄屏专用，判定见下方 useEffect）。
+  // 只升不降：收紧后各项变窄 → 重测 → 可能又判成“放得下”→ 取消收紧 → 又放不下，
+  // 那就是一个自激振荡。锁存住，只在横竖屏切换时随其余测量值一起清零。
+  const [tightened, setTightened] = useState(false);
+
   // 滑动期间暂停整体的自动隐藏，滑动停止后再恢复（无原生 scrollend，用防抖判定结束）
   const scrollingRef = useRef(false);
   const scrollEndTimerRef = useRef();
   // 测量时需要叠加当前滚动量，用 ref 避免闭包拿到过期值
   const scrollLeftRef = useRef(0);
-  // 仅用于在可见项数变化时打一条日志，便于真机核对分档结果
-  const lastCountRef = useRef(-1);
   useEffect(() => {
     setScrollResetKey(k => k + 1);
     setScrollLeft(0);
@@ -130,6 +139,7 @@ const BottomLeftContent = _ref => {
     setContentWidth(0);
     setWrapWidth(0);
     setItemWidths([]);
+    setTightened(false);
   }, [screenType]);
 
   // 程序化滚动目标只在动画期间短暂受控，之后释放为非受控，避免回弹影响手动拖动
@@ -168,11 +178,13 @@ const BottomLeftContent = _ref => {
   // 避免估算失准把本来放得下的元素裁掉。
   const isFlat = isVertical && (measuredCount > 0 ? measuredCount <= VERTICAL_FLAT_MAX && contentFits : contentFits);
   const isCompact = isVertical && !isFlat && measuredCount > 0 && measuredCount <= VERTICAL_FLAT_MAX;
+  const isScrollMode = isVertical && !isFlat && !isCompact;
+
   // 前 4 项实际累计宽（元素按自身内容撑开，不做等分）
   const firstFourWidth = itemWidths.slice(0, VERTICAL_FLAT_MAX).reduce((sum, w) => sum + w, 0);
   // 滚动档可视宽 = 前 4 项宽 + 第 5 项的露出区（箭头就压在这段上）
   const verticalScrollWidth = (() => {
-    if (!(isVertical && !isFlat && !isCompact) || measuredCount === 0) return 0;
+    if (!isScrollMode || measuredCount === 0) return 0;
     const want = firstFourWidth + VERTICAL_PEEK_WIDTH;
     if (!(availableWidth > 0)) return want;
     // 前 4 项 + 露出区塞不下 —— 前 4 项里有宽 widget（焦距转盘的倍率胶囊、清晰度文案）时很常见。
@@ -180,7 +192,48 @@ const BottomLeftContent = _ref => {
     if (want > availableWidth) return 0;
     return want;
   })();
-  // 竖屏只有锁住宽度时箭头才有专属的露出区可压；否则箭头一定会盖到前 4 项上，索性不出
+  /**
+   * 收紧后前 4 项能省下多少（估算：按每项的 padding 差值累加）。
+   * 逐项宽是实测值，收紧后的真实宽度未必精确等于这个差值，作为“够不够”的预判足够。
+   */
+  const tightenSaving = (() => {
+    const n = Math.min(measuredCount, VERTICAL_FLAT_MAX);
+    if (n <= 0) return 0;
+    return TIGHT_SAVE_FIRST + TIGHT_SAVE_OTHER * (n - 1);
+  })();
+
+  /**
+   * 是否要把 item 间距从 12px 收到 10px。
+   *
+   * 两头都不收：
+   * - **本来就放得下**（宽屏）：不动，保持 12px 的宽松间距 —— 不为个别窄屏机型
+   *   让全量机型的图标挤在一起；
+   * - **收紧了也放不下**（更窄的屏 / 3 镜头的转盘胶囊）：白挤一遍换不回箭头的
+   *   专属落位区，不如保住观感，让箭头压在第 4 项右缘上（见下方 hasArrowRoom）。
+   *
+   * 只有“差一点、收紧刚好够”这一段才收 —— 这正是真机上遇到的那一档。
+   */
+  useEffect(() => {
+    if (tightened) return;
+    if (!isScrollMode || measuredCount === 0 || !(availableWidth > 0)) return;
+    const want = firstFourWidth + VERTICAL_PEEK_WIDTH;
+    if (want <= availableWidth) return;
+    if (want - tightenSaving > availableWidth) return;
+    setTightened(true);
+  }, [tightened, isScrollMode, measuredCount, availableWidth, firstFourWidth, tightenSaving]);
+
+  /**
+   * 竖屏 scroll 档一律出箭头。
+   *
+   * 曾要求「锁宽成功（verticalScrollWidth > 0）才出箭头」，理由是没锁宽时箭头会盖到前 4 项上。
+   * 真机上这条判断反而更糟：前 4 项里有宽 widget（焦距转盘胶囊 2 镜头约 100px、
+   * 3 镜头约 138px）时，`前 4 项 + 34` 很容易超过可用宽，于是箭头连同窄渐变一起消失 ——
+   * 右边还藏着两三个 widget，却没有任何可滑提示（6 个 widget、可用宽 256、内容宽 359 的实测 case）。
+   *
+   * 宁可让箭头压在第 4 项右缘那 26px 上：那块本来就落在淡出渐变里，
+   * 观感是「内容淡出 + 箭头」，正好是「右边还有」的暗示。
+   * 想既保住前 4 项完整、又给箭头留出专属位，在窄屏上物理上做不到。
+   */
 
   // 滚动末端的安全距离：滑到最右时最后一个元素与右边缘留更宽松的间距（横屏更宽）。
   // 只有真正锁宽滚动的那一档需要；平铺 / 紧凑 / 塞不下而没锁宽的情况，
@@ -230,10 +283,6 @@ const BottomLeftContent = _ref => {
         }
         if (Array.isArray(itemRects)) {
           const widths = itemRects.map(r => (r === null || r === void 0 ? void 0 : r.width) || 0).filter(w => w > 0);
-          if (widths.length !== lastCountRef.current) {
-            lastCountRef.current = widths.length;
-            console.log('[ipc-player] 左下角可见 widget 数 =', widths.length, widths);
-          }
           // 值没变时保持同一引用，避免轮询期间无谓重渲染
           setItemWidths(prev => prev.length === widths.length && prev.every((w, i) => w === widths[i]) ? prev : widths);
         }
@@ -271,7 +320,9 @@ const BottomLeftContent = _ref => {
   // reservedRight 决定 ScrollView 可视宽度（右下角内容异步加载后会从 0 变为实际宽度）
   reservedRight,
   // playState：视频就绪后 overlay 可能重新布局，需重新测量
-  playState, bottomLeftContent === null || bottomLeftContent === void 0 ? void 0 : bottomLeftContent.length, shouldHide, showBadge, wrapCls, scrollCls, contentCls, scrollResetKey, resizeSignal]);
+  playState, bottomLeftContent === null || bottomLeftContent === void 0 ? void 0 : bottomLeftContent.length, shouldHide, showBadge, wrapCls, scrollCls, contentCls, scrollResetKey, resizeSignal,
+  // 收紧后各项 padding 变小，必须重测一遍逐项宽，否则分档还在用收紧前的旧值
+  tightened]);
 
   // 子元素主动上报宽度变化 → 重跑测量，及时更新横滑箭头与右边缘淡出
   useEffect(() => {
@@ -337,19 +388,6 @@ const BottomLeftContent = _ref => {
     if (!(availableWidth > 0) || !(scrollViewWidth > 0)) return 4;
     return Math.max(availableWidth - scrollViewWidth + 4, 4);
   })();
-
-  // 真机核对分档结果用，确认无误后可摘掉
-  useEffect(() => {
-    if (!isVertical) return;
-    console.log('[ipc-player] 左下角分档', {
-      个数: measuredCount,
-      档位: isFlat ? 'flat 平铺' : isCompact ? 'compact 紧凑' : 'scroll 滚动',
-      可用宽: availableWidth,
-      内容宽: naturalWidth,
-      可视宽: verticalScrollWidth || availableWidth,
-      逐项宽: itemWidths
-    });
-  }, [isVertical, measuredCount, isFlat, isCompact, availableWidth, naturalWidth, verticalScrollWidth, itemWidths]);
   return /*#__PURE__*/React.createElement(CoverView, {
     className: clsx('ipc-player-bottom-left-content-wrap', wrapCls),
     style: {
@@ -408,8 +446,11 @@ const BottomLeftContent = _ref => {
     },
     className: clsx(scrollCls, {
       'ipc-player-bottom-left-scroll-fademask': fadeRightEdge,
-      // 锁宽档可视区只有“前 4 项 + 一角”，渐变区要跟着收窄，否则会把第 4 项也淡掉一大半
-      'ipc-player-bottom-left-scroll-fademask--narrow': fadeRightEdge && verticalScrollWidth > 0
+      // 竖屏 scroll 档一律用窄渐变（34px，只覆盖箭头那块）。
+      // 原条件是「锁宽成功」，可没锁宽时可视区右缘同样压着第 4 项，
+      // 72px 的宽渐变会把宽 widget（转盘胶囊约 100px）淡掉一大半。
+      // 横屏 isScrollMode 恒为 false，仍走 72px 宽渐变，行为不变。
+      'ipc-player-bottom-left-scroll-fademask--narrow': fadeRightEdge && isScrollMode
     }),
     style: {
       paddingBottom: `${paddingBottomPx}px`,
@@ -421,7 +462,9 @@ const BottomLeftContent = _ref => {
       whiteSpace: 'nowrap'
     }
   }, /*#__PURE__*/React.createElement(View, {
-    className: clsx('ipc-player-bottom-left-content-container', contentCls),
+    className: clsx('ipc-player-bottom-left-content-container', contentCls, {
+      'ipc-player-bottom-left-content-container-tight': tightened
+    }),
     style: {
       display: 'inline-flex',
       flexDirection: 'row',
@@ -436,7 +479,7 @@ const BottomLeftContent = _ref => {
       height: '1px',
       flexShrink: 0
     }
-  }))), isOverflow && !atEnd && !isCompact && (!isVertical || verticalScrollWidth > 0) && (isButtonHint || !isDismissed) && /*#__PURE__*/React.createElement(CoverView, {
+  }))), isOverflow && !atEnd && !isCompact && (!isVertical || isScrollMode) && (isButtonHint || !isDismissed) && /*#__PURE__*/React.createElement(CoverView, {
     className: clsx('ipc-player-bottom-left-scroll-hint', {
       'ipc-player-bottom-left-scroll-hint--button': isButtonHint
     }),

package/lib/ui/bottomRightContent.js

@@ -69,7 +69,9 @@ const BottomRightContent = _ref => {
   return /*#__PURE__*/React.createElement(CoverView, {
     className: clsx('ipc-player-bottom-right-content-wrap', wrapCls),
     style: _objectSpread({
-      paddingLeft: screenType === 'vertical' ? '10px' : '0',
+      // 竖屏归 0：这 10px 是纯空白，且计入实测宽后又被 reservedRight 带给左下角，
+      // 等于左下角白让 10px。与右下角按钮的间距统一由 BOTTOM_RIGHT_SAFE_GAP 负责。
+      paddingLeft: '0',
       height: screenType === 'vertical' ? shouldHide ? '49px' : '48px' : shouldHide ? '59px' : '58px'
     }, widthStyle)
   }, /*#__PURE__*/React.createElement(View, {

package/lib/ui/ui.js

@@ -59,7 +59,10 @@ const SET_SCALE_ALIGN_TIMEOUT = 1500;
 const SCALE_MATCH_EPS = 0.01;
 
 /** 竖屏左下角内容与右下角按钮之间的安全间距（px） */
-const BOTTOM_RIGHT_SAFE_GAP = 12;
+// 左下角内容右缘与右下角按钮之间的安全间距。
+// 原为 12px：右下角 wrap 当时还带 10px paddingLeft，两段叠起来是 22px 空白，窄屏上太奢侈。
+// paddingLeft 已归 0，这里收到 4px —— 右下角按钮自身还有 16px 的右留白撑着，不会显挤。
+const BOTTOM_RIGHT_SAFE_GAP = 4;
 export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
   const {
     className,
@@ -803,13 +806,17 @@ export const IPCPlayerIntegration = /*#__PURE__*/React.memo(props => {
     if (screenType === 'full') {
       return bottomRightWidth;
     }
+    // 安卓上 CoverView 的 boundingClientRect 可能一直测不出宽度，轮询跑完仍是 0
+    if (!(bottomRightMeasuredWidth > 0)) {
+      return bottomRightWidth;
+    }
     // 封顶保护：个别宿主里不设宽度的 CoverView 可能撑满整行，实测值会异常放大，
     // 那样左下角会被挤没。超过屏宽一半就当测量不可信，退回常量估算。
     const maxReserved = windowWidthRef.current ? windowWidthRef.current / 2 : 0;
-    if (bottomRightMeasuredWidth > 0 && (!maxReserved || bottomRightMeasuredWidth <= maxReserved)) {
-      return Math.ceil(bottomRightMeasuredWidth) + BOTTOM_RIGHT_SAFE_GAP;
+    if (maxReserved && bottomRightMeasuredWidth > maxReserved) {
+      return bottomRightWidth;
     }
-    return bottomRightWidth;
+    return Math.ceil(bottomRightMeasuredWidth) + BOTTOM_RIGHT_SAFE_GAP;
   }, [screenType, bottomRightWidth, bottomRightMeasuredWidth]);
 
   /**

package/lib/ui/ui.less

@@ -311,7 +311,7 @@
     padding: 0 16px 0 0;
   }
 
-  // 左下角子元素容器
+  // 左下角子元素容器（竖屏；横屏另叠 .bottom-left-item-full-container 且带 !important）
   .bottom-left-item-container {
     padding: 0 12px;
     display: flex;
@@ -334,6 +334,30 @@
     padding: 0 0 0 16px;
   }
 
+  // 收紧态：左右各 10px（默认 12px）。
+  //
+  // 只有窄屏上「前 4 项 + 34 露出区」放不下、且收紧后刚好放得下时才挂这个类
+  // （判定见 bottomLeftContent.tsx 的 tightened）。宽屏本来就放得下，
+  // 保持 12px 的宽松间距，不为个别机型让全量机型变紧。
+  //
+  // 中间项左右各省 2px = 4px；首项只省右侧 2px —— 左侧 16px 是内容起始留白，
+  // 要和其余三个角落对齐，不能动。10px 是不显挤的下限。
+  //
+  // 横屏叠的 .bottom-left-item-full-container 带 !important，优先级更高，不受影响。
+  .ipc-player-bottom-left-content-container-tight {
+    .bottom-left-item-container {
+      padding: 0 10px;
+    }
+
+    .bottom-left-item-container:first-of-type {
+      padding: 0 10px 0 16px;
+    }
+
+    .bottom-left-item-container:last-of-type {
+      padding: 0 0 0 10px;
+    }
+  }
+
   // 左下角全屏子元素容器
   .bottom-left-item-full-container {
     padding: 0 16px !important;

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

@@ -56,6 +56,14 @@ export declare const isZoomSkillValid: (skill?: ZoomSkill | null) => boolean;
  * @param value DP 值；内部 mock 常量是对象、DP 上报是 string，两条来源共用同一校验链路
  */
 export declare const parseZoomSkill: (value?: unknown) => ZoomSkill | null;
+/**
+ * 宿主是否支持切镜头下发。
+ *
+ * 转盘的每一种交互（点 tab 切镜头、拖转盘跨界、手势触底下切）最终都落到 switchChannel 上，
+ * 方法不存在时转盘画得出来却切不动，只会让用户以为坏了 —— 故整个入口不渲染
+ * （门控在 useLensZoom 的 multiLensReady 里，与 cnt > 1 同级）。
+ */
+export declare const isSwitchChannelSupported: () => boolean;
 /**
  * 切换物理镜头。channel 取上报的子镜头 id 而非数组下标 —— 固件可上报非连续 id。
  * 返回 false（不支持 / 失败）时由 useLensZoom 回滚读数，无回调另有 SWITCH_LENS_TIMEOUT 兜底。

package/lib/widgets/zoomTurntable/lensSkill.js

@@ -111,13 +111,34 @@ export const parseZoomSkill = value => {
 
 /** ty.ipc.switchChannel 的最小签名：ty 类型包尚未收录，本地声明避免调用点退化成 any */
 
+/** 「宿主不支持 switchChannel」只提示一次：判定会被 render 反复调用，不去重会刷屏 */
+let switchChannelMissingLogged = false;
+
+/**
+ * 宿主是否支持切镜头下发。
+ *
+ * 转盘的每一种交互（点 tab 切镜头、拖转盘跨界、手势触底下切）最终都落到 switchChannel 上，
+ * 方法不存在时转盘画得出来却切不动，只会让用户以为坏了 —— 故整个入口不渲染
+ * （门控在 useLensZoom 的 multiLensReady 里，与 cnt > 1 同级）。
+ */
+export const isSwitchChannelSupported = () => {
+  var _ty;
+  const supported = typeof ((_ty = ty) === null || _ty === void 0 || (_ty = _ty.ipc) === null || _ty === void 0 ? void 0 : _ty.switchChannel) === 'function';
+  if (!supported && !switchChannelMissingLogged) {
+    switchChannelMissingLogged = true;
+    console.warn('[zoomTurntable] 宿主不支持 ty.ipc.switchChannel，焦距转盘入口不展示');
+    dumpChannelApis();
+  }
+  return supported;
+};
+
 /**
  * 切换物理镜头。channel 取上报的子镜头 id 而非数组下标 —— 固件可上报非连续 id。
  * 返回 false（不支持 / 失败）时由 useLensZoom 回滚读数，无回调另有 SWITCH_LENS_TIMEOUT 兜底。
  */
 export const switchLens = (devId, lens) => {
-  var _ty;
-  const switchChannel = (_ty = ty) === null || _ty === void 0 || (_ty = _ty.ipc) === null || _ty === void 0 ? void 0 : _ty.switchChannel;
+  var _ty2;
+  const switchChannel = (_ty2 = ty) === null || _ty2 === void 0 || (_ty2 = _ty2.ipc) === null || _ty2 === void 0 ? void 0 : _ty2.switchChannel;
   // 入参与回调结果都打出来：真机上「切没切成」只能靠这条链路判断
   const params = {
     deviceId: devId,
@@ -223,8 +244,8 @@ const pickChannel = payload => {
  * 返回 null（不支持 / 失败 / 超时）时调用方保持现状，不重置镜头。
  */
 export const queryCurrentLens = devId => {
-  var _ty2;
-  const queryCurrentChannel = (_ty2 = ty) === null || _ty2 === void 0 || (_ty2 = _ty2.ipc) === null || _ty2 === void 0 ? void 0 : _ty2.queryCurrentChannel;
+  var _ty3;
+  const queryCurrentChannel = (_ty3 = ty) === null || _ty3 === void 0 || (_ty3 = _ty3.ipc) === null || _ty3 === void 0 ? void 0 : _ty3.queryCurrentChannel;
   if (typeof queryCurrentChannel !== 'function') {
     console.warn('[zoomTurntable] 宿主不支持 ty.ipc.queryCurrentChannel');
     return Promise.resolve(null);
@@ -273,8 +294,8 @@ export const queryCurrentLens = devId => {
  * 切镜头的收尾（画面归 1 倍 + 刷读数）以该事件为准，不支持时只能退回「switchChannel 成功即收尾」。
  */
 export const isChannelChangeSupported = () => {
-  var _ty3;
-  return typeof ((_ty3 = ty) === null || _ty3 === void 0 || (_ty3 = _ty3.ipc) === null || _ty3 === void 0 ? void 0 : _ty3.onChannelChange) === 'function';
+  var _ty4;
+  return typeof ((_ty4 = ty) === null || _ty4 === void 0 || (_ty4 = _ty4.ipc) === null || _ty4 === void 0 ? void 0 : _ty4.onChannelChange) === 'function';
 };
 
 /**
@@ -282,8 +303,8 @@ export const isChannelChangeSupported = () => {
  * 真机上「事件为什么不来」第一步就是确认宿主到底提供了哪个名字。
  */
 export const dumpChannelApis = () => {
-  var _ty4;
-  const ipc = (_ty4 = ty) === null || _ty4 === void 0 ? void 0 : _ty4.ipc;
+  var _ty5;
+  const ipc = (_ty5 = ty) === null || _ty5 === void 0 ? void 0 : _ty5.ipc;
   if (!ipc) {
     console.warn('[zoomTurntable] ty.ipc 不存在', `typeof ty=${typeof ty}`);
     return;
@@ -321,9 +342,9 @@ export const subscribeChannelChange = (devId, handler) => {
   console.log('[zoomTurntable] 已订阅 ty.ipc.onChannelChange', devId);
   ty.ipc.onChannelChange(listener);
   return () => {
-    var _ty5;
+    var _ty6;
     console.log('[zoomTurntable] 解绑 channelChange 监听', devId);
-    if (typeof ((_ty5 = ty) === null || _ty5 === void 0 || (_ty5 = _ty5.ipc) === null || _ty5 === void 0 ? void 0 : _ty5.offChannelChange) === 'function') {
+    if (typeof ((_ty6 = ty) === null || _ty6 === void 0 || (_ty6 = _ty6.ipc) === null || _ty6 === void 0 ? void 0 : _ty6.offChannelChange) === 'function') {
       ty.ipc.offChannelChange(listener);
     } else {
       console.warn('[zoomTurntable] 宿主无 offChannelChange，监听无法解绑');

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

@@ -1,6 +1,6 @@
 import { ComponentConfigProps } from '../../interface';
 type Options = ComponentConfigProps & {
-    /** 业务侧的功能开关；实际是否渲染仍由 ipc_multi_zoom 解析出的 cnt 决定 */
+    /** 业务侧的功能开关；实际是否渲染仍由宿主 switchChannel 能力 + ipc_multi_zoom 的 cnt 决定 */
     showZoomTurntable?: boolean;
     /** 跳过能力加载：Entry 常驻负责加载，Dock 作为消费方传 true 避免重复解析 */
     skipLoad?: boolean;

package/lib/widgets/zoomTurntable/useLensZoom.js

@@ -1,10 +1,10 @@
-import { useEffect, useRef, useState } from 'react';
+import { useEffect, useMemo, useRef, useState } from 'react';
 import { useMemoizedFn } from 'ahooks';
 import { useStore } from '../../ctx/store';
 import { PlayState } from '../../interface';
 import { useDpState } from '../../hooks/useDpState';
 import { setScaleMultipleEvent, zoomLevelChange } from '../../ui/constant';
-import { MOCK_ZOOM_SKILL, MULTI_ZOOM_DP_CODE, dumpChannelApis, isChannelChangeSupported, isZoomSkillValid, lensCount, parseZoomSkill, queryCurrentLens, showSmallMonitor, subscribeChannelChange, switchLens } from './lensSkill';
+import { MOCK_ZOOM_SKILL, MULTI_ZOOM_DP_CODE, dumpChannelApis, isChannelChangeSupported, isSwitchChannelSupported, isZoomSkillValid, lensCount, parseZoomSkill, queryCurrentLens, showSmallMonitor, subscribeChannelChange, switchLens } from './lensSkill';
 import { DEFAULT_STEP, D_MIN, buildMarks, buildTickValues, indexOfLensId, lensRange, matchLens, maxScaleMultiple, toDisplayZoom, toScaleMultiple, zoomBounds } from './lensModel';
 import { CHANNEL_SETTLE_TIMEOUT, DOWN_SWITCH_COOLDOWN, DRAG_CROSS_SWITCH_DELAY, D_MATCH_EPS, FLOOR_HIT_COUNT, FLOOR_HIT_SETTLE_GUARD, FLOOR_HIT_WINDOW, GESTURE_SWITCH_DEBOUNCE, POST_SWITCH_APPLY_DELAY, SETTLE_APPLY_TIMEOUT, SWITCH_DEDUPE_WINDOW, SWITCH_LENS_TIMEOUT, ZOOM_PREVIEW_THROTTLE, zoomTurntableLensChange, zoomTurntableSwitching, zoomTurntableZoomChange } from './constants';
 /**
@@ -210,9 +210,18 @@ export const useLensZoom = options => {
     };
   }, [event]);
 
+  // ---------------- 宿主能力 ----------------
+  /**
+   * 宿主是否支持 ty.ipc.switchChannel。宿主能力在运行期不会变，求一次即可 ——
+   * 放 useMemo 而不是 render 期直接调，免得 typeof 判定与首次告警日志跟着每次渲染跑。
+   *
+   * 转盘的每一种交互最终都落到这个方法上，它不存在时转盘切不动，故整个入口不展示。
+   */
+  const switchChannelSupported = useMemo(() => isSwitchChannelSupported(), []);
+
   // ---------------- 能力加载 ----------------
   useEffect(() => {
-    if (skipLoad || !devId || !showZoomTurntable) return undefined;
+    if (skipLoad || !devId || !showZoomTurntable || !switchChannelSupported) return undefined;
     const raw = multiZoomDpValue;
     console.log('[zoomTurntable] ipc_multi_zoom 上报值', JSON.stringify(raw !== null && raw !== void 0 ? raw : null));
     const skill = parseZoomSkill(raw);
@@ -223,10 +232,14 @@ export const useLensZoom = options => {
     }
     setZoomSkill(skill);
     return undefined;
-  }, [devId, showZoomTurntable, multiZoomDpValue, skipLoad]);
+  }, [devId, showZoomTurntable, switchChannelSupported, multiZoomDpValue, skipLoad]);
 
-  /** 多镜头能力就绪：ipc_multi_zoom 解析出的 cnt > 1（单镜头设备不出现） */
-  const multiLensReady = showZoomTurntable && lensCount(zoomSkill) > 1;
+  /**
+   * 多镜头能力就绪：宿主提供 ty.ipc.switchChannel，且 ipc_multi_zoom 解析出的 cnt > 1。
+   * 两条缺一个入口都不出现 —— 单镜头设备没有可切的镜头，
+   * 老宿主则是切不动（见 isSwitchChannelSupported）。
+   */
+  const multiLensReady = showZoomTurntable && switchChannelSupported && lensCount(zoomSkill) > 1;
 
   // 手势缩放上限按当前镜头换算后下发给播放器：maxScaleMultiple 是 d 口径，
   // 直接用画面绝对上限（如 6.0）会让画面放到该镜头区间之外。切镜头后跟着更新。

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

@@ -3,7 +3,7 @@ import { ComponentConfigProps } from '../../interface';
 import './zoomTurntableEntry.less';
 type Props = ComponentConfigProps & {
     className?: string;
-    /** 业务侧的功能开关；实际是否渲染仍由 ipc_multi_zoom 解析出的 cnt 决定 */
+    /** 业务侧的功能开关；实际是否渲染仍由宿主 switchChannel 能力 + ipc_multi_zoom 的 cnt 决定 */
     showZoomTurntable?: boolean;
     /** 长按判定时长，默认 500ms */
     longPressDuration?: number;
@@ -12,7 +12,8 @@ type Props = ComponentConfigProps & {
 };
 /**
  * 焦距转盘入口：左下角工具条中的图标，长按弹出转盘。
- * 仅 cnt > 1 的多镜头设备渲染；单镜头设备倍率交互仍由 RealTimeMagnification 承担。
+ * 仅「宿主支持 ty.ipc.switchChannel」且 cnt > 1 的多镜头设备渲染；
+ * 单镜头设备倍率交互仍由 RealTimeMagnification 承担。
  */
 export declare const ZoomTurntableEntry: (props: Props) => React.JSX.Element | null;
 export {};

package/lib/widgets/zoomTurntable/zoomTurntableEntry.js

@@ -19,7 +19,8 @@ import { FORCE_SHOW_ZOOM_TIP, LONG_PRESS_MS, MOVE_TOLERANCE, TIP_RESHOW_DELAY, g
 import './zoomTurntableEntry.less';
 /**
  * 焦距转盘入口：左下角工具条中的图标，长按弹出转盘。
- * 仅 cnt > 1 的多镜头设备渲染；单镜头设备倍率交互仍由 RealTimeMagnification 承担。
+ * 仅「宿主支持 ty.ipc.switchChannel」且 cnt > 1 的多镜头设备渲染；
+ * 单镜头设备倍率交互仍由 RealTimeMagnification 承担。
  */
 export const ZoomTurntableEntry = props => {
   var _props$event;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ray-js/ipc-player-integration",
-  "version": "0.0.50-beta.4",
+  "version": "0.0.50-beta.6",
   "description": "IPC 融合播放器",
   "main": "lib/index",
   "files": [