Sintaxis
Parámetros
entityToken PartyString
El nuevo token de entidad de PlayFab que se va a asociar al usuario local.
Valor devuelto
PartyErrorc_partyErrorSuccess si la llamada se realizó correctamente o un código de error en caso contrario. La forma legible del código de error se puede recuperar mediante PartyManager::GetErrorMessage().
## Comentarios
Este método toma un token de entidad de PlayFab como entityToken. No se realiza ninguna validación sincrónica de este valor. Cuando la biblioteca realiza operaciones que requieren autenticación o autorización del usuario, como crear una red, autenticarse en una red o realizar una transcripción de voz a texto, el servicio Party validará que el token es válido, que no ha expirado, que está asociado al mismo identificador de entidad que se proporcionó a la llamada a PartyManager::CreateLocalUser() o PartyManager::CreateLocalUserWithEntityType() y que está autorizado a realizar la operación. Si no se cumplen estas condiciones, la operación generará un error. Se puede obtener un token de entidad de PlayFab a partir de la salida de una operación de inicio de sesión de PlayFab y, a continuación, proporcionarlo como entrada a este método. El token debe estar asociado al mismo identificador y tipo de entidad de PlayFab que se especificó originalmente en PartyManager::CreateLocalUser() o PartyManager::CreateLocalUserWithEntityType().
El
entityToken proporcionado debe haberse adquirido con el mismo identificador de título que se pasó a PartyManager::Initialize(). La biblioteca de Party realiza una copia del token de entidad de PlayFab proporcionado para su uso en operaciones posteriores que requieren autenticación o autorización del usuario local, como PartyManager::CreateNewNetwork() o PartyNetwork::AuthenticateLocalUser(). Si el token proporcionado a esta llamada ha expirado o no es válido por otro motivo, las operaciones que requieren un token válido generarán un error. Se puede proporcionar un token nuevo y válido a la biblioteca de Party mediante otra llamada a este método.
El autor de la llamada es responsable de supervisar la expiración del token de entidad proporcionado a este método y a PartyManager::CreateLocalUser() o PartyManager::CreateLocalUserWithEntityType(). Cuando el token se acerque a la hora de expiración o la haya superado, se debe obtener un nuevo token realizando una operación de inicio de sesión de PlayFab y proporcionarlo a la biblioteca de Party llamando a este método. Se recomienda adquirir un nuevo token cuando el token proporcionado anteriormente se encuentre a mitad de su período de validez. En las plataformas que pueden entrar en un estado de bajo consumo o hacer que la aplicación pause la 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.
Requisitos
Encabezado: Party.hConsulte también
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser