リモートデバイスでのアプリの起動

[アーティクル]
07/13/2023

この記事では、Windows アプリをリモートデバイスで起動する方法について説明します。

Windows 10 Version 1607 以降で実行される UWP アプリは、同じく Windows Version 1607 を実行し、同じ Microsoft アカウント (MSA) にサインオンしている別のデバイスの UWP アプリまたは Windows デスクトップアプリケーションをリモートで起動できます。これは Project Rome の最も簡単な使用例です。

このリモート起動機能を使うと、ユーザーが 1 台のデバイスでタスクを開始し、別のデバイスでそのタスクを完了するといった、タスク指向のユーザーエクスペリエンスが実現します。たとえば、車を運転しながらスマートフォンで音楽を聴き、自宅に着いた後は、機器を Xbox One に切り替えて同じ音楽を引き続き再生することができます。リモート起動では、中断した箇所からタスクを続行できるように、起動するリモートアプリにコンテキストデータを渡します。

準備段階のセットアップ

remoteSystem 機能を追加する

アプリでリモートデバイスのアプリを起動するには、remoteSystem 機能をアプリパッケージマニフェストに追加する必要があります。これには、マニフェストデザイナーで [機能] タブの [リモートシステム] を選んで追加するか、プロジェクトの Package.appxmanifest ファイルに以下のコードを手動で追加します。

<Capabilities>
   <uap3:Capability Name="remoteSystem"/>
</Capabilities>

さらに、クライアントデバイスは、デバイス間の共有を許可するように設定する必要があります。この設定には [設定] : [システム]>[共有エクスペリエンス]>[デバイス間で共有します] でアクセスできます。既定で有効になっています。

[共有エクスペリエンス] 設定ページ

リモートデバイスを見つける

最初に、接続するデバイスを見つける必要があります。この方法については、「リモートデバイスの検出」で詳しく説明されています。ここでは、デバイスまたは接続の種類によるフィルタリングを避けた、シンプルなアプローチを使います。つまり、リモートデバイスを探すリモートシステムウォッチャーを作成し、デバイスが検出または削除されたときに発生するイベントのハンドラーを記述します。これにより、リモートデバイスのコレクションが提供されます。

この例のコードでは、クラスファイルに using Windows.System.RemoteSystems ステートメントがあることを利用としています。

private async Task BuildDeviceList()
{
    RemoteSystemAccessStatus accessStatus = await RemoteSystem.RequestAccessAsync();

    if (accessStatus == RemoteSystemAccessStatus.Allowed)
    {
        m_remoteSystemWatcher = RemoteSystem.CreateWatcher();

        // Subscribing to the event raised when a new remote system is found by the watcher.
        m_remoteSystemWatcher.RemoteSystemAdded += RemoteSystemWatcher_RemoteSystemAdded;

        // Subscribing to the event raised when a previously found remote system is no longer available.
        m_remoteSystemWatcher.RemoteSystemRemoved += RemoteSystemWatcher_RemoteSystemRemoved;

        m_remoteSystemWatcher.Start();
    }
}

リモート起動を作成する前に、最初に RemoteSystem.RequestAccessAsync() を呼び出す必要があります。戻り値を確認して、お使いのアプリがリモートデバイスにアクセスする許可を持っていることを確認してください。このチェックが失敗する理由の 1 つは、アプリに remoteSystem 機能を追加していないことです。

システムウォッチャーのイベントハンドラーは、接続可能なデバイスが検出されたとき、または接続できなくなったときに呼び出されます。これらのイベントハンドラーを使用して、接続可能なデバイスの一覧を最新に保ちます。

private void RemoteSystemWatcher_RemoteSystemRemoved(
    RemoteSystemWatcher sender, RemoteSystemRemovedEventArgs args)
{
    if ( m_deviceMap.ContainsKey(args.RemoteSystemId))
    {
        m_deviceList.Remove(m_deviceMap[args.RemoteSystemId]);
        m_deviceMap.Remove(args.RemoteSystemId);
    }
}

private void RemoteSystemWatcher_RemoteSystemAdded(
    RemoteSystemWatcher sender, RemoteSystemAddedEventArgs args)
{
    m_deviceList.Add(args.RemoteSystem);
    m_deviceMap.Add(args.RemoteSystem.Id, args.RemoteSystem);
}

Dictionary を使って、リモートシステム ID によってデバイスを追跡します。 ObservableCollection を使って、列挙可能なデバイスの一覧を保持します。 ObservableCollection ではデバイスの一覧を UI にバインドすることも簡単にできますが、この例では行いません。

private RemoteSystemWatcher m_remoteSystemWatcher;
private ObservableCollection<RemoteSystem> m_deviceList = new ObservableCollection<RemoteSystem>();
private Dictionary<string, RemoteSystem> m_deviceMap = new Dictionary<string, RemoteSystem>();

リモートアプリの起動を試みる前に、アプリのスタートアップコードに BuildDeviceList() への呼び出しを追加します。