@ray-js/robot-map-sdk 0.0.6-beta.9 → 0.0.6

package/dist/index.d.ts

@@ -2,6 +2,8 @@ import { AnimatedSprite } from 'pixi.js';
 import { AppContainer as AppContainer_2 } from './AppContainer';
 import { Application } from 'pixi.js';
 import { ApplicationOptions } from 'pixi.js';
+import { BackgroundGradient as BackgroundGradient_2 } from '..';
+import { BackgroundImage as BackgroundImage_2 } from '..';
 import { ColorSource } from 'pixi.js';
 import { Container } from 'pixi.js';
 import { ControlsConfig as ControlsConfig_2 } from '..';
@@ -55,9 +57,17 @@ export declare type AppConfig = {
         containerWidth: string
         /** 容器高度 */
         containerHeight: string
-        /** 背景颜色 */
-        backgroundColor: ColorSource
-        /** 背景透明度 */
+        /** 背景颜色（优先级最低） */
+        backgroundColor?: ColorSource
+        /** 渐变背景配置（优先级中等，优先于backgroundColor） */
+        backgroundGradient?: BackgroundGradient
+        /** 图片背景配置（优先级最高） */
+        backgroundImage?: BackgroundImage
+        /**
+         * 背景透明度
+         * 注意：仅对纯色背景 (backgroundColor) 和图片背景 (backgroundImage) 有效。
+         * 对于渐变背景，请在 colorStops 中使用 rgba 颜色。
+         */
         backgroundAlpha: number
         /** 是否启用高性能模式（强制关闭抗锯齿等） */
         performanceMode: boolean
@@ -123,10 +133,20 @@ export declare type AppConfig = {
             active: string[]
             /** 非激活状态颜色 */
             inactive: string[]
+            /** 普通状态颜色（非选择模式下使用） */
+            normal?: string[]
             /** 房间名称颜色 */
             name: string[]
+            /** 房间名称非激活状态颜色 */
+            nameInactive?: string[]
+            /** 房间名称普通状态颜色（非选择模式下使用） */
+            nameNormal?: string[]
             /** 属性主题颜色 */
             propertyTheme: string[]
+            /** 属性主题非激活状态颜色 */
+            propertyThemeInactive?: string[]
+            /** 属性主题普通状态颜色（非选择模式下使用） */
+            propertyThemeNormal?: string[]
             /** 选择指示器背景颜色 */
             selectionIndicatorBackground: string[]
             /** 选择指示器图标颜色 */
@@ -140,7 +160,7 @@ export declare type AppConfig = {
             /** 未知房间特殊颜色 */
             [SPECIAL_ROOM_IDS.UNKNOWN_ROOM]: string
             /** 不稳定房间特殊颜色（建图中） */
-            [SPECIAL_ROOM_IDS.UNSTABLE_ROOM]: string
+            [SPECIAL_ROOM_IDS.VERSION0_ROOM]: string
         }
         /** 房间名称配置 */
         nameLabel: {
@@ -151,6 +171,26 @@ export declare type AppConfig = {
             /** 字体粗细 */
             fontWeight: TextStyleFontWeight
         }
+        /** 房间类型配置 */
+        type: {
+            /** 房间图标资源数组 */
+            assets: string[]
+            /** 图标大小 */
+            iconSize: number
+            /** 图标与文字间距 */
+            gap: number
+            /** 图标显示位置 */
+            position: 'left' | 'right'
+            /** 容器样式 */
+            container: {
+                /** 是否显示背景容器 */
+                visible: boolean
+                /** 容器大小 */
+                size: number
+                /** 边框圆角 */
+                borderRadius: number
+            }
+        }
         /** 房间属性配置 */
         property: {
             /** 显示顺序（支持内置字段和自定义字段名） */
@@ -332,6 +372,23 @@ export declare type AppConfig = {
             /** 宽度 */
             width: number
         }
+        /** 拖地路径配置 */
+        mopPath: {
+            /** 核心线是否可见 */
+            lineVisible: boolean
+            /** 核心线颜色 */
+            lineColor: ColorSource
+            /** 核心线宽度 */
+            lineWidth: number
+            /** 轨迹是否可见 */
+            trackVisible: boolean
+            /** 轨迹颜色 */
+            trackColor: ColorSource
+            /** 轨迹透明度 */
+            trackAlpha: number
+            /** 轨迹宽度 */
+            trackWidth: number
+        }
     }
 
     /** 地毯配置 */
@@ -642,7 +699,9 @@ declare class AppService {
         containerLeft: string;
         containerWidth: string;
         containerHeight: string;
-        backgroundColor: ColorSource;
+        backgroundColor?: ColorSource;
+        backgroundGradient?: BackgroundGradient_2;
+        backgroundImage?: BackgroundImage_2;
         backgroundAlpha: number;
         performanceMode: boolean;
         resolution: number;
@@ -667,21 +726,37 @@ declare class AppService {
             strategy: "priority" | "balanced";
             active: string[];
             inactive: string[];
+            normal?: string[];
             name: string[];
+            nameInactive?: string[];
+            nameNormal?: string[];
             propertyTheme: string[];
+            propertyThemeInactive?: string[];
+            propertyThemeNormal?: string[];
             selectionIndicatorBackground: string[];
             selectionIndicatorIcon: string[];
             NO_ROOM_DATA: string;
             ROOM_GAP: string;
             OBSTACLE_ROOM: string;
             UNKNOWN_ROOM: string;
-            UNSTABLE_ROOM: string;
+            VERSION0_ROOM: string;
         };
         nameLabel: {
             fontSize: number;
             fontFamily: string;
             fontWeight: TextStyleFontWeight;
         };
+        type: {
+            assets: string[];
+            iconSize: number;
+            gap: number;
+            position: "left" | "right";
+            container: {
+                visible: boolean;
+                size: number;
+                borderRadius: number;
+            };
+        };
         property: {
             displayOrders: ("cleanMode" | "suction" | "cistern" | "cleanTimes" | string)[];
             iconWidth: number;
@@ -768,6 +843,15 @@ declare class AppService {
             color: ColorSource;
             width: number;
         };
+        mopPath: {
+            lineVisible: boolean;
+            lineColor: ColorSource;
+            lineWidth: number;
+            trackVisible: boolean;
+            trackColor: ColorSource;
+            trackAlpha: number;
+            trackWidth: number;
+        };
     };
     get carpetConfig(): {
         src: string;
@@ -879,6 +963,7 @@ declare class AppService {
         readonly roomPropertyFoldIds: readonly number[];
         readonly roomSelectionMode: "checkmark" | "order";
         readonly showRoomName: boolean;
+        readonly showRoomType: boolean;
         readonly unit: MeasurementUnit_2;
         readonly unitLabel: string;
         readonly showRoomProperty: boolean;
@@ -951,6 +1036,85 @@ declare class AppService {
     } | null;
 }
 
+/**
+ * 背景组件
+ * 支持纯色背景、渐变背景和图片背景
+ * 优先级：图片背景 > 渐变背景 > 纯色背景
+ */
+declare class Background extends Container {
+    private graphics;
+    private sprite;
+    private viewportBounds;
+    private lastConfig;
+    private onImageLoaded?;
+    constructor(config: AppConfig['global'], viewportBounds: {
+        width: number;
+        height: number;
+    }, onImageLoaded?: () => void);
+    /**
+     * 渲染背景（根据优先级）
+     */
+    private render;
+    /**
+     * 清空背景内容
+     */
+    private clear;
+    /**
+     * 渲染纯色背景
+     */
+    private renderSolidColor;
+    /**
+     * 渲染渐变背景
+     */
+    private renderGradient;
+    /**
+     * 渲染图片背景
+     */
+    private renderImage;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}
+
+/**
+ * 渐变背景配置
+ */
+export declare type BackgroundGradient = {
+    /** 渐变类型 */
+    type: 'linear' | 'radial'
+    /** 线性渐变起点x (相对于视口宽度，0-1) */
+    x0?: number
+    /** 线性渐变起点y (相对于视口高度，0-1) */
+    y0?: number
+    /** 线性渐变终点x (相对于视口宽度，0-1) */
+    x1?: number
+    /** 线性渐变终点y (相对于视口高度，0-1) */
+    y1?: number
+    /** 径向渐变中心x (相对于视口宽度，0-1) */
+    cx?: number
+    /** 径向渐变中心y (相对于视口高度，0-1) */
+    cy?: number
+    /** 径向渐变半径 (相对于视口对角线长度，0-1) */
+    r?: number
+    /** 渐变色停靠点 */
+    colorStops: Array<{ offset: number; color: ColorSource }>
+}
+
+/**
+ * 图片背景配置
+ */
+export declare type BackgroundImage = {
+    /** 图片URL */
+    src: string
+    /** 图片适应模式，默认'cover' */
+    fit?: 'fill' | 'contain' | 'cover' | 'none'
+    /** 图片位置（x, y为相对于视口的比例，0-1），默认居中(0.5, 0.5) */
+    position?: { x: number; y: number }
+    /** 是否重复平铺，默认false */
+    repeat?: boolean
+}
+
 declare abstract class BaseControlButton<T extends BaseControlButtonOptions = BaseControlButtonOptions> extends FixedSizeContainer {
     protected appService: AppService;
     protected background: Graphics;
@@ -1164,6 +1328,7 @@ export declare type ComponentPropsApp = {
 /** 组件类型定义 */
 declare type Components = {
     viewportContainer: ViewportContainer;
+    background: Background;
     appContainer: AppContainer;
     interaction: Interaction_2;
 };
@@ -4290,6 +4455,8 @@ declare class Path extends Container {
     private chargePath;
     private transitionsPath;
     private mopPath;
+    private mopPathTrack;
+    private mopPathTrackContainer;
     private debugPoints;
     private pathData;
     private lastPointCount;
@@ -4844,6 +5011,10 @@ declare class RoomManager_2 {
      * 更新特定房间的名称
      */
     updateRoomName(roomId: number, name: string): void;
+    /**
+     * 更新特定房间的类型
+     */
+    updateRoomType(roomId: number, type: number | null): Promise<void>;
     /**
      * 更新特定房间的位置
      */
@@ -4869,10 +5040,18 @@ declare class RoomManager_2 {
      * 更新所有房间名称的可见性
      */
     private updateAllRoomNameVisibility;
+    /**
+     * 更新所有房间类型图标的可见性
+     */
+    private updateAllRoomTypeVisibility;
     /**
      * 更新所有房间选择指示器的可见性
      */
     private updateAllRoomSelectionIndicatorVisibility;
+    /**
+     * 刷新所有房间颜色
+     */
+    private refreshAllRoomColors;
     /**
      * 更新地板材质
      * 在房间几何数据或属性数据更新后调用
@@ -4918,6 +5097,8 @@ export declare type RoomProperty = {
     floorType: number
     /** 拖地模式 */
     yMop: number
+    /** 房间类型 */
+    type?: number | null
     /** 自定义数据 */
 
     customData?: Record<string, any>
@@ -4963,6 +5144,8 @@ export declare type RuntimeConfig = {
     roomSelectionMode: 'checkmark' | 'order'
     /** 是否显示房间名称 */
     showRoomName: boolean
+    /** 是否显示房间类型图标 */
+    showRoomType: boolean
     /** 测量单位 */
     unit: MeasurementUnit
     /** 单位标签 */