Sintaxis
Parámetros
entityId PartyString
El identificador de entidad de PlayFab que se va a asociar al usuario local.
titlePlayerEntityToken PartyString
El token de entidad de PlayFab que se va a asociar al usuario local.
localUser PartyLocalUser**salida asignada por la biblioteca El objeto de usuario local de salida.
Valor devuelto
PartyErrorc_partyErrorSuccess 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 GetErrorMessage().
Comentarios
Este método toma un identificador de entidad de PlayFab comoentityId y un token de entidad de PlayFab como titlePlayerEntityToken. No se realiza ninguna validación sincrónica de estos valores, excepto que la longitud de entityId sea menor o igual que c_maxEntityIdStringLength. 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 identificador de entidad proporcionado 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 identificador 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, a continuación, proporcionarlos como entrada a este método. El identificador de entidad de PlayFab debe ser de tipo
title_player_account que, para la mayoría de los desarrolladores, representa al “jugador” de la manera más tradicional. Para crear usuarios que representen otros tipos de entidades compatibles, use CreateLocalUserWithEntityType() en su lugar. Los valores
entityId y titlePlayerEntityToken proporcionados deben haberse adquirido con el mismo identificador de título que se pasó a 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 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 una llamada a PartyLocalUser::UpdateEntityToken().
El autor de la llamada es responsable de supervisar la expiración del token de entidad proporcionado a este método y a PartyLocalUser::UpdateEntityToken(). 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 PartyLocalUser::UpdateEntityToken(). 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.
Solo pueden existir
c_maxLocalUsersPerDeviceCount objetos PartyLocalUser simultáneamente en un momento dado. Este método generará un error de forma sincrónica si la creación de otro usuario local supera ese límite. Si se devuelve correctamente, este método invalida la memoria de cualquier matriz devuelta anteriormente por GetLocalUsers(), ya que agrega de forma sincrónica el nuevo usuario a la matriz. StartProcessingStateChanges() también invalida la memoria de la matriz. El objeto
localUser devuelto será válido hasta que se haya generado un PartyDestroyLocalUserCompletedStateChange y todos los cambios de estado que hacen referencia al objeto se hayan devuelto a FinishProcessingStateChanges().
Requisitos
Encabezado: Party.hConsulte también
PartyManagerPartyDestroyLocalUserCompletedStateChange
PartyManager::Initialize
PartyManager::GetLocalUsers
PartyManager::CreateLocalUserWithEntityType
PartyManager::DestroyLocalUser
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser
PartyNetwork::RemoveLocalUser
PartyNetwork::CreateInvitation
PartyNetwork::RevokeInvitation
PartyNetwork::CreateEndpoint
PartyLocalUser::UpdateEntityToken
PartyLocalDevice::CreateChatControl