LegacyGipGameControllerProvider.ClearPairing(User, String) Método

Definición

Espacio de nombres:

Windows.Gaming.Input.Preview

Quita los emparejamientos de copilot para controllerId para el usuario especificado.

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)

Parámetros

user

User

Usuario para el que borrar el emparejamiento.

controllerProviderId

String

Platform::String

winrt::hstring

Id. de proveedor del controlador que se va a quitar del análisis.

Ejemplos

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

Comentarios

Quita el controlador especificado de los emparejamientos en los que es un piloto o copiloto para el usuario determinado. No es necesario conectar el controlador para que no esté emparejado. La eliminación de un controlador de un emparejamiento quita completamente el emparejamiento, es decir, si un controlador está emparejado como copiloto a otro controlador, al quitar el controlador copiloto también se quitará el emparejamiento para el controlador piloto y viceversa.

Precaución

El emparejamiento de Copilot es en todo el sistema y es persistente para el usuario determinado. Esto solo debe hacerse en la dirección del usuario.