Sintaxis
Parámetros
handle PFMultiplayerHandle
El identificador de la instancia de la API PFMultiplayer.
entity PFEntityKey*
La clave de entidad de PlayFab que se va a asociar a un token.
entityToken char*termina en null TBD
Valor devuelto
Tipo: HRESULTS_OK si la creación del usuario local se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante PFMultiplayerGetErrorMessage().
Comentarios
Este método toma una clave de entidad de PlayFab comoentity y un token de entidad de PlayFab como token. Cuando la biblioteca realiza operaciones en nombre de una entidad que requieren autenticación o autorización, como crear o actualizar un lobby, la biblioteca busca un token asociado a la entidad para usarlo en la operación. Si no se ha establecido previamente ningún token para la entidad, la operación producirá un error de forma sincrónica. Durante la operación asincrónica, el servicio de PlayFab valida que el token sea válido, no haya expirado, esté asociado al identificador de entidad proporcionado y esté autorizado para realizar la operación. Si no se cumplen estas condiciones, la operación producirá un error. Se pueden obtener una clave de entidad y un token de entidad de PlayFab a partir de la salida de una operación de inicio de sesión de PlayFab y, después, proporcionarse como entrada a este método.
Los valores
entity y token proporcionados deben haberse adquirido con el mismo identificador de título de PlayFab que se pasó a PFMultiplayerInitialize(). La biblioteca Multiplayer realiza una copia del token de entidad de PlayFab proporcionado para usarlo en operaciones posteriores que requieran autenticación o autorización del usuario local, como
PFMultiplayerCreateAndJoinLobby. Si el token proporcionado a esta llamada ha expirado o no es válido por otro motivo, las operaciones que requieran un token válido producirán un error. Se puede proporcionar un token nuevo y válido a la biblioteca Multiplayer llamando de nuevo a este método con la misma clave de entidad. El autor de la llamada es responsable de supervisar la expiración del token de entidad proporcionado a este método. Cuando el token se acerque al momento de expiración o lo haya superado, se debe obtener un nuevo token mediante una operación de inicio de sesión de PlayFab y proporcionarlo a la biblioteca Multiplayer llamando de nuevo a este método. Se recomienda adquirir un nuevo token cuando el token proporcionado anteriormente esté a la mitad de su período de validez. En plataformas que puedan entrar en un estado de bajo consumo o que de otro modo hagan que la aplicación pause su ejecución durante mucho tiempo, lo que impide que el token se actualice antes de que expire, se debe comprobar la expiración del token una vez que se reanude la ejecución.
No se realiza ninguna validación sincrónica de estos valores.
Requisitos
Encabezado: PFMultiplayer.hConsulte también
Miembros de PFMultiplayerPFMultiplayerInitialize