Partager via


LegacyGipGameControllerProvider.PairPilotToCopilot Méthode

Définition

Associe les contrôleurs pilote et copilote donnés pour l’utilisateur donné.

public:
 static void PairPilotToCopilot(User ^ user, Platform::String ^ pilotControllerProviderId, Platform::String ^ copilotControllerProviderId);
 static void PairPilotToCopilot(User const& user, winrt::hstring const& pilotControllerProviderId, winrt::hstring const& copilotControllerProviderId);
public static void PairPilotToCopilot(User user, string pilotControllerProviderId, string copilotControllerProviderId);
function pairPilotToCopilot(user, pilotControllerProviderId, copilotControllerProviderId)
Public Shared Sub PairPilotToCopilot (user As User, pilotControllerProviderId As String, copilotControllerProviderId As String)

Paramètres

user
User

Utilisateur pour lequel créer un jumelage copilote.

pilotControllerProviderId
String

Platform::String

winrt::hstring

ID de fournisseur pour le contrôleur pilote.

copilotControllerProviderId
String

Platform::String

winrt::hstring

ID de fournisseur pour le contrôleur copilote.

Exemples

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

Remarques

Une fois qu’un contrôleur pilote et un copilote sont associés, toutes les entrées physiques de l’un ou l’autre contrôleur s’affichent via toutes les API d’entrée comme si elles provenaient du contrôleur pilote.

Attention

Le jumelage Copilot est persistant à l’échelle du système pour l’utilisateur donné. Cela ne doit être effectué qu’à la direction de l’utilisateur.

S’applique à