RemoteSystemSessionWatcher クラス

リファレンス

定義

名前空間:: Windows.System.RemoteSystems

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

リモートセッションの検出に関連するアクティビティを監視し、適切なイベントを発生させます。

public ref class RemoteSystemSessionWatcher sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class RemoteSystemSessionWatcher final

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class RemoteSystemSessionWatcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class RemoteSystemSessionWatcher

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class RemoteSystemSessionWatcher

Public NotInheritable Class RemoteSystemSessionWatcher

継承: Object Platform::Object IInspectable RemoteSystemSessionWatcher

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 Creators Update (10.0.15063.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v4.0 で導入)
アプリの機能	remoteSystem

例

リモートセッションを検出するプロセスについては、以下のコード例を参照してください。

// Discover an existing shared experience.
public void DiscoverExistingSessions() {

    // create a watcher for remote system sessions
    RemoteSystemSessionWatcher sessionWatcher = RemoteSystemSession.CreateWatcher();

    // register a handler for the "added" event
    sessionWatcher.Added += async (sender, args) => {

        // get a reference to the info about the discovered session
        RemoteSystemSessionInfo sessionInfo = args.RemoteSystemSessionInfo;

        // update the UI with the sessionInfo.DisplayName and 
        // sessionInfo.ControllerDisplayName strings. Save a reference to 
        // this RemoteSystemSessionInfo, to use when the user selects
        // this session from the UI

        //...
    };

    // Begin watching
    sessionWatcher.Start();
}

注釈

このクラスは、 RemoteSystemSession.CreateWatcher メソッドが呼び出されたときにインスタンス化されます。

重要

このクラスをインスタンス化する前に、 RemoteSystem.RequestAccessAsync を呼び出してリモートシステムプラットフォームへのアクセスを確認する必要があります。

重要

リモートセッション検出が意図したとおりに機能するためには、次の条件を満たす必要があります。

クライアントデバイスとホストデバイスの両方で Bluetooth をオンにする必要があります。セッション検出は LAN 検出を介して機能する可能性がありますが、保証されません (ネットワーク構成によって異なります)。
ホストデバイスの [設定] アプリで、[システム -> 共有エクスペリエンス] の [デバイス間で共有] 設定を [近くにいるすべてのユーザー] に設定する必要があります。
クライアントアプリとホストアプリには、同じ PackageFamilyName が必要です。

プロパティ

Status

このリモートセッションウォッチャーの操作状態を取得します。

メソッド

Start()	検出可能なリモートセッションの監視を開始します。検出プロセスは、Stop メソッドが呼び出されるまで実行されます。 RemoteSystemSessionWatcher オブジェクトは、その Start メソッドを後で再度呼び出すことができます。
Stop()	検出可能なリモートセッションの監視を停止します。

イベント

Added	RemoteSystemSessionWatcher によって新しいリモートセッションが検出されたときに発生します。
Removed	以前に検出されたリモートセッションが消えたときに発生します。
Updated	以前に検出されたリモートセッションの情報の一部が更新されたときに発生します。

適用対象