08 | Advanced Features Jerry Nixon | Microsoft Developer Evangelist Daren May | President & Co-founder, Crank211
Agenda for the Day First HalfSecond Half 01 | Animations05 | Advanced Contracts Pt | Responsive Design06 | Advanced Contracts Pt | Branding07 | Media 04 | Reusable Controls 08 | Advanced Features ** MEAL BREAK ** Visit xamlShow on CodePlex
Microsoft Virtual Academy Windows Live
Uses OAuth 2.0, JSON and REST APIs Simplifies log in and token management Provides shims & UI for interacting endpoints The SDK provides access to: –SkyDrive –Outlook.com –Skype Live SDK for Windows 8
Microsoft Virtual Academy Microsoft Account
Microsoft account –Authentication –Personalization –Information –Scopes wl.basic wl.signin Guidelines –Sign-in state –Enable sign-out Microsoft account
Microsoft Account
Microsoft Virtual Academy SkyDrive
Microsoft’s cloud storage solution for files and photo sharing Guidelines for using SkyDrive in Windows 8 Apps –Upload data in response to user action Apps are allowed to store data without user interaction –Use SkyDrive for what it does best Documents, photos, etc. –Don’t undermine trust Respect user security and privacy Warn if data is public, etc. SkyDrive overview
Don’t scatter data around SkyDrive Follow this pattern: –[SkyDrive root] Sub folder: ApplicationData –Sub folder: [Application Name] ([Publisher Name or Company Name]) »Files… Where to store app data in SkyDrive
Interact with files using HTTP operations: –POST / PUT to upload –GET to download –MOVE / COPY to move or copy without downloading –The SDK wrappers these operations for you: LiveConnectClient.PostAsync LiveConnectClient.GetAsync Etc. Permissions –Inherited from parent object up the folder hierarchy SkyDrive API Core Concepts
id - prefixed with file or folder –i.e. “file.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!126” name – user supplied display name –i.e. “EpisodeNotes.txt” description type – file, folder, album, etc. source – if a file, the path to download the file – Useful folder and file properties
Important types: –LiveConnectSession –LiveConnectClient Requires a valid session Required scope: –wl.skydrive - Read access –wl.skydrive_update – read and write access –LiveOperationResult contains a dynamic dictionary containing resultant key/value pairs Working with SkyDrive API
Supply the itemId as either an id or one of the few friendly names: file.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!126 /me/skydrive Retrieving file or folder properties
Warning: no type safety or compiler checks! Result properties can be access via dynamic
Files and folders are contained within a parent folder up to /me Don’t use fully qualified paths Understanding folder and file hierarchy
Some folders are accessed by Folder ID –Example: folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!126 Some folders are accessed by name –/me - details about the signed in user –/me/skydrive – root of your SkyDrive folder –/me/calendars –/me/contacts –/me/events List files by obtaining the containing folder id Understanding folder and file hierarchy
Imagine we want to download filename.txt: –/me/skydrive/directory1/directory2/filename.txt In order to retrieve a list of files and folders contained in directory1 (and we don’t know directory1’s id), we first need to get a list of the folders in /me/skydrive Download a file: Step 1 : Get folders of “/me/skydrive”
Once we have the list of files and folders (from /me/skydrive), we can find directory1 and its id property: –id = folder.96a6fb5ab7b940c6.96A6FB5AB7B940C6!123 Download a file: Step 2 : Get “directory1” from list
We use the Folder Id to find the folders in directory1, so we can find the id for directory2: Download a file: Step 3 : Get folders of “directory1”
We repeat the last few steps and get directory2’s id, –directory2Id = folder.bb1b4E12b9f9414f.BB1B4E12B9F9414F!231 We use can get a list of files (and folders) in directory2: Download a file: Step 5 : Get files of “directory2”
We can the find the properties for filename.txt and the path we need to download it: Download a file: Step 6 : Get “file.txt” file url
Now we have the download path, we need to create a local StorageFile where we will write the downloaded file Download a file: Step 7 : Create local target
Use the download path –Note: uses the background downloader Download a file: Step 8 : Create local target
1.Get folders of “/me/skydrive” 2.Get “directory1” from list 3.Get folders of “directory1” 4.Get “directory2” from list 5.Get files of “directory2” 6.Get “file.txt” file url 7.Create local target 8.Download to target Get a file, recap
Once we have the containing folder Id, uploading a file is straightforward: Uploading a file
Names conflict –You can have multiple directory1 folders throughout your hierarchy Why all these IDs?
SkyDrive
©2013 Microsoft Corporation. All rights reserved. Microsoft, Windows, Office, Azure, System Center, Dynamics and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.