Windows (Phone) 8 NFC App Scenarios

Windows (Phone) 8 NFCApp ScenariosAndreas Jakl NFC Introduction Related Presentations bit.ly/NfcIntro[@mopius] NFC Development on the Windows 8 Platformnfcinteractor.com bit.ly/Win8NFCTechnology WizardNokia NFC Development with Qt on Symbian and MeeGo bit.ly/NfcDevelopment 1 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl NFC Forum and the NFC Forum logo are trademarks of the Near Field Communication Forum.

Near Field Communication NDEF Library Nfc Interactor Seamless Multi- User Games & Discover Your App Share to Others Collaboration2 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Tap and Do A gesture that is a natural interaction between people in close proximity used to trigger doing something together between the devices they are holding. System: Near Field Proximity (e.g., NFC)5 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl Driver Specification: bit.ly/ProximitySpec

General Project Setup1 Add Proximity Capability2 Initialize ProximityDevice _device = ProximityDevice.GetDefault(); Connect to HW Detect devices in range Publish & subscribe to messages9 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Discover Your App Tag directly contains app name and parameters Tag / phone launches app through custom URI scheme10 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

parameters t a b platform 1 a b t app name 1 a b t platform 2 t a b app name 2 … Encoded into NDEF message* Directly launch App11 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl * For your low-level interest: type: Absolute URI, type name format: windows.com/LaunchApp. Contents re-formatted, e.g., with string lengths before each value

Write LaunchApp Tags1 Launch parameters, platforms + app IDs // Arguments to pass to app, valid for all platforms var launchArgs = "user=default"; // WP8: apps product id from the app manifest, wrapped in {} var wp8App = "{5e506af4-4586-4c90-bc5f-428b12cf48bc}"; // Win8: app ID: Package.appxmanifest -> source -> <Application Id="..."> var win8AppId = "Proximity.App"; var win8App = Windows.ApplicationModel.Package.Current.Id.FamilyName + "!" + win8AppId; // Combine to LaunchApp Message var launchAppMessage = launchArgs + "tWindowsPhonet" + wp8App + "tWindowst" + win8App;12 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Write LaunchApp Tags2 Convert to byte array var dataWriter = new Windows.Storage.Streams.DataWriter {UnicodeEncoding = Windows.Storage.Streams.UnicodeEncoding.Utf16LE}; dataWriter.WriteString(launchAppMessage);3 Write to tags _device.PublishBinaryMessage("LaunchApp:WriteTag", dataWriter.DetachBuffer());13 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Cross-Platform LaunchApp* NDEF Message Windows Symbian Generic URL Android Android App Application LaunchApp Custom Website Record URL (AAR) windows.com/LaunchApp e.g., nokia.com:nfcinteractor e.g., http://nfcinteractor.com android.com:pkg App IDs for Windows + WP8 Register app for custom type Links to store Payload: app package name(incl. custom app arguments) 14 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl * More information: http://bit.ly/LaunchApp - write using the open source NDEF Library: https://ndef.codeplex.com/

nfcinteractor: compose Protocol Custom name data Encoded Launch URI Examples* skype:mopius?call spotify:search:17th%20boulevard15 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl * Definition & examples: http://en.wikipedia.org/wiki/URI_scheme

WP Protocol Association Note: different in Win8 / WP81 Specify protocol name in WMAppManifest.xml ...</Tokens> Protocol <Extensions> name <Protocol Name="nfcinteractor" NavUriFragment="encodedLaunchUri=%s" TaskID="_default" /> </Extensions> Fixed2 Create UriMapper to parse parameters class NfcInteractorUriMapper : UriMapperBase { public override Uri MapUri(Uri uri) { var tempUri = HttpUtility.UrlDecode(uri.ToString()); // Launched from associated "nfcinteractor:" protocol if (tempUri.Contains("nfcinteractor:")) { return new Uri("/MainPage.xaml?" + /* Parse parameters */, UriKind.Relative); } // Not launched via protocol - return default URI return uri; }}17 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

WP Protocol Association3 Use UriMapper in App.xaml.cs private void InitializePhoneApplication() { RootFrame = new PhoneApplicationFrame(); RootFrame.UriMapper = new NfcInteractorUriMapper(); }– If needed: launch protocol from app (for app2app comm) await Windows.System.Launcher.LaunchUriAsync(new Uri("nfcinteractor:compose"));18 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Publish Messages1 Start publishing _publishingMessageId = _device.PublishUriMessage( new Uri("nfcinteractor:compose"));• Proximity devices only – (doesn’t write tags) Contains scheme,• Windows Protocol + URI record platform & App ID – Encapsulated in NDEF21 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Write Tags1 Prepare & convert data var dataWriter = new Windows.Storage.Streams.DataWriter { UnicodeEncoding = Windows.Storage.Streams. UnicodeEncoding.Utf16LE}; Mandatory dataWriter.WriteString("nfcinteractor:compose"); encoding var dataBuffer = dataWriter.DetachBuffer();2 Write tag (no device publication) _device.PublishBinaryMessage("WindowsUri:WriteTag", dataBuffer);22 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Seamless Multi-User Games & Tap forCollaboration Quick Data Long Term Exchange Connection ProximityDevice PeerFinder Exchange Windows / Automatically builds NDEF messages, Bt / WiFi Direct SNEP protocol socket connection24 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Connection State Proximity gesture complete 1 Devices can be pulled away PeerFound Which device initiated tap gesture? → Connecting, other device Listening 2 Connecting / Listening Access socket of persistent transport (e.g., TCP/IP, Bt) 3 Completed27 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Find Peers1 Start waiting for triggered connections PeerFinder.TriggeredConnectionStateChanged += TriggeredConnectionStateChanged; PeerFinder.Start();2 Peer found & connection established? Send message over socket private async void TriggeredConnectionStateChanged(object sender, TriggeredConnectionStateChangedEventArgs eventArgs) { if (eventArgs.State == TriggeredConnectState.Completed) { // Socket connection established! var dataWriter = new DataWriter(eventArgs.Socket.OutputStream); dataWriter.WriteString("Hello Peer!"); var numBytesWritten = await dataWriter.StoreAsync(); }} 328 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl Completed * For URI records + simple Smart Poster (w/o title), use the WindowsUri type.

UX Recommendations*User initiated peer Show connection Ask for consent search only stateFailed connection? Let user get out of Proximity: only ifInform & revert to proximity connection details single-user mode experience not relevant30 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl * bit.ly/ProximityUX

Data on an NFC Tag Smart PosterTitleThe JourneyURIjourney2.mopius.com Data Encapsulated in Encoded through Stored on NDEF Records NDEF Message NFC Forum NFC Forum Tag Tag Type Platform34 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl NDEF = NFC Data Exchange Format, Container image adapted from s_volenszki (Flickr), released under Creative Commons BY-NC 2.0

Reading NDEF1 Subscribe to all NDEF messages _subscribedMessageId = _device.SubscribeForMessage( "NDEF", MessageReceivedHandler);2 Parse raw byte array in handler  http://www.nfc-forum.org/specs/35 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Reading NDEF1 Subscribe to all NDEF messages // Convert the language code to a byte array assembling payload of Text record var languageEncoding = Encoding.UTF8; var encodedLanguage = languageEncoding.GetBytes(languageCode); _subscribedMessageId = _device.SubscribeForMessage( // Encode and convert the text to a byte array var encoding = (textEncoding == TextEncodingType.Utf8) ? Encoding.UTF8 : Encoding.BigEndianUnicode; "NDEF", MessageReceivedHandler); var encodedText = encoding.GetBytes(text); // Calculate the length of the payload & create the array var payloadLength = 1 + encodedLanguage.Length + encodedText.Length;2 Parse raw byte array in handler  Payload = new byte[payloadLength]; // Assemble the status byte Payload[0] = 0; // Make sure also the RFU bit is set to 0 // Text encoding if (textEncoding == TextEncodingType.Utf8) Simple example: Payload[0] &= 0x7F; // ~0x80 else http://www.nfc-forum.org/specs/ Payload[0] |= 0x80; // Language code length Payload[0] |= (byte)(0x3f & (byte)encodedLanguage.Length); // Language code Array.Copy(encodedLanguage, 0, Payload, 1, encodedLanguage.Length); // Text Array.Copy(encodedText, 0, Payload, 1 + encodedLanguage.Length, encodedText.Length);36 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

NDEF.codeplex.com Create NDEF Reusable Parse information messages & records NDEF from raw byte arrays (standard compliant) classes Fully documented Open Source LGPL license (based on Qt Mobility)38 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Reading: Smart Poster// Parse raw byte array to NDEF messagevar msg = NdefMessage.FromByteArray(rawMsg);foreach (NdefRecord record in msg){ // Go through each record, check if its a Smart Poster if (record.CheckSpecializedType(false) == typeof (NdefSpRecord)) { // Convert and extract Smart Poster info var spRecord = new NdefSpRecord(record); Debug.WriteLine("URI: " + spRecord.Uri); Debug.WriteLine("Titles: " + spRecord.TitleCount()); Debug.WriteLine("1. Title: " + spRecord.Titles[0]); Debug.WriteLine("Action set: " + spRecord.ActionInUse());} }39 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Writing: Smart Poster// Initialize Smart Poster record with URI, Action + 1 Titlevar spRecord = new NdefSpRecord { Uri = "http://nokia.com", NfcAction = NdefSpActRecord.NfcActionType.DoAction };spRecord.AddTitle(new NdefTextRecord { Text = "Nokia", LanguageCode = "en" });// Add record to NDEF messagevar msg = new NdefMessage { spRecord };// Publish NDEF message to a tag_device.PublishBinaryMessage("NDEF:WriteTag", msg.ToByteArray().AsBuffer());// Alternative: send NDEF message to another NFC device_device.PublishBinaryMessage("NDEF", msg.ToByteArray().AsBuffer());40 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Supported Record Types Geo tags Smart Poster Social tags URI SMS tags Text Telephone call LaunchApp Android Application Record (AAR) Nokia Accessories Record41 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Near Field Communication NDEF Library Nfc Interactor Seamless Multi- User Games & Discover Your App Share to Others Collaboration42 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

Thank You.Andreas Jakl NFC Introduction Related Presentations bit.ly/NfcIntro[@mopius] NFC Development on the Windows 8 Platformnfcinteractor.com bit.ly/Win8NFCTechnology WizardNokia NFC Development with Qt on Symbian and MeeGo bit.ly/NfcDevelopment 43 © 2012 Nokia Windows (Phone) 8 NFC App Scenarios v2.1.0 November 5, 2012 Andreas Jakl

http://www.scoop.it	42
http://supriyono-regman02.blogspot.com	18
http://www.redditmedia.com	11
https://twitter.com	4
http://windows8masrapido.blogspot.com	4
http://windows8masrapido.blogspot.mx	4

Windows (Phone) 8 NFC App Scenarios

by Andreas Jakl on Nov 05, 2012

Accessibilité

Détails de l'import

Droits d'utilisation

6 Ajouts 83

Statistiques

Windows (Phone) 8 NFC App Scenarios Presentation Transcript