SeattleClouds Custom URL Schemes    
This topic is assigned to Victor Robu

Sep 16, 2011 12:12 AM
In order to give SeattleClouds users even more tools to design feature-rich interactive applications, we have created a custom set of URL schemes. Some of them are platform specific, others will run equally well on both iOS and Android. Please, look through the list bellow and see how you can enrich your apps.

URL Scheme Description Platform Support
addtocart:// Adds an item to the user's shopping cart. The scheme has four parameters: item name, item price, URL of item info and URL of an image. All parameters are separated with an ampersand (&).
 
  Example:
<a href="addtocart://id?itemname=name&itemprice=price&urlimg=imag​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​​e.png&urlin​f​​​o​=​i​n​f​o​"​>​​​Add item to your shopping cart</a>

 
bgplayer-play:// Playbacks an audio file in the background.
 
  Example:
<a href="bgplayer-play://track-1.mp3">Track #1</a>

 
bgplayer-stop:// Stops background playback.
 
  Example:
<a href="bgplayer-stop://">Stop background player</a>

 
counterenter:// Limits user to a specified number of page visits to a linked page or sets to zero the number of visits of the page if resetzero parameter is presented.
  Example:
<a href="counterenter://secret.html?maxenter=1">Access my secret page just once</a>
<a href="counterenter://secret.html?resetzero=">Reset the number of your visits</a>

 
external:// Opens a linked page in a default web browser. This scheme will take user out of your application.
 
  Example:
<a href="external://http://seattleclouds.com">SeattleClouds</a>

facebook:// Posts a screenshot of current app page to user's Facebook wall. This URL scheme requires no arguments.
  Example:
<a href="facebook://">Let your Facebook friends see this page</a>

 
globe:// Links a user to a globe-type page from our page type menu. The globe caries location marks that can be edited in our online editor.
  Example:
<a href="globe://offices-worldwide.html">Our offices worldwide</a>

 
latlong:// Opens following coordinates with available Maps applications. Map opens up inside UI without leaving the app on iOS, while on Android available mapping application is loaded.
 
  Example:
<a href="latlong://40.689167,-74.044444">Statue of Liberty National Monument, NY</a>

local:// Allows web sites loaded in In-App Browser or Mobile pages to link to internal resources of the app.
 
  Example:
<a href="local://tab1.html">Start page of our app</a>

 
logout:// If your app allows users to register their own accounts, this scheme will log them out.
  Example:
<a href="logout://">Log out<a>

 
map:// Displays the location of preset address using Maps application. Similar with latlong://.
 
  Example:
<a href="map://Infinite+Loop+Cupertino+Santa+Clara+California+95014">Infinite Loop, Cupertino, Santa Clara, California 95014</a>

 
movie:// Opens a linked media file in default player.
 
  Example:
<a href="movie://movie.mp4">Play movie</a>

 
ratings:// Allows users to rate and comment a linked page on Facebook.
  Example:
<a href="ratings://gallery.html">My gallery on Facebook</a>

 
removefromcart:// Removes an item from user's shopping cart by its ID.
  Example:
<a href="removefromcart://item_id">Remove item from cart</a>

sendmail:// Prompts user to send an email to an indicated email address without leaving an app.
 
 
  Example:
<a href="sendmail://my@email.com">Email me</a>

sharemail:// Creates a screenshot of current app page and prompts user so send it by email. This URL scheme requires no arguments.
  Example:
<a href="sharemail://">Send a screenshot of this page by email</a>

 
sound:// Playbacks a sound file in OS' default player. The scheme was designed with audio effects in mind, so the playback can not be stopped. On iOS the audio file can only be 30 seconds long and of >WAV format.
 
  Example:
<a href="sound://beep.wav">Alert</a>

 
uploadphoto:// Uploads an image file to a preselected file hosting.
  Example:
<a href="uploadphoto://file_hosting.com/upload">Choose a photo to upload on the web</a>

 
xaudio:// Playbacks an audio file or stream in OS' default player.
  Example:
<a href="xaudio://track-1.mp3">Track #1</a>

 
xvideo:// Playbacks a video file or stream in OS' default player.
  Example:
<a href="xvideo://clip-1.mp4">Clip #1</a>

 
purchase://restore "Restore Purchase" option for Apple In-App Purchases. This URL scheme requires no arguments.
  Example:
<a href="purchase://restore">R​estore your Purchase</a>

 
removeads:// "Remove Ads" option, removes all the Ads from the app. This option is available only for Monetization ads subscription, more info can be found here
 
  Example:
<a href="removeads://">Remove Ads</a>
 


Sep 16, 2011 03:26 PM
THANK YOU SO MUCH SC!!!


Sep 16, 2011 11:13 PM
You are always welcome. Thank you for staying with us :)


Sep 18, 2011 01:28 PM
Exactly what I needed!!

quick question, how does the upload photo:// work?


CAn this be adjusted so that you can upload a photo to your Facebook wall from within the app, without having to have it hosted on an SC server?


Sep 18, 2011 04:01 PM
camera url scheme,

I tried testing this out, but the link itself just takes me to a full screen view of the camera.
How would the consumer take a picture?

What I did was create a png file which I stretched out to dimension of the page
I added the .png file as an image in a blank HTML page


Copied your code and changed all the links to match my link.





Sep 19, 2011 06:11 AM
Marc,
url scheme 'uploadphoto://' is used to send a photo from device to your server via specific target url on your website. 

NOTE: The content of photo is sent as hex stream. On the server side your handler should read this stream and convert into physical file (*.png, *.jpg).

All the best


Sep 19, 2011 12:46 PM
Hi ,

Can i use the above commands in a mobile page hosted in another server, i tried the 
1<a href="local://tab1.html">Start page of our app</a>

But the above link code didn't work, it works only on an SC html page, 

 what i need is a link to put in my mobile page on my server in order to go directly to tab1.html in the app can you help on this case
Khondr,

Can you please specify two moments for me here:

1.) Is there a trouble with any other page which is not a Tab?

2.) When this page of yours loads, does it load in a web browser (Safari) or in app's UI Web View.

Thank you.

if i use the above herf in a html page from SC it works fine but if i use it in my mobile page it does nothing at all...

the question is can i use the above command in a mobile page to return back to tab1 in the app??

Thanks for help

Khondr,

Yes, you can. As it is a new feature, the common answer is to request a rebuild. If you want to test this functionality in a Seattle Clouds app you need to wait till we update it in a couple of weeks.



Sep 19, 2011 01:05 PM
Dmitry,


Thanks for the reply. I am gonna work with my webmaster to be able to set this up. What would it take to have all photos taken and files in general be hosted onto our server versus have it linked to SC.

For example:
Photo effect allows for posting on websites such as FB, but the file is hosted on SC.
Is the URL scheme used to upload pictures taken from photo effect.html to our own server?

Goes back to debranding SC as we are putting the app as our own app. 

Would this be a special build?


Sep 19, 2011 06:39 PM
Great stuff here. Thanks a lot


Dec 21, 2011 05:55 AM
yeah, Vadim is the Man. Thanks a lot.


Aug 16, 2012 12:33 PM
<a href="uploadphoto://file_hosting.com/upload">Choose a photo to upload on the web</a>

Do I need a hosting service? or the images upload directly to "My Resources".

Thanks!


Aug 23, 2012 05:00 AM
No, Jorge

This is for a hosting of your own.

Vladimir
SeattleClouds team


Sep 14, 2012 06:39 AM
how can add the functionality of login via facebook to my app??
help please..


Sep 18, 2012 06:42 AM
We have a Facebook Fan Page for integration with Facebook. Other than that there are no features that would require Facebook login.

Vladimir
SeattleClouds team


Sep 18, 2012 01:37 PM
Is there a URL scheme that will launch a search in the Apple installed Maps app?   For example, if I wanted to trigger a search for "gas stations" and wanted that to pull up a map of local stations based on their GPS location, is that possible?  I tried looking at the different map pages; however, they all require an XML response from a pre-built database.  


Sep 19, 2012 08:08 AM
Yes, Jason

map:// URL scheme searches for the provided address and comes up a pin on the desired location. A tap on the Get Directions will open the Map application itself so that user was able to get directions from their current to the pinned location.

    1 2   next