Jump to: navigation, search

Difference between revisions of "Panotour - FAQ - Viewing the tour online (desktop)"

(Tour and video (youtube, vimeo, dailymotion, kolor eyes) in fullscreen concurrency)
m (How does deep linking work in Panotour Pro ?)
Line 24: Line 24:
  
 
=== How does deep linking work in Panotour Pro ? ===
 
=== How does deep linking work in Panotour Pro ? ===
Deep linking allows you to go directly to the panorama view and zoom of your choice. You can achieve this by adding some variables to the URL.  <br>
+
{{:Panotour_-_Notions_-_Deep_Linking}}
* Deep-linking starts with '''<span style="color:#ff0000">?</span>''' at the end of your URL, then your variable (see example below).
+
* To use several variables in the same link, use the '''<span style="color:#ff0000">&</span>''' between variables (see example below).
+
* '''startscene''' or '''s''' is the panorama identifier name.[[Image:Ptp2 Tour Main Workspace Panorama Properties Informations.jpg|thumb|Panorama Information - PanoID]]
+
**The variable «s» can be retrieved in [[Panotour_-_Tour_-_Picture/panorama_properties#Name|'''Picture/Panorama Properties > Name''']], click on  [[Image:Info.png|info]] icon and get the panorama ID. In this example, panorama ID is «pano425».<br>
+
  
Additional parameters you can use:
 
* '''h''' is the horizontal looking direction (-180 to +180).
 
* '''v''' is the vertical looking direction (-90 to +90).
 
* '''f''' is the current field of view in degrees (0.0 to 179.0). ''Depending on its value, this variable may have no effect if [[Panotour_Pro_2_-_Tour_-_Picture/panorama_properties#Zoom_limits|'''Limit to image resolution checkbox''']] is checked.''
 
* '''skipintro''' is an option to skip the little planet effect and/or the splash screen introduction.
 
* '''norotation''' is an option to stop autorotation. Useful if your tour is build with autorotation on startup.
 
* '''tour_soundson=false''' is an option to start out the tour with the sounds turned off.
 
* '''tour_displaythumbnails=false''' is an option to start out the tour with the tour thumbnails hidden.
 
* '''vr''' to start the tour directly on the VR Mode start screen (can be combined with startscene variable).
 
 
<br>
 
For example your final deep linked URL could look like:
 
:: - <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''<span style="color:#ff0000">?</span>html5=only<span style="color:#ff0000">&</span>s=pano425<span style="color:#ff0000">&</span>h=-104<span style="color:#ff0000">&</span>v=-9<span style="color:#ff0000">&</span>f=67'''
 
:: - <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>s=pano425<span style="color:#ff0000">&</span>h=-104<span style="color:#ff0000">&</span>v=-9<span style="color:#ff0000">&</span>f=67<span style="color:#ff0000">&</span>skipintro=true<span style="color:#ff0000">&</span>norotation=true'''
 
:: - <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>vr<span style="color:#ff0000">&</span>s=pano425''' <br>
 
 
 
<br/>
 
 
<onlyinclude>
 
<onlyinclude>
  

Revision as of 16:37, 14 June 2017

Viewing functionalities

How to force the display of the tour in Flash viewer or in HTML5 viewer version ?

Add ?html5=VALUE at the end of URL where VALUE is:

  • auto for automatic selection of the viewer.
    • For example http://www.yoururl.com/?html5=auto or http://www.yoururl.com/mytour.html?html5=auto
  • never for the Flash viewer to be used.
    • For example http://www.yoururl.com/?html5=never or http://www.yoururl.com/mytour.html?html5=never
  • prefer for the HTML5 viewer when possible.
    • For example http://www.yoururl.com/?html5=prefer or http://www.yoururl.com/mytour.html?html5=prefer
  • only to enforce the HTML5 viewer.
    • For example http://www.yoururl.com/?html5=only or http://www.yoururl.com/mytour.html?html5=only
  • The same values can be used with ?flash=VALUE at the end of your URL instead.


VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.
See KrPano's documentation

More deep-linking variables are available below


How does deep linking work in Panotour Pro ?

Logo-Panotour-Pro-2010.png Panotour Pro only    This feature is available only in the pro version of Panotour.


Intro

Deep linking allows you to go directly to the panorama view and zoom of your choice, among other things. You can achieve this by adding some variables to the URL. This page will explain those different variables.



How does Deep Linking Work

  • Deep-linking starts with ? at the end of your URL, then your variable (see example below).
  • To use several variables in the same link, use the & between variables (see example below).



What variables can I use

  • startscene or s with the panorama id.
    Panorama Information - PanoID
  • h is the horizontal looking direction (-180 to +180).
  • v is the vertical looking direction (-90 to +90).
  • f is the current field of view in degrees (0.0 to 179.0). Depending on its value, this variable may have no effect if Limit to image resolution checkbox is checked.
  • skipintro is an option to skip the little planet effect and/or the splash screen introduction.
  • norotation is an option to stop autorotation. Useful if your tour is build with autorotation on startup.
  • tour_soundson=false is an option to start out the tour with the sounds turned off.
  • tour_displaythumbnails=false is an option to start out the tour with the tour thumbnails hidden.
  • tour_language=en is an option to start out the tour with as specific language. The value can be any language added into the Languages field of the Build screen.
  • vr to start the tour directly on the VR Mode start screen (can be combined with startscene variable).
  • starttime=NB to start a video scene (if it's the first scene) at NB seconds (not available into VR mode).


For example your final deep linked URL could look like:

- http://www.yoururl.com/?html5=only&s=pano425&h=-104&v=-9&f=67
- http://www.yoururl.com/mytour.html?s=pano425&h=-104&v=-9&f=67&skipintro=true&norotation=true
- http://www.yoururl.com/mytour.html?vr&s=pano425



How to force the display of the tour using the Flash or HTML5 player ?

Add ?html5=VALUE at the end of URL where VALUE is:

  • auto for automatic selection of the viewer
    • For example http://www.yoururl.com/?html5=auto or http://www.yoururl.com/mytour.html?html5=auto
  • never for the Flash viewer to be used.
    • For example http://www.yoururl.com/?html5=never or http://www.yoururl.com/mytour.html?html5=never
  • prefer for the HTML5 viewer when possible.
    • For example http://www.yoururl.com/?html5=prefer or http://www.yoururl.com/mytour.html?html5=prefer
    • This is the default mode of all tours using Panotour 2.5+
  • only to enforce the HTML5 viewer.
    • For example http://www.yoururl.com/?html5=only or http://www.yoururl.com/mytour.html?html5=only
  • The same values can be used with ?flash=VALUE at the end of your URL instead.


VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.
See KrPano's documentation



Is it possible to add my own variables?

Of course, but this requires that you edit the xml of the built tour or add a piece of code using the include an XML plugin.

Here are some custom variables have been posted by users on the forum:













BACK TO: Documentation / Panotour Documentation


Troubleshooting online viewing

How to troubleshoot online tours

If the tour worked locally while building the tour but not after uploading, there was an issue either during upload or in the setting of your server.

  1. On the tour's direct page, open the developer tools of your browser (usually with Ctrl+Shift+I)
  2. Go to the Network tab and do a hard reload (Ctrl+F5) of the page
    • From there you'll be able to see if some files are missing or if they don't have the correct permissions to be accessed (they should appear in red).
      • If some files do appear in red, check they were correctly uploaded on your server and have the appropriate file permissions.
      • You will be able to compare the tours on your server and on your computer using your FTP Client (like Filezilla).
      • If you do not know how to find your files or modify the permissions, you will have to contact your hosting provider for assistance. Kolor does not provide web development and publishing or hosting services and as such can not offer technical support on this point.


My fullscreen button is missing

If your tour is included into an <iframe> tag, the allowfullscreen attribute must be added.

<iframe ... allowfullscreen="true" mozallowfullscreen="true" webkitallowfullscreen="true"></iframe>

Also make sure your browser is up to date, and see this page to see if your browser/device is compatible with the fullscreen API in the HTML5 player, because the button is also removed if it isn't supported by the viewing browser/device: http://caniuse.com/#feat=fullscreen


Viewing the tour isn't smooth

Tours built with v2.3 or lower:
This is due to the incorporation of the Flash Player and HTML5 plugins above it. To remedy this, try adding ?html5=prefer to the end of your URL. Doing this will force the viewer in HTML5 first, but have Flash as a fallback in case the browser does not support HTML5.
Rotation should be much smoother because there won't be the interaction between those two components.

From Panotour 2.5+, the HTML5 player is loaded in priority, so you won't need to add the code to the end of your URL.


Some plugins are not displayed or interfere with the fullscreen mode

Some browsers don't support the HTML5 fullscreen API (see https://dvcs.w3.org/hg/fullscreen/raw-file/tip/Overview.html).
For these browsers the HTML5 plugins (see list of HTML5 plugins) are not displayed in full screen mode. These browsers include IE10 and earlier versions, Safari 6 and earlier versions.


Tour and video (youtube, vimeo, dailymotion) in fullscreen concurrency

Panotour Pro generates a tour which is compliant with the Fullscreen HTML5 API. But the videos providers as YouTube, Dailymotion and Vimeo use also this technology to display video in fullscreen mode. So when using Video Fullscreen, the fullscreen event can broke the tour fullscreen until the video is closed.


Some plugins appear always over other plugins even with the plugins order have been defined

Yes, the HTML5 plugins are always displayed over the others plugins. You can order all plugins but the ordered HTML5 plugins will be always over the standard plugins. HTML5 plugins concerned are:


Tours made with Panotour 2.3 or under do not work in Microsoft Edge

It's a bug in KrPano HTML5 viewer, which is fixed in the version 1.18.5 of KrPano and the 1.19 pre-release 3.
The fix is included in Panotour 2.5, but you can also follow the instructions here to update your tours KrPano version to the latest stable one if you built the tour with Panotour Pro 2.3 and don't want to use the beta.









BACK TO: Documentation / Panotour Documentation / Frequently Asked Questions