Библиотека для работы с vk api — libvkx 0.1 release

Morty · 3 Фев 2018

libvkx — Библиотека для работы с vk api, реализующая удобный C++ интерфейс.
Для работы с сетью использует libcurl.dll
Классы:

Конструктор принимает int user_id или std::string screen_name. Получает id, first_name и last_name
get() заполняет объект другими полями, реализованными в библиотеке
static get(int user_id) & static get(std::string screen_name) возвращают заполненные объекты vkx::user
getFirstName() возвращает строку с именем
getLastName() возвращает строку с фамилией
getName() возвращает строку вида "Имя Фамилия"
getID() возвращает целое user_id
getSName() возвращает строку screen_name
isChecked() возвращает булевое состояние галочки профиля
isOnline() возвращает булевое состояние "Онлайн"/"Оффлайн"
getStatus() возвращает строку со статусом
getBirthdayString() возвращает отформатированную строку с датой рождения
getSexString() возвращает пол в виде строки. "Male" или "Female"
getHomeTown() возвращает строку "родной город"
getCountryString() возвращает строку со страной в профиле
getCityString() возвращает строку с городом в профиле
toString() дампит объект в отформатированную удобочитаемую строку
getCityCountryString() возвращает удобочитаемую строку с городом и страной
static tostring(vkx::user usr) дампит объект vkx::user в удобочитаемую строку

Конструктор принимает std::string access_token или std::string login, std::string password. При получении логина-пароля делает попытку авторизации через настольное приложение VK для Windows. Поддерживает 2FA (требует передачи кода авторизации в stdin)
get() улучшенная версия vkx::user::get()
banUser(int user_id) добавляет пользователя с user_id в черный список
unBanUser(int user_id) убирает пользователя с user_id из черного списка
setOnline(bool voip) устанавливает статус "Онлайн"
setOffline() устанавливает статус "Оффлайн"

Публичный конструктор принимает std::string access_token пользователя
msgGet() возвращает структуру сообщения из встроенного буфера
msgSet(vkx:: obj::message) сохраняет структуру сообщения в встроенный буфер
msgGetByID(int msg_id, int maxlen = 0) получает сообщение с msg_id во встроенный буфер
static send(std::string access_token, int peer_id, std::string body) не привязанная к созданию объекта отправка сообщения
msgSend() отправка сообщения из встроенного буфера
msgSend(vkx:: obj::message) отправка сообщения из структуры сообщения
msgSend(int peer_id, std::string body="...", std::vector<int> fwd_messgaes = {}) отправка сообщения
msgSendGeo(int peer_id, double lat, double llong, std::string body="...") отправка географических координат сообщением
msgSendSticker(int peer_id, int sticker_id) отправка стикера
msgDelete(int message_id, bool spam = 0, bool = tdelete = 1) удаление сообщения
msgEdit(int peer_id, int msg_id, std::string body) редактирование сообщения
msgMarkAsRead(int peer_id, int msg_start_id) пометить сообщения начиная с msg_start_id как прочитанные
msgRestore(int msg_id) восстановить сообщение
msgSetActivity(int peer_id, std::string type = "typing") отправить "typing" activity в диалог с peer_id (собеседник будет видеть как вы набираете сообщение)
getLongPollServer(int lp_ver = 2) получить структуру для работы с long poll механизмом библиотеки
static getLongPollServer(std::string access_token, int lp_ver = 2) получить long poll структуру используя токен

Конструкторы:
polling(vkx:: obj::lpobj lp) инициализирует long poll механизм из структуры lpobj
polling(std::string access_token) инициализирует long poll механизм из строки, содержащей токен
polling(std::string srv, std::string key, std::string ts) инициализирует long poll из параметров метода vk api
polling(std::string srv, std::string key, int ts) см. пред. пункт
Методы:
start() запускает long poll цикл
stop() останавливает long poll цикл
registerNewMsgFunc(void (*func)(int)) регистрирует функцию обработки события нового сообщения
registerNewUserStatusFunc(void (*func)(int, bool)) регистрирует функцию обработки события смены онлайн статуса пользователя из списка друзей

Структуры объектов, которые используются в библиотеке можно посмотреть в objects.h
Любые вопросы/предложения по улучшению и переработке дизайна библиотеки принимаются в комментариях к треду и мне в личные сообщения

Ссылка на скачивание —