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.
You have full access to this open access chapter, Download chapter PDF
Keywords
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
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.
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
DOI: https://doi.org/10.1007/978-1-4302-6137-7_13
Published:
Publisher Name: Apress, Berkeley, CA
Print ISBN: 978-1-4302-6136-0
Online ISBN: 978-1-4302-6137-7
eBook Packages: Professional and Applied ComputingApress Access BooksProfessional and Applied Computing (R0)