web3dlink 2.1.9 → 2.1.11

package/dist/web3dlink.js

@@ -1,5 +1,5 @@
 //#region \0rolldown/runtime.js
-var __commonJSMin = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), name = "web3dlink", version$1 = "2.1.9", description = "LarkSR / ZS 推流 GameAPI SDK", type = "module", main = "./dist/web3dlink.js", module$1 = "./dist/web3dlink.js", exports$1 = { ".": {
+var __commonJSMin = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), name = "web3dlink", version$1 = "2.1.11", description = "LarkSR / ZS 推流 GameAPI SDK", type = "module", main = "./dist/web3dlink.js", module$1 = "./dist/web3dlink.js", exports$1 = { ".": {
 	import: "./dist/web3dlink.js",
 	default: "./dist/web3dlink.js"
 } }, files = ["dist"], scripts = {
@@ -173,6 +173,20 @@ console.log(`[web3dlink] version: ${version}`), (function(e) {
 })(typeof window < "u" ? window : globalThis);
 //#endregion
 //#region ../baseConfig/responses.js
+function normalizeMessageList(e) {
+	return (Array.isArray(e) ? e : [e]).map((e) => {
+		if (typeof e == "string") return e;
+		if (e && typeof e == "object") {
+			if (typeof e.message == "string" && e.message) return e.message;
+			try {
+				return JSON.stringify(e);
+			} catch {
+				return String(e);
+			}
+		}
+		return e == null ? "" : String(e);
+	}).filter((e) => e !== "");
+}
 function createSuccessResponse(e, t, n) {
 	return {
 		success: !0,
@@ -184,7 +198,7 @@ function createSuccessResponse(e, t, n) {
 function createErrorResponse(e, t, n) {
 	let r = {
 		success: !1,
-		message: e,
+		message: normalizeMessageList(e),
 		params: t,
 		command: n
 	};
@@ -193,7 +207,7 @@ function createErrorResponse(e, t, n) {
 function createWarnResponse(e, t, n) {
 	let r = {
 		success: !1,
-		message: e,
+		message: normalizeMessageList(e),
 		params: t,
 		command: n
 	};
@@ -769,7 +783,7 @@ function verifyEnumerationValue(e) {
 }
 //#endregion
 //#region ../api/camera/validate.js
-function validateOptionalBoolean(e, t, n, r, i) {
+function validateOptionalBoolean$1(e, t, n, r, i) {
 	if (n == null || n === "") {
 		e[t] = i;
 		return;
@@ -984,6 +998,12 @@ function aroundMode(e = {}) {
 		defaultValue: 0,
 		min: -180,
 		max: 180
+	})), t.push(...validateOptionalNumber({
+		normalized: n,
+		field: "duration",
+		value: e.duration,
+		defaultValue: 2,
+		min: 0
 	})), t.push(...validateOptionalNumber({
 		normalized: n,
 		field: "minDistanceToTarget",
@@ -1026,7 +1046,7 @@ function aroundMode(e = {}) {
 		value: e.y_AnimSpeed,
 		defaultValue: 5,
 		min: 0
-	})), validateOptionalBoolean(n, "isCheckCollision", e.isCheckCollision, t, !1), validateOptionalBoolean(n, "isIgnoreAttachedActors", e.isIgnoreAttachedActors, t, !0), t.push(...validateOptionalNumber({
+	})), validateOptionalBoolean$1(n, "isCheckCollision", e.isCheckCollision, t, !1), validateOptionalBoolean$1(n, "isIgnoreAttachedActors", e.isIgnoreAttachedActors, t, !0), t.push(...validateOptionalNumber({
 		normalized: n,
 		field: "collisionOffset",
 		value: e.collisionOffset,
@@ -1071,14 +1091,14 @@ function firstPersonMode(e = {}) {
 		value: e.speed,
 		defaultValue: 2,
 		min: 0
-	})), validateOptionalBoolean(n, "collision", e.collision, t, !0), {
+	})), validateOptionalBoolean$1(n, "collision", e.collision, t, !0), {
 		errors: t,
 		normalized: n
 	};
 }
 function viewLock(e = {}) {
 	let t = [], n = { ...e };
-	return validateOptionalBoolean(n, "state", e.state, t, !1), {
+	return validateOptionalBoolean$1(n, "state", e.state, t, !1), {
 		errors: t,
 		normalized: n
 	};
@@ -1679,6 +1699,28 @@ function validatePopupCustom1Config(e, t) {
 }
 //#endregion
 //#region ../api/marker/validate.js
+var DEFAULT_VISIBLE_RANGE = [0, 2147483647];
+function validateVisibleRange(e, t, n, r = "visibleRange") {
+	n.push(...validateOptionalArray({
+		normalized: t,
+		field: r,
+		value: e[r],
+		length: 2,
+		defaultValue: [...DEFAULT_VISIBLE_RANGE]
+	}));
+	let i = t[r];
+	if (!Array.isArray(i) || i.length !== 2) return;
+	let a = Number(i[0]), o = Number(i[1]);
+	if (!Number.isFinite(a) || !Number.isFinite(o)) {
+		n.push(`[${r}]元素必须是数字`);
+		return;
+	}
+	if (a > o) {
+		n.push(`[${r}]最小值不能大于最大值`);
+		return;
+	}
+	t[r] = [a, o];
+}
 var MARKER_TYPE_LIST = [
 	"default",
 	"default1",
@@ -1706,13 +1748,7 @@ function iconMarker(e) {
 		normalized: n,
 		field: "groupId",
 		value: e.groupId
-	})), t.push(...validateOptionalArray({
-		normalized: n,
-		field: "visibleRange",
-		value: e.visibleRange,
-		length: 2,
-		defaultValue: [0, 2147483647]
-	})), t.push(...verifyEnumerationValue({
+	})), validateVisibleRange(e, n, t), t.push(...verifyEnumerationValue({
 		normalized: n,
 		field: "isScreenSpace",
 		value: e.isScreenSpace,
@@ -1728,17 +1764,11 @@ function iconMarker(e) {
 		list: MARKER_TYPE_LIST
 	})), e.recordData !== void 0) {
 		let r = e.recordData;
-		if (typeof r != "object" || !r || Array.isArray(r)) t.push({
-			field: "recordData",
-			message: "[recordData] 必须是对象类型"
-		});
+		if (typeof r != "object" || !r || Array.isArray(r)) t.push("[recordData] 必须是对象类型");
 		else try {
 			n.recordData = JSON.stringify(r);
 		} catch {
-			t.push({
-				field: "recordData",
-				message: "[recordData] 序列化失败，请检查是否包含循环引用"
-			});
+			t.push("[recordData] 序列化失败，请检查是否包含循环引用");
 		}
 	}
 	return validateConfigByMarkerType(n, t), {
@@ -1756,13 +1786,7 @@ function followMarker(e) {
 		normalized: n,
 		field: "groupId",
 		value: e.groupId
-	})), t.push(...validateOptionalArray({
-		normalized: n,
-		field: "visibleRange",
-		value: e.visibleRange,
-		length: 2,
-		defaultValue: [0, 2147483647]
-	})), t.push(...verifyEnumerationValue({
+	})), validateVisibleRange(e, n, t), t.push(...verifyEnumerationValue({
 		normalized: n,
 		field: "isScreenSpace",
 		value: e.isScreenSpace,
@@ -1778,17 +1802,11 @@ function followMarker(e) {
 		list: MARKER_TYPE_LIST
 	})), e.recordData !== void 0) {
 		let r = e.recordData;
-		if (typeof r != "object" || !r || Array.isArray(r)) t.push({
-			field: "recordData",
-			message: "[recordData] 必须是对象类型"
-		});
+		if (typeof r != "object" || !r || Array.isArray(r)) t.push("[recordData] 必须是对象类型");
 		else try {
 			n.recordData = JSON.stringify(r);
 		} catch {
-			t.push({
-				field: "recordData",
-				message: "[recordData] 序列化失败，请检查是否包含循环引用"
-			});
+			t.push("[recordData] 序列化失败，请检查是否包含循环引用");
 		}
 	}
 	return validateConfigByMarkerType(n, t), {
@@ -1935,23 +1953,14 @@ function secondMarker(e) {
 		normalized: n,
 		field: "groupId",
 		value: e.groupId
-	})), t.push(...validateOptionalArray({
-		normalized: n,
-		field: "visibleRange",
-		value: e.visibleRange,
-		length: 2,
-		defaultValue: [0, 2147483647]
-	})), t.push(...verifyEnumerationValue({
+	})), validateVisibleRange(e, n, t), t.push(...verifyEnumerationValue({
 		normalized: n,
 		field: "isScreenSpace",
 		value: e.isScreenSpace,
 		defaultValue: 1,
 		type: "number",
 		list: [0, 1]
-	})), typeof e.isInitSecond == "boolean" ? n.isInitSecond = e.isInitSecond : e.isInitSecond === void 0 ? n.isInitSecond = !1 : t.push({
-		field: "isInitSecond",
-		message: "isInitSecond must be boolean"
-	}), t.push(...verifyEnumerationValue({
+	})), typeof e.isInitSecond == "boolean" ? n.isInitSecond = e.isInitSecond : e.isInitSecond === void 0 ? n.isInitSecond = !1 : t.push("[isInitSecond]必须是布尔类型"), t.push(...verifyEnumerationValue({
 		normalized: n,
 		field: "triggerType",
 		value: e.triggerType,
@@ -1986,17 +1995,11 @@ function secondMarker(e) {
 		value: e.value ?? ""
 	})) : r.dataTexts = []), e.recordData !== void 0) {
 		let r = e.recordData;
-		if (typeof r != "object" || !r || Array.isArray(r)) t.push({
-			field: "recordData",
-			message: "[recordData] 必须是对象类型"
-		});
+		if (typeof r != "object" || !r || Array.isArray(r)) t.push("[recordData] 必须是对象类型");
 		else try {
 			n.recordData = JSON.stringify(r);
 		} catch {
-			t.push({
-				field: "recordData",
-				message: "[recordData] 序列化失败，请检查是否包含循环引用"
-			});
+			t.push("[recordData] 序列化失败，请检查是否包含循环引用");
 		}
 	}
 	return {
@@ -3432,6 +3435,157 @@ function offMouseClick(e = {}) {
 		normalized: n
 	};
 }
+function validateOptionalBoolean(e, t, n, r, i) {
+	let a = e[t];
+	if (a == null || a === "") {
+		i[t] = n;
+		return;
+	}
+	if (typeof a != "boolean") {
+		r.push(`[${t}]必须是布尔类型`);
+		return;
+	}
+	i[t] = a;
+}
+function validateOptionalCoordinates(e, t, n) {
+	let r = e.coordinates;
+	if (r == null || r === "" || Array.isArray(r) && r.length === 0) {
+		n.coordinates = [];
+		return;
+	}
+	t.push(...validateCoordinatesRequired(r)), Array.isArray(r) && r.length >= 3 && (n.coordinates = r.slice(0, 3).map(Number));
+}
+function playSequence(e = {}) {
+	let t = [], n = { ...e };
+	t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), t.push(...validateRequiredString({
+		normalized: n,
+		field: "fieldName",
+		value: e.fieldName
+	})), t.push(...validateOptionalString({
+		normalized: n,
+		field: "sequenceDirectory",
+		value: e.sequenceDirectory,
+		defaultValue: ""
+	})), t.push(...validateOptionalArray({
+		normalized: n,
+		field: "sequenceFiles",
+		value: e.sequenceFiles,
+		defaultValue: []
+	})), Array.isArray(n.sequenceFiles) && (n.sequenceFiles = n.sequenceFiles.map((e) => String(e ?? "").trim()).filter(Boolean));
+	let r = typeof n.sequenceDirectory == "string" && n.sequenceDirectory.trim() !== "", i = Array.isArray(n.sequenceFiles) && n.sequenceFiles.length > 0;
+	return i && r ? t.push("[sequenceFiles]与[sequenceDirectory]二选一，不能同时填写（设置 sequenceDirectory 时 sequenceFiles 必须为空）") : i ? n.sequenceDirectory = "" : r ? (n.sequenceDirectory = n.sequenceDirectory.trim(), n.sequenceFiles = []) : t.push("[sequenceFiles]与[sequenceDirectory]二选一，必须填写其中一个（设置 sequenceDirectory 时 sequenceFiles 必须为空）"), t.push(...validateOptionalNumber({
+		normalized: n,
+		field: "frameIndex",
+		value: e.frameIndex,
+		defaultValue: 0,
+		min: 0
+	})), t.push(...validateOptionalNumber({
+		normalized: n,
+		field: "playbackSpeed",
+		value: e.playbackSpeed,
+		defaultValue: 1,
+		min: 0
+	})), typeof n.playbackSpeed == "number" && n.playbackSpeed <= 0 && t.push("[playbackSpeed]取值必须大于0"), validateOptionalCoordinates(e, t, n), t.push(...validateOptionalVector3Array({
+		normalized: n,
+		field: "rotation",
+		value: e.rotation,
+		defaultValue: [
+			0,
+			0,
+			0
+		]
+	})), t.push(...validateOptionalVector3Array({
+		normalized: n,
+		field: "scale",
+		value: e.scale,
+		defaultValue: [
+			1,
+			1,
+			1
+		]
+	})), {
+		errors: t,
+		normalized: n
+	};
+}
+function pauseSequence(e = {}) {
+	let t = [], n = { ...e };
+	return t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), {
+		errors: t,
+		normalized: n
+	};
+}
+function stopSequence(e = {}) {
+	let t = [], n = { ...e };
+	return t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), {
+		errors: t,
+		normalized: n
+	};
+}
+function setFrame(e = {}) {
+	let t = [], n = { ...e };
+	return t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), t.push(...validateOptionalNumber({
+		normalized: n,
+		field: "frameIndex",
+		value: e.frameIndex,
+		defaultValue: 0,
+		min: 0
+	})), {
+		errors: t,
+		normalized: n
+	};
+}
+function setPlaybackSpeed(e = {}) {
+	let t = [], n = { ...e };
+	return t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), t.push(...validateOptionalNumber({
+		normalized: n,
+		field: "playbackSpeed",
+		value: e.playbackSpeed,
+		defaultValue: 4,
+		min: 0
+	})), typeof n.playbackSpeed == "number" && n.playbackSpeed <= 0 && t.push("[playbackSpeed]取值必须大于0"), {
+		errors: t,
+		normalized: n
+	};
+}
+function clearSequence(e = {}) {
+	let t = [], n = { ...e };
+	return t.push(...validateRequiredString({
+		normalized: n,
+		field: "id",
+		value: e.id
+	})), validateOptionalBoolean(e, "isClearCache", !0, t, n), {
+		errors: t,
+		normalized: n
+	};
+}
+function clearAllSequence(e = {}) {
+	let t = [], n = { ...e };
+	return validateOptionalBoolean(e, "isClearCache", !0, t, n), {
+		errors: t,
+		normalized: n
+	};
+}
 //#endregion
 //#region ../api/vtk/vtkApi.js
 var validator = {
@@ -3447,7 +3601,14 @@ var validator = {
 	setDisplacementScale,
 	closeDisplacementScale,
 	onMouseClick,
-	offMouseClick
+	offMouseClick,
+	playSequence,
+	pauseSequence,
+	stopSequence,
+	setFrame,
+	setPlaybackSpeed,
+	clearSequence,
+	clearAllSequence
 }, VtkApi = class {
 	constructor(e) {
 		this.commandManager = e;