Skip to main content

Introducing new learning courses and educational videos from Apress. Start watching

TouchDevelop Services

  • Chapter
  • Open Access
  • First Online:
  • 8121 Accesses

Abstract

This appendix reproduces material found on the TouchDevelop website at https://www.touchdevelop.com/docs/api . It is provided here to make the book more self-contained. Appendix B covers the objects (known as resources or services) provided by the API. The datatypes are covered in Appendix C.

Keywords

  • Datatype
  • Appendix
  • Script Review
  • Calendar Service
  • Windows Phone

These keywords were added by machine and not by the authors. This process is experimental and the keywords may be updated as the learning algorithm improves.

This appendix reproduces material found on the TouchDevelop website at https://www.touchdevelop.com/docs/api . It is provided here to make the book more self-contained. Appendix B covers the objects (known as resources or services) provided by the API. The datatypes are covered in Appendix C.

B.1 bazaar

Browse and review scripts from the bazaar.

ast of(id : String) : Json Object Returns Abstract Syntax Tree JSON object for specified script
leaderboard score : Number Gets the current score for the current script
post leaderboard score(score : Number) Posts the current game score to the script leaderboard
post leaderboard to wall Posts the current game leaderboard to the wall
script id(which : String) : String Returns an identifier for either the top-level script or the current library

B.2 box

Access current box element on the page.

edit(style : String, value : String,
changehandler : Text Action)
Display editable text, with the given binding
on tapped(handler : Action) Set what happens when the box is tapped
page height : Number Get the total height of the page
page width : Number Get the total width of the page
pixels per em : Number Get the number of pixels in an em
set background( color : Color) Sets the background color
set border( color : Color, width : Number) Set the color and width of the border
set border widths( top : Number,
right : Number, bottom : Number,
left : Number)
Set the width of each border
set font size(font size : Number) Set font size in this box
set foreground(color : Color) Sets the foreground color of elements
set height(height : Number) Set the height of this box
set height range(min width : Number, max width : Number) Set lower and upper limits on the width of this box
set horizontal align(arrange : String) Specify how to arrange the content of this box; arrange is “left” “center” “right” or “justify”
set horizontal stretch(elasticity : Number) Specify how to compute box width (0 = shrink to fit content, 1 = stretch to fit frame, 0.5 = stretch to half width
set margins(top : Number, right : Number, bottom : Number, left : Number) Set the margins of this box (to leave space around the outside of this box)
set padding(top : Number, right : Number, bottom : Number, left : Number) Set the padding of this box (to leave space around the contents of this box)
set scrolling(horizontal scrolling : Boolean, vertical scrolling : Boolean) Specify whether to use scrollbars when box contents overflow
set text wrapping(wrap : Boolean, minimumwidth : Number) Set whether to break long lines, and specify what length is too short for breaking
set vertical align(arrange : String) Specify how to arrange the content of this box; arrange is “top” “bottom” “center” or “baseline”
set vertical stretch(elasticity : Number) Specify how to compute box height (0 = shrink to fit content, 1 = stretch to fit frame, 0.5 = stretch to half height)
set width(width : Number) Set the width of this box
set width range(min width : Number, max width : Number) Set lower and upper limits on the width of this box
use horizontal layout Arrange boxes inside this box from left to right
use overlay layout Arrange boxes inside this box as layers on top of each other
use vertical layout Arrange boxes inside this box from top to bottom; this is the default

B.3 collections

Create collections of items.

create link collection : Link Collection Creates an empty link collection
create location collection : Location Collection Creates an empty location collection
create message collection : Message Collection Creates an empty message collection
create number collection : Number Collection Creates an empty number collection
create number map : Number Map Creates an empty number map
create place collection : Place Collection Creates an empty place collection
create string collection : String Collection Creates an empty string collection
create string map : String Map Creates an empty string map (case and culture sensitive)

B.4 colors

Access predefined colors or create new colors.

accent : Color Gets the accent color in the current theme
background : Color Gets the background color in the current theme
black : Color Gets the color that has the ARGB value of #FF000000
blue : Color Gets the color that has the ARGB value of #FF0000FF
brown : Color Gets the color that has the ARGB value of #FFA52A2A
chrome : Color Gets the chrome color in the current theme (control background)
cyan : Color Gets the color that has the ARGB value of #FF00FFFF
dark gray : Color Gets the color that has the ARGB value of #FFA9A9A9
foreground : Color Gets the foreground color in the current theme
from ahsb(alpha : Number, hue : Number, saturation : Number, brightness : Number) : Color Creates a color from the alpha, hue, saturation, brightness channels (0.0-1.0 range)
from argb(alpha : Number, red : Number, green : Number, blue : Number) : Color Creates a color from the alpha, red, green, blue channels (0.0-1.0 range)
from hsb(hue : Number, saturation : Number, brightness : Number) : Color Creates a color from the hue, saturation, brightness channels (0.0-1.0 range)
from rgb(red : Number, green : Number, blue : Number) : Color Creates a color from the red, green, blue channels (0.0-1.0 range)
gray : Color Gets the color that has the ARGB value of #FF808080
green : Color Gets the color that has the ARGB value of #FF008000
is light theme : Boolean Indicates if the user is using a light theme in his phone
light gray : Color Gets the color that has the ARGB value of #FFD3D3D3
linear gradient(c1 : Color, c2 : Color, alpha : Number) : Color Computes an intermediate color
magenta : Color Gets the color that has the ARGB value of #FFFF00FF
orange : Color Gets the color that has the ARGB value of #FFFFA500
purple : Color Gets the color that has the ARGB value of #FF800080
random : Color Picks a random color
red : Color Gets the color that has the ARGB value of #FFFF0000
sepia : Color Gets the color that has the ARGB value of #FF704214
subtle : Color Gets the subtle color in the current theme (light gray)
transparent : Color Gets the color that has the ARGB value of #00FFFFFF
white : Color Gets the color that has the ARGB value of #FFFFFFFF
yellow : Color Gets the color that has the ARGB value of #FFFFFF00

B.5 contract

Statements that test whether correctness requirements are satisfied.

assert(condition : Boolean, message : String) Checks for a condition; if the condition is false, execution fails. Does nothing for published scripts.
requires(condition : Boolean, message : String) Specifies a precondition contract for the action; if the condition is false, execution fails. Does nothing for published scripts.

B.6 invalid

Create an invalid value for any datatype.

Action : Action Creates an invalid Action instance
appointment : Appointment Creates an invalid Appointment instance
appointment collection : Appointment Collection Creates an invalid Appointment Collection instance
board : Board Creates an invalid Board instance
boolean : Boolean Creates an invalid Boolean instance
camera : Camera Creates an invalid Camera instance
color : Color Creates an invalid Color instance
contact : Contact Creates an invalid Contact instance
contact collection : Contact Collection Creates an invalid Contact Collection instance
datetime : DateTime Creates an invalid DateTime instance
device : Device Creates an invalid Device instance
device collection : Device Collection Creates an invalid Device Collection instance
form builder : Form Builder Creates an invalid Form Builder instance
json builder : Json Builder Creates an invalid Json Builder instance
json object : Json Object Creates an invalid Json Object instance
link : Link Creates an invalid Link instance
link collection : Link Collection Creates an invalid Link Collection instance
location : Location Creates an invalid Location instance
location collection : Location Collection Creates an invalid Location Collection instance
map : Map Creates an invalid Map instance
Matrix : Matrix Creates an invalid Matrix instance
media link : Media Link Creates an invalid Media Link instance
media link collection : Media Link Collection Creates an invalid Media Link Collection instance
media player : Media Player Creates an invalid Media Player instance
media player collection : Media Player Collection Creates an invalid Media Player Collection instance
media server : Media Server Creates an invalid Media Server instance
media server collection : Media Server Collection Creates an invalid Media Server Collection instance
message : Message Creates an invalid Message instance
message collection : Message Collection Creates an invalid Message Collection instance
message collection action : Action Creates an invalid Message Collection Action instance
motion : Motion Creates an invalid Motion instance
number : Number Creates an invalid Number instance
number collection : Number Collection Creates an invalid Number Collection instance
number map : Number Map Creates an invalid Number Map instance
oauth response : OAuth Response Creates an invalid OAuth Response instance
page : Page Creates an invalid Page instance
page button : Page Button Creates an invalid Page Button instance
page collection : Page Collection Creates an invalid Page Collection instance
picture : Picture Creates an invalid Picture instance
picture album : Picture Album Creates an invalid Picture Album instance
picture albums : Picture Albums Creates an invalid Picture Albums instance
pictures : Pictures Creates an invalid Pictures instance
place : Place Creates an invalid Place instance
place collection : Place Collection Creates an invalid Place Collection instance
playlist : Playlist Creates an invalid Playlist instance
playlists : Playlists Creates an invalid Playlists instance
position action : Action Creates an invalid Position Action instance
song : Song Creates an invalid Song instance
song album : Song Album Creates an invalid Song Album instance
song albums : Song Albums Creates an invalid Song Albums instance
songs : Songs Creates an invalid Songs instance
sound : Sound Creates an invalid Sound instance
sprite : Sprite Creates an invalid Sprite instance
sprite action : Action Creates an invalid Sprite Action instance
sprite set : Sprite Set Creates an invalid Sprite Set instance
sprite set action : Action Creates an invalid Sprite Set Action instance
string : String Creates an invalid String instance
string collection : String Collection Creates an invalid String Collection instance
string map : String Map Creates an invalid String Map instance
text action : Action Creates an invalid Text Action instance
textbox : TextBox Creates an invalid TextBox instance
vector3 : Vector3 Creates an invalid Vector3 instance
vector action : Action Creates an invalid Vector Action instance
web request : Web Request Creates an invalid Web Request instance
web response : Web Response Creates an invalid Web Response instance
webresponse action : Action Creates an invalid WebResponse Action instance
xml object : Xml Object Creates an invalid Xml Object instance

B.7 languages

Translation, and speech to text services.

current language : String Gets the current language code, to be used in the 'translate' method
detect language(text : String) : String Automatically detects the language of a given text using Bing.
picture to text(lang : String, pic : Picture) : String Extracts text in the picture using Project Hawaii from Microsoft Research
record text : String Converts the microphone dictation to text using Project Hawaii from Microsoft Research
speak(lang : String, text : String) : Sound Speaks the text in the specified language using Bing
speech to text(lang : String, speech : Sound) : String Converts a sound to a text using Project Hawaii from Microsoft Research
translate(source lang : String, target lang : String, text : String) : String Translates some text between two languages using Bing. Empty source language to auto-detect

B.8 locations

Geo coordinates services.

create location(latitude : Number, longitude : Number) : Location Creates a new geo coordinate location
create location list : Location Collection Creates an empty list of locations
describe location(location : Location) : String Looks for an address near a location using Bing
search location(address : String, postal code : String, city : String, country : String) : Location Looks for the coordinate of an address using Bing

B.9 maps

Maps, location to address and address to location services.

create full map : Map Creates a full screen Bing map. Use 'post to wall' to display it.
create map : Map Creates a Bing map. Use 'post to wall' to display it.
directions(from : Location, to : Location, walking : Boolean) : Location Collection Calculates the directions between two coordinates using Bing.
open directions(start search : String, start loc : Location, end search : String, end loc : Location) Shows the directions in the Bing map application. If search term is provided, location is ignored. Provide search term or location for start and end.
open map(center : Location, search : String, zoom : Number) Opens the Bing map application. zoom between 0 (close) and 1 (far)

B.10 math

Mathematical constants, operators, and functions such as cos, sin etc.

∞- : Number Returns negative infinity
∞+ : Number Returns positive infinity
abs(x : Number) : Number Returns the absolute value of a number
acos(x : Number) : Number Returns the angle whose cosine is the specified number
asin(x : Number) : Number Returns the angle whose sine is the specified number
atan(x : Number) : Number Returns the angle whose tangent is the specified number
atan2(y : Number, x : Number) : Number Returns the angle whose tangent is the quotient of two specified numbers
ceiling(x : Number) : Number Returns the smallest integral value greater than or equal to the specified number
cos(angle : Number) : Number Returns the cosine of the specified angle
cosh(angle : Number) : Number Returns the hyperbolic cosine of the specified angle
create matrix(rows : Number, columns : Number) : Matrix Creates a matrix of zeros of a given size
create vector3(x : Number, y : Number, z : Number) : Vector3 Creates a 3D vector
deg to rad(degrees : Number) : Number Converts degrees into radians
e : Number Returns the natural logarithmic base, specified by the constant, e
ε : Number Returns the machine epsilon, the smallest positive number greater than zero
exp(x : Number) : Number Returns e raised to the specified power
floor(x : Number) : Number Returns the largest integer less than or equal to the specified number
gravity : Number Returns the value of standard gravity  (9.80665) in meters/sec2
ieee remainder(x : Number, y : Number) : Number Returns the remainder resulting from the division of a specified number by another specified number
is ∞(x : Number) : Boolean Indicates whether number evaluates to negative or positive infinity
is ∞-(x : Number) : Boolean Indicates whether number evaluates to negative infinity
is ∞+(x : Number) : Boolean Indicates whether number evaluates to positive infinity
is nan(x : Number) : Boolean Indicates that value cannot be represented as a number, i.e. Not-a-Number. This usually happens when the number is the result of a division by zero.
log(x : Number, base : Number) : Number Returns the logarithm of a specified number in a specified base
log10(x : Number) : Number Returns the base 10 logarithm of a specified number
loge(x : Number) : Number Returns the natural (base e) logarithm of a specified number
max(x : Number, y : Number) : Number Returns the larger of two numbers
min(x : Number, y : Number) : Number Returns the smaller of two numbers
mod(x : Number, y : Number) : Number Returns the modulus resulting from the division of one number by another number
π : Number Returns the constant pi
pow(x : Number, y : Number) : Number Returns a specified number raised to the specified power
rad to deg(radians : Number) : Number Converts rad into degrees
random(max : Number) : Number Returns a random integral number x: 0 ≤ x < max
random normalized : Number Returns a random floating-point number x: 0 ≤ x < 1
round(x : Number) : Number Rounds a number to the nearest integral value
round with precision(x : Number, digits : Number) : Number Rounds a number to a specified number of fractional digits.
sign(x : Number) : Number Returns a value indicating the sign of a number
sin(angle : Number) : Number Returns the sine of the specified angle
sinh(angle : Number) : Number Returns the hyperbolic sine of the specified angle
sqrt(x : Number) : Number Returns the square root of a specified number
tan(angle : Number) : Number Returns the tangent of the specified angle
tanh(angle : Number) : Number Returns the hyperbolic tangent of the specified angle

B.11 media

Pictures and music.

choose picture : Picture Chooses a picture from the media library
choose song : Song Chooses a song from the media library (planned addition to the API)
create board(height : Number) : Board Creates a new game board
create landscape board(width: Number, height : Number) : Board Creates a new game board in landscape mode. On rotatable devices it will take the entire screen when posted.
create picture(width : Number, height : Number) : Picture Creates a new picture of the given size
create portrait board(width: Number, height : Number) : Board Creates a new game board in portrait mode. On rotatable devices it will take the entire screen when posted.
picture albums : Picture Albums Gets the picture albums
pictures : Pictures Gets the pictures on the phone
playlists : Playlists Gets the playlists on the phone
saved pictures : Pictures Gets the saved pictures on the phone
search marketplace(terms : String, type : String) Searches the Windows Phone Marketplace (type in applications or music)
song albums : Song Albums Gets the song albums on the phone
songs : Songs Gets the songs on the phone

B.12 phone

Phone numbers, vibrate, etc.

choose address : Link Chooses an address from the contacts
choose phone number : Link Chooses a phone number from the contact list
dial phone number(number : String) Starts a phone call
power source : String Indicates if the phone is on 'battery' or 'external' power source.
save phone number(phone number : String) Allows the user to save the phone number
vibrate(seconds : Number) Vibrates the phone for a number of seconds (0.02 minimum)

B.13 player

Play, stop or resume songs

active song : Song Gets the active song if any
is muted : Boolean Indicates if the player is muted
is paused : Boolean Indicates if the player is paused
is playing : Boolean Indicates if the player is playing a song
is repeating : Boolean Indicates if the player is repeating
is shuffled : Boolean Indicates if the player is shuffled
is stopped : Boolean Indicates if the player is stopped
next Moves to the next song in the queue of playing songs
pause Pauses the currently playing song
play(song : Song) Plays a Song
play home media(media : Media Link) Plays an audio/video file from the home network
play many(songs : Songs) Plays a collection of songs
play position : Number Gets the position in seconds within the active song
previous Moves to the previous song in the queue of playing songs
resume Resumes a paused song
set repeating(repeating : Boolean) Sets the repeating on and off
set shuffled(shuffled : Boolean) Sets the shuffling on and off
set sound volume(x : Number) Sets the sound volume level from 0 (silent) to 1 (current volume)
sound volume : Number Gets the sound volume for sounds from 0 (silent) to 1 (current volume)
stop Stops playing a song

B.14 senses

Camera, location, microphone and other sensors.

acceleration quick : Vector3 Gets filtered accelerometer data using a combination of a low-pass and threshold triggered high-pass on each axis to eliminate the majority of the sensor low amplitude noise while trending very quickly to large offsets (not perfectly smooth signal in that case), providing a very low latency. This is ideal for quickly reacting UI updates.
acceleration smooth : Vector3 Gets filtered accelerometer data using a 1 Hz first-order low-pass on each axis to eliminate the main sensor noise while providing a medium latency. This can be used for moderately reacting UI updates requiring a very smooth signal.
acceleration stable : Vector3 Gets filtered and temporally averaged accelerometer data using an arithmetic mean of the last 25 'optimally filtered' samples, so over 500ms at 50Hz on each axis, to virtually eliminate most sensor noise. This provides a very stable reading but it has also a very high latency and cannot be used for rapidly reacting UI.
battery level : Number Gets the charge level of the battery between 0 (discharged) and 1 (fully charged). Returns invalid if this information is not available.
camera : Camera Gets the primary camera
current location : Location Gets the current phone location. The phone optimizes the accuracy for power, performance, and other cost considerations.
current location accurate : Location Gets the current phone location with the most accuracy. This includes using services that might charge money, or consuming higher levels of battery power or connection bandwidth.
front camera : Camera Gets the front facing camera
has gyroscope : Boolean Indicates if the gyroscope is available on the device
heading : Number Gets the compass heading, in degrees, measured clockwise from the Earth’s geographic north.
is device stable : Boolean Indicates whether the device is 'stable' (no movement for about 0.5 seconds)
motion : Motion Gets the current phone motion that combines data from the accelerometer, compass and gyroscope.
orientation : Vector3 Gets the current orientation in degrees if available. (x,y,z) is also called (pitch, roll, yaw) or (alpha, beta, gamma).
record microphone : Sound Records audio using the microphone
rotation speed : Vector3 Gets the gyroscope rotational velocity around each axis of the device, in degrees per second.
take camera picture : Picture Takes a picture and returns it. This picture does not contain the gps location.

B.15 social

Emails, sms, contacts, and calendar services.

choose contact : Contact Chooses a contact from the contact list
choose email : Link Chooses an email from the contact list
create contact(nickname : String) : Contact Creates a new contact
create message(message : String) : Message Creates a message to share
create place(name : String, location : Location) : Place Creates a place
link email(email address : String) : Link Creates a link from an email
link phone number(phone number : String) : Link Creates a link from a phone number
save contact(contact : Contact) Saves a new contact
save email(email address : String) Allows the user to save the email address (email)
search(network : String, terms : String) : Message Collection Searches for recent messages in a social network (twitter, facebook)
search appointments(start : DateTime, end : DateTime) : Appointment Collection Searches for appointments in a given time range
search contacts(prefix : String) : Contact Collection Searches for contacts by name.
search places nearby(network : String, terms : String, location : Location, distance : Number) : Place Collection Searches for places nearby. The distance is in meters.
send email(to : String, subject : String, body : String) Opens the mail client
send sms(to : String, body : String) Opens the short message client (to, body)

B.16 tags

2D barcodes, QR codes and NFC tags..

send nfc(value : String, type : String) Sends a url or text using NFC
tag text(text : String, size : Number, bw : Boolean) : Picture Generates a 2D barcode pointing to the text using Microsoft Tag. text must be less than 1000 character long and size must be between 0.75 and 5 inches.
tag url(url : String, size : Number, bw : Boolean) : Picture Generates a 2D barcode pointing to the url using Microsoft Tag. url must be less than 1000 character long and size must be between 0.75 and 5 inches

B.17 tile

Windows 8 and Windows phones have tiles displayed on the start screen which initiate an application program when tapped. A tile may be associated with a TouchDevelop script through use of this service. Note: this resource replaces the Tile datatype which is no longer supported.

pin default prompt the user whether a tile should be pinned to the start screen
set default counter( n : Number ) Set a counter (a number) which is displayed on the tile; only values in the range 1 to 99 are displayed; other values are hidden
set default text( title: String, text : String) Displays a short title and a longer piece of text on the tile

B.18 time

Time and date operations.

create(year : Number, month : Number, day : Number, hour : Number, minute : Number, second : Number) : DateTime Creates a new date instance
fail if not(condition : Boolean) Aborts the execution if the condition is false.
log(message : String) Appends this message to the debug log. Does nothing when the script is published.
now : DateTime Gets the current time
sleep(seconds : Number) Waits for a specified amount of seconds
stop Stops the execution and stays on the wall.
today : DateTime Gets today's date without time
tomorrow : DateTime Gets tomorrow's date without time

B.19 wall

Ask for or display values on the wall.

add button(icon : String, text : String) : Page Button Add a new button. icon must be the name of a built-in icon, text must be non-empty.
ask boolean(text : String, caption : String) : Boolean Prompts the user with ok and cancel buttons
ask number(text : String) : Number Prompts the user to input a number
ask string(text : String) : String Prompts the user to input a string
button icon names : String Collection Gets the list of available page button names.
clear Clears the background, buttons and entries
clear background Clears the background color, picture and camera
clear buttons Clears the application bar buttons and hides the bar
create text box(text : String, font size : Number) : TextBox Creates an updatable text box
current page : Page Gets the current page displayed on the wall
display search(on : Boolean) Indicates whether to show or hide the search icon
pages : Page Collection Returns the current back stack of pages, starting from the current page to the bottom page.
pick date(text : String, caption : String) : DateTime Prompts the user to pick a date. Returns a datetime whose date is set, the time is 12:00:00.
pick string(text : String, caption : String, values : String Collection) : Number Prompts the user to pick a string from a list. Returns the selected index.
pick time(text : String, caption : String) : DateTime Prompts the user to pick a time. Returns a datetime whose time is set, the date is undefined.
pop page : Boolean Pops the current page and restores the previous wall page. Returns false if already on the default page.
prompt(text : String) Prompts the user with an ok button
push new page : Page Pushes an empty page on the wall
screenshot : Picture Takes a screenshot of the wall
set background(color : Color) Sets the wall background color
wall→set background camera( camera : Camera) Sets the wall background camera
set background picture(picture : Picture) Sets the wall background picture. The picture will be resized and clipped to the screen background as needed
set foreground(color : Color) Sets the wall foreground color of elements
set reversed(bottom : Boolean) Reverses the elements on the wall and inserts new ones at the bottom.
set subtitle(title : String) Sets the subtitle of the wall
set title(title : String) Sets the title of the wall
set transform matrix(m11 : Number, m12 : Number, m21 : Number, m22 : Number, offsetx : Number, offsety : Number) Sets the 3x3 affine matrix transformation applied to the wall

B.20 web

Search and browse the web.

base64 decode(text : String) : String Decodes a string that has been base64-encoded
base64 encode(text : String) : String Converts a string into an base64-encoded string
browse(url : String) Opens a web browser to a url
connection name : String Gets a name of the currently connected network servicing Internet requests
connection type : String Gets the type of the network servicing Internet requests (unknown, none, ethernet, wifi, mobile)
create form builder : Form Builder Create a form builder
create json builder : Json Builder Creates a json builder
create request(url : String) : Web Request Creates a web request
csv(text : String, delimiter : String) : Json Object Parses a Command Separated Values document into a JsonObject where the headers is a string array of column names; records is an array of rows where each row is itself an array of strings. The delimiter is inferred if not specified.
download(url : String) : String Downloads the content of an internet page (http get)
download json(url : String) : Json Object Downloads a web service response as a JSON data structure (http get)
download picture(url : String) : Picture Downloads a picture from internet
download song(url : String, name : String) : Song Create a streamed song file from internet (download happens when playing)
download sound(url : String) : Sound Downloads a WAV sound file from internet
feed(value : String) : Message Collection Parses the newsfeed string (RSS 2.0 or Atom 1.0) into a message collection
html decode(html : String) : String Decodes a string that has been HTML-encoded
html encode(text : String) : String Converts a text string into an HTML-encoded string
is connected : Boolean Indicates whether any network connection is available
json(value : String) : Json Object Parses the string as a json object
json array : Json Object Returns an empty json array
json object : Json Object Returns an empty json object
link image(url : String) : Link Creates a link to an internet image
link media(url : String) : Link Creates a link to an internet audio/video
link url(name : String, url : String) : Link Creates a link to an internet page
oauth v2(oauth url : String) : OAuth Response Authenticate with OAuth 2.0 and receive the access token or error. (See oauthv2 for more information on which Redirect URI to choose.)
open connection settings(page : String) Opens a connection settings page (airplanemode, bluetooth, wiki, cellular)
play media(url : String) Plays an internet audio/video in full screen
search(terms : String) : Link Collection Search the web using Bing
search images(terms : String) : Link Collection Search for images using Bing
search images nearby(terms : String, location : Location, distance : Number) : Link Collection Search for images near a location using Bing. Distance in meters, negative to ignore.
search nearby(terms : String, location : Location, distance : Number) : Link Collection Searching the web near a location using Bing. Distance in meters, negative to ignore.
search news(terms : String) : Link Collection Search for news using Bing
search news nearby(terms : String, location : Location, distance : Number) : Link Collection Search for news near a location using Bing. Distance in meters, negative to ignore.
upload(url : String, body : String) : String Uploads text to an internet page (http post)
upload picture(url : String, pic : Picture) : String Uploads a picture to an internet page (http post)
url decode(url : String) : String Decodes a string that has been url-encoded
url encode(text : String) : String Converts a text string into an url-encoded string
xml(value : String) : Xml Object Parses the string as a xml element

Author information

Authors and Affiliations

Authors

Rights and permissions

Open Access This chapter is licensed under the terms of the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License (http://creativecommons.org/licenses/by-nc-nd/4.0/), which permits any noncommercial use, sharing, distribution and reproduction in any medium or format, as long as you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons licence and indicate if you modified the licensed material. You do not have permission under this licence to share adapted material derived from this chapter or parts of it.

The images or other third party material in this chapter are included in the chapter’s Creative Commons licence, unless indicated otherwise in a credit line to the material. If material is not included in the chapter’s Creative Commons licence and your intended use is not permitted by statutory regulation or exceeds the permitted use, you will need to obtain permission directly from the copyright holder.

Reprints and Permissions

Copyright information

© 2013 R. Nigel Horspool

About this chapter

Cite this chapter

Horspool, R.N., Tillmann, N. (2013). TouchDevelop Services. In: TouchDevelop: Programming on the Go. Apress, Berkeley, CA. https://doi.org/10.1007/978-1-4302-6137-7_13

Download citation

We’re sorry, something doesn't seem to be working properly.

Please try refreshing the page. If that doesn't work, please contact support so we can address the problem.