LegacyGipGameControllerProvider.PairPilotToCopilot Methode

Referenz

Definition

Namespace:: Windows.Gaming.Input.Preview

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

Koppelt die angegebenen Pilot- und Copilot-Controller für den angegebenen Benutzer.

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)

Parameter

user: User

Benutzer, für den eine Copilot-Kopplung erstellt werden soll.

pilotControllerProviderId: String
Platform::String

winrt::hstring

Anbieter-ID für den Pilotcontroller.

copilotControllerProviderId: String
Platform::String

winrt::hstring

Anbieter-ID für den Copilot-Controller.

Beispiele

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

Hinweise

Sobald ein Pilot- und Copilot-Controller gekoppelt sind, werden alle physischen Eingaben von beiden Controllern über alle Eingabe-APIs angezeigt, als ob sie vom Pilotcontroller stammen.

Achtung

Die Copilot-Kopplung ist systemweit und persistent für den jeweiligen Benutzer. Dies sollte nur auf Die Anweisung des Benutzers erfolgen.

Gilt für:

Freigeben über