iflow-engine-base 3.9.18 → 3.9.21

package/dist/index.d.ts

@@ -1611,6 +1611,14 @@ declare class EngineKernel2d {
         enableChunkedLoading?: boolean;
         enableValidation?: boolean;
     }): Promise<{}>;
+    /**
+     * 通过 viewToken 向 OpenAPI 解析真实加载地址，再复用现有 2D URL 加载逻辑。
+     */
+    loadModelByViewToken(viewToken: string, options?: {
+        chunkSize?: number;
+        enableChunkedLoading?: boolean;
+        enableValidation?: boolean;
+    }): Promise<{}>;
     /** 获取当前 2D 图纸中可切换的布局空间列表。 */
     getLayouts(): LoadedLayoutSpace2d[];
     /** 获取当前激活的工作空间，供外部状态栏或自定义 UI 同步显示。 */
@@ -1744,6 +1752,7 @@ declare class EngineKernel2d {
  * 提供 720° 全景图查看和标注功能
  */
 declare class EngineKernel720 {
+    private readonly options;
     sceneModule: SceneModule720;
     cameraModule: CameraModule720;
     renderModule: RenderModule720;
@@ -1768,6 +1777,10 @@ declare class EngineKernel720 {
      * @param imageUrl 全景图 URL（png, jpg）
      */
     loadPanorama(imageUrl: string): Promise<void>;
+    /**
+     * 通过 viewToken 解析全景资源地址，再复用现有全景加载逻辑。
+     */
+    loadPanoramaByViewToken(viewToken: string): Promise<void>;
     /**
      * 预加载多个全景图
      * @param urls 全景图 URL 数组
@@ -1885,10 +1898,15 @@ declare class EngineKernelGaussian {
     controlModule: ControlModuleGaussian;
     loaderModule: LoaderModuleGaussian;
     private isInitialized;
+    private readonly options;
     private readonly version;
     constructor(options: EngineGaussianOptions);
     private initialize;
     loadModel(url: string, options?: GaussianSceneOptions): Promise<GaussianSceneInfo>;
+    /**
+     * 通过 viewToken 解析 Gaussian 资源地址，再复用现有 URL 加载逻辑。
+     */
+    loadModelByViewToken(viewToken: string, options?: GaussianSceneOptions): Promise<GaussianSceneInfo>;
     unloadModel(id: string): Promise<void>;
     setOrientationPreset(preset: GaussianOrientationPreset): void;
     getOrientationPreset(): GaussianOrientationPreset;
@@ -1909,6 +1927,7 @@ declare class EngineKernelGaussian {
  * 当前默认封装 Cesium Viewer，提供基础地图查看和相机控制能力。
  */
 export declare class EngineKernelGIS {
+    private readonly options;
     eventModule: EventModuleGIS;
     viewerModule: ViewerModuleGIS;
     modelManager: ModelLoadManagerGIS;
@@ -1976,6 +1995,31 @@ export declare class EngineKernelGIS {
      * 加载 GeoJSON 数据。
      */
     loadGeoJson(options: GISGeoJsonLoadOptions): Promise<GISLoadedModel>;
+    /**
+     * 通过 viewToken 解析 GIS 模型地址，并按返回格式复用现有 GIS 加载能力。
+     */
+    loadModelByViewToken(viewToken: string, options?: Omit<GIS3DTilesLoadOptions, 'url'>): Promise<GISLoadedModel>;
+    /**
+     * GIS 场景本身没有单一模型 URL，resolve 返回的 info 会携带子模型清单与定位信息。
+     */
+    private loadGisSceneByResolvedInfo;
+    /**
+     * 只接受标准 GIS 场景 info 结构；旧数据缺失时继续走单模型 URL 回退逻辑。
+     */
+    private parseResolvedGisSceneInfo;
+    private hasResolvedSceneSource;
+    private loadResolvedGisSceneModel;
+    private applyResolvedSceneCalibration;
+    private createResolvedSceneCalibrationOptions;
+    private getTilesetCartographicBySource;
+    private normalizeResolvedModelType;
+    private resolveSceneModelUrl;
+    private resolveTilesetSceneUrl;
+    private resolveResolvedModelPosition;
+    private normalizeSceneRotation;
+    private toResolvedModelId;
+    private toResolvedModelName;
+    private toFiniteNumber;
     /**
      * 移除指定模型。
      */
@@ -2127,6 +2171,10 @@ declare class EngineKernelV2 {
     private container;
     constructor(options: any);
     updateVersionDisplay(): void;
+    /**
+     * 通过 viewToken 解析 3D 模型地址，再复用现有 loaderModule URL 加载逻辑。
+     */
+    loadModelByViewToken(viewToken: string, options?: any): Promise<void>;
     /**
      * 对指定 url 的 3D 模型应用整体校准矩阵。
      */
@@ -6164,6 +6212,31 @@ declare class SceneModuleGaussian {
     dispose(): void;
 }
 
+export declare interface SdkAuthOptions {
+    endpoint: string;
+    token?: string;
+    appId?: string;
+    appKey?: string;
+    appSecret?: string;
+    origin?: string;
+    product?: string;
+    timeoutMs?: number;
+}
+
+export declare type SdkEngineType = '3d' | '2d' | '720' | 'gis' | 'gaussian';
+
+export declare interface SdkVerifySession {
+    authorized: boolean;
+    expiresIn: number;
+    sdkToken?: string;
+    appId: string;
+    applicationId: number;
+    teamId: number;
+    engineType: string;
+    origin?: string;
+    enginePermissions: string[];
+}
+
 /** 可被右键搜索面板检索的文字实体索引。 */
 declare interface SearchableText2d {
     id: string;
@@ -6623,7 +6696,7 @@ declare class ViewerModuleGIS {
     private normalizeImageryMaximumLevel;
     /**
      * 配置 Cesium 静态资源目录。
-     * Vite 开发环境未配置时会把 Assets/*.json 回退成 index.html，导致 JSON 解析失败。
+     * 默认从 SDK 打包产物同级的 Cesium/ 目录解析，避免依赖业务项目的 /node_modules 路径。
      */
     private configureCesiumBaseUrl;
     /**