LegacyGipGameControllerProvider.PairPilotToCopilot 메서드

정의

네임스페이스:

Windows.Gaming.Input.Preview

지정된 사용자에 대해 지정된 파일럿 및 부조종사 컨트롤러를 페어링합니다.

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

부조종사 페어링을 만들 사용자입니다.

pilotControllerProviderId

String

Platform::String

winrt::hstring

파일럿 컨트롤러의 공급자 ID입니다.

copilotControllerProviderId

String

Platform::String

winrt::hstring

부조종사 컨트롤러에 대한 공급자 ID입니다.

예제

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

설명

파일럿 및 부조종사 컨트롤러가 페어링되면 두 컨트롤러의 모든 물리적 입력이 파일럿 컨트롤러에서 온 것처럼 모든 입력 API를 통해 표시됩니다.

주의

Copilot 페어링은 시스템 전체이며 지정된 사용자에 대해 영구적입니다. 이 작업은 사용자의 지시에 따라 수행해야 합니다.