web3dlink 2.1.16 → 2.1.18

package/dist/linkFlowzsStream-BPCKLTn_.js

@@ -0,0 +1,195 @@
+import { a as e, n as t, o as n, s as r, t as i } from "./createGameSession-DkD790Ci.js";
+//#region linkFlowzsStream.js
+(function(e) {
+	let t = "zs-stream-parent", n = "zs-stream-embed";
+	function r(e) {
+		return e ? typeof e == "string" ? document.querySelector(e) : e : null;
+	}
+	function i(e, t, n) {
+		let r = (e || "").replace(/\/+$/, "") || (typeof location < "u" ? location.origin : ""), i = new URLSearchParams({
+			template: t || "default",
+			autoconnect: "1",
+			muted: "1"
+		});
+		return n && i.set("streamId", n), `${r}/embed?${i.toString()}`;
+	}
+	function a(e, n, r) {
+		return e?.contentWindow ? (e.contentWindow.postMessage({
+			source: t,
+			streamId: n,
+			...r
+		}, "*"), { ok: !0 }) : {
+			ok: !1,
+			error: "iframe 未就绪"
+		};
+	}
+	class o {
+		constructor({ streamId: t, template: n, container: i, baseUrl: a } = {}) {
+			if (!t) throw Error("ZsStream: streamId 必填（同页多路时用于区分）");
+			this.streamId = t, this.template = n || "default", this.baseUrl = a, this.container = r(i), this.iframe = null, this._handlers = /* @__PURE__ */ new Map(), this._ready = !1, this._inputReady = !1, this._onMessage = this._onMessage.bind(this), e.addEventListener("message", this._onMessage), this._mountIframe();
+		}
+		_mountIframe() {
+			if (!this.container) throw Error("ZsStream: container 未找到");
+			let e = document.createElement("iframe");
+			e.src = i(this.baseUrl, this.template, this.streamId), e.style.width = "100%", e.style.height = "100%", e.style.border = "0", e.setAttribute("allow", "autoplay; fullscreen; encrypted-media"), e.title = `ZS Stream ${this.streamId}`, this.container.innerHTML = "", this.container.appendChild(e), this.iframe = e;
+		}
+		_onMessage(e) {
+			let t = e.data;
+			if (!t || t.source !== n || t.streamId && t.streamId !== this.streamId || t.type !== "event") return;
+			let r = t.event;
+			r === "ready" && (this._ready = !0), r === "inputready" && (this._inputReady = !0), this._emit(r, t.data);
+		}
+		_emit(e, t) {
+			let n = this._handlers.get(e);
+			if (n) for (let e of n) try {
+				e(t);
+			} catch (e) {
+				console.error("[ZsStream]", e);
+			}
+		}
+		on(e, t) {
+			return this._handlers.has(e) || this._handlers.set(e, /* @__PURE__ */ new Set()), this._handlers.get(e).add(t), () => this.off(e, t);
+		}
+		off(e, t) {
+			this._handlers.get(e)?.delete(t);
+		}
+		_send(e, t) {
+			return a(this.iframe, this.streamId, {
+				type: e,
+				...t
+			});
+		}
+		invoke(e, t, n) {
+			return this._send("invoke", {
+				module: e,
+				action: t,
+				params: n ?? {}
+			});
+		}
+		camera(e, t) {
+			return this._send("camera", {
+				action: e,
+				params: t ?? {}
+			});
+		}
+		sendRaw(e) {
+			return this._send("sendRaw", { descriptor: String(e) });
+		}
+		sendCommand(e, t) {
+			return this._send("larkCommand", {
+				command: e,
+				params: t ?? {}
+			});
+		}
+		sendTextToDataChannel(e) {
+			let t = typeof e == "string" ? e : JSON.stringify({
+				command: e.command,
+				params: e.params ?? {}
+			});
+			return this._send("sendRaw", { descriptor: t });
+		}
+		disconnect() {
+			return this._send("disconnect", {});
+		}
+		destroy() {
+			e.removeEventListener("message", this._onMessage), this.disconnect(), this.iframe?.parentNode && this.iframe.parentNode.removeChild(this.iframe), this.iframe = null, this._handlers.clear();
+		}
+		get isReady() {
+			return this._ready;
+		}
+		get isInputReady() {
+			return this._inputReady;
+		}
+	}
+	class s {
+		constructor() {
+			this._streams = /* @__PURE__ */ new Map();
+		}
+		mount(e) {
+			let t = e?.streamId;
+			if (!t) throw Error("ZsStreamHub.mount: streamId 必填");
+			this._streams.has(t) && this._streams.get(t).destroy();
+			let n = new o(e);
+			return this._streams.set(t, n), n;
+		}
+		get(e) {
+			return this._streams.get(e) || null;
+		}
+		has(e) {
+			return this._streams.has(e);
+		}
+		destroy(e) {
+			let t = this._streams.get(e);
+			t && (t.destroy(), this._streams.delete(e));
+		}
+		destroyAll() {
+			for (let e of [...this._streams.keys()]) this.destroy(e);
+		}
+		list() {
+			return [...this._streams.keys()];
+		}
+	}
+	e.ZsStream = {
+		mount(e) {
+			return new o(e);
+		},
+		Hub: s,
+		buildEmbedSrc: i,
+		MSG_SOURCE_PARENT: t,
+		MSG_SOURCE_EMBED: n
+	}, e.ZsStreamHub = s;
+})(typeof window < "u" ? window : globalThis);
+var a = null, o = null, s = [];
+function c(e) {
+	if (typeof e == "string") return e;
+	if (e == null) return null;
+	try {
+		return JSON.stringify(e);
+	} catch {
+		return null;
+	}
+}
+function l(e) {
+	if (typeof e != "string") return e;
+	try {
+		return JSON.parse(e.trim());
+	} catch {
+		return e;
+	}
+}
+function u(e, t, n) {
+	n && (e.on(t, n), s.push({
+		target: e,
+		event: t,
+		handler: n
+	}));
+}
+async function d(e, t = {}) {
+	if (!globalThis.ZsStream?.mount) throw Error("ZsStream 未加载，请确认已引入 zs-stream-parent.js");
+	await f(), r(e?.UELogLevel ?? !0);
+	let n = globalThis.ZsStream.mount(e);
+	a = n, u(n, "inputready", t.onInputready), u(n, "platform", t.onPlatform), u(n, "queue", t.onQueue), u(n, "error", t.onError);
+	let s = t.onSceneInit || t.onSceneInitialized, d = i({
+		sendText: (e) => n.sendTextToDataChannel(e),
+		commandTimeout: t.commandTimeout ?? 3e3,
+		onSceneInit: s ? (e) => s(l(e)) : void 0
+	});
+	o = d, u(n, "message", (e) => {
+		let n = c(e);
+		d.handleIncoming(n, e), t.onMessage && t.onMessage(e);
+	});
+	let p = d.gameAPI;
+	return p.destroy = () => f(), p;
+}
+async function f() {
+	if (t(s), s = [], o?.destroy(), o = null, a && typeof a.destroy == "function") try {
+		await a.destroy(), e("连接关闭成功");
+	} catch (e) {
+		n("连接关闭失败:", e);
+	}
+	a = null;
+}
+//#endregion
+export { d as n, f as t };
+
+//# sourceMappingURL=linkFlowzsStream-BPCKLTn_.js.map

package/dist/linkFlowzsStream-BPCKLTn_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linkFlowzsStream-BPCKLTn_.js","names":[],"sources":["../linkFlowzsStream.js"],"sourcesContent":["import './zs-stream-parent.js';\nimport { log, logError, setUELogEnabled } from './baseConfig/logger.js';\nimport { createGameSession, unbindAll } from './createGameSession.js';\n\nlet activeStream = null;\nlet activeSession = null;\nlet activeBindings = [];\n\nfunction toRawText(payload) {\n    if (typeof payload === 'string') return payload;\n    if (payload === undefined || payload === null) return null;\n    try {\n        return JSON.stringify(payload);\n    } catch (_) {\n        return null;\n    }\n}\n\nfunction parseSceneInitPayload(payload) {\n    if (typeof payload !== 'string') return payload;\n    try {\n        return JSON.parse(payload.trim());\n    } catch (_) {\n        return payload;\n    }\n}\n\nfunction bind(target, event, handler) {\n    if (!handler) return;\n    target.on(event, handler);\n    activeBindings.push({ target, event, handler });\n}\n\n/**\n * 挂载 ZS 推流并返回带校验的 gameAPI\n * @param {Object} config 透传给 ZsStream.mount（UELogLevel 为插件内部参数）\n * @param {Object} callbacks onInputready / onMessage / onError / onSceneInit / onPlatform / onQueue\n */\nexport async function ZsStreamMount(config, callbacks = {}) {\n    if (!globalThis.ZsStream?.mount) {\n        throw new Error('ZsStream 未加载，请确认已引入 zs-stream-parent.js');\n    }\n\n    await ZsStreamDestroy();\n\n    setUELogEnabled(config?.UELogLevel ?? true);\n\n    const stream = globalThis.ZsStream.mount(config);\n    activeStream = stream;\n\n    bind(stream, 'inputready', callbacks.onInputready);\n    bind(stream, 'platform', callbacks.onPlatform);\n    bind(stream, 'queue', callbacks.onQueue);\n    bind(stream, 'error', callbacks.onError);\n\n    // 对外正式回调名：onSceneInit（兼容 onSceneInitialized）\n    const onSceneInit = callbacks.onSceneInit || callbacks.onSceneInitialized;\n    const session = createGameSession({\n        sendText: (text) => stream.sendTextToDataChannel(text),\n        commandTimeout: callbacks.commandTimeout ?? 3000,\n        onSceneInit: onSceneInit\n            ? (payload) => onSceneInit(parseSceneInitPayload(payload))\n            : undefined\n    });\n    activeSession = session;\n\n    const onMessage = (payload) => {\n        const raw = toRawText(payload);\n        session.handleIncoming(raw, payload);\n        if (callbacks.onMessage) {\n            callbacks.onMessage(payload);\n        }\n    };\n    bind(stream, 'message', onMessage);\n\n    const gameAPI = session.gameAPI;\n    gameAPI.destroy = () => ZsStreamDestroy();\n    return gameAPI;\n}\n\n/**\n * 销毁当前 ZS 推流并清理资源\n */\nexport async function ZsStreamDestroy() {\n    unbindAll(activeBindings);\n    activeBindings = [];\n\n    activeSession?.destroy();\n    activeSession = null;\n\n    if (activeStream && typeof activeStream.destroy === 'function') {\n        try {\n            await activeStream.destroy();\n            log('连接关闭成功');\n        } catch (error) {\n            logError('连接关闭失败:', error);\n        }\n    }\n\n    activeStream = null;\n}\n"],"mappings":";;CAKA,SAAI,GAAgB;CACpB,IAAI,IAAmB;CAGrB,SAAM,EAAO,GAAa;EAGxB,OAFI,IACA,OAAA,KAAA,WAAA,SAAA,cAAA,CAAA,IACA,IAFY;CAGlB;CAEA,SAAE,EAAA,GAAA,GAAA,GAAA;WACJ,KAAA,IAAA,QAAA,QAAA,EAAA,MAAA,OAAA,WAAA,MAAA,SAAA,SAAA,KAES,IAAA,IAAA,gBAAsB;GACzB,UAAS,KAAa;GACxB,aAAI;GACF,OAAE;EACJ,CAAC;EAED,OADI,KAAO,EAAA,IAAO,YAAA,CAAA,GAClB,GAAA,EAAA,SAAA,EAAA,SAAA;CACJ;CAEA,SAAS,EAAa,GAAO,GAAS,GAAA;EAMpC,OALO,GAAQ,iBACb,EAAO,cAAU,YACjB;GAAA,QAAA;GAA8B;GAAO,GAAO;EAAG,GACnD,GAAA,GAEE,EAAA,IAAA,GAAA,KALsB;GAAA,IAAA;GAAA,OAAA;EAAA;CAMtB;CAEA,MAAE,EAAa;EACf,YAAA,EAAA,aAAA,aAAA,cAAA,eAAA,CAAA,GAAA;GACI,IAAC,CAAA,GAAc,MAAC,MAAc,kCAAwB;GACtD,KAAG,WAAW,GACd,KAAE,WAAU,KAAgB,WAC9B,KAAA,UAAA,0BAEA,KAAM,SAAA,kDAEN,KAAA,SAAgB,2BAEhB,KAAM,aAAS,KAAU,WAAU,KAAM,IAAA,GACzC,EAAA,iBAAqB,WAAA,KAAA,UAAA;EAErB;EAEA,eAAc;GACd,IAAK,CAAA,KAAO,WAAU,MAAU,MAAO,yBAAC;;GAUtC,AARA,EAAC,MAAQ,EAAe,KAAA,SAAA,KAAkB,UAAA,KAAA,QAAA,GAC5C,EAAM,MAAA,QAAc,QACpB,EAAM,MAAS,SAAC,QACd,EAAE,MAAW,SAAS,KACtB,EAAE,aAAgB,SAAU,uCAAsB,GAClD,EAAE,QAAa,aAAA,KAAA,YACf,KAAK,UAAI,YAAY,IACrB,KAAK,UAAG,YAAA,CAAA,GACR,KAAA,SAAA;EACF;EAEA,WAAM,GAAS;GACb,IAAE,IAAU,EAAE;GAGd,IAFE,CAAA,KAAQ,EAAA,WAAe,KACrB,EAAE,YAAU,EAAA,aAAW,KAAA,YACvB,EAAE,SAAU,SAAU;GAE3B,IAAA,IAAA,EAAA;GAGD,AAFK,MAAS,YAAU,KAAA,SAAU,oDAElC,KAAM,MAAO,GAAG,EAAQ,IAAA;EACxB;EAEJ,MAAA,GAAA,GAAA;;GAEE,OACC,KAAQ,IAAA,KAAA,GACT,IAAA;IAAA,EAAA,CAAA;GAAA,SAAA,GAAA;IAAA,QAAA,MAAA,cAAA,CAAA;GAAA;EAEE;;UAGA,KAAA,UAAsB,IAAE,CAAA,KAAA,KAAA,UAAA,IAAA,mBAAA,IAAA,IAAA,CAAA,GACxB,KAAA,UAAgB,IAAI,CAAA,EAAA,IAAA,CAAA;EAEpB;EAEA,IAAI,GAAI,GAAM;GACZ,KAAK,UAAM,IAAQ,CAAA,GAAA,OAAA,CAAA;EACrB;EAEA,MAAI,GAAA,GAAA;GACJ,OAAA,EAAA,KAAA,QAAA,KAAA,UAAA;IAAA;IAAA,GAAA;GAAA,CAAA;;EAGJ,OAAA,GAAA,GAAA,GAAA"}

package/dist/web3dlink-larksr.js

@@ -0,0 +1,3 @@
+import { n as e, r as t, t as n } from "./linkFlowLarkSR-D4p33n9x.js";
+import { c as r, i, r as a } from "./createGameSession-DkD790Ci.js";
+export { a as CommandManager, i as GameAPI, n as closeGameApi, e as createAndInitLarkSR, t as getLarkSR, r as version };

package/dist/web3dlink-zs.js

@@ -0,0 +1,3 @@
+import { c as e, i as t, r as n } from "./createGameSession-DkD790Ci.js";
+import { n as r, t as i } from "./linkFlowzsStream-BPCKLTn_.js";
+export { n as CommandManager, t as GameAPI, i as ZsStreamDestroy, r as ZsStreamMount, e as version };

package/dist/web3dlink.d.ts

@@ -0,0 +1,91 @@
+/**
+ * web3dlink 对外类型声明
+ *
+ * GameAPI 方法名由 scripts/sync-dts.mjs 根据 api/index.js 同步；发版跑 npm run build 即可。
+ */
+
+export declare const version: string;
+
+export interface CommandResult {
+  success: boolean;
+  message: string | string[];
+  data?: unknown;
+  params?: unknown;
+  command?: string;
+}
+
+export interface Transport {
+  sendTextToDataChannel(text: string): void;
+  bindMessageHandler(handler: (raw: string) => void): void;
+}
+
+export declare class CommandManager {
+  constructor(transport: Transport, options?: { timeout?: number });
+  destroy(): void;
+  sendWithDefault(
+    result: { errors: string[]; normalized?: object },
+    command: string,
+    options?: { timeout?: number }
+  ): Promise<CommandResult> | CommandResult;
+}
+
+export declare class GameAPI {
+  constructor(commandManager: CommandManager);
+
+  camera(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  cesium(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  marker(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  floodPeak(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  animation(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  hydrodynamicForce(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  sceneModel(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  atmosphericEffects(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  tool(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  line(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  level(api: string, params?: object): Promise<CommandResult> | CommandResult;
+  VTK(api: string, params?: object): Promise<CommandResult> | CommandResult;
+
+  oneDimensionalHydrodynamics(api: string, params?: object, options?: { timeout?: number }): Promise<CommandResult> | CommandResult;
+  customDomain(api: string, params?: object, options?: { timeout?: number }): Promise<CommandResult> | CommandResult;
+  arrow(api: string, params?: object, options?: { timeout?: number }): Promise<CommandResult> | CommandResult;
+  NC(api: string, params?: object, options?: { timeout?: number }): Promise<CommandResult> | CommandResult;
+  gateOperation(api: string, params?: object, options?: { timeout?: number }): Promise<CommandResult> | CommandResult;
+}
+
+export interface LarkSRCallbacks {
+  onConnected?: (larksr: unknown) => void;
+  onError?: (e: unknown) => void;
+  onInfo?: (e: unknown) => void;
+  onDataChannelOpen?: (e: unknown) => void;
+  onDatachanneltext?: (e: unknown) => void;
+  /** 场景初始化完成 */
+  onSceneInitialized?: (e: unknown) => void;
+  commandTimeout?: number;
+  [key: string]: unknown;
+}
+
+export declare function createAndInitLarkSR(
+  config: object,
+  callbacks?: LarkSRCallbacks
+): Promise<GameAPI>;
+
+export declare function closeGameApi(): Promise<void>;
+export declare function getLarkSR(): unknown;
+
+export interface ZsStreamCallbacks {
+  onInputready?: (e: unknown) => void;
+  onMessage?: (e: unknown) => void;
+  onError?: (e: unknown) => void;
+  /** 场景初始化完成 */
+  onSceneInit?: (e: unknown) => void;
+  onPlatform?: (e: unknown) => void;
+  onQueue?: (e: unknown) => void;
+  commandTimeout?: number;
+}
+
+export declare function ZsStreamMount(
+  config: object,
+  callbacks?: ZsStreamCallbacks
+): Promise<GameAPI & { destroy: () => Promise<void> }>;
+
+export declare function ZsStreamDestroy(): Promise<void>;