XGameUiShowWebAuthenticationWithOptionsAsync
사용자가 실행 중인 타이틀에 자격 증명을 직접 제공하지 않고도 외부 웹 사이트 및 서비스에 대한 액세스를 위임할 수 있도록, 필요 시 전체 화면으로 표시할 수 있는 웹 UI를 표시하는 비동기 인증 요청을 시작합니다.구문
매개 변수
async _In_형식: XAsyncBlock* XAsyncRun에 전달되는 XAsyncBlock에 대한 포인터입니다. requestingUser _In_
형식: XUserHandle 웹 인증을 요청하는 사용자에 대한 핸들입니다. requestUri _In_z_
형식: char* 사용자에게 표시되는 웹 뷰의 초기 URI입니다(일반적으로 서비스에 대한 사용자 인증 필드가 포함됨). 요청 URI는 안전한 HTTPS 주소여야 합니다. completionUri _In_z_
형식: char* 웹 인증 프로세스의 성공적인 완료를 나타내는 URI를 지정합니다. 웹 뷰가 completionUri와 일치하는 URI로 이동하면 웹 뷰가 닫히고 제어권이 호출 타이틀로 반환됩니다. options &nbps; _In_ 형식: XGameUiWebAuthenticationOptions UI를 전체 화면으로 표시할지 여부를 나타내는 플래그입니다. PC에서는 이 플래그가 무시됩니다. 전체 화면은 PC에서 지원되는 옵션이 아닙니다.
반환 값
형식: HRESULT 비동기 호출의 HRESULT 성공 또는 오류 코드입니다. 결과를 가져오려면 AsyncBlock 콜백 내부 또는 AsyncBlock 완료 후 xgameuishowwebauthenticationresultsize 및 xgameuishowwebauthenticationresult를 호출하세요.설명
이 비동기 작업이 실행되면 시스템은 사용자에게 웹 뷰를 표시하며(현재 애플리케이션을 오버레이함), 사용자는 이와 상호 작용하거나 뒤로 버튼을 눌러 닫을 수 있습니다. 이를 통해 사용자는 OAuth를 사용하여 외부 웹 사이트 및 서비스에 대한 권한 부여를 승인할 수 있습니다. 이는 소셜 미디어에서 게임 하이라이트를 공유하기 위한 게임 인증, 외부 공급자로부터의 사용자 데이터 요청 등의 시나리오에서 사용할 수 있습니다. 인증 요청의 결과는 XGameUiShowWebAuthenticationResult 메서드에서 반환되는 XGameUiWebAuthenticationResultData 객체에 저장됩니다. completionUri로의 이동 결과로 웹 뷰가 닫힌 경우, 결과 데이터 구조체의 responseStatus 필드는S_OK가 됩니다.
사용자가 웹 뷰를 취소하거나 수동으로 닫는 경우, 결과 데이터 구조체의 responseStatus 필드는 E_CANCELLED가 됩니다.
예제
다음 코드 예제는 Facebook을 사용하여 OAuth를 수행하는 방법을 보여 줍니다. 이 예제에는 코드를 간결하게 유지하기 위해 메모리 할당 오류 처리가 포함되지 않았습니다.요구 사항
헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔함께 보기
XGameUI XGameUiShowWebAuthenticationAsyncXGameUiShowWebAuthenticationResultSize
XGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
비동기 프로그래밍 모델
