RemoteSystemSessionWatcher 類別

定義

命名空間:

Windows.System.RemoteSystems

監看與探索遠端會話相關的活動，並引發適當的事件。

public ref class RemoteSystemSessionWatcher sealed

/// [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)]
public sealed class RemoteSystemSessionWatcher

Public NotInheritable Class RemoteSystemSessionWatcher

繼承

Object Platform::Object IInspectable RemoteSystemSessionWatcher

屬性

ContractVersionAttribute MarshalingBehaviorAttribute

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 來確認遠端系統平臺的存取權，才能具現化此類別。

重要

必須符合下列條件，遠端會話探索才能如預期般運作：

1. 用戶端和主機裝置都必須開啟藍牙。 會話探索可透過 LAN 探索運作，但不保證 (取決於網路組態) 。
2. 在主機裝置上的 [設定] 應用程式中，[系統 - > 共用體驗] 底下的 [跨裝置共用]設定必須設定為 [附近的所有人]。
3. 用戶端和主機應用程式必須具有相同的 PackageFamilyName。

屬性

Status

取得這個遠端會話監看員的操作狀態。

方法

Start()	開始監看可探索的遠端會話。 探索程式會執行到 呼叫 Stop 方法為止。 RemoteSystemSessionWatcher物件可以在稍後再次呼叫其Start方法。
Stop()	停止監看可探索的遠端會話。

事件

Added	當 RemoteSystemSessionWatcher探索到新的遠端會話時引發。
Removed	在先前探索到的遠端會話消失時引發。
Updated	當先前探索到的遠端會話有一部分的資訊更新時引發。