RemoteSystemSession クラス

リファレンス

定義

名前空間:: Windows.System.RemoteSystems

重要

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

編集

接続されている 2 つ以上のデバイス間で共有できるリモートセッションを表し、処理します。この機能の詳細については、「解説」を参照してください。

public ref class RemoteSystemSession sealed : IClosable

/// [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 RemoteSystemSession final : IClosable

[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 RemoteSystemSession : System.IDisposable

Public NotInheritable Class RemoteSystemSession
Implements IDisposable

継承: Object Platform::Object IInspectable RemoteSystemSession

属性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

実装: IClosable IDisposable

Windows の要件

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

例

リモートセッションに参加するプロセス ( RemoteSystemSession インスタンスへの参照の取得を含む) については、以下のコード例を参照してください。

public async void JoinExistingSession() {

    // request to join. sessionInfo has already been selected by user.
    RemoteSystemSessionJoinResult joinResult = await sessionInfo.JoinAsync();

    // process the result
    if (joinResult.Status == RemoteSystemSessionJoinStatus.Success) {

        // if the join was successful, acquire a reference to the session
        currentSession = joinResult.Session;

        // optionally handle the disconnected event
        currentSession.Disconnected += async (sender, args) => {
            // update the UI, using args.Reason
        };

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

    } else {
        // join request failed. optionally update UI
    }
}

または、リモートセッションを作成して参加要求を処理する方法の例については、次のコードを参照してください。

public async void StartNewSharedExperience() {

    var manager = new RemoteSystemSessionController("Bob’s Minecraft game");

    // register the following code to handle the JoinRequested event
    manager.JoinRequested += async (sender, args) => {
        // Get the deferral
        var deferral = args.GetDeferral();

        // display the participant (args.JoinRequest.Participant) on UI, giving the 
        // user an opportunity to respond
        // ...

        // If the user chooses "accept", accept this remote system as a participant
        args.JoinRequest.Accept();
    };

    // create and start the session
    RemoteSystemSessionCreationResult createResult = await manager.CreateSessionAsync();

    // handle the creation result
    if (createResult.Status == RemoteSystemSessionCreationStatus.Success) {
        // creation was successful
        RemoteSystemSession currentSession = createResult.Session;

        // optionally subscribe to the disconnection event
        currentSession.Disconnected += async (sender, args) => {
            // update the UI, using args.Reason
            // ...
        };

        // Use session ...

    } else if (createResult.Status == RemoteSystemSessionCreationStatus.SessionLimitsExceeded) {
        // creation failed. Optionally update UI to indicate that there are too many sessions in progress
    } else {
        // creation failed for an unknown reason. Optionally update UI
    }
}

注釈

リモートシステムセッションは、より広範なリモートシステム機能セットの一部です。これにより、アプリは、2 つ以上のデバイスが継続的に通信できる中間サードパーティとしてセッションオブジェクトを確立し、リモートアプリメッセージングなどの多くの新しいクロスデバイスシナリオを可能にします。

参加しているセッションは、 RemoteSystemSession オブジェクトによって表されます。既知のセッションが参加していないセッションは、 RemoteSystemSessionInfo オブジェクトによって表されます。

プロパティ

ControllerDisplayName	このリモートセッションのコントローラーであるデバイスのコンピューター名を取得します。
DisplayName	セッションのコントローラーによって指定された、このリモートセッションの公開名を取得します。
Id	このリモートセッションの一意識別子を取得します。

メソッド

Close()	セッションを閉じ、すべての参加者を切断します。
CreateParticipantWatcher()	RemoteSystemSessionParticipantWatcher を初期化して、このリモートセッションの参加者を監視します。
CreateWatcher()	RemoteSystemSessionWatcher オブジェクトを初期化して返し、リモートセッションの存在を監視します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
SendInvitationAsync(RemoteSystem)	特定のリモートデバイスをこのリモートセッションに参加するよう招待します。

イベント

Disconnected

このデバイスがこのリモートセッションから切断されたときに発生します。

適用対象

次の方法で共有