PeerFinder.Role Propiedad

Definición

Espacio de nombres:

Windows.Networking.Proximity

Obtiene o establece el rol de la aplicación en conexiones punto a punto.

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

Valor de propiedad

PeerRole

Rol de la aplicación en conexiones punto a punto.

Requisitos de Windows

Características de aplicaciones

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

Ejemplos

// 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;
        });
}

Comentarios

La propiedad Role se usa en conexiones de aplicaciones de varios pares para identificar si la aplicación del mismo nivel es el host o el cliente, o si la aplicación del mismo nivel participa en una conexión de dos pares como punto. Para las conexiones de aplicaciones de varios sistemas del mismo nivel, debe establecer la propiedad Role antes de llamar al método Start . Si no se establece la propiedad Role, el valor predeterminado es Peer.

En un escenario de aplicación de varios sistemas del mismo nivel, el rol identifica la funcionalidad de las aplicaciones que se van a conectar. Una aplicación host puede conectarse a hasta cinco aplicaciones cliente . Las aplicaciones host solo pueden detectar aplicaciones que anuncian como aplicaciones cliente . Las aplicaciones cliente solo pueden detectar aplicaciones que se anuncian como aplicaciones host . El rol del mismo nivel identifica un escenario de dos aplicaciones. Por lo tanto, las aplicaciones del mismo nivel solo pueden detectar otras aplicaciones del mismo nivel . Las mismas reglas se aplican a las aplicaciones del mismo nivel conectadas mediante un gesto de pulsación. Por ejemplo, las aplicaciones que anuncian como aplicaciones host solo pueden pulsar para conectarse con aplicaciones que anuncian como aplicaciones cliente .

Consulte también

• Proximidad y pulsación (C#/VB/C++)
• Muestra de proximidad