다음을 통해 공유

OAuth 사용

  • 아티클

게임 개발자는 사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고 외부 사이트 및 서비스에 대한 액세스를 위임할 수 있도록 OAuth를 사용할 수 있어야 합니다. 실제로 이는 소셜 미디어에 게임 하이라이트를 공유하기 위해 게임 인증을 하는 것부터 외부 공급자로부터 사용자 데이터를 요청하는 것을 의미합니다.

참고 항목

여기에 설명된 OAuth 솔루션은 표시될 수 있는 모든 웹 페이지에 대한 지원을 제공하지 않습니다. 이 솔루션은 메모리가 상당히 제한된 환경에서 게임 위에 웹 페이지를 렌더링하는 데 따라 달라집니다. 개발자는 웹 페이지가 문제 없이 메모리 제약 조건에 맞는지 테스트해야 합니다.

XGameUiShowWebAuthentication 흐름은 3가지 함수로 구성되며, 이는 일반적으로 다음 순서로 호출되어야 합니다.

  1. XGameUiShowWebAuthenticationAsync 또는 XGameUiShowWebAuthenticationWithOptionsAsync를 호출하여 비동기 인증 요청을 시작합니다. 이로 인해 사용자에게 웹 보기가 표시되고(현재 애플리케이션과 중첩되지 않음), 이를 사용하여 상호 작용하거나 ‘뒤로’를 눌러 무시할 수 있습니다. "option" 변형을 사용하여 호출자가 웹 보기를 전체 화면에 표시할지 여부를 선택할 수 있습니다.

    요청 URI는 보안 HTTPS 주소여야 합니다. 사용자에게 표시되는 웹 보기의 초기 URI를 나타냅니다(서비스에 대한 사용자 인증 필드가 포함될 가능성이 높음).

    콜백 URI는 사용자에게 표시되는 웹 보기에서 탐색되는 모든 URI와 일치됩니다. 콜백 URI에 액세스할 수는 없지만 사용자가 링크를 클릭하거나 웹 서버에서 리디렉션이 시작될 때 제어가 호출 타이틀로 돌아갑니다.

  2. XGameUiShowWebAuthenticationResultSize를 호출하여 이전에 완료된 인증 요청을 저장하는 데 필요한 버퍼의 크기를 가져옵니다. 서버 응답에 임의의 데이터 양이 포함될 수 있으므로 이 크기는 가변적입니다.

  3. XGameUiShowWebAuthenticationResult를 호출하여 이전에 완료된 인증 요청 결과를 가져옵니다. 필요한 버퍼 크기는 이전에 XGameUiShowWebAuthenticationResultSize 호출을 통해 획득한 상태여야 합니다.

    XGameUiShowWebAuthenticationResult를 호출하면 결과를 저장하는 데 사용되는 바이트 수는 물론 제공된 버퍼 내에 포함된 XGameUiWebAuthenticationResultData 구조에 대한 포인터가 생성됩니다.

    인증 요청의 결과는 XGameUiWebAuthenticationResultData 구조에 저장됩니다.

    • 응답 상태는 작업의 전체 결과를 설명합니다.

    • 응답 데이터 수에는 문자열 종결자를 포함한 응답의 크기가 포함됩니다.

    • 응답 데이터에는 성공 시 사용자 인증 결과로 OAuth 제공자가 추가한 매개 변수(액세스 토큰, 만료 시간 등), 실패 시 null 문자열을 포함한 기본 콜백 URI가 포함됩니다. 또한 responseStatus 구조 멤버를 확인할 수 있습니다. 인증 브라우저가 완료 URI를 성공적으로 탐색하는 경우 S_OK을(를) 포함합니다. 그렇지 않은 경우에는 ‘뒤로’를 눌러 사용자가 취소했음을 나타내는 E_CANCELLED이(가) 포함됩니다.

참고 항목

XGameUiShowWebAuthenticationAsync
XGameUiShowWebAuthenticationWithOptionsAsync