5a1fd7dadd
Bumps [github.com/SevereCloud/vksdk/v2](https://github.com/SevereCloud/vksdk) from 2.11.0 to 2.13.0. - [Release notes](https://github.com/SevereCloud/vksdk/releases) - [Commits](https://github.com/SevereCloud/vksdk/compare/v2.11.0...v2.13.0) --- updated-dependencies: - dependency-name: github.com/SevereCloud/vksdk/v2 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> |
||
---|---|---|
.. | ||
README.md | ||
context.go | ||
errors.go | ||
longpoll.go |
README.md
Bots Long Poll API
Подключение Bots Long Poll API
Long Poll настраивается автоматически. Вам не требуется заходить в настройки сообщества.
Версия API
Данная библиотека поддерживает версию API 5.131.
Инициализация
Модуль можно использовать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow(требуются права доступа: groups) или с ключом доступа сообщества(требуются права доступа: manage).
В начале необходимо инициализировать api:
vk := api.NewVK("<TOKEN>")
А потом сам longpoll
lp, err := longpoll.NewLongPoll(vk api.VK, groupID int)
// По умолчанию Wait = 25
// lp.Wait = 90
// lp.Ts = "123"
HTTP client
В модуле реализована возможность изменять HTTP клиент - lp.Client
Пример прокси
dialer, _ := proxy.SOCKS5("tcp", "127.0.0.1:9050", nil, proxy.Direct)
httpTransport := &http.Transport{
Dial: dialer.Dial,
// DisableKeepAlives: true,
}
httpTransport.Dial = dialer.Dial
lp.Client.Transport = httpTransport
Обработчик событий
Для каждого события существует отдельный обработчик, который передает функции
ctx
и object
.
Пример для события message_new
lp.MessageNew(func(ctx context.Context, obj events.MessageNewObject) {
...
})
Если вы хотите получать полный ответ от Long Poll(например для сохранения ts
или специальной обработки failed
), можно воспользоваться следующим обработчиком.
lp.FullResponse(func(resp object.LongPollBotResponse) {
...
})
Полный список событий Вы найдёте в документации
Контекст
Поля groupID
, ts
и eventID
передаются в ctx
. Чтобы получить их, можно
воспользоваться следующими функциями:
groupID := events.GroupIDFromContext(ctx)
eventID := events.EventIDFromContext(ctx)
ts := longpoll.TsFromContext(ctx)
Запуск и остановка
// Запуск
if err := lp.Run(); err != nil {
log.Fatal(err)
}
// Безопасное завершение
// Ждет пока соединение закроется и события обработаются
lp.Shutdown()
// Закрыть соединение
// Требует lp.Client.Transport = &http.Transport{DisableKeepAlives: true}
lp.Client.CloseIdleConnections()
Пример
package main
import (
"log"
"github.com/SevereCloud/vksdk/v2/api"
longpoll "github.com/SevereCloud/vksdk/v2/longpoll-bot"
"github.com/SevereCloud/vksdk/v2/events"
)
func main() {
vk := api.NewVK("<TOKEN>")
lp, err := longpoll.NewLongPoll(vk, 12345678)
if err != nil {
panic(err)
}
lp.MessageNew(func(ctx context.Context, obj events.MessageNewObject) {
log.Print(obj.Message.Text)
})
lp.Run()
}