Direct link to specific scene tutorial (url params)

Sudarchikov Andrey · August 26, 2013 at 2:20 PM

Hi!
Customers often ask me about scenes direct link (url) in the tour.
Well, krpano has great feature pass url params to xml.
And here is small tutorial of how to use it.

First, you need to set passQueryParameters to true
example:
embedpano({swf:"tour.swf", xml:"tour.xml", target:"pano", passQueryParameters:true });
then you can use any variable names in url string
for example:
http://yourdomain.com/mytours/tour.h…e_var=its_value
and so on
all this variables will be passed to xml and you can get it's values
like get(some_variable) or get(more_var)

So, what if we want to start specific scene from url?
then let's use start_scene for define which scene to start.
your url will be like this
http://yourdomain.com/mytours/tour.h…e_name_or_index
and in xml
some start action

Code

<krpano onstart="start();"
<action name="start">
	<!-- set default start scene if start_scene is not defined -->
	if(start_scene === null, set(start_scene,0); );
	loadscene(get(start_scene));
</action>


...


</krpano>

Display More

you can pass start view same way or any other variables to your tour xml.

Well, I hope you will find it usefull

Best wishes
Andrey

nefar1ous · August 26, 2013 at 3:11 PM

Great, a nice straightforward example. Appreciate the mini-tute. Care to add some challenging examples?
Thanks Andrey!
Tony

Sudarchikov Andrey · August 26, 2013 at 7:25 PM

Small working example!

how to use:
open tour.html
and add params to url, for example:
tour.html?start_scene=scene1
or
tour.html?start_scene=1

name and index of the scene can be used

start_fov, start_hlookat, start_vlookat also available in this example

for example:
tour.html?start_scene=2&start_fov=70&start_vlookat=20

Enjoy
Andrey

Arsdezi · September 2, 2013 at 7:43 PM

Well done!
It's working!

And can to be useful, thank you!

360view · April 20, 2014 at 5:01 PM

Hi

i did try the exemple but is it possible the the url dinamicly display the full link every time you change panorama

if you click on scene 2 the url change to:
tour.html?start_scene=2&start_fov=70&start_vlookat=20

if you click on scene 1 url automaticly change to

tour.html?start_scene=1&start_fov=70&start_vlookat=20

Kind regards,

José

wilsan · May 3, 2014 at 6:39 PM

Very useful example, very easy to use.
Its working fine,Thanks Andrey.

Masterwork done by Andrey.

Stefan.L · October 22, 2014 at 2:38 PM

Very useful! Great!

attefable · July 12, 2015 at 12:22 AM

Hello

i followed your tutorial and found passQueryParameters set to ture already in my tour.html

and when i write the url in the address bar in my browser like that it opens the next scene instead of the written number?! i don`t know what did i do wrong? :/

plus.. i actually when i started to read this thread i thought that it would be able to get the link updated from current scene i`m viewing.. i mean for example if i`m viewing scene no 007 and i clicked on share.. it shares this scene.. not the main tour link that opens from scene 001.. get me?

thanks in advance :)

Sudarchikov Andrey · July 12, 2015 at 9:11 PM

Scene name must starts from letter
004 - trying to load 4 index scene (0,1,2,3,4) 5-th actually
so it's correct behaviour
rename your scenes to string names like s004 or something

Andrey

sebastianm · August 14, 2015 at 5:09 PM

Thank you for this tip, is working as supposed to, now that we can access direct panos inside the virtual tour, i wonder do you know a way to share(on facebook) a specific pano within the virtual tour?

Edit:

I saw you already made this happen in another post, so thank you again :)

Thanks
Sebastian

anjenehm · November 15, 2018 at 7:57 PM

Is it possible to get these vars when change current view?
Update the url when user is looking up an see something interesting and want to share the scene but with the current view?

Many thanks for your solution Andrey!

pur · November 18, 2018 at 10:18 PM

Hi Andrey,

Thank you for sharing your example!
Since 1.19.pr3 there is 'deep linking' in krpano, which allows to start any scene of the tour.xml
https://krpano.com/forum/wbb/inde…ews119vtourskin

It seems to do the same job as your code.
The <action name="skin_deeplinking_update_url_process" of the vtourskin.xml brings the syntax of the url. The <view> can be set by the url, too.
Pavel

anjenehm · November 21, 2018 at 10:17 PM

Thx,

deeplinking was my solution.

But is it possible to change the path of the deeplinking?

http://192.168.178.22:666/?s=0&ansicht=lookat(112,56,140);

to

http://192.168.178.22:666/?s=0&hlookat=1…okat=56&fov=140

<action name="skin_deeplinking_update_url_process">
copy(adr, browser.location);
indexoftxt(qi, get(adr), '?');
if(qi GT 0, subtxt(adr, adr, 0, get(qi)));
copy(si, scene[get(xml.scene)].index);
copy(h, view.hlookat);
copy(v, view.vlookat);
copy(f, view.fov);
set(pp, calc(f LT 10 ? 6 : 0));
roundval(h, get(pp));
roundval(v, get(pp));
roundval(f, get(pp));
set(adr, calc(adr + '?s=' + si + '&ansicht=lookat('+h+','+v+','+f+');'));
js( history.replaceState(null, document.title, get(adr)); );
</action>

Thanks for any help!

pur · November 26, 2018 at 10:50 PM

Anjenehm,
If you use the default krpano tour.xml generated by the MAKE VTOUR (MULTIRES) droplet (ver. 1.19.pr16) you see the

Code

<!-- startup action - load the first scene -->
	<action name="startup" autorun="onstart">
		if(startscene === null OR !scene[get(startscene)], copy(startscene,scene[0].name); );
		loadscene(get(startscene), null, MERGE);
		if(action[startactions].name !== null, startactions() );
	</action>

Then you can start any of your scenes by adding to the startlink yourdomain.tour.html?startscene=yourscenename_or_sceneindex&startactions=any_krpano_actions
e.g.:
https://pavel.ursiny.sk/pano/Art/ZORIC…kat(-150,0,10);

Pavel

stevechapdbox · October 30, 2019 at 5:09 PM

Been playing around with this and can't get it too completely work, I'd appreciate any insight.

Noticed that in previous threads the syntax was

Code

tour.html?start_scene=coolScene

but now it is:

Code

tour.html?startscene=coolScene

This works fine to load the specified scene but when I try to change another attribute like fov or hlookat it doesn't quite work.

I've tried various combinations similar to:

Code

tour.html?startscene=coolScene&start_fov=85&start_hlookat=20

Is my syntax wrong? I can't seem to change the fov or hlook at all.

Thanks!

Alexey Tkachenko · October 31, 2019 at 7:32 AM

Hi)

Thats because URL parameters are passed BEFORE the scene is loaded and the scene has its own VIEW settings.

Try this:

Code

?startscene=1&h=90

and add the following into "onstart" of the needed scene (in my test it's second scene)

Code

onstart="lookat(get(h), get(v), get(f))"

Hope this helps

klaus.krpano · November 13, 2019 at 3:50 PM

Hi,

just set the deeplinking setting in the tour.xml to true - then you will get automatically links/urls to the current scene and current view.

Best regards,
Klaus

iambeniwal · November 21, 2019 at 3:21 PM

Hi Klaus,

I set the deeplinking setting to true but there's no effect on tour at all.
Kindly advise.

Thanks

spacerywirtualne · November 21, 2019 at 6:39 PM

In what file did you set deeplinking="true"
In the tour.xml file or in the vtourskin.xml file

Piotr

sanaltur · February 25, 2021 at 9:46 AM

I SOLVED.
Thanks.

Code

hi, 
I could not find how to use it for PTP. How can I go to the scene I want in PTP projects?
1.20.9 krpano installed on panotour pro 2.5.14

Best!
Alican Y.

Participate now!