LegacyGipGameControllerProvider.PairPilotToCopilot 方法

定義

命名空間:

Windows.Gaming.Input.Preview

為指定的使用者配對指定的試驗和 Copilot 控制器。

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)

參數

user

User

要為其建立 Copilot 配對的使用者。

pilotControllerProviderId

String

Platform::String

winrt::hstring

試驗控制器的提供者標識碼。

copilotControllerProviderId

String

Platform::String

winrt::hstring

copilot 控制器的提供者標識符。

範例

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

備註

一旦配對試驗和 Copilot 控制器，來自任一控制器的所有實體輸入都會透過所有輸入 API 出現，就像它們來自試驗控制器一樣。

警告

Copilot 配對是特定使用者的全系統且持續。 這應該只會在使用者的指示下完成。