Los logros pueden ser una excelente manera de aumentar la participación de los usuarios dentro de tu juego. Puedes implementar logros en tu juego para motivar a los jugadores a experimentar con funciones que por lo general no usarían o a abordar tu juego con estilos completamente diferentes. Los logros también pueden ser una forma divertida para que los jugadores comparen sus progresos entre sí y participen en juegos de poca intensidad.
A fin de obtener información para implementar logros en tu plataforma, consulta Implementaciones de clientes.
Atributos
Para comprender cómo funcionan los logros, te recomendamos que te familiarices con algunos de los atributos asociados a estos.
Estos elementos básicos están asociados a cada logro:
- ID: Es una string única que genera Google Play Console. Utilizarás este ID único para hacer referencia al logro en los clientes de tu juego.
- Nombre: Es un nombre corto del logro (por ejemplo, "Maestro pastelero"). El valor puede ser de hasta 100 caracteres.
- Descripción: Es una descripción concisa de tu logro. Por lo general, le indica al jugador cómo obtener el logro (por ejemplo, "Prepara un pastel de merengue de limón antes del atardecer"). El valor puede ser de hasta 500 caracteres.
- Ícono: Es un ícono cuadrado que se asocia con tu logro. Si deseas conocer las prácticas recomendadas para la creación de íconos de logros, consulta la sección Lineamientos de los íconos.
- Orden de lista: Es el orden en el que aparecen los logros bloqueados cuando un jugador ve los que se relacionan con el juego. Puede estar en el orden que quieras. Los logros desbloqueados aparecen en la parte superior de la lista en el orden en el que se los alcanzó.
Estado
Los logros pueden estar en uno de los siguientes tres estados:
- Un logro oculto significa que el jugador no podrá ver los detalles de este. Los Servicios de juego de Play proporcionan una descripción y un ícono del marcador de posición genéricos para el logro mientras se encuentra oculto. Te recomendamos que ocultes un logro si contiene un información sobre tu juego que no deseas revelar demasiado pronto (por ejemplo, "Descubre que fuiste un fantasma todo el tiempo").
- Un logro revelado significa que el jugador conoce el logro, pero aún no lo obtuvo. La mayoría de los logros comienzan en el estado revelado.
- Un logro desbloqueado significa que el jugador obtuvo el logro con éxito. Un logro se puede desbloquear sin conexión. Cuando el juego está en línea, se sincroniza con los Servicios de juego de Play para actualizar el estado del logro desbloqueado.
Logros incrementales
Los logros pueden designarse como estándar o incrementales. En general, un logro incremental implica un jugador que avanza de forma gradual para obtener el logro durante un período más largo. A medida que el jugador avanza para obtener el logro incremental, puedes informarle su progreso parcial a los Servicios de juego de Play.
El servicio de Google Play realiza un seguimiento de la información de progreso, le alerta al juego cuando el jugador cumple con los criterios necesarios para desbloquear ese logro y le informa qué tan lejos está de cumplir ese objetivo.
![Ejemplo de un logro incremental que muestra el progreso del jugador al 40%.](https://developer.android.com/static/images/games/pgs/achievementIncremental.png?authuser=3&hl=es-419)
Los logros incrementales son acumulativos en todas las sesiones del juego, y no se puede quitar ni restablecer el progreso dentro de este. Por ejemplo, "Ganar 50 veces" calificaría como un logro incremental. "Ganar 3 veces seguidas" no calificaría, ya que el progreso del jugador se restablecería cuando pierda una vez. "Tener 5,000 fichas de póquer" tampoco calificaría, ya que un jugador podía ganar y perder fichas cuando juega. En los últimos dos logros, depende de ti realizar un seguimiento del estado de "Victorias consecutivas" o del total de fichas del jugador y desbloquear los logros estándar cuando el jugador los obtiene.
Cuando crees un logro incremental, deberás definir la cantidad total de pasos necesarios para desbloquearlo (debe ser un número entre 2 y 10,000). A medida que el usuario avanza para desbloquear el logro, debes informar a los Servicios de juego de Play la cantidad de pasos adicionales que el usuario realizó. Una vez que la cantidad total de pasos alcanza el valor de desbloqueo, el logro se desbloquea (incluso si estaba oculto). No es necesario que guardes el progreso acumulado del usuario.
Puntos
Los logros tienen una puntuación asociada. La puntuación del jugador debe ser un múltiplo de 5, y un juego nunca puede tener un total de más de 1,000 puntos para todos sus logros (aunque puede tener menos). Además, ningún logro puede tener más de 200 puntos.
Haz un seguimiento de los puntos de experiencia (XP)
Además, los jugadores pueden ganar niveles en su perfil de juego cuando obtienen logros en los juegos habilitados para Play Juegos. Por cada punto asociado a un logro, el jugador ganará 100 puntos de experiencia (XP) cuando obtenga ese logro. En otras palabras:
XP for an achievement = 100 * (point value for the achievement)
Los Servicios de juego de Play hacen un seguimiento de los XP que gana cada jugador y envían una notificación a la app de Google Play Juegos cuando el jugador obtuvo suficientes puntos para "subir de nivel". Los jugadores pueden consultar su nivel y el historial de XP en la página de perfil de la app de Google Play Juegos.
Logros mínimos
Un juego que integra logros debe tener al menos cinco antes de publicarse. Puedes probar con menos de cinco logros, pero te recomendamos que tengas al menos cinco creados antes de publicar el juego.
Logros máximos
La cantidad de logros está restringida por los límites y la distribución de puntos. Si la cantidad máxima de puntos se establece en 1,000 y a cada logro se le asigna 5 puntos, la cantidad máxima de logros es 200. Sin embargo, si a los logros se les asignan más puntos, como resultado, la cantidad de logros disponible disminuye.
Lineamientos de los íconos
Los íconos deben crearse como archivos PNG o JPG de 512 x 512. Solo debes proporcionarnos el ícono del logro desbloqueado. Generaremos una versión en escala de grises automáticamente para el ícono revelado. Por ese motivo, te recomendamos que los íconos de logros incluyan elementos coloridos, de modo que los usuarios puedan diferenciar con facilidad los logros revelados y desbloqueados.
Cuando los íconos de logros se muestran en los avisos de Android, se superponen con un círculo y se ocultan las esquinas exteriores. Asegúrate de que tu ícono se vea bien, incluso en estas circunstancias.
![Ejemplo de un ícono de logro ubicado dentro de un círculo.](https://developer.android.com/static/images/games/pgs/achievementIconExample.png?authuser=3&hl=es-419)
Se usa el mismo ícono en todos los parámetros de configuración regional, por lo que te recomendamos que no incluyas texto ni contenido localizado en un ícono.
Crea un logro
En esta sección, se describe cómo crear logros para juegos nuevos y publicados.
Juego nuevo
Si deseas crear un logro para un juego nuevo y no publicado, ve a la entrada de Google Play Console correspondiente a tu juego en la pestaña Juegos con servicios de juego.
Selecciona la pestaña Logros a la izquierda y haz clic en el botón Agregar logro.
![Botón "Agregar logro" en el panel principal de Logros](https://developer.android.com/static/images/games/pgs/achievementAddButton.png?authuser=3&hl=es-419)
Luego, solo completa la información que se necesita para este logro.
![Ejemplo de un formulario de logro completado para el logro "Último lugar".](https://developer.android.com/static/images/games/pgs/achievementSampleForm.png?authuser=3&hl=es-419)
Haz clic en Guardar, y tu logro estará disponible en el modo "Listo para publicar". Una vez que publiques el juego, todos tus logros se publicarán con este.
Juego publicado
A fin de crear un logro adicional para un juego que ya se publicó, sigue los mismos pasos anteriores. La única diferencia es que el botón Guardar se volverá a etiquetar como Guardar como borrador y el logro estará en el modo "Listo para probar". A fin de obtener más información para probar una versión actualizada de un juego, consulta Cómo publicar los cambios en los juegos.
Una vez que hayas probado tu logro y estés conforme con este, podrás volver a publicar el juego con los nuevos logros, y estos estarán disponibles para todo el mundo.
Edita un logro
Para editar un logro que ya creaste, selecciónalo en la pestaña Logros en Google Play Console. En este punto, verás el mismo formulario que usaste cuando creaste el logro por primera vez y podrás editar cualquiera de los campos según lo desees.
Cuando termines de editar un logro, haz clic en el botón Guardar como borrador. El logro que acabas de editar estará en la etapa de "listo para probar", y podrás realizar pruebas. Si funciona de forma correcta, selecciona Volver a publicar en la lista desplegable. De esta manera, se vuelve a publicar el juego para el público, junto con todos los logros actualizados.
Deshace una edición
Si decides que no te gusta tu logro actual y deseas cambiarlo a como era antes, selecciona Revertir en la lista desplegable de Google Play Console, y todos tus logros volverán a la versión publicada anteriormente.
Borra un logro
Una vez que se publica el logro, no se puede borrar.
Solo puedes borrar un logro en un estado publicado previamente si haces clic en el botón Borrar en la parte inferior del formulario para ese logro.
Restablece un logro
Solo puedes restablecer los datos de progreso de los jugadores para los logros en borrador.
- Para restablecer los logros en Google Play Console, haz clic en el botón Restablecer el progreso del logro en la parte inferior del formulario de ese evento.
- Para restablecer los datos de logros de manera programática, llama a los métodos
Achievements
de la API de Management.
Agrega traducciones para los logros
Puedes especificar tus propias traducciones de los logros que se relacionan con el juego. Antes de hacerlo, primero asegúrate de completar los pasos que se describen en Cómo agregar traducciones para tu juego. También debes haber creado uno o más logros para tu juego.
A fin de agregar tus propias traducciones para los logros, abre la pestaña Logros de tu juego en Google Play Console y, luego, selecciona uno existente. En la página de detalles de los logros, selecciona la pestaña de un idioma que agregaste anteriormente en la pestaña Detalles del juego. En la página de detalles del logro para ese idioma, edita el formulario con las traducciones correspondientes. Haz clic en Guardar para almacenar los detalles de tu logro traducido.
Implementaciones de cliente
A fin de obtener información para implementar logros en tu plataforma, consulta los siguientes recursos: