microsoft / project-rome

Code samples and documentation of Microsoft's Project Rome SDK

Project Rome

Project Rome is Microsoft's cross-device experiences platform. Project Rome frees your app from running on a specific device, enabling a cross-device, user centric experience.

On this site you will find samples of Project Rome.

Visit the Project Rome landing page for more general information about Project Rome.

See the Project Rome developer docs for how-to guides and API reference docs that will help you get started integrating Project Rome features into your app.

See the Cross-Device Experience docs under Microsoft Graph node to find out more about how Project Rome feature capabilities are exposed via Microsoft Graph REST API endpoint.

Privacy

See Microsoft's privacy statement for more information.

Microsoft Open Source Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Give feedback

UserVoice	Feedback Hub	Contact Us

project-rome's Issues

Build error, because 'Secrets' and ProdClientId' value is not defined in source.

Hi,
I try to build GraphNotificationSample in Window.
But build error occurs, because 'Secrets' and ProdClientId' value is not defined in source.
Anyone can help me to solve this issue.
Thanks

Native Windows Applications (WinForms/WPF)

Hello,

is it possible to register native Window Applications as "devices" with windows components or can i do it with the REST API/graph?

I can see in the graph api that there are "list device" and "send command" calls but it seems that something like "register device" is missing. How am i suppused to register something as a "device"?

Thanks and best regards

How can we launch installed game on Xbox?

How can we launch previously installed game on Xbox from iOS application?

Unique ID of current device

Is there any way to find the Unique ID of the current device (the ID which other instances of the app will see in their device list) in UWP?

Can we discover and launch app store on XBOX from iOS/Android app without microsoft/azure login?

1. Is there a way to discover XBOX on local wifi from iOS/Android without requiring the user to login on mobile app?

We tried to set the right discovery filters including 'anonymous' user but couldn't get this to work.

2. Is there a way to launch the XBOX app store page from iOS/Android without requiring the user to login on mobile app?

--

The use-case here is simply a mobile app that wants to launch corresponding app store page on XBOX. (Requiring the user to first enter XBOX credentials on mobile app is too big a hurdle for this initial step and is not a viable experience)

Xamarin sample is not working with NuGet package

I've cloned the repository, opened the Xamarin sample (ConnectedDevices.Xamarin.Droid.Sample), removed the local reference of Project Rome dll (which is missing when you clone the git) and installed it via NuGet package (latest version, 0.6.2).

Now when I run the sample, I get this error: "An unhandled exception occured." with no further explanation.

I'm testing via Visual Studio 2017, on a device running Android 5.1.1, and the SDK used for compile is for Android 7.1.

Support for Azure AD B2C and XF

Hi,
Just want to record this use case here while this is being actively worked on as I think it's important if you want broad adoption.

I'm currently working on a Xamarin forms app targeting the trinity (iOS, Android & UWP).

I'm using Azure as the backend and in particular Azure AD B2C for authentication. I've added Google as an additional authentication provider, though it could be Facebook as well.

I am expecting users to install apps on all of the platforms they are using and I have some interesting use cases to build on top of Rome. However there are some minimum viable features that I expect from Rome:

I expect users to install the UWP version on their work and home PC's (in addition to their mobile or tablet). Therefore one installation will be on a conventional AD domain login and another using a Microsoft Account. My app doesn't care because it uses AD B2C. It is critical that Rome does not rely on a connection to either the AD account or the MSA account. Just the account needed for my app. It would be an unnecessary barrier to adoption if it was required to link all these accounts together,

Update: The more I read about Rome, the more it looks to me that I would need to include a Microsoft login as part of my app eco system because of the reliance on MS Graph. If that's the case then I think that's a show stopper.

Personally I would be very wary of any app that required this - it's more than is required, This is an App first world now, not Windows first. I should add the Microsoft account link when I need to access Windows or Office 365 services, not the other way round.

Secondly, Xamarin Forms is your cross platform toolkit and I expect first class support for it. If that is lacking then it would raise serious doubts in my mind about the project.

Proximity is important (though not a show stopper) - I need to know what device is physically the closest as obviously that's the principal peer to peer connection at any given time. It would be rare (I think) to want to share much to a remote device.

Hope that helps! Real world examples can be useful!

You may well have this on your roadmap already of course.

It all sounds very exciting and I can't wait to give it a shot.

Cheers

Steve

Login Company Account

what to set in https://apps.dev.microsoft.com for using a AD Account
Standard Login URL is https://login.microsoftonline.com/common/oauth2/nativeclient which have not the Option to Switch

Gettig SessionLimitsExceeded

Hello, I've been playing around with the API on the UWP platform, when running on my laptop or tablet, it can create remote sessions and discover other remote sessions, but when running on my phone it doesn't work, when creating a new remote session it always has a RemoteSystemSessionCreationStatus.SessionLimitsExceeded, and even if I create the session from my laptop and my tablet can find it, my phone can't. Any idea why? My win10 mobile build is 10.0.15254.124 and the version is 1709.

Not possible to turn on Xbox

I would like to propose to implement a new feature in project-rome SDK.
In the scope of main use-cases it is possible to scan for available Xbox devices, open URI on selected one. But it is not possible to turn on Xbox as it is possible in SmartGlass.
Please take a look on this feature. This would be great to have it in your SDK.

License!

Can i use this project personally?

Am planning to do Open source project using

repositories {
    maven {
        url "https://projectrome.bintray.com/maven"
    }
}

dependencies { 
    compile(group: 'com.microsoft.connecteddevices', name: 'connecteddevices-core-armv7', version: '0.1.0', ext: 'aar', classifier: 'externalRelease') 
    compile(group: 'com.microsoft.connecteddevices', name: 'connecteddevices-sdk-armv7', version: '0.1.0', ext: 'aar', classifier: 'externalRelease') 
}

The project is like accessing PC browser through Android app
Example : opining www.bing.com from App

iOS Sample - Need to specify where client id is applied

In the readme you mention that we'll have to create a registration, but there's no mention of client id placement in the sample (AuthenticationViewController.m). There's also a pre-existing app id bound to the project regardless:

• (NSString*)appId
  {
  // Change to your own app's MSA Client ID
  return @"8a284efa-414b-445e-8710-0fabde940942";
  }

Can I close a Session for new Participants but keep it open for joined ones?

Hi,

I'm using Project Rome in my UWP game for Multiplayer turned based game playing. It seems to work OK but I have a question or maybe a feature request.

Can I close a Session for new Participants but keep it open for joined ones? The host can start a game after 1 or more participants have joined the session. When the games is started no extra participants are allowed. If other users try to discover a session they still see the already started game. I would love to be able to "hide" session for discovery.

I used the QuizGame sample code (SessionManager) as a starting point for my own game.

Regards,

Fons
(ex Microsoft MVP)
[email protected]

Where can I get dSYM for iOS binary?

Can't discover Windows 10 IoT Core devices on Project Rome App for Android device

Dear friends,

Today I tested with the latest Rome App on Andorid (https://github.com/Microsoft/project-rome/tree/master/Android/sample), and find that my raspberry pi 3 still can't be shown in the device list.

After some tests, i find that the system type of the IoT device is "Hub" (Not IoT). So, i add this type to the Android Studio Project. However, it still can't work.

Android Hardware: LG Nexus 5 with Android 4.4.2
Windows 10 IoT Core Hardware: Raspberry Pi 3 with Windows 10 IoT Core Build 17101
Version of com.microsoft.connecteddevices in build.gradle file: 0.8.1

And i confirm that Windows 10 IoT Core device can be discovered by Desktop and Other Windows 10 IoT Core device(For example, Minnow Board Max).

So,any suggestions? Thanks a lot.

REMOTE_SYSTEM_UNAVAILABLE error

Its working well but, Sometimes log shows REMOTE_SYSTEM_UNAVAILABLE when am trying to launch URL

Note:
Both Mobile and DESKTOP have good internet connection

How to make Project Rome on Xamarin (Android) forget about previous auth code?

I'm adding a "Log out" button into my Xamarin (Android) app which uses Project Rome.

How can I make Platform forget about the current authenticated user so it asks for authentication (via FetchAuthCode event) again?

Not showing any devices!

Project is Interesting! I started working on this.

These are steps i did as of now
1. Pulled Android project-rome from HERE
2. Created app called romanapp in Developer Account
3. Replaced CLIENT_ID with My CLIENT_ID HERE #29

Authentication process done well! I logged in with Microsoft LIVE Account

But its now showing any devices

Let me know any thing i Missed out 👎

Multi-user app service remote connection not possible

I am trying to send messages between an UWP desktop app and an app service running on Xbox One. The RemoteSystemWatcher is able to discover Xbox One machines, but any attempts of opening a connection with them end up with the RemoteSystemUnavaiable AppServiceConnectionStatus.

I got this result every time on mutiple Xbox One machines with 10.0.18362.5047 Windows OS. Analogous communication attempts between two PCs work just fine. RemoteSystem.FindByHostNameAsync() method also doesn't work, it returns null every time an Xbox machine is being looked for. The Xbox one machines are also not able to create a localhost connection.

EDIT: It turns out that the problem is that the app service provider is an multi-user application. Is it possible to succesfully communicate with such app service remotely using AppServiceConnection?

What is the compatibility of Project Rome for Android with graddle?

I was trying with graddle 3.0 and keep failing with error "unable to merge dex". I saw all the samples are using graddle 2.2.0, is there a compatibility issue with Project Rome at the moment? And is there plan to support higher version?

Thanks,

RemoteSystemWatcher error

Unhandled Exception:

Java.Lang.UnsatisfiedLinkError: No implementation found for long com.microsoft.connecteddevices.RemoteSystemWatcher.initialize() (tried Java_com_microsoft_connecteddevices_RemoteSystemWatcher_initialize and Java_com_microsoft_connecteddevices_RemoteSystemWatcher_initialize__)

libgnustl_shared.so conflicts with Spotify SDK

The version of the libgnustl_shared.so is in conflict with the one shipped by the Spotify SDK, available here;
https://github.com/spotify/android-sdk/releases/tag/24-noconnect-2.20b

Since yours size is 5MB vs 1MB Spotify's version, my guess is that they are stripping something: while giving priority to your version seems to allow Spotify SDK to work correctly, the other way round makes the app to crash in your native code for the luck of some symbols.

In order to avoid possible unknown bugs (and conflicts with other SDKs), wouldn't it be better to just use static linking?
If it's a licensing issue, wouldn't be better to rename your version like libgnustl_rome_shared.so?

Firebase dynamic links & 3rd party apps for AppUriHandlers

Is it possible to use AppUriHandlers for Firebase dynamic links? Those links look like this: https://xyz.app.goo.gl/?link=....

The thing is I obviously cannot put any files to the root of https://xyz.app.goo.gl because that's not my domain..

Also 3rd party apps cannot take advantage of AppUriHandlers due to the requirement to have the json file on web root

.NET Standard 2.0

doenst install the package with VS Project targeting .NET Standard

CDRemoteSystemConnectionRequest to device that is connected via cloud return CDRemoteLauncherUriStatusRemoteSystemUnavailable

CDRemoteSystemConnectionRequest to device that is connected via cloud returns status CDRemoteLauncherUriStatusRemoteSystemUnavailable. In result request succesfully opens Uri on remove device. How can I detect a success result for CDRemoteSystemConnectionRequest in this case?

Getting RemoteSystemUnavailable for PCs running Windows 10 version 1809 when available via proximity.

I'm getting RemoteSystemUnavailable error when trying to connect or launch urls to a PC running 1809, if that PC is available via proximity. (However, when it's not available via proximity and is using cloud, it's fine)

This issue has been reported by my app's users on Android->Windows and Windows Mobile->Windows scenarios.

And it seems that Windows 10 version 1809 is only affected, and 1803 is fine.

X86 support

Hi
It would be great if you can add support for x86, so that we can test the app in the visual studio android emulator.

Thanks

How to unregister an android device from Rome? (in Xamarin)

So it won't appear at all when other devices with same MSA try to find user's devices.

Local account

When a user uses a local account, Rome APIs does not show any devices. Is there any way to allow user to sign-in in the app (but keep local account, the same way users can login into Groove, Store, etc. in a local account) so Rome APIs work?

Bitcode support on iOS

Hi,
I noticed that your SDK don't support the bitcode.
Is it possible to plan the support on the iOS SDK?

Thanks

Class not Found Exception

Unhandled Exception:

Java.Lang.ClassNotFoundException: Didn't find class "md56b4bf6e49f378dfe4b7822922cda6c0f.RemoteSystemDiscoveryListener" on path: DexPathList[[zip file "/data/app/com.project_rome.romecastremote-1/base.apk"],nativeLibraryDirectories=[/data/app/com.project_rome.romecastremote-1/lib/arm, /system/fake-libs, /data/app/com.project_rome.romecastremote-1/base.apk!/lib/armeabi-v7a, /system/lib, /vendor/lib, /system/vendor/lib]]

Bad request on MS Graph

Hi,
I have tried to use MS Graph because I wish I use it on Xamarin Forms and... I couldn't get it works. I want to read available devices and send command. I received bad request. Could you tell me some advice in order to implement it? I get the token with the SDK c# that I use in order to get information about account, so the token works. But I don't know what I have been able to do bad…
Thank you

Not correct CDRemoteSystemStatus of discovered devices

In delefate method
-(void)remoteSystemDiscoveryManager:(nonnull CDRemoteSystemDiscoveryManager*)discoveryManager didFind:(nonnull CDRemoteSystem*)remoteSystem

We get a CDRemoteSystem device. Its status CDRemoteSystemStatus is always CDRemoteSystemStatusUnknown. How can I check if device is available for CDRemoteSystemConnectionRequest?

Could not login using iOS example project

I have run example project from SDKSample. The code in the class IdentityViewController in the block never executes:

_platformManager.accountsPromise.then(^{
// ... code
});

So after success authentication to Microsoft account, _transitionToMainViewController method does not execute.

UnsatisfiedLinkError on xamarin sample

Hi,

if i launch the xamarin sample i obtain this error, i have tried on emulator and phisical devices with android 6 and 7, all works only on an old Samsung with android 5.1, if i try with other new devices i have this error
Thanks in advance

java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[DexPathList[[zip file "/data/app/ConnectedDevices.Xamarin-1/base.apk"],nativeLibraryDirectories=[/data/app/ConnectedDevices.Xamarin-1/lib/x86_64, /data/app/ConnectedDevices.Xamarin-1/base.apk!/lib/x86_64, /vendor/lib64, /system/lib64]]] couldn't find "libcdp_sdk.so" 05-16 17:42:27.156 E/AndroidRuntime( 2738): at java.lang.Runtime.loadLibrary(Runtime.java:367) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at java.lang.System.loadLibrary(System.java:1076) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at com.microsoft.connecteddevices.PlatformInternal.<clinit>(PlatformInternal.java:19) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at com.microsoft.connecteddevices.Platform$1.onDone(Platform.java:87) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at com.microsoft.connecteddevices.Platform$OAuthWebAccountProvider.invokeCallbackOnDone(Platform.java:188) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at com.microsoft.connecteddevices.Platform$OAuthWebAccountProvider.fetchAccessTokensAndCid(Platform.java:250) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at com.microsoft.connecteddevices.Platform$OAuthWebAccountProvider$FetchTokensWithAuthCodeTask.run(Platform.java:355) 05-16 17:42:27.156 E/AndroidRuntime( 2738): at java.util.Timer$TimerImpl.run(Timer.java:284) 05-16 17:42:27.340 E/Surface ( 2738): getSlotFromBufferLocked: unknown buffer: 0x7fe2e6c1f630 05-16 17:42:29.917 I/Process ( 2738): Sending signal. PID: 2738 SIG: 9

RemoteSystemSessionCreationStatus.SessionLimitsExceeded

Not an issue yet; I can't find documentation for the connection limit. I'd like to use RemoteSystems for messaging on IOT devices in our manufacturing plant, but before I spend a ton of time I'd like to know what the limit is. Does anyone know what the limit is?

Thanks!

Reliability issues when PC is connected to a VPN network

I've found out that when my PC is connected to VPN (via SoftEther), it can't receive commands from Project Rome REST APIs. For example, launching urls does not work. The problem persists for some time after disconnecting from VPN, but then returns to normal behavior.

I'm the developer of Roamit, and this behavior can easily be seen by trying to open a webpage from Android to PC.

My PC is running the latest version of Windows (1809).

Launch browser on Android

I have a UWP app which I am currently running on a Windows 10 PC using 1803. I can discover a RemoteSystem for my Pixel 2 running Android 9 but when I try to launch a uri on the phone using http

var rscr = new RemoteSystemConnectionRequest(remote);
var uri = new Uri("http://www.google.co.uk");
var status = await RemoteLauncher.LaunchUriAsync(rscr, uri); 

I get RemoteSystemUnavailable.
Also, if I query capabilities all of them return false.
I am able to use 'continue later' from the phone to the PC.
What's the best way to diagnose this?

Possible to keep service alive on Android->Windows scenario?

On Windows to Windows scenario, the app service on the destination device will continue to be alive as long as the source device wants (keeps the connection object alive).

However, on Android to Windows scenario it seems that the app service on the Windows device gets cancelled after ~30 seconds by SystemPolicy.

Is there any way to keep the service alive for more time, just like Windows to Windows scenario?

Empty android device name shown in other devices.

In Xamarin (Android) sample, after authentication, the android device will appear in devices list in Windows devices with same MSA account (when querying Windows Rome APIs). But it has an empty DisplayName.

I'm testing sample on a Nexus 4 running Android 5.1.1.

Is that the expected behavior?

UWP Sample and Microsoft.ConnectedDevices.UserNotifications.Uwp NuGet

I downloaded the project-rome-release-0.13.7 samples and when I look at the NuGet packages it says Not available in this source for the nuget package Microsoft.ConnectedDevices.UserNotifications.Uwp. Can someone tell me what package source I need to setup in order to be able to find this package? Thank you in advance.

How should I use it on release mode for xamarin forms?

Hello,
I have Xamarin forms app and It works perfectly on debug mode. But when I build of release mode, I receive a exception of concurrency. I'm using a ConcurrentBag in order to save RemoteSystem but it crashes when add ítems. How should I do it in order to save ítems in a list?
Thank you

Fails to build ConnectedDevices.Xamarin.Droid

Hi,
I could not build the ConnectedDevices.Xamarin.Droid with following errors.
Do you have any clue for build it?
...If the latest binaries are uploaded as nuget, it helps me too :)

Source: 8960cb1
Tools: Visual Studio 2017 Enterprise 26228.9

1>D:\Github\project-rome\xamarin\src\ConnectedDevices.Xamarin.Droid\Additions\Platform.cs(58,33,58,61): error CS0246: The type or namespace name 'PlatformInitializationStatus' could not be found (are you missing a using directive or an assembly reference?)
1>D:\Github\project-rome\xamarin\src\ConnectedDevices.Xamarin.Droid\Additions\Platform.cs(49,64,49,94): error CS0535: 'Platform.PlatformInitializer' does not implement interface member 'IPlatformInitializationHandler.OnDone(bool)'

Non-public API usage detected by the App Store Team

I was publishing an app that uses ProjectRomeSdk pod with version 0.12 and got an error from ITunerConnect:

Non-public API usage:

The app references non-public symbols in Frameworks/ConnectedDevices.framework/ConnectedDevices: _getcontext, _makecontext, _setcontext

Could you investigate and fix this issue?

Thanks in advance.

Xamarin.Droid.Sample : Failed at Platform.InitializeAsync

Hi,
I've tried to run the xamarin/samples/ConnectedDevices.Xamarin.Droid.Sample.
I could build it and run with my CLIENT_ID. At the first time launch, I've put the my MSA id and pass. But, the app crashed at this point.
It seems that the app crashed at MainActivity.cs, line 63:

var result = await Platform.InitializeAsync(this.ApplicationContext, CLIENT_ID);

I want to debug it but I can't.
Because, this Platform.InitializeAsync is a part of Xamarin/src/ConnectedDevices.Xamarin.Droid/ , and the source is insufficient to build and debug. It seems that the Jars/connecteddevices-sdk-armv7-release.aar ( you can download it by download-aas.ps1) is old, and it does not contain the definition of AppServiceClientConnectionClosedStatus. This prevent the build of ConnectedDevices.Xamarin.Droid.

best regards,

Is is possible to have RemoteSystemSession decentral?

I am curious if the new RemoteSystemSession is always confined to one 'host' with several 'clients' or is it possible to have the devices share a session, and if one disconnects, the other devices can carry on using the same session.

Xamarin NuGet 0.6.2 problem

After updating the Xamarin NuGet package to 0.6.2 (from 0.4.0), I'm getting this warning:

There was a mismatch between the processor architecture of the project being built "MSIL" and the processor architecture of the reference "Microsoft.ConnectedDevices.Xamarin.Droid, Version=0.6.2.0, Culture=neutral, processorArchitecture=x86", "x86". This mismatch may cause runtime failures. Please consider changing the targeted processor architecture of your project through the Configuration Manager so as to align the processor architectures between your project and references, or take a dependency on references with a processor architecture that matches the targeted processor architecture of your project.

Shouldn't Xamarin package be available on ARM too?

fail the installation of nuget package on xamarin.android

Hello,
I have downloaded sample Project of Xamarin Android and I can't compile it. I have checked nuget packages and the package isn't installed. So I have tried to install it but It launchs an error. I get the same error if I try to install the nuget package on my Xamarin.Android app. The error is this:

No se pudo instalar el paquete 'Microsoft.ConnectedDevices.Xamarin.Droid 0.1.0'. Está intentando instalar este paquete en un proyecto que tiene 'MonoAndroid,Version=v6.0' como destino, pero el paquete no contiene referencias de ensamblado o archivos de contenido compatibles con dicho marco.
Best regards

Project Rome Xamarin.Android Unbrauchbar

Project Rome Xamarin.Android Unbrauchbar

useless

Two Devices won't connect through RemoteSystems

Hi

I have two devices which I want to have exchanging messages with each other through the RemoteSystems API. I have added the remote capability to the manifest like this:

<uap3:Capability Name="remoteSystem" />

Then in my ViewModel I set up a RemoteWatcher and attach the added, updated and removed events:

        RemoteSystemAccessStatus accessStatus = await RemoteSystem.RequestAccessAsync();



        if (accessStatus == RemoteSystemAccessStatus.Allowed)

        {
            m_remoteSystemWatcher = RemoteSystem.CreateWatcher();
            m_remoteSystemWatcher.RemoteSystemAdded += M_remoteSystemWatcher_RemoteSystemAdded;
            m_remoteSystemWatcher.RemoteSystemRemoved += M_remoteSystemWatcher_RemoteSystemRemoved;
            m_remoteSystemWatcher.RemoteSystemUpdated += M_remoteSystemWatcher_RemoteSystemUpdated;
            m_remoteSystemWatcher.Start();

        }

When I run both devices, they both have an accessStatus of 'Allowed', however Device A does not see Device B. Device B does see Device A but indicates that it is not available through proximity, establishing a connection results in 'RemoteSystemUnavailable'.

Both devices are logged in with the same Microsoft Account and logged in on the same WIFI network.

What can I try to debug this connection issue?

UPDATE:

After some restarts, the connection now returns success. I attach a request received handler and send a message from Device A to B and vice versa. Neither of them receives a request..