更新 2023.12.11 krpano 1.21.2
以下隐藏内容
使用<action>元素可定义krpano动作。
krpano动作与其它脚本和程序语言的函数相似。.
可在任意位置调用动作 – 通过call接口从事件、从其它动作或从外部来源（JavaScript、插件）。
有两种动作的类型：
events元素说明文档
更新 2023.12.11 krpano 1.21.2
krpano事件 – 当特定事件调用时可以执行action或指定的功能。
以下隐藏内容
有以下类型的事件:
- 全局krpano事件
一个不具有name属性的 <events> 元素定义的事件都是全局事件。通常只有一个全局事件。当有另一个 <events>标签定义相同的事件时，之前定义的同一事件就会被覆写。
注意 – 当载入另一个xml文件或其他场景时，所有全局事件将保留，它们不会发生改变，除非在新的xml文件或场景中被再次定义。 - 独立局部krpano事件
一个具有name属性的 <events> 元素定义的事件都是独立事件。
它可以包含所有类型的事件，但它们不会覆写全局事件，它们是另外进行调用的。
这些被“命名”的<events>元素同样具有keep属性（默认值为false）。这意味着没有keep=”true”的<events>元素在新全景载入时将会被自动移除。 - Javascript 事件回调
使用events.addListener()和events.removeListener()函数可以使用直接Javascript函数回调。
移花接木（2）- 添加背景音乐和控制声音播放的按钮
更新于 2024.4.19 krpano 1.21.2
本案例官方下载包路径
你电脑的路径\krpano-1.21.2\viewer\examples\backgroundsound\ （1.21.2）
提示：如果不明白下载包路径是什么，请查看 循序渐进（3）- krpano下载包的使用说明
（更多…）
移花接木（1）- 添加动态热点或动态图层
更新于 2024.4.19 krpano 1.21.2
官方下载包路径
你电脑的路径\krpano-1.21.2\viewer\examples\animated-hotspots\
提示：如果不了解何谓下载包路径，请查看 循序渐进（3）- krpano下载包的使用说明
display元素说明文档
更新 2023.12.11 krpano 1.21.2
调整全景图渲染品质/性能以及显示模式的设定。
以下隐藏内容
<display
autofullscreen=”true”
stereo=”false”
stereooverlap=”0.0″
stereoscale=”1.0″
stereoseparation=”6.5″
monoside=”1″
anaglyph=”false”
safearea=”auto”
mipmapping=”auto”
loadwhilemoving=”auto”
framebufferscale=”1.0″
hotspotvrrendering=”natural”
hotspotvrflying=”500″
hotspotworldscale=”2.0″
depthmaprendermode=”depthmap”
depthmapcachesize=”3″
depthbuffer=”false”
depthrange=”0.1,100000″
surfacesubdiv=”100″
nofullscreenfallback=”true”
wireframe=”false”
wirecolor=”0x00FF00″
chromesubpixelantialiasing=”false”
/>
autofullscreen=”true”
stereo=”false”
stereooverlap=”0.0″
stereoscale=”1.0″
stereoseparation=”6.5″
monoside=”1″
anaglyph=”false”
safearea=”auto”
mipmapping=”auto”
loadwhilemoving=”auto”
framebufferscale=”1.0″
hotspotvrrendering=”natural”
hotspotvrflying=”500″
hotspotworldscale=”2.0″
depthmaprendermode=”depthmap”
depthmapcachesize=”3″
depthbuffer=”false”
depthrange=”0.1,100000″
surfacesubdiv=”100″
nofullscreenfallback=”true”
wireframe=”false”
wirecolor=”0x00FF00″
chromesubpixelantialiasing=”false”
/>
动态变量:
- display.safearea_inset
- display.havedepthmap
- display.iphonefullscreen
- display.istransparent
- display.currentfps
- display.refreshrate
- display.frame
- display.rframe
- display.viewerwidth / viewerheight
- display.windowwidth / windowheight
- display.screenwidth / screenheight
- display.layout.root / stage / bglayer / overlay
- display.htmltarget
- display.viewerlayer
- display.controllayer
- display.customFullscreenElement
动作/函数:
area元素官方说明文档
更新 2023.12.11 krpano 1.21.2
定义全景图像展示的区域/窗口。
两种定义区域位置和尺寸的模式：
- 或通过定义尺寸和位置 (mode=align)。
- 或定义边界边距 (mode=border)。
可在onresize事件中动态改变/调整这些设定。如果在onresize事件之外改动了area设置，那么在下一次屏幕刷新时候将会调用一个onresize事件，针对新的区域/窗口尺寸作出回应。
注意 – 所有的<layer> / <plugin>元素都要放在这个区域内。如果要把<layer> / <plugin>元素放在区域外面，将该layer/plugin的parent属性设置为“STAGE” 或者”OVERLAY”。
（更多…）
krpano添加分享至微博按钮
全景漫游项目在手机端和PC端有很多不同之处，其中一点就是手机端的展示平台通常自备浏览功能，例如微信右上角的三个小圆点，还有众多手机浏览器的强大分享功能。相比起手机端的分享功能，PC端的浏览器相对就差很多了。要快速将全景地址分享到微博，想通过浏览器自带的功能，并不是那么一件容易的事情。因此我们需要自己添加分享到微博的按钮。
事实上，关于分享到微博的按钮，微博本身提供了一个按钮： （更多…）
点击按钮（layer）或热点（hotspot）弹出帮助图片
这一次从解决问题的思路来解释如何实现一个简单的帮助画面。
首先我们要明确需求：
有一个按钮，它的功能就是弹出帮助画面，当点击这个按钮时，全景画面中央出现一个设计好的帮助图片，点击该图片，图片消失，同时如果不点击图片，点击按钮的话，图片也会消失。
krpano网页地址链接到指定场景和视角（适用krpano 1.19 pr2以前版本）
假设现在有那么一种情况，你拍了几套样板间，然后这十几个点（场景）都放在一个xml里，然后，这时候客户希望在能打开地址展示第一个场景的同时，还可以按照其需求通过打开网址直接看到其他场景，例如，打开网址直接就是卫生间（恶趣味的客户）。
以下方法适用于krpano 1.19 pr2及之前版本
我们不可能因为这样去调整文件中scene的位置，因为这样就需要很多个xml文件，同时又要生成很多个地址，占据服务器空间。我们只需要在原来的网页地址上做个小小手脚。
首先，我们先来看看默认皮肤中tour.xml有这么一个startup的action。 （更多…）
krpano让场景开始即展示图片，10秒后自动隐藏
每个场景开始时都显示一张图片在正中央，然后图片在10秒后自动消失或用户可以自行点击图片隐藏。
视角相关 | 自动循环浏览全部场景（按照规定时间）
效果说明
这是一个常见的自动浏览代码，可以实现场景自动循环浏览，每个场景按照规定的时间在没有用户交互的情况下自动旋转特定的时间，然后跳转到下一个场景，当浏览完最后一个场景时，则跳转到第一个场景，继续循环。
虚拟漫游交互设计秘笈 – krpano中文网对话互动视界CEO
这次与肥宗对话的张海浪君是互动视界全景视觉的CEO、联合创始人及互动视界文化传媒总经理，他还是：
交互多媒体设计师、平面设计师、专业全景摄影师、全景视觉践行者
你可能之前不知道互动视界，更别说了解张海浪是何许人也。那你也许知道特斯拉，那个到现在都很火的电动汽车，特斯拉电动汽车的官方全景展示就是互动视界拍摄制作的。 （更多…）
krpano中获取用户输入文本的方法（支持全屏）
说明
此处的用法是运用js接口制作的一个小小插件，可以在xml文件调用js插件，然后在全景中获取用户所输入的文本。因为该插件是在xml内调用，属于krpano的元素，因此在krpano全屏时不会被放在后面，因此不会消失。
以下隐藏内容只提供VIP赞助会员，VIP会员说明请查看置顶文章
（更多…）
详解krpano的加密保护
以下内容基于krpano 1.18以上讲解，1.16.9及以下版本与之稍有区别。
加密保护目的无非是不想其他人看到自己的代码或者不想别人看到自己的切片图片。又或者是希望自己的项目不会被其它人“利用”。下面按照不同的加密设置进行讲解。注意，所有的加密保护设置都在krpano 1.19的文件夹中的krpano Tools.exe完成，见下图红色图标（另外一种更完备的方式是通过命令行完成），双击图标打开krpano Tools.exe （更多…）
让图片（layer）支持鼠标滚轮缩放和手势缩放
1.18.3支持全平台所有设备的图片缩放
krpano1.18.3解决了图片手势缩放在安卓手机系统不正常的问题。现在，使用1.18.3以上的用户可以正常在电脑上通过鼠标滚轮、在手机、平板（ios、android以及windows系统）手势实现图片放大缩小。 （更多…）
完全屏蔽krpano右键菜单
要完全屏蔽右键菜单，首先你要有Branding Free License，也就是那个价值299欧元的授权，详情查看：循序渐进（2）- 购买、下载、注册与更新krpano
我们知道右键菜单的内容是由contextmenu标签控制的，因此你首先要删掉所有contextmenu标签，然后加入以下代码即可。
|
1 |
<contextmenu fullscreen="false" versioninfo="false" /> |
注意 – 这个方法仅在1.17之后能够完全去掉右键菜单的弹出。
侧栏弹出菜单插件SideMenu（5个不同的样式）
插件说明
这是一个第三方免费插件Side Menu Plugin。 如在线演示所示，可以生成一个侧边栏弹出菜单。使用鼠标拖拽拉出菜单。非VIP会员可到官网自行下载。 （更多…）
查看krpano项目的授权信息
每个能够正常显示的krpano项目都肯定有授权信息的支持，如果没有正式的授权，这个项目显示时就会在屏幕中央有krpano的水印。
出于某种原因，我们有时候需要查看某个全景的授权信息，也就是我们想知道这个授权的用户名和注册邮箱。 （更多…）
让官方皮肤在手机展示时也默认弹出缩略图（1.18）
大家都能找到下面代码中高亮的部分：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
<skin_settings maps="true" maps_type="bing" maps_bing_api_key="" maps_zoombuttons="false" gyro="true" title="false" thumbs="true" thumbs_width="120" thumbs_height="80" thumbs_padding="10" thumbs_crop="" thumbs_opened="false" thumbs_text="true" thumbs_dragging="true" thumbs_onhoverscrolling="false" thumbs_scrollbuttons="true" thumbs_scrollindicator="false" tooltips_thumbs="false" tooltips_hotspots="false" tooltips_mapspots="false" controlbar_offset="20" /> |
也就是thumbs_opened=”false” 将它改为 thumbs_opened=”true”
这样我们打开场景时下方缩略图是默认显示的。但尽管我们已经改为true了，若在手机上看是缩略图默认还是隐藏的，怎么回事呢？ （更多…）
本地/离线使用krpano flash viewer时的注意事项
在离线或本地使用Flashplayer时，Flashplayer的外部接口会因为安全限制的默认原因被屏蔽。
在“在线”使用Flashplayer，也就是说Flashplayer是在 ‘http://’ 的地址中打开时（也可是 ‘localhost’ 服务器)，那么外部接口就可以使用。
外部接口 对于很多方面是非常必要和重要的;
- 使用krpano Javascript接口。
- 使用krpano鼠标缩放/页面滚动修正(对于Mac系统非常重要)。
- 打开一个超链接，例如krpano中的openurl(url) action。
- 从互联网载入数据或代码，例如Google Maps插件或Bing Maps插件需要载入地图切片。
在外部接口不可用是，krpano会显示下面的错误信息：
WARNING: ExternalInterface NOT available
可通过外部的 haveexternalinterface 变量检查外部接口是否可用。
如何更改Flashplayer安全设置
移花接木（33）- 热点截取与精确对齐
更新于 2024.4.19 krpano 1.21.2
本案例官方下载包路径
你电脑的路径\krpano-1.21.2\viewer\examples\hotspot-extract\ （1.21.2）
提示：如果不明白下载包路径是什么，请查看 循序渐进（3）- krpano下载包的使用说明
在线演示
以下隐藏内容仅供VIP会员查看，加入VIP会员请查看首页头图文章或添加站长微信
如何避免krpano的语法错误
不愿意见到的黑屏
刚接触krpano的朋友，最初目的很可能是想在手机上观看全景，krpano的两套viewer，Flash和HTML5正好满足了跨平台的需求，而且同一个地址就能在电脑和手机观看，于是我们的朋友很开心在电脑上看到了出色的全景效果，但当在手机上打开地址时，却弹出下面这个黑色画面，什么意思？FATAL ERROR，致命错误，载入或解析失败