@ray-js/robot-map-sdk 0.0.8 → 0.0.9-beta.2

package/dist/index.d.ts

@@ -694,6 +694,7 @@ declare class AppService {
     get ticker(): Ticker;
     get mapState(): MapState_2 | null;
     get isMapDrawn(): boolean;
+    get config(): AppConfig;
     get gloalConfig(): {
         containerTop: string;
         containerLeft: string;
@@ -1071,6 +1072,10 @@ declare class Background extends Container {
      * 渲染图片背景
      */
     private renderImage;
+    /**
+     * 动态更新背景配置
+     */
+    update(config: AppConfig['global']): Promise<void>;
     /**
      * 销毁组件
      */
@@ -3035,6 +3040,90 @@ export declare interface MapApi {
      * 当小程序侧检测到 touchend 或其他需要强制结束手势的情况时调用。
      */
     forceEndGesture(): void;
+    /**
+     * 更新运行时配置
+     *
+     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
+     *
+     * @param runtime - 要更新的运行时配置
+     */
+    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
+    /**
+     * 动态更新静态配置
+     *
+     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
+     * 主要用于主题切换、颜色调整等场景。
+     *
+     * @param partialConfig - 部分配置对象，支持深度增量更新
+     *
+     * @example
+     * ```typescript
+     * // 切换背景颜色
+     * mapApp.updateConfig({
+     *   global: { backgroundColor: '#1a1a1a' }
+     * })
+     *
+     * // 切换房间颜色主题
+     * mapApp.updateConfig({
+     *   room: {
+     *     colors: {
+     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
+     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
+     *     }
+     *   }
+     * })
+     *
+     * // 更新路径样式
+     * mapApp.updateConfig({
+     *   path: {
+     *     commonPath: { color: '#00ff00', width: 0.8 }
+     *   }
+     * })
+     * ```
+     */
+    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
+    /**
+     * 更新运行时配置
+     *
+     * 动态更新地图应用的运行时配置，如显示设置、交互模式等。
+     *
+     * @param runtime - 要更新的运行时配置
+     */
+    updateRuntime(runtime: DeepPartialRuntimeConfig): void;
+    /**
+     * 动态更新静态配置
+     *
+     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
+     * 主要用于主题切换、颜色调整等场景。
+     *
+     * @param partialConfig - 部分配置对象，支持深度增量更新
+     *
+     * @example
+     * ```typescript
+     * // 切换背景颜色
+     * mapApp.updateConfig({
+     *   global: { backgroundColor: '#1a1a1a' }
+     * })
+     *
+     * // 切换房间颜色主题
+     * mapApp.updateConfig({
+     *   room: {
+     *     colors: {
+     *       active: ['#ff6b6b', '#4ecdc4', '#45b7d1', '#ffa07a'],
+     *       inactive: ['#ffcccb', '#b4f8c8', '#a0e7e5', '#ffdab9'],
+     *     }
+     *   }
+     * })
+     *
+     * // 更新路径样式
+     * mapApp.updateConfig({
+     *   path: {
+     *     commonPath: { color: '#00ff00', width: 0.8 }
+     *   }
+     * })
+     * ```
+     */
+    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
     /**
      * 获取当前地图上所有禁扫区域数据
      *
@@ -3515,6 +3604,15 @@ declare class MapApplication extends Application implements MapApi {
      * @param runtime - 要更新的运行时配置
      */
     updateRuntime(runtime: DeepPartialRuntimeConfig): void;
+    /**
+     * 动态更新静态配置
+     *
+     * 支持增量更新配置对象，配置变化会自动通知订阅的组件进行重绘。
+     * 主要用于主题切换、颜色调整等场景。
+     *
+     * @param partialConfig - 部分配置对象，支持深度增量更新
+     */
+    updateConfig(partialConfig: DeepPartial<AppConfig>): void;
     /**
      * 将米转换为像素
      *
@@ -4464,6 +4562,7 @@ declare class Path extends Container {
     private isRealTimeDrawing;
     private throttledUpdateLineWidth;
     private throttledHandleRobotPosition;
+    private unsubscribeFns;
     constructor(appService: AppService);
     /**
      * 注册事件监听
@@ -4884,6 +4983,7 @@ declare class RoomFill extends Container {
     private unsubscribeFns;
     private mapWidth;
     private rasterRoomDataMap;
+    private structuredRoomGeometry;
     constructor(appService: AppService);
     /**
      * 绘制结构化协议地图房间
@@ -4975,6 +5075,10 @@ declare class RoomFill extends Container {
      * 获取矩形覆盖的像素点索引
      */
     private getZonePixels;
+    /**
+     * 刷新所有房间的颜色（不重新计算几何）
+     */
+    private refreshRoomColors;
     /**
      * 清除所有房间
      */