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

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/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.5",
   "description": "IPC 融合播放器",
   "main": "lib/index",
   "files": [