Instagram және Facebook-тегі геймификация әдістері
Функциялардың жұмысын конфигурациялау үшін Instagram чаттарына арналған геймификация үлгісін анықтама ретінде пайдалануды ұсынамыз.
Төменде көрсетілген функцияларды пайдалану үшін Жоба параметрлерінде ортақ айнымалыларды жариялау қажет:
game_add_comment(text=None) - Instagram немесе FB-дегі пікір үшін ұпай қосады; кез келген мәтінді де беруге болады.
game_add_stories() - стористердегі реакциялар үшін ұпай қосады
game_add_message() - Direct хабарламалары үшін ұпай қосады
game_add_stories_mention() - стористердегі атап өтулер үшін ұпай қосады
game_get_user_score() - пайдаланушының ұпайларын қайтарады
game_get_user_place() - пайдаланушының рейтингтегі орнын көрсетеді
game_get_leader_score() - рейтингтегі көшбасшының ұпайларын қайтарады
game_get_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None) - функцияны аргументтерсіз шақыру пайдаланушылар массиві ретінде сұрыпталған рейтингті қайтарады. Келесі 5 параметрді қабылдайды: count - қанша пайдаланушыны қайтару керек; shift - іріктеу үшін бастапқы рейтинг позициясы (0 тізім көшбасшыдан басталып, ұпайлар бойынша төмендейтінін білдіреді; мысалы, 3 іріктеу 4-ші орыннан және одан төмен басталады); humanize 0 - пайдаланушы сөздіктерінің массивін қайтарады, 1 пайдаланушыға көрсету үшін пішімделген тізімді қайтарады; delimiter - пайдаланушы аты мен оның ұпайы арасындағы бөлгіш (егер humanize=1 болса қолданылады); platform 1 - пайдаланушы атының орнына Instagram логинін шығарады (мысалы, @nik).
Мысал 1: game_get_top(10, 0, 1, ' - ') келесіні қайтарады: John - 40 Anna - 30 George - 10
Мысал 2: game_get_top(3, 0, 1, ' - ', 1) келесіні қайтарады: @john - 40 @anna - 30 @privet - 10
game_add_score(count=1, client_id=None) - пайдаланушыға ұпай қосады
game_set_score(score, client_id=None) - пайдаланушының жалпы ұпайын орнатады
game_ban_player() - пайдаланушыны блоктайды
game_unban_player() - пайдаланушыны блоктан шығарады
game_user_banned() - пайдаланушының блоктау күйін қайтарады; блокталған болса True, блокталмаған болса False
# көшбасшылар тақтасында ерікті мәндермен жұмыс істеуге мүмкіндік береді.
game_add_value(val_name, count=1, client_id=None) -
game_set_value(val_name, value, client_id=None)
Егер client_id көрсетілмесе, функция ағымдағы клиентпен жұмыс істейді.
game_minus_user_score(count =10) - пайдаланушыдан ұпайларды алып тастайды (count - қанша ұпай алып тастау керек)
game_get_today_user_comment_action() - пайдаланушының бүгін жазған пікірлерінің саны
game_get_today_user_message_actions() - пайдаланушының бүгін жіберген хабарламаларының саны
game_get_today_user_stories_actions() - пайдаланушының бүгін жариялаған стористерінің саны
game_get_today_user_mention_actions() - пайдаланушының бүгінгі әрекеттерінің (атап өтулер) саны
game_get_today_user_post_mention_actions() - пайдаланушының бүгін атап өтулері бар жазбаларының саны
game_get_total_comment_action() - бүкіл ойын кезіндегі пікірлердің жалпы саны
game_get_total_message_actions() - бүкіл ойын кезіндегі хабарламалардың жалпы саны
game_get_total_stories_actions() - бүкіл ойын кезіндегі стористердің жалпы саны
game_get_total_stories_mention_actions() - бүкіл ойын кезіндегі стористердегі атап өтулердің жалпы саны
game_get_total_post_mention_actions() - бүкіл ойын кезіндегі жазбалардағы атап өтулердің жалпы саны
Telegram-да рейтинг алу
Функциялардың жұмысын конфигурациялау үшін Telegram чаттарына арналған геймификация үлгісін анықтама ретінде пайдалануды ұсынамыз.
Жаһандық айнымалыларда клиент ақпаратын сақтау үшін tg_thanks_score_data деп аталатын сөздік жасау керек, келесі форматта:
{"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)
Параметрлері:
count - қанша пайдаланушыны қайтару керек
shift - іріктеу үшін бастапқы рейтинг позициясы (0 тізім көшбасшыдан басталып, ұпайлар бойынша төмендейтінін білдіреді; мысалы, 3 іріктеу 4-ші орыннан және одан төмен басталады)
humanize - 0 пайдаланушы сөздіктерінің массивін қайтарады, 1 пайдаланушыға көрсету үшін пішімделген тізімді қайтарады
delimiter - пайдаланушы аты мен оның ұпайы арасындағы бөлгіш (егер humanize=1 болса қолданылады)
tg_get_user_info()
{'score': user_score, 'place': place, 'name': name}