Métodos de gamificação no Instagram e Facebook
Para configurar as operações das funções, recomendamos usar o modelo de gamificação para chats do Instagram como referência.
Para usar as funções listadas abaixo, você precisa declarar variáveis comuns nas Configurações do projeto:
game_add_comment(text=None) - adiciona pontos por um comentário no Instagram ou FB; você também pode passar qualquer texto.
game_add_stories() - adiciona pontos por reações em stories
game_add_message() - adiciona pontos por mensagens diretas
game_add_stories_mention() - adiciona pontos por menções em stories
game_get_user_score() - retorna os pontos do usuário
game_get_user_place() - exibe a posição do usuário no ranking
game_get_leader_score() - retorna os pontos do líder no ranking
game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - chamar a função sem argumentos retorna um ranking ordenado como um array de usuários. Aceita os seguintes 5 parâmetros: count - quantos usuários retornar; shift - a posição inicial do ranking para a seleção (0 significa que a lista começa pelo líder e desce por pontos; por exemplo, 3 significa que a seleção começa a partir do 4º lugar e abaixo); humanize 0 - retorna um array de dicionários de usuários, 1 retorna uma lista formatada para exibição ao usuário; delimiter - o separador entre o nome de usuário e sua pontuação (usado se humanize=1); platform 1 - exibe o login do Instagram (por exemplo, @nik) em vez do nome de usuário.
Exemplo 1: game_get_top(10, 0, 1, ' - ') retornará: John - 40 Anna - 30 George - 10
Exemplo 2: game_get_top(3, 0, 1, ' - ', 1) retornará: @john - 40 @anna - 30 @privet - 10
game_add_score(count=1, client_id=None) - adiciona pontos ao usuário
game_set_score(score, client_id=None) - define o total de pontos do usuário
game_ban_player() - bloqueia o usuário
game_unban_player() - desbloqueia o usuário
game_user_banned() - retorna o status de banimento do usuário; True se banido, False se não
# permite trabalhar com valores arbitrários no leaderboard.
game_add_value(val_name, count=1, client_id=None) -
game_set_value(val_name, value, client_id=None)
Se client_id não for fornecido, a função trabalha com o cliente atual.
game_minus_user_score(count =10) - subtrai pontos do usuário (count - quantos pontos subtrair)
game_get_today_user_comment_action() - número de comentários feitos pelo usuário hoje
game_get_today_user_message_actions() - número de mensagens enviadas pelo usuário hoje
game_get_today_user_stories_actions() - número de stories publicados pelo usuário hoje
game_get_today_user_mention_actions() - número de atividades do usuário (menções) hoje
game_get_today_user_post_mention_actions() - número de posts com menções pelo usuário hoje
game_get_total_comment_action() - número total de comentários durante todo o jogo
game_get_total_message_actions() - número total de mensagens durante todo o jogo
game_get_total_stories_actions() - número total de stories durante todo o jogo
game_get_total_stories_mention_actions() - número total de menções em stories durante todo o jogo
game_get_total_post_mention_actions() - número total de menções em posts durante todo o jogo
Obtendo ranking no Telegram
Para configurar as operações das funções, recomendamos usar o modelo de gamificação para chats do Telegram como referência.
Nas variáveis globais, você deve criar um dicionário chamado tg_thanks_score_data para armazenar informações do cliente no seguinte 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 - quantos usuários retornar
shift - a posição inicial do ranking para seleção (0 significa que a lista começa pelo líder e desce por pontos; por exemplo, 3 significa que a seleção começa a partir do 4º lugar e abaixo)
humanize - 0 retorna um array de dicionários de usuários, 1 retorna uma lista formatada para exibição ao usuário
delimiter - o separador entre o nome de usuário e sua pontuação (usado se humanize=1)
tg_get_user_info()
{'score': user_score, 'place': place, 'name': name}