gpg::
#include <game_services.h>
Es el punto de partida para interactuar con Google Play Juegos.
Resumen
Ciclo de vida de los servicios de juego
Se crea una instancia de la clase GameServices a través de un GameServices::Builder. Cuando se crea, la instancia no accede a los Servicios de juego de forma inicial (es decir, IsAuthorized() mostrará un valor falso). Se inicia un intento de acceso silencioso en segundo plano y puede tener éxito si un usuario accedió al final de una sesión anterior. Hasta que se complete este intento de acceso silencioso, se debe inhabilitar o ocultar cualquier IU de autenticación del usuario (por ejemplo, los botones de acceso o salida).
Cuando se complete este intento de acceso silencioso, se notificará la devolución de llamada OnAuthActionFinished para la instancia de GameServices (registrada con GameServices::Builder::SetOnAuthActionFinished). Si los argumentos de devolución de llamada reflejan un intento de acceso exitoso, se puede suponer que la instancia está conectada a Game Services (es decir, IsAuthorized() mostrará un valor verdadero) y se debe habilitar la IU de salida. Si el argumento de devolución de llamada refleja un intento de acceso fallido, se debe habilitar la IU de acceso.
El cierre de sesión explícito a través del método SignOut() solo debe invocarse a pedido del usuario. Esto solicita una transición a un estado de salida. La finalización de esta transición se indica con una invocación de la devolución de llamada OnAuthActionFinished. Hasta que se invoque esta devolución de llamada, no se debe llamar a otras APIs de GameServices (incluida StartAuthorizationUI()).
Cuando se destruya una instancia de GameServices, se bloqueará hasta que no haya operaciones pendientes para evitar la pérdida de datos. Si no se desea este comportamiento de bloqueo en la destrucción, se debe emitir un Flush() y la instancia de GameServices debe mantenerse activa hasta que se complete Flush().
Para que GameServices funcione correctamente en versiones de Android anteriores a la 4.0, la actividad propietaria debe llamar a las devoluciones de llamada del ciclo de vida. Consulta AndroidSupport.
Constructores y destructores |
|
|---|---|
GameServices()
|
|
~GameServices()
|
Tipos públicos |
|
|---|---|
FlushCallback
|
typedefstd::function< void(FlushStatus)>
Define un tipo de devolución de llamada que recibe el resultado (estado) de una operación de limpieza. |
Funciones públicas |
|
|---|---|
Achievements()
|
Proporciona una referencia al objeto AchievementManager que se usa para acceder a los logros y manipularlos.
|
Achievements() const
|
const AchievementManager &
Proporciona una referencia constante al objeto AchievementManager que se usa para acceder a los logros y manipularlos.
|
Events()
|
Proporciona una referencia al objeto EventManager que se usa para acceder a los eventos y manipularlos.
|
Events() const
|
const EventManager &
Proporciona una referencia const al objeto EventManager que se usa para acceder a eventos y manipularlos.
|
Flush(FlushCallback callback)
|
void
Borra de forma asíncrona la cola de envío principal y muestra el estado de la limpieza en el FlushCallback proporcionado.
|
FlushBlocking()
|
Limpia de forma síncrona y obtiene un resultado (estado) de la limpieza.
|
FlushBlocking(Timeout timeout)
|
Limpia de forma síncrona y obtiene un resultado (estado) de la limpieza.
|
IsAuthorized()
|
bool
Te permite verificar de forma explícita el estado de autorización actual.
|
Leaderboards()
|
Proporciona una referencia al objeto LeaderboardManager que se usa para acceder a los logros y manipularlos.
|
Leaderboards() const
|
const LeaderboardManager &
Proporciona una referencia constante al objeto LeaderboardManager que se usa para acceder a los logros y manipularlos.
|
Players()
|
Proporciona una referencia al objeto PlayerManager, que permite acceder a información sobre los jugadores.
|
Players() const
|
const PlayerManager &
Proporciona una referencia const al objeto PlayerManager, que permite el acceso a la información sobre los jugadores.
|
RealTimeMultiplayer()
|
Proporciona una referencia al objeto RealTimeMultiplayerManager, que permite el acceso a métodos relacionados con RTMP.
|
RealTimeMultiplayer() const
|
const RealTimeMultiplayerManager &
Proporciona una referencia constante al objeto RealTimeMultiplayerManager, que permite el acceso a métodos relacionados con RTMP.
|
SignOut()
|
void
Inicia el proceso de salida asíncrono.
|
Snapshots()
|
Proporciona una referencia al objeto SnapshotManager que se usa para acceder a las instantáneas y manipularlas.
|
Snapshots() const
|
const SnapshotManager &
Proporciona una referencia constante al objeto SnapshotManager que se usa para acceder a las instantáneas y manipularlas.
|
StartAuthorizationUI()
|
void
Muestra un flujo de autorización de usuario específico de la plataforma.
|
Stats()
|
Proporciona una referencia al objeto StatsManager que se usa para acceder a las estadísticas del juego y del jugador.
|
Stats() const
|
const StatsManager &
Proporciona una referencia const al objeto StatsManager que se usa para acceder a las estadísticas del juego y del jugador.
|
TurnBasedMultiplayer()
|
Proporciona una referencia al objeto TurnBasedMultiplayerManager, que permite el acceso a los métodos relacionados con TBMP.
|
TurnBasedMultiplayer() const
|
const TurnBasedMultiplayerManager &
Proporciona una referencia const al objeto TurnBasedMultiplayerManager, que permite el acceso a los métodos relacionados con TBMP.
|
Video()
|
Proporciona una referencia al objeto VideoManager, que permite el acceso a métodos relacionados con videos.
|
Video() const
|
const VideoManager &
Proporciona una referencia const al objeto VideoManager, que permite el acceso a métodos relacionados con los videos.
|
Clases |
|
|---|---|
|
gpg:: |
Se usa para crear y configurar una instancia de la clase GameServices. |
Tipos públicos
FlushCallback
std::function< void(FlushStatus)> FlushCallback
Define un tipo de devolución de llamada que recibe el resultado (estado) de una operación de limpieza.
Se usa en Flush().
Funciones públicas
Logros
AchievementManager & Achievements()
Proporciona una referencia al objeto AchievementManager que se usa para acceder a los logros y manipularlos.
Logros
const AchievementManager & Achievements() const
Proporciona una referencia constante al objeto AchievementManager que se usa para acceder a los logros y manipularlos.
Eventos
EventManager & Events()
Proporciona una referencia al objeto EventManager que se usa para acceder a los eventos y manipularlos.
Eventos
const EventManager & Events() const
Proporciona una referencia const al objeto EventManager que se usa para acceder a eventos y manipularlos.
Flush
void Flush( FlushCallback callback )
Borra de forma asíncrona la cola de envío principal y muestra el estado de la limpieza en el FlushCallback proporcionado.
Los estados posibles son: FLUSHED, ERROR_INTERNAL y ERROR_VERSION_UPDATE_REQUIRED.
FlushBlocking
FlushStatus FlushBlocking()
Limpia de forma síncrona y obtiene un resultado (estado) de la limpieza.
Los estados posibles son: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED y ERROR_TIMEOUT. Si no especificas este tiempo de espera, esta llamada a función equivale a llamar a FlushStatus FlushBlocking(Timeout), con un tiempo de espera especificado como 10 años.
FlushBlocking
FlushStatus FlushBlocking( Timeout timeout )
Limpia de forma síncrona y obtiene un resultado (estado) de la limpieza.
Los estados posibles son: FLUSHED, ERROR_INTERNAL, ERROR_NOT_AUTHORIZED, ERROR_VERSION_UPDATE_REQUIRED y ERROR_TIMEOUT. Especifica el tiempo de espera como una cantidad arbitraria de milisegundos.
GameServices
GameServices()=delete
IsAuthorized
bool IsAuthorized()
Te permite verificar de forma explícita el estado de autorización actual.
Se recomienda a los consumidores del SDK que se registren para recibir devoluciones de llamada de AUTH_ACTION_* para controlar los cambios de estado de autorización, en lugar de sondear.
Tablas de clasificación
LeaderboardManager & Leaderboards()
Proporciona una referencia al objeto LeaderboardManager que se usa para acceder a los logros y manipularlos.
Tablas de clasificación
const LeaderboardManager & Leaderboards() const
Proporciona una referencia constante al objeto LeaderboardManager que se usa para acceder a los logros y manipularlos.
Players
PlayerManager & Players()
Proporciona una referencia al objeto PlayerManager, que permite acceder a información sobre los jugadores.
Players
const PlayerManager & Players() const
Proporciona una referencia const al objeto PlayerManager, que permite el acceso a la información sobre los jugadores.
RealTimeMultiplayer
RealTimeMultiplayerManager & RealTimeMultiplayer()
Proporciona una referencia al objeto RealTimeMultiplayerManager, que permite el acceso a métodos relacionados con RTMP.
RealTimeMultiplayer
const RealTimeMultiplayerManager & RealTimeMultiplayer() const
Proporciona una referencia constante al objeto RealTimeMultiplayerManager, que permite el acceso a métodos relacionados con RTMP.
SignOut
void SignOut()
Inicia el proceso de salida asíncrono.
Después de llamar a SignOut, no debes llamar a ninguna operación en GameServices hasta que recibas la devolución de llamada OnAuthActionFinishedCallback que indique que se realizó correctamente la salida.
Instantáneas
SnapshotManager & Snapshots()
Proporciona una referencia al objeto SnapshotManager que se usa para acceder a instantáneas y manipularlas.
Instantáneas
const SnapshotManager & Snapshots() const
Proporciona una referencia const al objeto SnapshotManager que se usa para acceder a las instantáneas y manipularlas.
StartAuthorizationUI
void StartAuthorizationUI()
Muestra un flujo de autorización de usuario específico de la plataforma.
Estadísticas
StatsManager & Stats()
Proporciona una referencia al objeto StatsManager que se usa para acceder a las estadísticas del juego y del jugador.
Estadísticas
const StatsManager & Stats() const
Proporciona una referencia const al objeto StatsManager que se usa para acceder a las estadísticas del juego y del jugador.
TurnBasedMultiplayer
TurnBasedMultiplayerManager & TurnBasedMultiplayer()
Proporciona una referencia al objeto TurnBasedMultiplayerManager, que permite el acceso a los métodos relacionados con TBMP.
TurnBasedMultiplayer
const TurnBasedMultiplayerManager & TurnBasedMultiplayer() const
Proporciona una referencia const al objeto TurnBasedMultiplayerManager, que permite el acceso a los métodos relacionados con TBMP.
Video
VideoManager & Video()
Proporciona una referencia al objeto VideoManager, que permite el acceso a métodos relacionados con videos.
Video
const VideoManager & Video() const
Proporciona una referencia const al objeto VideoManager, que permite el acceso a métodos relacionados con videos.
~GameServices
~GameServices()