XGameUiShowWebAuthenticationWithOptionsAsync
Inicia la solicitud de autenticación asincrónica que muestra una interfaz de usuario web, posiblemente a pantalla completa, que permite al usuario delegar el acceso a sitios web y servicios externos sin proporcionar directamente sus credenciales al título en ejecución.Sintaxis
Parámetros
async _In_Tipo: XAsyncBlock* Un puntero al XAsyncBlock que se pasa a XAsyncRun. requestingUser _In_
Tipo: XUserHandle Un identificador del usuario que solicita la autenticación web. requestUri _In_z_
Tipo: char* El URI inicial de la vista web presentada al usuario (que probablemente contiene campos para la autenticación del usuario en el servicio). El URI de la solicitud debe ser una dirección HTTPS segura. completionUri _In_z_
Tipo: char* Indica el URI que representa la finalización correcta del proceso de autenticación web. Cuando la vista web navega a un URI que coincide con completionUri, la vista web se cierra y el control se devuelve al título que realizó la llamada. options &nbps; _In_ Tipo: XGameUiWebAuthenticationOptions Marca que indica si se debe intentar mostrar la interfaz de usuario a pantalla completa o no. En PC, esta marca se omite. La pantalla completa no es una opción compatible en PC.
Valor devuelto
Tipo: HRESULT HRESULT de éxito o código de error de la llamada asincrónica. Para obtener el resultado, llame a xgameuishowwebauthenticationresultsize y xgameuishowwebauthenticationresult dentro de la devolución de llamada de AsyncBlock o después de que AsyncBlock se haya completado.Comentarios
Cuando se ejecuta esta tarea asincrónica, el sistema presenta una vista web al usuario (superpuesta a la aplicación actual), con la que puede interactuar o que puede descartar presionando atrás. Esto permite a los usuarios usar OAuth para conceder permisos de autorización a sitios web y servicios externos. Esto se puede usar en escenarios como autenticar el juego para compartir momentos destacados del juego en redes sociales, solicitar datos de usuario de proveedores externos y mucho más. El resultado de la solicitud de autenticación se almacena en el objeto XGameUiWebAuthenticationResultData que devuelve el método XGameUiShowWebAuthenticationResult. Si la vista web se cierra como resultado de navegar al completionUri, el campo responseStatus de la estructura de datos de resultado seráS_OK.
Si el usuario cancela o cierra manualmente la vista web de otra manera, el campo responseStatus de la estructura de datos de resultado será E_CANCELLED.
Ejemplo
El siguiente ejemplo de código muestra cómo realizar OAuth mediante Facebook. Este ejemplo no incluye el control de errores de asignación de memoria para mantener el código breve.Requisitos
Encabezado: XGameUI.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesConsulte también
XGameUI XGameUiShowWebAuthenticationAsyncXGameUiShowWebAuthenticationResultSize
XGameUiShowWebAuthenticationResult
XGameUiWebAuthenticationResultData
Modelo de programación asincrónica
