@realsee/dnalogel

import type { Tag, TagId, Tags, State, ContentTypeConfigKey } from '../typings'; import type { TagClickParams, TagConfigByKey, TagContentType } from '..'; import type { ArrayPosition } from '../typings'; import type { Five } from '@realsee/five'; import { TagRender } from './TagRender'; import type { PartialObjectDeep } from '../../typings/typings'; export declare const pluginFlag: (name: string) => string; declare class PanoTagPluginController extends TagRender { /** state */ state: { enabled: boolean; visible: boolean; }; /** debug */ private debug; private debugUtil; /** 全局 hover 启用状态，默认 true */ globalHoverEnabled: boolean; constructor(five: Five, params?: { config?: Pick<Tags, 'contentTypeConfig' | 'globalConfig'>; debug?: boolean; containerZIndex?: number; }); appendTo(wrapper: Element): void; /** * @description 加载数据 */ load(data: Tags): Promise<void>; /** * @description 添加标签 * @param tag 标签或标签数组 * @param options 可选配置 * @param options.updateMaskUrl 是否更新 mask。若为 true 且该 panoIndex 已有 Mask 标签，仅更新其 maskUrl（不变 color、style），并添加新标签 */ addTag(tag: Tag | Tag[], options?: { updateMaskUrl?: boolean; }): Promise<void>; /** * @description 改变配置 */ changeConfig(config: Pick<Tags, 'globalConfig' | 'contentTypeConfig'>, merge?: boolean): void; /** * @description 改变全局配置 */ changeGlobalConfig(globalConfig: Tags['globalConfig'], merge?: boolean): void; /** * @description 改变类型配置 */ changeContentTypeConfig<T extends ContentTypeConfigKey>(key: T, contentTypeConfig: TagConfigByKey<T>, merge?: boolean): void; show(params?: { userAction?: boolean; }): Promise<void>; hide(params?: { userAction?: boolean; }): Promise<void>; enable(params?: { userAction?: boolean; }): void; disable(params?: { userAction?: boolean; }): void; setState(state: Partial<State>, params?: { userAction?: boolean; }): void; /** * @description 销毁 */ dispose(): void; /** * @description 闪烁标签 * @param {TagId} id * @param {Partial<anime.AnimeParams>} animeConfig */ blinkTagById(id: TagId, animeConfig?: Partial<anime.AnimeParams>): Promise<void>; /** * @description 展开/收起指定id的标签 * @param {TagId} id * @param {boolean} unfolded */ changeUnfoldedById(id: TagId, unfolded: boolean): void; /** * @description 启用/停用指定id的标签 * @param {TagId} id * @param {boolean} enabled */ changeEnabledById(id: TagId, enabled: boolean): void; /** * @description 修改3D标签normal * @param {TagId} id * @param {ArrayPosition} normal */ changeTagNormalById(id: TagId, normal: ArrayPosition): void; /** * @description 改变data */ changePositionById(id: TagId, position: Tag['position']): void; /** * @description 改变data */ changeDataById<C extends TagContentType = TagContentType>(id: TagId, data: PartialObjectDeep<Tag<C>['data']>, deepMerge?: boolean): void; /** * @description 改变tag的stickType */ changeStickTypeById<C extends TagContentType = TagContentType>(id: TagId, data: PartialObjectDeep<{ [P in keyof Pick<Tag<C>, 'stickType' | 'position' | 'normal' | 'data'>]: Tag[P]; }>, deepMerge?: boolean): void; /** * @description 改变tag任意属性 */ changeTagById<C extends TagContentType = TagContentType>(id: TagId, tag: PartialObjectDeep<Tag<C>>, deepMerge?: boolean): void; /** * @description 批量更新指定点位的 Mask 图 * @param maskUpdates 包含点位索引和对应 mask 的数组 * @example * changeMask([ * { index: 0, mask: 'https://example.com/mask1.png' }, * { index: 1, mask: canvasElement } * ]) */ changeMask(maskUpdates: Array<{ index: number; mask: string | HTMLCanvasElement; }>): void; /** * @description 销毁tag */ destroyTagById(id: TagId | TagId[]): void; /** 更改 tag 模型 */ changeTagModel: (tag: any, data: PartialObjectDeep<Tag<'MediaModel'>['data']>) => Promise<void>; /** * @deprecated */ updateRenderAllTags(): void; /** * @description 清除所有标签 */ clearTags(): void; /** * @description 设置 unfolded */ private setUnfolded; private handleShow; private handleHide; private handleEnable; private handleDisable; private addResizeListener; private addResizeObserver; private handleFiveModeChange; private handleFiveWantsMoveToPano; clickhandler: (params: TagClickParams) => void; private handleFiveCameraUpdate; private handleFiveCameraFovUpdate; private handleFivePanoArrived; /** 楼层切换时，需要更新标签可见性 */ private handleFiveModelShownFloorChange; private onFiveRefined; private onFiveEveryReady; private setUnfoldedByCamera; private changeTagMode; /** * @description 添加 cameraUpdate, panoArrived 等事件监听 */ private addEventListener; render: () => void; /** * @description 设置标签 hover 启用状态 */ setTagHoverEnabled(id: TagId, enabled: boolean): void; /** * @description 获取标签 hover 启用状态 */ getTagHoverEnabled(id: TagId): boolean | undefined; /** * 设置全局 hover 启用状态 */ setGlobalHoverEnabled(enabled: boolean): void; /** * 获取全局 hover 启用状态 */ getGlobalHoverEnabled(): boolean; /** * 验证 ArrayPosition 是否为有效格式 * @param value 待验证的值 * @returns 是否为有效的 ArrayPosition */ private isValidArrayPosition; /** * 更新当前点位的 Mask 标签 * Mask 标签仅在当前点位可见 */ private updateMaskTagsForCurrentPano; /** * 获取所有 Mask 类型的标签 */ get filterMaskTag(): (import("./Tag/BaseTag").BaseTag<"Panorama" | "Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", import("..").StickType> & { [key: string]: any; })[]; /** * 获取 MaskTag 性能统计信息（用于性能监控和调试） * @returns 性能统计信息 */ getMaskTagPerformanceStats(): { totalMaskTags: number; visibleMaskTags: number; textureCache: { totalCached: number; totalRefCount: number; estimatedMemoryMB: number; cacheEntries: { source: string; refCount: number; sizeMB: number; }[]; }; currentPanoIndex: number; }; /** * 清理所有 MaskTag 纹理缓存（用于内存管理） * 注意：这会释放所有纹理缓存，谨慎使用 */ clearMaskTagCache(): void; } export default PanoTagPluginController; export { PanoTagPluginController };