LegacyGipGameControllerProvider.ClearPairing(User, String) Metodo

Definizione

Spazio dei nomi:

Windows.Gaming.Input.Preview

Rimuove eventuali associazioni di copilot per controllerId per l'utente specificato.

public:
 static void ClearPairing(User ^ user, Platform::String ^ controllerProviderId);

 static void ClearPairing(User const& user, winrt::hstring const& controllerProviderId);

public static void ClearPairing(User user, string controllerProviderId);

function clearPairing(user, controllerProviderId)

Public Shared Sub ClearPairing (user As User, controllerProviderId As String)

Parametri

user

User

Utente per cui cancellare l'associazione.

controllerProviderId

String

Platform::String

winrt::hstring

ID provider per il controller da rimuovere dai paring.

Esempio

public void CopilotSample(GipGameControllerProvider pilotProvider,
                                    GipGameControllerProvider copilotProvider)
{
    // Establish a copilot pairing for the given pilot and copilot providers
    string pilotId = GameControllerProviderInfo.GetProviderId(pilotProvider);
    string copilotId = GameControllerProviderInfo.GetProviderId(copilotProvider);
    User user = User.GetDefault();
    LegacyGipGameControllerProvider.PairPilotToCopilot(user, pilotId,
        copilotId);

    // Read copilot properties
    LegacyGipGameControllerProvider.IsPilot(user, pilotId); // Returns copilotId
    LegacyGipGameControllerProvider.IsPilot(user, copilotId); // Returns null
    LegacyGipGameControllerProvider.IsCopilot(user, pilotId); // Returns null
    LegacyGipGameControllerProvider.IsCopilot(user, copilotId); // Returns pilotId

    // Removes the pairing for both controllers
    LegacyGipGameControllerProvider.ClearPairing(user, pilotId);
    // Also removes the pairing for both controllers (unnecessary since the pairing was already removed)
    LegacyGipGameControllerProvider.ClearPairing(user, copilotId);
}

Commenti

Rimuove il controller specificato da qualsiasi associazione in cui si tratta di un pilota o un copilota per l'utente specificato. Il controller non deve essere connesso per essere non abbinato. La rimozione di un controller da un'associazione rimuove completamente l'associazione, ovvero se un controller è associato come copilota a un altro controller, la rimozione del controller copilot rimuoverà anche l'associazione per il controller pilota e viceversa.

Attenzione

L'associazione di Copilot è a livello di sistema e persistente per l'utente specificato. Questa operazione deve essere eseguita solo nella direzione dell'utente.