plugin元素说明文档

krpano xml元素官方文档

<plugin>

更新 2025.2.7 krpano 1.22.3

 

关于 <plugin> 元素:

  •  <plugin> 元素和 <layer> 元素本质上是同一元素
  • 仅仅名字不同而已。
  • 任何时候都可以使用<layer>或<plugin> 或反向来处理相同的元素。在静态xml代码和动态Action或Javascript代码中，是相同的。
  • 术语 ‘plugin（插件）’ 来自krpano的老版本，其中的插件主要用于包含用于进一步交互的外部工具。
  • 如今，该元素提供了更多的布局功能，因此较新的术语“layer（图层）”更好地描述了它的行为、
  • 因此建议<plugin>仅在包含使用附加功能扩展的krpano插件（如Soundinterface或WebVR插件）时使用，<layer>则使用在所有与布局相关的元素。
  • 以下是关于<plugin> 的特殊用法，该设置仅与xml解析有关:
    • 当加载一个 krpano Javascript Plugin 并在xml文件中定义api属性时，将立即创建具有该名称的全局 krpano 插件对象。
    • 插件的item元素将获得与 api属性中设置中相同的名称。
    • 这允许在 xml 解析期间使用短的 api 名称设置指向该插件的链接。
    • 例子 – 当插件定义如下:
      可以使用api名字链接插件:
      替代完整的插件名称: