PeerFinder.Role Eigenschaft

Referenz

Definition

Namespace:: Windows.Networking.Proximity

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft die Rolle der App in Peer-to-Peer-Verbindungen ab oder legt sie fest.

public:
 static property PeerRole Role { PeerRole get(); void set(PeerRole value); };

static PeerRole Role();

static void Role(PeerRole value);

public static PeerRole Role { get; set; }

var peerRole = PeerFinder.role;
PeerFinder.role = peerRole;

Public Shared Property Role As PeerRole

Eigenschaftswert

PeerRole

Die Rolle der App in Peer-to-Peer-Verbindungen.

Windows-Anforderungen

App-Funktionen

ID_CAP_NETWORKING [Windows Phone] ID_CAP_NETWORKING [Windows Phone] proximity ID_CAP_PROXIMITY [Windows Phone]

Beispiele

// Default to the peer role.
Windows.Networking.Proximity.PeerRole appRole = Windows.Networking.Proximity.PeerRole.Peer;
bool launchedByTap = false;

protected override void OnNavigatedTo(NavigationEventArgs e)
{
    LaunchActivatedEventArgs launchArgs = e.Parameter as LaunchActivatedEventArgs;

    if (launchArgs.Arguments.Contains("Windows.Networking.Proximity.PeerFinder:StreamSocket"))
    {
        launchedByTap = true;

        if (launchArgs.Arguments.Contains("Role=Host"))
        {
            appRole = Windows.Networking.Proximity.PeerRole.Host;
        }
        else if (launchArgs.Arguments.Contains("Role=Client"))
        {
            appRole = Windows.Networking.Proximity.PeerRole.Client;
        }
        else
        {
            appRole = Windows.Networking.Proximity.PeerRole.Peer;
        }
    }
}

bool started = false;

// Click event for "Advertise" button.
void AdvertiseForPeers(object sender, RoutedEventArgs e)
{
    if (!started)
    {
        Windows.Networking.Proximity.PeerFinder.DisplayName = DisplayNameTextBox.Text;

        if ((Windows.Networking.Proximity.PeerFinder.SupportedDiscoveryTypes &
             Windows.Networking.Proximity.PeerDiscoveryTypes.Triggered) ==
             Windows.Networking.Proximity.PeerDiscoveryTypes.Triggered)
        {
            Windows.Networking.Proximity.PeerFinder.TriggeredConnectionStateChanged +=
                TriggeredConnectionStateChanged;

            WriteMessageText("You can tap to connect a peer device that is " +
                             "also advertising for a connection.\n");
        }
        else
        {
            WriteMessageText("Tap to connect is not supported.\n");
        }

        if ((Windows.Networking.Proximity.PeerFinder.SupportedDiscoveryTypes &
             Windows.Networking.Proximity.PeerDiscoveryTypes.Browse) !=
             Windows.Networking.Proximity.PeerDiscoveryTypes.Browse)
        {
            WriteMessageText("Peer discovery using Wi-Fi Direct is not supported.\n");
        }

        // Set the peer role selected by the user.  
        if (launchedByTap)
        {
            Windows.Networking.Proximity.PeerFinder.Role = appRole;
        }
        else
        {
            switch (GetRoleFromUser())
            {
                case "Peer":
                    Windows.Networking.Proximity.PeerFinder.Role =
                        Windows.Networking.Proximity.PeerRole.Peer;
                    break;
                case "Host":
                    Windows.Networking.Proximity.PeerFinder.Role =
                        Windows.Networking.Proximity.PeerRole.Host;
                    break;
                case "Client":
                    Windows.Networking.Proximity.PeerFinder.Role =
                        Windows.Networking.Proximity.PeerRole.Client;
                    break;
            }
        }

        // Set discoveryData property with user supplied text. 
        var discData = GetDiscoveryDataFromUser();
        var writer = new Windows.Storage.Streams.DataWriter(
            new Windows.Storage.Streams.InMemoryRandomAccessStream());
        writer.WriteString(discData);
        Windows.Networking.Proximity.PeerFinder.DiscoveryData =
            writer.DetachBuffer();

        Windows.Networking.Proximity.PeerFinder.Start();
        started = true;
    }
}

// Write a message to MessageBlock on the UI thread.
private Windows.UI.Core.CoreDispatcher messageDispatcher = Window.Current.CoreWindow.Dispatcher;
async private void WriteMessageText(string message, bool overwrite = false)
{
    await messageDispatcher.RunAsync(Windows.UI.Core.CoreDispatcherPriority.Normal,
        () =>
        {
            if (overwrite)
                MessageBlock.Text = message;
            else
                MessageBlock.Text += message;
        });
}

Hinweise

Die Role-Eigenschaft wird in Multi-Peer-App-Verbindungen verwendet, um zu ermitteln, ob die Peer-App der Host oder Client ist oder ob die Peer-App an einer Zwei-Peer-Verbindung als Peer teilnimmt. Für Multi-Peer-App-Verbindungen müssen Sie die Role-Eigenschaft festlegen, bevor Sie die Start-Methode aufrufen. Wenn die Role-Eigenschaft nicht festgelegt ist, ist der Standardwert Peer.

In einem Multi-Peer-App-Szenario identifiziert die Rolle die Fähigkeit der Apps, eine Verbindung herzustellen. Eine Host-App kann eine Verbindung mit bis zu fünf Client-Apps herstellen. Host-Apps können nur Apps ermitteln, die als Client-Apps ankündigen. Client-Apps können nur Apps ermitteln, die als Host-Apps ankündigen. Die Peerrolle identifiziert ein Szenario mit zwei Apps. Daher können Peer-Apps nur andere Peer-Apps ermitteln. Die gleichen Regeln gelten für Peer-Apps, die über eine Tippengeste verbunden sind. Beispielsweise können Apps, die als Host-Apps werben, nur tippen, um eine Verbindung mit Apps herzustellen, die als Client-Apps werben.

Gilt für:

Freigeben über