Class PanoTagPluginController

Hierarchy

TagRender
- PanoTagPluginController

Constructors

constructor

new PanoTagPluginController(five, params?): PanoTagPluginController
Parameters
- five: Five
- Optional params: {
  config?: Pick<Tags, "globalConfig" | "contentTypeConfig">;
  debug?: boolean;
  }
  - Optional config?: Pick<Tags, "globalConfig" | "contentTypeConfig">
  - Optional debug?: boolean
Returns PanoTagPluginController
Overrides TagRender.constructor
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:41

Properties

`Readonly` VERSION

VERSION: string = __DNALOGEL_VERSION__

@realsee/dnalogel 版本号

config

config: Pick<Tags, "globalConfig" | "contentTypeConfig"> = DefaultConfig

five

five: Five

hooks

hooks: Subscribe<EventMap> = ...

插件事件钩子

state

state: {
enabled: boolean;
visible: boolean;
} = ...

state

Type declaration

enabled: boolean
visible: boolean

`Readonly` staticPrefix

staticPrefix: string = '//vrlab-static.ljcdn.com'

Methods

addTag

addTag(tag, paramsConfig?): Promise<void>
@description: 添加标签
Parameters
- tag: Tag | Tag[]
- Optional paramsConfig: AddTagConfig
Returns Promise<void>
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:90

`Optional` appendTo

appendTo(wrapper): void
插件自身DOM添加到父容器
Parameters
- wrapper: Element
Returns void
Inherited from TagRender.appendTo
- Defined in plugins/src/base/BasePlugin.ts:103

changeConfig

changeConfig(config, merge?): void
@description: 改变配置
Parameters
- config: Pick<Tags, "globalConfig" | "contentTypeConfig">
- merge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:146

changeContentTypeConfig

changeContentTypeConfig<T>(key, contentTypeConfig, merge?): void
@description: 改变类型配置
Type Parameters
- T extends ContentTypeConfigKey
Parameters
- key: ContentTypeConfigKey
- contentTypeConfig: PickTagContentTypeInContentTypeConfigKey<T> extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
  ? TagConfig<Object>
  : unknown
- merge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:174

changeDataById

changeDataById<C>(id, data, deepMerge?): void
@description: 改变data
Type Parameters
- C extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown" = "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
Parameters
- id: TagId
- data: PartialObjectDeep<C extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
      ? ContentTypeMap[C]
      : {
          action?: {
              type: "iframe" | "window" | "custom";
              url?: string;
          };
          matrix?: number[];
          modelUrl: string;
      } & {
          extraData?: Object;
      } | {
          mediaData: Object[];
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          icon?: TagIconUrl;
          linkType?: "normal" | "vr";
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          appearance?: "line" | "plane";
          audioUrl: string;
          text?: string;
          theme?: "light" | "dark";
          title?: string;
      } & {
          extraData?: Object;
      } | {
          appearance?: "line" | "plane";
          description?: string;
          edit?: {
              description?: {
                  inputting?: boolean;
                  placeholder?: string;
              };
              title?: {
                  inputting?: boolean;
                  placeholder?: string;
              };
          };
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          brandTags?: string[];
          headerPictureUrl?: string;
          highlightText?: string;
          limitWidth?: number | boolean;
          price?: {
              unit: string;
              value: string | number;
          };
          tags?: string[];
          theme?: "light" | "dark";
          title: string;
      } & {
          extraData?: Object;
      } | {
          autoplayConfig?: {
              autoplayCarousel?: boolean;
              autoplayVideo?: boolean;
              autoplayVideoInCarousel?: boolean;
          };
          enableCarousel?: boolean;
          mediaData: MediaData[];
          objectFit?: ObjectFit;
          playIcon?: string;
      } & DeprecatedMediaPlaneProperty & {
          extraData?: Object;
      } | {
          action?: {
              type: "iframe" | "window";
              url: string;
          };
          matrix?: number[];
          mediaData: MediaData[];
          mediaPosition: [ArrayPosition, ArrayPosition, ArrayPosition, ArrayPosition];
          modelUrl: string;
          objectFit?: ObjectFit;
      } & {
          extraData?: Object;
      } | Object & {
          extraData?: Object;
      }>
- deepMerge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:295

changeEnabledById

changeEnabledById(id, enabled): void
Parameters
- id: TagId
- enabled: boolean
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:275

changeGlobalConfig

changeGlobalConfig(globalConfig, merge?): void
@description: 改变全局配置
Parameters
- globalConfig: TagConfig<"Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown">
- merge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:160

changeStickTypeById

changeStickTypeById<C>(id, data, deepMerge?): void
@description: 改变tag的stickType
Type Parameters
- C extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown" = "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
Parameters
- id: TagId
- data: PartialObjectDeep<{
      data: {
          action?: {
              type: "iframe" | "window" | "custom";
              url?: string;
          };
          matrix?: number[];
          modelUrl: string;
      } & {
          extraData?: Object;
      } | {
          mediaData: Object[];
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          icon?: TagIconUrl;
          linkType?: "normal" | "vr";
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          appearance?: "line" | "plane";
          audioUrl: string;
          text?: string;
          theme?: "light" | "dark";
          title?: string;
      } & {
          extraData?: Object;
      } | {
          appearance?: "line" | "plane";
          description?: string;
          edit?: {
              description?: {
                  inputting?: boolean;
                  placeholder?: string;
              };
              title?: {
                  inputting?: boolean;
                  placeholder?: string;
              };
          };
          text?: string;
          title?: string;
      } & {
          extraData?: Object;
      } | {
          brandTags?: string[];
          headerPictureUrl?: string;
          highlightText?: string;
          limitWidth?: number | boolean;
          price?: {
              unit: string;
              value: string | number;
          };
          tags?: string[];
          theme?: "light" | "dark";
          title: string;
      } & {
          extraData?: Object;
      } | {
          autoplayConfig?: {
              autoplayCarousel?: boolean;
              autoplayVideo?: boolean;
              autoplayVideoInCarousel?: boolean;
          };
          enableCarousel?: boolean;
          mediaData: MediaData[];
          objectFit?: ObjectFit;
          playIcon?: string;
      } & DeprecatedMediaPlaneProperty & {
          extraData?: Object;
      } | {
          action?: {
              type: "iframe" | "window";
              url: string;
          };
          matrix?: number[];
          mediaData: MediaData[];
          mediaPosition: [ArrayPosition, ArrayPosition, ArrayPosition, ArrayPosition];
          modelUrl: string;
          objectFit?: ObjectFit;
      } & {
          extraData?: Object;
      } | Object & {
          extraData?: Object;
      };
      normal?: ArrayPosition;
      position: ArrayPosition | [ArrayPosition, ArrayPosition, ArrayPosition, ArrayPosition];
      stickType: StickType;
  }>
- deepMerge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:316

changeTagById

changeTagById<C>(id, tag, deepMerge?): void
@description: 改变tag任意属性
Type Parameters
- C extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown" = "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
Parameters
- id: TagId
- tag: PartialObjectDeep<Tag<C>>
- deepMerge: boolean = true
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:327

changeTagModel

changeTagModel(tag, data): Promise<void>
更改 tag 模型
Parameters
- tag: TagInstance<"Model", "Model"> | TagInstance<"MediaModel", "Model">
- data: PartialObjectDeep<{
      action?: {
          type: "iframe" | "window";
          url: string;
      };
      matrix?: number[];
      mediaData: MediaData[];
      mediaPosition: [ArrayPosition, ArrayPosition, ArrayPosition, ArrayPosition];
      modelUrl: string;
      objectFit?: ObjectFit;
  } & {
      extraData?: Object;
  }>
Returns Promise<void>
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:361

changeTagNormalById

changeTagNormalById(id, normal): void
@description: 修改3D标签normal
Parameters
- id: TagId
- normal: ArrayPosition
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:285

changeUnfoldedById

changeUnfoldedById(id, unfolded): void
Parameters
- id: TagId
- unfolded: boolean
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:261

clearTags

clearTags(): void
Returns void
Inherited from TagRender.clearTags
- Defined in plugins/src/PanoTagPlugin/controller/TagRender.ts:65

destroyTagById

destroyTagById(id): void
@description: 销毁tag
Parameters
- id: TagId | TagId[]
Returns void
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:350

disable

disable(params?): void
Parameters
- Optional params: {
  userAction?: boolean;
  }
  - Optional userAction?: boolean
Returns void
Overrides TagRender.disable
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:213

dispose

dispose(): void
@description: 销毁

Returns void
Overrides TagRender.dispose
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:238

enable

enable(params?): void
Parameters
- Optional params: {
  userAction?: boolean;
  }
  - Optional userAction?: boolean
Returns void
Overrides TagRender.enable
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:206

getCurrentState

getCurrentState(): State
获取当前的插件状态，如果当初插件内存在需要通过动画变更的 state 值，则通过此方法可以得到中间状态

Returns State
Inherited from TagRender.getCurrentState
- Defined in plugins/src/base/BasePlugin.ts:95

getCurrentVisibleState

getCurrentVisibleState(tag): boolean
Description
获取标签当前状态
Parameters
- tag: TagInstance
Returns boolean
(this.state.visible && tag.state.visible) ?? true
Inherited from TagRender.getCurrentVisibleState
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:135

getModelMedialVisibleByPanoIndex

getModelMedialVisibleByPanoIndex(tag): boolean
获取当前点位上模型中的多媒体是否应该展示
Parameters
- tag: TagInstance
Returns boolean
Inherited from TagRender.getModelMedialVisibleByPanoIndex
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:148

getTagById

getTagById<C, S>(id): TagInstance<C, S>
Type Parameters
- C extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown" = "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
- S extends StickType = StickType
Parameters
- id: TagId
Returns TagInstance<C, S>
Inherited from TagRender.getTagById
- Defined in plugins/src/PanoTagPlugin/controller/TagUtil.ts:79

getTagConfig

getTagConfig(tag): TagConfig<"Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown">
@description: 获取merge后的配置 TODO: 缓存
Parameters
- tag: Tag
Returns TagConfig<"Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown">
Inherited from TagRender.getTagConfig
- Defined in plugins/src/PanoTagPlugin/controller/TagUtil.ts:100

getUnfoldedByCamera

getUnfoldedByCamera(tag): boolean
@description: 获取是否展开
Parameters
- tag: TagInstance
Returns boolean
Inherited from TagRender.getUnfoldedByCamera
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:197

getUnfoldedByPanoIndex

getUnfoldedByPanoIndex(tag, panoIndex?): boolean
@description: 获取是否展开
Parameters
- tag: TagInstance
- Optional panoIndex: number
Returns boolean
Inherited from TagRender.getUnfoldedByPanoIndex
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:165

getVisible

getVisible(tag): boolean
Parameters
- tag: TagInstance
Returns boolean
Inherited from TagRender.getVisible
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:139

getVisibleByFiveMode

getVisibleByFiveMode(tag, mode?): boolean
Parameters
- tag: TagInstance
- Optional mode: Mode
Returns boolean
Inherited from TagRender.getVisibleByFiveMode
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:110

getVisibleByPanoIndex

getVisibleByPanoIndex(tag, panoIndex?): boolean
@description: 获取是否可见
Parameters
- tag: TagInstance
- Optional panoIndex: number
Returns boolean
Inherited from TagRender.getVisibleByPanoIndex
- Defined in plugins/src/PanoTagPlugin/controller/TagComputer.ts:21

hide

hide(params?): Promise<void>
Parameters
- Optional params: {
  userAction?: boolean;
  withAnimation?: boolean;
  }
  - Optional userAction?: boolean
  - Optional withAnimation?: boolean
Returns Promise<void>
Overrides TagRender.hide
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:199

isAbsoluteURL

isAbsoluteURL(url): string
Parameters
- url: string
Returns string
Inherited from TagRender.isAbsoluteURL
- Defined in plugins/src/base/BasePlugin.ts:122

load

load(data, config?): Promise<void>
@description: 加载数据
Parameters
- data: Tags
- Optional config: AddTagConfig
Returns Promise<void>
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:63

pauseCurrentMedia

pauseCurrentMedia(): void
暂停当前标签内进行的所有多媒体

Returns void
Inherited from TagRender.pauseCurrentMedia
- Defined in plugins/src/PanoTagPlugin/controller/TagUtil.ts:92

registerRenderer

registerRenderer(contentType, renderer): void
@description: 设置 contentType 的渲染器

Note
优先级低于 tag.element
Parameters
- contentType: string
  
  如果是 TagContentType 中的类型，将会覆盖掉插件内部默认的渲染器, 如果是其他任意 str ing 如：'Foo'，则可以将类似 {id: 1, contentType: 'Foo', position: [0,0,0]} 的 tag 交给插件渲染
- renderer: ElementRenderer
Returns void
Inherited from TagRender.registerRenderer
- Defined in plugins/src/PanoTagPlugin/controller/TagRender.ts:61

setState

setState(state, params): void
Parameters
- state: Partial<State>
- params: {
  userAction?: boolean;
  visibleWithAnimation?: boolean;
  }
  - Optional userAction?: boolean
  - Optional visibleWithAnimation?: boolean
Returns void
Overrides TagRender.setState
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:220

show

show(params?): Promise<void>
Parameters
- Optional params: {
  userAction?: boolean;
  withAnimation?: boolean;
  }
  - Optional userAction?: boolean
  - Optional withAnimation?: boolean
Returns Promise<void>
Overrides TagRender.show
- Defined in plugins/src/PanoTagPlugin/controller/index.ts:192

Class PanoTagPluginController

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

five: Five

Optional params: { config?: Pick<Tags, "globalConfig" | "contentTypeConfig">; debug?: boolean; }

Optional config?: Pick<Tags, "globalConfig" | "contentTypeConfig">

Optional debug?: boolean

Returns PanoTagPluginController

Properties

Readonly VERSION

config

five

hooks

state

Type declaration

enabled: boolean

visible: boolean

Readonly staticPrefix

tags

Methods

addTag

Parameters

tag: Tag | Tag[]

Optional paramsConfig: AddTagConfig

Returns Promise<void>

Optional appendTo

Parameters

wrapper: Element

Returns void

changeConfig

Parameters

config: Pick<Tags, "globalConfig" | "contentTypeConfig">

merge: boolean = true

Returns void

changeContentTypeConfig

Type Parameters

T extends ContentTypeConfigKey

Parameters

key: ContentTypeConfigKey

contentTypeConfig: PickTagContentTypeInContentTypeConfigKey<T> extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown" ? TagConfig<Object> : unknown

merge: boolean = true

Returns void

changeDataById

Type Parameters

Parameters

id: TagId

deepMerge: boolean = true

Returns void

changeEnabledById

Parameters

id: TagId

enabled: boolean

Returns void

changeGlobalConfig

Parameters

globalConfig: TagConfig<"Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown">

merge: boolean = true

Returns void

changeStickTypeById

Type Parameters

Parameters

id: TagId

deepMerge: boolean = true

Returns void

changeTagById

Type Parameters

Parameters

id: TagId

tag: PartialObjectDeep<Tag<C>>

deepMerge: boolean = true

Returns void

changeTagModel

Parameters

tag: TagInstance<"Model", "Model"> | TagInstance<"MediaModel", "Model">

`Optional` params: {
config?: Pick<Tags, "globalConfig" | "contentTypeConfig">;
debug?: boolean;
}

`Optional` config?: Pick<Tags, "globalConfig" | "contentTypeConfig">

`Optional` debug?: boolean

`Readonly` VERSION

`Readonly` staticPrefix

`Optional` paramsConfig: AddTagConfig

`Optional` appendTo

contentTypeConfig: PickTagContentTypeInContentTypeConfigKey<T> extends "Model" | "Image" | "Link" | "Audio" | "Text" | "ImageText" | "Video" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Custom" | "Unknown"
? TagConfig<Object>
: unknown

data: PartialObjectDeep<{
action?: {
type: "iframe" | "window";
url: string;
};
matrix?: number[];
mediaData: MediaData[];
mediaPosition: [ArrayPosition, ArrayPosition, ArrayPosition, ArrayPosition];
modelUrl: string;
objectFit?: ObjectFit;
} & {
extraData?: Object;
}>

`Optional` params: {
userAction?: boolean;
}

`Optional` userAction?: boolean

`Optional` params: {
userAction?: boolean;
}

`Optional` userAction?: boolean

`Optional` panoIndex: number