@nnepoch/dtc-sdk 3.0.0

package/docs/api/types/interfaces/WeatherOpenCameraFogRequest.md

@@ -0,0 +1,69 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherOpenCameraFogRequest
+
+# Interface: WeatherOpenCameraFogRequest
+
+WeatherSystem.openCameraFog 参数。
+
+## Properties
+
+### fogIntensity?
+
+> `optional` **fogIntensity**: `number`
+
+雾强度。
+
+***
+
+### fogStartColor?
+
+> `optional` **fogStartColor**: `string`
+
+雾近端颜色。
+
+***
+
+### fogEndColor?
+
+> `optional` **fogEndColor**: `string`
+
+雾远端颜色。
+
+***
+
+### fogStartDistance?
+
+> `optional` **fogStartDistance**: `number`
+
+雾起始距离。
+
+***
+
+### fogEndDistance?
+
+> `optional` **fogEndDistance**: `number`
+
+雾终止距离。
+
+***
+
+### directionalIntensity?
+
+> `optional` **directionalIntensity**: `number`
+
+方向光强度。
+
+***
+
+### directionalFallOff?
+
+> `optional` **directionalFallOff**: `number`
+
+方向光衰减。
+
+***
+
+### directionalColor?
+
+> `optional` **directionalColor**: `string`
+
+方向光颜色。

package/docs/api/types/interfaces/WeatherSetAnimateTimeOfDayRequest.md

@@ -0,0 +1,29 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherSetAnimateTimeOfDayRequest
+
+# Interface: WeatherSetAnimateTimeOfDayRequest
+
+WeatherSystem.setAnimateTimeOfDay 参数。
+
+## Properties
+
+### isAnimate?
+
+> `optional` **isAnimate**: `boolean`
+
+是否模拟白天，黑夜时间动画。
+
+***
+
+### dayLength?
+
+> `optional` **dayLength**: `number`
+
+白天持续时间（分）。 默认0.5分钟
+
+***
+
+### nightLength?
+
+> `optional` **nightLength**: `number`
+
+夜晚持续时间（分）。 默认0.5分钟

package/docs/api/types/interfaces/WeatherSetDayAndNightRequest.md

@@ -0,0 +1,13 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherSetDayAndNightRequest
+
+# Interface: WeatherSetDayAndNightRequest
+
+WeatherSystem.setDayAndNight 参数。
+
+## Properties
+
+### dayType
+
+> **dayType**: `string`
+
+日夜类型，如 day/night。

package/docs/api/types/interfaces/WeatherSetSceneTimeRequest.md

@@ -0,0 +1,21 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherSetSceneTimeRequest
+
+# Interface: WeatherSetSceneTimeRequest
+
+WeatherSystem.setSceneTime 参数。
+
+## Properties
+
+### hour
+
+> **hour**: `number`
+
+小时值。 0~24小时
+
+***
+
+### timeDuration?
+
+> `optional` **timeDuration**: `number`
+
+时间变化持续的时间（秒）。

package/docs/api/types/interfaces/WeatherSetTimeSyncRequest.md

@@ -0,0 +1,13 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherSetTimeSyncRequest
+
+# Interface: WeatherSetTimeSyncRequest
+
+WeatherSystem.setTimeSync 参数。
+
+## Properties
+
+### syncSystemTime?
+
+> `optional` **syncSystemTime**: `boolean`
+
+是否同步系统时间。

package/docs/api/types/interfaces/WeatherTypeRequest.md

@@ -0,0 +1,27 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / WeatherTypeRequest
+
+# Interface: WeatherTypeRequest
+
+WeatherSystem.changeWeatherType 参数。
+
+## Properties
+
+### type
+
+> **type**: `number`
+
+天气类型名称。
+
+***
+
+### timeDuration
+
+> **timeDuration**: `number`
+
+天气类型持续时间（秒）。
+
+***
+
+### test?
+
+> `optional` **test**: `string`

package/docs/api/types/type-aliases/ApiCallback.md

@@ -0,0 +1,21 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / ApiCallback
+
+# Type Alias: ApiCallback()\<T\>
+
+> **ApiCallback**\<`T`\> = (`result`) => `void`
+
+## Type Parameters
+
+| Type Parameter |
+| ------ |
+| `T` |
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `result` | `T` |
+
+## Returns
+
+`void`

package/docs/api/types/type-aliases/AuthWorkflowState.md

@@ -0,0 +1,5 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / AuthWorkflowState
+
+# Type Alias: AuthWorkflowState
+
+> **AuthWorkflowState** = `"idle"` \| `"centerConnecting"` \| `"centerConnected"` \| `"serviceAllocating"` \| `"waiting"` \| `"authorizing"` \| `"webrtcConnecting"` \| `"connected"` \| `"failed"`

package/docs/api/types/type-aliases/DlssQuality.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / DlssQuality
+
+# Type Alias: DlssQuality
+
+> **DlssQuality** = *typeof* [`DlssQuality`](../variables/DlssQuality.md)\[keyof *typeof* [`DlssQuality`](../variables/DlssQuality.md)\]
+
+Dlss.setDlssQuality 参数。

package/docs/api/types/type-aliases/EngineLogLevel.md

@@ -0,0 +1,5 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / EngineLogLevel
+
+# Type Alias: EngineLogLevel
+
+> **EngineLogLevel** = `"silent"` \| `"error"` \| `"warn"` \| `"info"` \| `"debug"`

package/docs/api/types/type-aliases/EngineViewMode.md

@@ -0,0 +1,5 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / EngineViewMode
+
+# Type Alias: EngineViewMode
+
+> **EngineViewMode** = `"bs"` \| `"cs"`

package/docs/api/types/type-aliases/GetWeatherTypeRequest.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / GetWeatherTypeRequest
+
+# Type Alias: GetWeatherTypeRequest
+
+> **GetWeatherTypeRequest** = `Record`\<`string`, `never`\>
+
+WeatherSystem.changeWeatherType 参数。

package/docs/api/types/type-aliases/NetworkAdaptationActionType.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / NetworkAdaptationActionType
+
+# Type Alias: NetworkAdaptationActionType
+
+> **NetworkAdaptationActionType** = `"SetSceneRenderBitrate"` \| `"SetSceneFPS"` \| `"SetScreenResolution"`
+
+策略动作类型。

package/docs/api/types/type-aliases/NetworkAdaptationLevel.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / NetworkAdaptationLevel
+
+# Type Alias: NetworkAdaptationLevel
+
+> **NetworkAdaptationLevel** = `"Normal"` \| `"Mild"` \| `"Moderate"` \| `"Severe"` \| `"Recovering"`
+
+弱网自适应档位。

package/docs/api/types/type-aliases/NetworkAdaptationMode.md

@@ -0,0 +1,9 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / NetworkAdaptationMode
+
+# Type Alias: NetworkAdaptationMode
+
+> **NetworkAdaptationMode** = `"auto"` \| `"manual"`
+
+弱网自适应运行模式：
+- auto: 自动策略决策
+- manual: 手动接管档位

package/docs/api/types/type-aliases/QosEventName.md

@@ -0,0 +1,9 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / QosEventName
+
+# Type Alias: QosEventName
+
+> **QosEventName** = *typeof* [`QOS_EVENT_NAMES`](../variables/QOS_EVENT_NAMES.md)\[`number`\]
+
+QoS V1 事件名类型。
+
+注意：V1 明确不包含 `ue_request_timeout`。

package/docs/api/types/type-aliases/QosLevel.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / QosLevel
+
+# Type Alias: QosLevel
+
+> **QosLevel** = `"info"` \| `"warn"` \| `"error"`
+
+QoS 事件日志等级（仅用于事件严重程度标记）。

package/docs/api/types/type-aliases/QosStage.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / QosStage
+
+# Type Alias: QosStage
+
+> **QosStage** = `"auth"` \| `"center"` \| `"webrtc"` \| `"media"` \| `"ue_api"` \| `"session"`
+
+QoS 事件阶段定义。

package/docs/api/types/type-aliases/QosStatus.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / QosStatus
+
+# Type Alias: QosStatus
+
+> **QosStatus** = `"start"` \| `"success"` \| `"failed"` \| `"update"` \| `"end"`
+
+QoS 事件状态定义。

package/docs/api/types/type-aliases/ScreenRenderBitratePreset.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / ScreenRenderBitratePreset
+
+# Type Alias: ScreenRenderBitratePreset
+
+> **ScreenRenderBitratePreset** = *typeof* [`ScreenRenderBitratePreset`](../variables/ScreenRenderBitratePreset.md)\[keyof *typeof* [`ScreenRenderBitratePreset`](../variables/ScreenRenderBitratePreset.md)\]
+
+Screen.setSceneRenderBitrate 参数。

package/docs/api/types/type-aliases/Season.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / Season
+
+# Type Alias: Season
+
+> **Season** = *typeof* [`Season`](../variables/Season.md)\[keyof *typeof* [`Season`](../variables/Season.md)\]
+
+WeatherSystem.changeSeason 参数。

package/docs/api/types/type-aliases/Vector3Input.md

@@ -0,0 +1,5 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / Vector3Input
+
+# Type Alias: Vector3Input
+
+> **Vector3Input** = `Vector3` \| [`Vector3JsonInput`](../interfaces/Vector3JsonInput.md)

package/docs/api/types/variables/DlssQuality.md

@@ -0,0 +1,57 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / DlssQuality
+
+# Variable: DlssQuality
+
+> `const` **DlssQuality**: `object`
+
+Dlss.setDlssQuality 参数。
+
+## Type Declaration
+
+### Off
+
+> `readonly` **Off**: `0` = `0`
+
+关闭 DLSS。默认值。
+
+### Auto
+
+> `readonly` **Auto**: `1` = `1`
+
+Auto 模式会根据系统性能自动选择最合适的 DLSS 质量档位，提供更智能的画质与性能平衡方案。
+
+### DLAA
+
+> `readonly` **DLAA**: `2` = `2`
+
+2倍效果
+
+### UltraQuality
+
+> `readonly` **UltraQuality**: `3` = `3`
+
+超高质量。
+
+### Quality
+
+> `readonly` **Quality**: `4` = `4`
+
+高质量。
+
+### Balanced
+
+> `readonly` **Balanced**: `5` = `5`
+
+平衡。
+
+### Performance
+
+> `readonly` **Performance**: `6` = `6`
+
+性能。
+
+### UltraPerformance
+
+> `readonly` **UltraPerformance**: `7` = `7`
+
+超高性能。

package/docs/api/types/variables/QOS_EVENT_NAMES.md

@@ -0,0 +1,7 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / QOS\_EVENT\_NAMES
+
+# Variable: QOS\_EVENT\_NAMES
+
+> `const` **QOS\_EVENT\_NAMES**: readonly \[`"session_start"`, `"auth_start"`, `"auth_success"`, `"auth_failed"`, `"center_connect_start"`, `"center_connected"`, `"center_disconnected"`, `"center_message_received"`, `"webrtc_connect_start"`, `"webrtc_connected"`, `"webrtc_disconnected"`, `"first_frame_rendered"`, `"media_stats_sample"`, `"ue_request_sent"`, `"ue_response_received"`, `"session_end"`\]
+
+QoS V1 事件名集合。

package/docs/api/types/variables/ScreenRenderBitratePreset.md

@@ -0,0 +1,39 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / ScreenRenderBitratePreset
+
+# Variable: ScreenRenderBitratePreset
+
+> `const` **ScreenRenderBitratePreset**: `object`
+
+Screen.setSceneRenderBitrate 参数。
+
+## Type Declaration
+
+### Auto
+
+> `readonly` **Auto**: `"auto"` = `'auto'`
+
+自动。
+
+### Low
+
+> `readonly` **Low**: `"low"` = `'low'`
+
+标清。
+
+### High
+
+> `readonly` **High**: `"high"` = `'high'`
+
+高清。
+
+### Super
+
+> `readonly` **Super**: `"super"` = `'super'`
+
+超清。
+
+### Blue
+
+> `readonly` **Blue**: `"blue"` = `'blue'`
+
+蓝光。

package/docs/api/types/variables/ScreenRenderBitratePresetOptions.md

@@ -0,0 +1,5 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / ScreenRenderBitratePresetOptions
+
+# Variable: ScreenRenderBitratePresetOptions
+
+> `const` **ScreenRenderBitratePresetOptions**: readonly \[\{ `label`: `"自动"`; `type`: `"auto"`; `value`: `12000000`; \}, \{ `label`: `"标清"`; `type`: `"low"`; `value`: `4000000`; \}, \{ `label`: `"高清"`; `type`: `"high"`; `value`: `8000000`; \}, \{ `label`: `"超清"`; `type`: `"super"`; `value`: `12000000`; \}, \{ `label`: `"蓝光"`; `type`: `"blue"`; `value`: `24000000`; \}\]

package/docs/api/types/variables/ScreenRenderBitratePresetValueMap.md

@@ -0,0 +1,27 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / ScreenRenderBitratePresetValueMap
+
+# Variable: ScreenRenderBitratePresetValueMap
+
+> `const` **ScreenRenderBitratePresetValueMap**: `object`
+
+## Type Declaration
+
+### auto
+
+> `readonly` **auto**: `12000000` = `12000000`
+
+### low
+
+> `readonly` **low**: `4000000` = `4000000`
+
+### high
+
+> `readonly` **high**: `8000000` = `8000000`
+
+### super
+
+> `readonly` **super**: `12000000` = `12000000`
+
+### blue
+
+> `readonly` **blue**: `24000000` = `24000000`

package/docs/api/types/variables/Season.md

@@ -0,0 +1,33 @@
+[@nnepoch/dtc-sdk](../../index.md) / [types](../index.md) / Season
+
+# Variable: Season
+
+> `const` **Season**: `object`
+
+WeatherSystem.changeSeason 参数。
+
+## Type Declaration
+
+### Spring
+
+> `readonly` **Spring**: `0` = `0`
+
+春季。
+
+### Summer
+
+> `readonly` **Summer**: `1` = `1`
+
+夏季。
+
+### Autumn
+
+> `readonly` **Autumn**: `2` = `2`
+
+秋季。
+
+### Winter
+
+> `readonly` **Winter**: `3` = `3`
+
+冬季。

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@nnepoch/dtc-sdk",
+  "version": "3.0.0",
+  "description": "UE frontend SDK built on official Pixel Streaming frontend package",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.js",
+  "types": "dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "docs/api"
+  ],
+  "scripts": {
+    "changeset": "npx @changesets/cli",
+    "clean": "rimraf ./dist ./docs/api",
+    "watch": "tsdown --config tsdown.config.ts --filter library --watch",
+    "dev:browser": "tsdown --config tsdown.config.ts --filter browser --watch",
+    "playground": "vite --config playground/vite.config.ts",
+    "playground:dev": "vite --config playground/vite.config.ts",
+    "playground:build": "vite build --config playground/vite.config.ts",
+    "playground:preview": "vite preview --config playground/vite.config.ts",
+    "playground:vue:dev": "vite --config playground/vue/vite.config.ts",
+    "playground:vanilla:dev": "vite --config playground/vanilla/vite.config.ts",
+    "playground:hzjz:dev": "vite --config playground/hzjz/vite.config.ts",
+    "build": "pnpm run build:lib && pnpm run build:browser",
+    "rebuild": "pnpm run clean && pnpm run build",
+    "build:browser": "tsdown --config tsdown.config.ts --filter browser && node scripts/rename-browser-bundle.mjs && pnpm run build:obfuscate",
+    "build:obfuscate": "node scripts/obfuscate.mjs",
+    "build:lib": "tsc --noEmit --pretty false && pnpm exec tsdown --config tsdown.config.ts --filter library",
+    "build:release": "pnpm run rebuild && pnpm run docs:build",
+    "verify:build": "node scripts/verify-build.mjs",
+    "generate:agent-metadata": "node --import tsx scripts/extract-agent-metadata.mts",
+    "docs:api": "typedoc",
+    "docs": "pnpm run docs:api",
+    "docs:dev": "npm run docs:api && vitepress dev docs",
+    "docs:build": "npm run docs:api && vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "typecheck": "tsc --noEmit --pretty false",
+    "dev": "pnpm run watch",
+    "lint": "eslint src --ext .ts --ignore-pattern '**/*.test.ts' --ignore-pattern '**/*.spec.ts' --ignore-pattern '**/__tests__/**'",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@epicgames-ps/lib-pixelstreamingcommon-ue5.6": "^0.1.4",
+    "@epicgames-ps/lib-pixelstreamingfrontend-ue5.6": "^0.2.5",
+    "axios": "^1.13.6",
+    "pako": "^2.1.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.30.0",
+    "@eslint/js": "^9.39.1",
+    "@rollup/plugin-commonjs": "^28.0.8",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/node": "^24.9.1",
+    "@types/pako": "^2.0.4",
+    "@vitejs/plugin-vue": "^6.0.4",
+    "eslint": "^9.39.1",
+    "javascript-obfuscator": "^4.1.1",
+    "rimraf": "^6.0.1",
+    "rollup": "^4.50.1",
+    "tsdown": "^0.22.14",
+    "tslib": "^2.8.1",
+    "tsx": "^4.22.3",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.10.0",
+    "typedoc-vitepress-theme": "^1.1.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "unrun": "^0.3.1",
+    "vite": "7.3.1",
+    "vitepress": "2.0.0-alpha.16",
+    "vitest": "^4.0.3",
+    "vue": "^3.5.30"
+  }
+}