3rd Party Application Integration - How?

Shadowy_one · October 13th, 2015, 09:55 PM

Can anybody tell me how to integrate third party applications? I can't seem to find out how to integrate Syrinscape.

Parody · October 13th, 2015, 10:27 PM

In Syrinscape, open the SoundSet from which you want to pick sounds. Go to Options and turn on Third-Party Integration. Now there should be a bunch of (+) buttons on the various controls. Click one to copy a custom URI to the clipboard; it'll look something like:

syrinscape-fantasy:moods/d2l0Y2h3b29kOjpSYWluaW5nIGFnYWlu/play/

In Realm Works, edit the Topic/Article/etc. where you want to put the link. Right-click in a snippet and pick Hyperlink. Replace the text in the Address box with the text from Syrinscape. Edit the Text to Display as appropriate.

Now you have a link that should fire up a Syrinscape player and act like you clicked on the button whose (+) button you clicked.

Shadowy_one · October 13th, 2015, 10:48 PM

Quote:

Originally Posted by Parody

In Syrinscape, open the SoundSet from which you want to pick sounds. Go to Options and turn on Third-Party Integration. Now there should be a bunch of (+) buttons on the various controls. Click one to copy a custom URI to the clipboard; it'll look something like:

syrinscape-fantasy:moods/d2l0Y2h3b29kOjpSYWluaW5nIGFnYWlu/play/

In Realm Works, edit the Topic/Article/etc. where you want to put the link. Right-click in a snippet and pick Hyperlink. Replace the text in the Address box with the text from Syrinscape. Edit the Text to Display as appropriate.

Now you have a link that should fire up a Syrinscape player and act like you clicked on the button whose (+) button you clicked.

Thanks! I would have never figured that one out without you.

DMG · October 13th, 2015, 11:42 PM

Parody is correct, you add the call as a hyperlink.

I actually put in a support ticket on how to do that, as per the release notes. I thought Syrinscape or other API calls were special snippet types. The hyperlinks never even occurred to me at the time.

rob · October 14th, 2015, 02:25 AM

If you simply paste the text into the snippet, without explicitly creating a hyperlink, I'm pretty sure that the link will be auto-detected and created. It did at one point during development, at least, but I haven't checked recently to confirm it.

Granted, having the link URI visible due to a direct paste is a little less pretty, but it's also less fiddly to setup. So you can use whichever approach you find more appealing.

Parody · October 14th, 2015, 07:26 AM

On my machine, http: is converted, syrinscape-fantasy: is not. But this is in version 200 and I don't have Syrinscape Fantasy installed, so it's not a very conclusive test. :)

liz · October 14th, 2015, 08:17 AM

You can see how to get URI's from within Sryinscape by watching their handy-dandy YouTube video here: https://www.youtube.com/watch?v=2aM30zA9CLg

rob · October 14th, 2015, 12:09 PM

Quote:

Originally Posted by Parody

On my machine, http: is converted, syrinscape-fantasy: is not. But this is in version 200 and I don't have Syrinscape Fantasy installed, so it's not a very conclusive test. :)

The 3pp integration wasn't added until build 201, so it definitely won't work with 200.

Seregil · October 14th, 2015, 01:21 PM

Just tried it. It does not auto detect because the link does not contain http://
You have to make it a hyperlink. Once this is done, however, it does work.

snaggle2th · October 15th, 2015, 11:04 AM

What about PDFs? It would be great to hyperlink to a page within a PDF.

What are the best practices? Is it better to upload a PDF into a realm, or leave it external? Would uploading several PDFs start to cause performance issues? Is it possible to link to a page within a PDF? I know it can be done with a remote file, but what about a local one? What about one internal to the realm?

Shadowy_one Member Join Date: Jul 2014 Location: Germany Posts: 46 October 13th, 2015, 09:55 PM	Can anybody tell me how to integrate third party applications? I can't seem to find out how to integrate Syrinscape.
#1

DMG Senior Member Join Date: Jun 2007 Location: Queensland, Australia Posts: 195 October 13th, 2015, 11:42 PM	Parody is correct, you add the call as a hyperlink. I actually put in a support ticket on how to do that, as per the release notes. I thought Syrinscape or other API calls were special snippet types. The hyperlinks never even occurred to me at the time.
#4

Parody Senior Member Join Date: Jan 2013 Location: Rochester, MN Posts: 1,516 October 14th, 2015, 07:26 AM	On my machine, http: is converted, syrinscape-fantasy: is not. But this is in version 200 and I don't have Syrinscape Fantasy installed, so it's not a very conclusive test. :) Michael Miller ESG Labs - Realm Works Locations App - Convention Events
#6

liz Ex-Staff Lone Wolf Staff Join Date: Jul 2013 Posts: 961 October 14th, 2015, 08:17 AM	You can see how to get URI's from within Sryinscape by watching their handy-dandy YouTube video here: https://www.youtube.com/watch?v=2aM30zA9CLg
#7

Seregil Member Join Date: Nov 2014 Posts: 66 October 14th, 2015, 01:21 PM	Just tried it. It does not auto detect because the link does not contain http:// You have to make it a hyperlink. Once this is done, however, it does work.
#9

snaggle2th Junior Member Join Date: Sep 2014 Location: Halifax, NS Posts: 6 October 15th, 2015, 11:04 AM	What about PDFs? It would be great to hyperlink to a page within a PDF. What are the best practices? Is it better to upload a PDF into a realm, or leave it external? Would uploading several PDFs start to cause performance issues? Is it possible to link to a page within a PDF? I know it can be done with a remote file, but what about a local one? What about one internal to the realm?
#10