Métodos de gamificación en Instagram y Facebook
Para configurar el funcionamiento de las funciones, recomendamos usar la plantilla de gamificación para chats de Instagram como referencia.
Para usar las funciones listadas a continuación, debes declarar variables comunes en la Configuración del proyecto:
game_add_comment(text=None) - añade puntos por un comentario en Instagram o FB; también puedes pasar cualquier texto.
game_add_stories() - añade puntos por reacciones en historias
game_add_message() - añade puntos por mensajes directos
game_add_stories_mention() - añade puntos por menciones en historias
game_get_user_score() - devuelve los puntos del usuario
game_get_user_place() - muestra la posición del usuario en el ranking
game_get_leader_score() - devuelve los puntos del líder en el ranking
game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - llamar a la función sin argumentos devuelve un ranking ordenado como un array de usuarios. Acepta los siguientes 5 parámetros: count - cuántos usuarios devolver; shift - la posición inicial del ranking para la selección (0 significa que la lista comienza desde el líder y desciende por puntos; por ejemplo, 3 significa que la selección comienza desde el 4to lugar hacia abajo); humanize 0 - devuelve un array de diccionarios de usuario, 1 devuelve una lista formateada para mostrar al usuario; delimiter - el separador entre el nombre de usuario y su puntuación (se usa si humanize=1); platform 1 - muestra el login de Instagram (ej., @nik) en lugar del nombre de usuario.
Ejemplo 1: game_get_top(10, 0, 1, ' - ') devolverá: John - 40 Anna - 30 George - 10
Ejemplo 2: game_get_top(3, 0, 1, ' - ', 1) devolverá: @john - 40 @anna - 30 @privet - 10
game_add_score(count=1, client_id=None) - añade puntos al usuario
game_set_score(score, client_id=None) - establece los puntos totales del usuario
game_ban_player() - bloquea al usuario
game_unban_player() - desbloquea al usuario
game_user_banned() - devuelve el estado de bloqueo del usuario; True si está bloqueado, False si no
# permite trabajar con valores arbitrarios en la tabla de clasificación.
game_add_value(val_name, count=1, client_id=None) -
game_set_value(val_name, value, client_id=None)
Si no se proporciona client_id, la función trabaja con el cliente actual.
game_minus_user_score(count =10) - resta puntos al usuario (count - cuántos puntos restar)
game_get_today_user_comment_action() - número de comentarios realizados por el usuario hoy
game_get_today_user_message_actions() - número de mensajes enviados por el usuario hoy
game_get_today_user_stories_actions() - número de historias publicadas por el usuario hoy
game_get_today_user_mention_actions() - número de actividades del usuario (menciones) hoy
game_get_today_user_post_mention_actions() - número de publicaciones con menciones del usuario hoy
game_get_total_comment_action() - número total de comentarios durante todo el juego
game_get_total_message_actions() - número total de mensajes durante todo el juego
game_get_total_stories_actions() - número total de historias durante todo el juego
game_get_total_stories_mention_actions() - número total de menciones en historias durante todo el juego
game_get_total_post_mention_actions() - número total de menciones en publicaciones durante todo el juego
Obtener ranking en Telegram
Para configurar el funcionamiento de las funciones, recomendamos usar la plantilla de gamificación para chats de Telegram como referencia.
En las variables globales, debes crear un diccionario llamado tg_thanks_score_data para almacenar la información del cliente en el siguiente formato:
{"total_thanks":20,"326659632":{"name":"John","user_name":"john","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}
tg_get_top(count=99999999, shift=0, humanize=False, delimiter=None)
Parámetros:
count - cuántos usuarios devolver
shift - la posición inicial del ranking para la selección (0 significa que la lista comienza desde el líder y desciende por puntos; por ejemplo, 3 significa que la selección comienza desde el 4to lugar hacia abajo)
humanize - 0 devuelve un array de diccionarios de usuario, 1 devuelve una lista formateada para mostrar al usuario
delimiter - el separador entre el nombre de usuario y su puntuación (se usa si humanize=1)
tg_get_user_info()
{'score': user_score, 'place': place, 'name': name}