{"id":13837,"date":"2017-02-09T03:30:04","date_gmt":"2017-02-08T18:30:04","guid":{"rendered":"https:\/\/jirak.net\/wp\/announcing-project-rome-android-sdk\/"},"modified":"2017-02-09T03:34:26","modified_gmt":"2017-02-08T18:34:26","slug":"announcing-project-rome-android-sdk","status":"publish","type":"post","link":"https:\/\/jirak.net\/wp\/announcing-project-rome-android-sdk\/","title":{"rendered":"Announcing Project Rome Android SDK"},"content":{"rendered":"

Announcing Project Rome Android SDK
\n<\/p>\n

Project Rome Overview<\/h2>\n

Project Rome<\/strong> is a platform for creating experiences that transcend a single device and driving up user engagement \u2013 empowering a developer to create human-centric scenarios that move with the user and blur the lines between their devices regardless of form factor or platform.<\/p>\n

We first shipped Project Rome capabilities for Remote Launch and Remote App Services in Windows 10 Anniversary Update.<\/p>\n

Project Rome Android SDK<\/h2>\n

\"\"<\/a><\/p>\n

Today we are excited to announce the release of the Android version of the Project Rome SDK<\/strong>.\u00a0 This Android SDK works both with Java and with Xamarin.<\/p>\n

You can download the Project Rome SDK for Android at <a href="https:\/\/github.com\/Microsoft\/project-rome\/tree\/master\/Project%20Rome%20for%20Android%20(preview%20release)<\/a>).<\/p>\n

Capabilities exposed through the Project Rome Android SDK<\/h2>\n

Let\u2019s take an example of an app that might need this capability. In the last blog post<\/a>, we had talked about Paul and his Contoso Music App. In that scenario, Paul had his UWP app which was a music player, and he wanted to make sure that his users had a way to communicate between his app as they moved between devices.<\/p>\n

\"\"<\/a><\/p>\n

If we take that example further, we can imagine that Paul has a Contoso Music App for Android as well. Paul notices that most of his users use his app on Windows, and on Android. These are the same users logged in with the same MSA. Paul wants to make sure that his users\u2019 experience translates well when they move between their Android and Windows devices. Paul also notices that many of his Windows users run his UWP app on their Xbox at home.<\/p>\n

With the Project Rome Android SDK Paul can use:<\/p>\n

    \n
  1. The Remote Systems API to discover other Windows devices that the user owns. The Remote Systems APIs will allow the Contoso Music app to discover these devices on the same network, and through the cloud.<\/li>\n
  2. Once discovered, the Remote Launch API will launch his app on another Windows device.<\/li>\n
  3. Once his app is launched on the other device, Paul can use remote app services to control his app running on Windows from his Android device. We are not releasing this functionality in the release today, but it is coming soon in a future release of the Android SDK.<\/li>\n<\/ol>\n

    Thus, using the Project Rome Android SDK, Paul can bridge the experience gap that exists as his users move between their Android and Windows devices.<\/p>\n

    Capability Walkthrough<\/h2>\n

    We will briefly walk through both a Java and Xamarin example.\u00a0 We have full examples of UWP here: https:\/\/github.com\/Microsoft\/Windows-universal-samples\/tree\/dev\/Samples\/RemoteSystems<\/a> and Android here: https:\/\/github.com\/Microsoft\/project-rome\/tree\/master\/Project%20Rome%20for%20Android%20(preview%20release)<\/a>.<\/p>\n

    Click on the image below to see the Android Sample app in action:<\/h3>\n

    <\/a><\/p>\n

    Using Java<\/h3>\n

    Here are snippets in Java from our sample of how you\u2019d use the Project Rome Android SDK.\u00a0 The first step to get going with the Android SDK is to initialize the platform, where you\u2019ll handle authentication.<\/p>\n

    \r\n\r\nPlatform.initialize(getApplicationContext(), new IAuthCodeProvider() {\r\n    @Override\r\n    public void fetchAuthCodeAsync(String oauthUrl, Platform.IAuthCodeHandler authCodeHandler) {\r\n        performOAuthFlow(oauthUrl, authCodeHandler);            \r\n    }\r\n}\r\n\r\n<\/pre>\n
    Using OAuth you\u2019ll retrieve an auth_code via a WebView:<\/p>\n
    \r\n\r\npublic performOAuthFlow (String oauthUrl, Platform.IAuthCodeHandler authCodeHandler) {\r\n\r\n    WebView web;\r\n    web = (WebView) _authDialog.findViewById(R.id.webv);\r\n    web.setWebChromeClient(new WebChromeClient());\r\n    web.getSettings().setJavaScriptEnabled(true);\r\n    web.getSettings().setDomStorageEnabled(true);\r\n\r\n    \/\/ Get auth_code\r\n    web.loadUrl(oauthUrl);\r\n\r\n    WebViewClient webViewClient = new WebViewClient() {\r\n        boolean authComplete = false;\r\n        @Override\r\n        public void onPageFinished(WebView view, String url) {\r\n            super.onPageFinished(view, url);\r\n\r\n            if (url.startsWith(REDIRECT_URI)) {\r\n                Uri uri = Uri.parse(url);\r\n                String code = uri.getQueryParameter(&amp;quot;code&amp;quot;);\r\n                String error = uri.getQueryParameter(&amp;quot;error&amp;quot;);\r\n                if (code != null &amp;amp;&amp;amp; !authComplete) {\r\n                authComplete = true;\r\n                authCodeHandler.onAuthCodeFetched(code);\r\n                } else if (error != null) {\r\n                  \/\/ Handle error case                                    }\r\n            }\r\n         }\r\n    };\r\n\r\n    _web.setWebViewClient(webViewClient);\r\n}\r\n\r\n<\/pre>\n
    Now, discover devices:<\/p>\n
    \r\n\r\nRemoteSystemDiscovery.Builder discoveryBuilder;\r\ndiscoveryBuilder = new RemoteSystemDiscovery.Builder().setListener(new IRemoteSystemDiscoveryListener() {\r\n    @Override\r\n    public void onRemoteSystemAdded(RemoteSystem remoteSystem) {\r\n        Log.d(TAG, &amp;quot;RemoveSystemAdded = &amp;quot; + remoteSystem.getDisplayName());\r\n        devices.add(new Device(remoteSystem));\r\n        \/\/ Sort devices\r\n        Collections.sort(devices, new Comparator&amp;lt;Device&amp;gt;() {\r\n            @Override\r\n            public int compare(Device d1, Device d2)\r\n            {\r\n                return d1.getName().compareTo(d2.getName());\r\n            }\r\n        });\r\n       }\r\n});\r\nstartDiscovery();\r\n\r\n<\/pre>\n
    Remote launch a URI to your device:<\/p>\n
    \r\n\r\nnew RemoteSystemConnectionRequest(remoteSystem)\r\nString url = &amp;quot;http:\/\/msn.com&amp;quot;\r\n\r\nnew RemoteLauncher().LaunchUriAsync(connectionRequest,\r\n        url,\r\n        new IRemoteLauncherListener() {\r\n            @Override\r\n            public void onCompleted(RemoteLaunchUriStatus status) {\r\n\r\n            \u2026\r\n            }\r\n        };\r\n\r\n<\/pre>\n
    Using Xamarin<\/h3>\n
    Similarly, here are snippets in Xamarin.<\/p>\n
    You will first initialize the Connected Devices Platform:<\/p>\n
    \r\n\r\nPlatform.FetchAuthCode += Platform_FetchAuthCode;\r\nvar result = await Platform.InitializeAsync(this.ApplicationContext, CLIENT_ID);\r\n\r\n<\/pre>\n
    Using OAuth you\u2019ll retrieve an auth_code:<\/p>\n
    \r\n\r\nprivate async void Platform_FetchAuthCode(string oauthUrl)\r\n{\r\n    var authCode = await AuthenticateWithOAuth(oauthUrl);\r\n    Platform.SetAuthCode(token);\r\n}\r\n\r\n<\/pre>\n
    Now, discover devices:<\/p>\n
    \r\n\r\nprivate RemoteSystemWatcher _remoteSystemWatcher;\r\nprivate void DiscoverDevices()\r\n{\r\n    _remoteSystemWatcher = RemoteSystem.CreateWatcher();\r\n    _remoteSystemWatcher.RemoteSystemAdded += (sender, args) =&amp;gt;\r\n    {\r\n        Console.WriteLine(&amp;quot;Discovered Device: &amp;quot; + args.P0.DisplayName);\r\n    };\r\n    _remoteSystemWatcher.Start();\r\n}\r\n\r\n<\/pre>\n
    Finally, connect and launch URIs using LaunchUriAsync:<\/p>\n
    \r\n\r\nprivate async void RemoteLaunchUri(RemoteSystem remoteSystem, Uri uri)\r\n{\r\n    var launchUriStatus = await RemoteLauncher.LaunchUriAsync(new RemoteSystemConnectionRequest(remoteSystem), uri);\r\n}\r\n\r\n<\/pre>\n
    If you want to see the Xamarin code, please head over to https:\/\/github.com\/Microsoft\/project-rome\/tree\/master\/xamarin<\/a>.<\/p>\n
    Wrapping Up<\/h2>\n
    Project Rome breaks down barriers across all Windows devices and creates experiences that are no longer constrained to a single device. With today\u2019s announcement, we are bringing this capability to Android devices as well. The Remote Systems API available in Windows 10 is a key piece of Project Rome that provides exposure of the device graph and the ability to connect and command \u2013 this is fundamental for driving user engagement and productivity for applications across all devices<\/strong>.<\/p>\n
    To learn more and browse sample code, including the snippets shown above, please check out the following articles and blog posts:<\/p>\n