Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.
Link2SMS - a protocol handling example
This article explains how to create a protocol handler for Windows Phone 8, using the particular example of handling sms: links (as found, for example, in NFC tags).
One popular use case for NFC is the implementation of the "tap to call a taxi" scenario. A predefined phone number and message is encoded in an NFC tag attached to a poster that advertises the service. All a user has to do is tap the poster and then confirm that they want to send the message - one tap of the phone and one tap on the phone, and your taxi order is placed.
The problem with the above use case is that it relies on the sms: protocol being handled on the device and Windows Phone does not support it at time of writing. Luckily on Windows Phone 8, third-party developers can add their own protocol handler applications and this article will show how easy this sms: handling gap can be filled.
We start by creating a simple Windows Phone application. We then add the following protocol specification to WMAppManifest.xml (note that the <Extensions> must follow the <Tokens> ):
<Protocol Name="sms" NavUriFragment="encodedLaunchUri=%s" TaskID="_default" />
Now the application will be recognized as a sms: protocol handler and will be called each time a link using this protocol is activated, be it from an other app, from a browser or from an NFC tag.
Handling the sms protocol URI
When our application is started, its navigation context will contain the fragment encodedLaunchUri with the actual link URL encoded as its value.
Since the app would probably want to handle this special start mode in a different way than when the user starts it from the menu or tile, we implement an URIMapper as follows:
class LinkToSMSUriMapper : UriMapperBase
private string tempUri;
public override Uri MapUri(Uri uri)
tempUri = System.Net.HttpUtility.UrlDecode(uri.ToString());
// URI association launch for sms.
int phoneNoIndex = tempUri.IndexOf("sms:") + 4;
// url encode back the payload string before passing it to the navigation framework
string payload = System.Net.HttpUtility.UrlEncode(tempUri.Substring(phoneNoIndex));
// Redirect this text message send request to the view specialized in handling such request
return new Uri("/MainPage.xaml?SMS=" + payload, UriKind.Relative);
// Otherwise perform normal launch.
// Global handler for uncaught exceptions.
UnhandledException += Application_UnhandledException;
// Standard XAML initialization
// Phone-specific initialization
// Assign the URI-mapper class to the application frame.
RootFrame.UriMapper = new LinkToSMSUriMapper();
In the MapUri() method the string received is first URL decoded then parsed to identify the protocol. If the SMS protocol is found its parameters are passed forward to one of the XAML pages, in this case the MainPage.xaml, for handling. Note that the parameters passed on to the page are again URL encoded so that no information is lost during the automatic parsing done in the navigation context.
In MainPage.xaml.cs the SMS can be handled by simply calling the SmsComposeTask using the phone number and message retrieved from the link:
// Sample code to localize the ApplicationBar
Loaded += MainPage_Loaded;
void MainPage_Loaded(object sender, RoutedEventArgs e)
string token = this.NavigationContext.QueryString["SMS"];
int bodyPos = token.IndexOf("?body=");
string phoneNo = token.Substring(0, bodyPos);
string body = token.Substring(bodyPos + 6);
SmsComposeTask smsComposeTask = new SmsComposeTask();
smsComposeTask.To = phoneNo;
smsComposeTask.Body = body;
// The view was entered without an SMS to handle, so likely the app was started from the app list.
As simple as that. Now you can use the NFC Interactor to write something like "sms:+5551234?body=This is a sample text message." on an NFC tag then tap it with your phone to have the message compose and sent away after user's confirmation. In our Taxi example, this sample message might include the poster location (or the location might be retrieved from the device).