wrapper

package
v1.6.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 19, 2020 License: MIT Imports: 4 Imported by: 0

README

Обработчик User Long Poll API v3

Documentation VK

Данный модуль поддерживает версию 3.

// import "github.com/SevereCloud/vksdk/longpoll-user/v3"

w := wrapper.NewWrapper(&lp)

// event with code 4
w.OnNewMessage(func(m wrapper.NewMessage) {
  fmt.Printf("4 wrapper.NewMessage: %v\n", m)
})

Documentation

Overview

Package wrapper implement User Long Poll API wrapper v3.

w := wrapper.NewWrapper(&lp)

w.OnNewMessage(func(m wrapper.NewMessage) {
	fmt.Printf("4 wrapper.NewMessage: %v\n", m)
})

VK documentation https://vk.com/dev/using_longpoll

Index

Constants

View Source
const (
	ChatCreate      = "chat_create"       // create chat
	ChatTitleUpdate = "chat_title_update" // change chat name
	ChatPhotoUpdate = "chat_photo_update" // change chat photo
	ChatInviteUser  = "chat_invite_user"  // invite user to chat
	ChatKickUser    = "chat_kick_user"    // kick out user from chat
)

Possible values for Action.SourceAct

Variables

This section is empty.

Functions

This section is empty.

Types

type Action

type Action struct {
	SourceAct         string // Service action name with multiple dialogs
	SourceMid         string // User ID to whom the service action concerns
	SourceText        string
	SourceOldText     string
	SourceMessage     string
	SourceChatLocalID string
}

Action struct for AdditionalData

type AdditionalData

type AdditionalData struct {
	Title     string // Message's subject.
	RefSource string
	From      string // User ID of who sent the message if the message is from a chat
	// FromAdmin ID of the administrator who sent the message. It is returned for
	// messages sent from a community (only for community administrators).
	FromAdmin string
	Emoji     string // Message contains emoji.
	Action
}

AdditionalData struct. If mode contains the flag 2 along with text and the message topic, a JSON-object may be passed. This object contains media attachments or other additional information. Descriptions of the object fields are listed below.

type ChatInfoChange

type ChatInfoChange struct {
	TypeID TypeID
	PeerID int
	Info   int
}

ChatInfoChange struct for event with code 52

Chat info change

type ChatInfoChangeHandler

type ChatInfoChangeHandler func(m ChatInfoChange)

ChatInfoChangeHandler handler func for ChatInfoChange

type ChatParamsChange

type ChatParamsChange struct {
	ChatID int
	Self   int
}

ChatParamsChange struct for event with code 51

One of the parameters (content, topic) of the conversation ChatID was changed. Self — 1 or 0 (whether the change was caused by the user).

type ChatParamsChangeHandler

type ChatParamsChangeHandler func(m ChatParamsChange)

ChatParamsChangeHandler handler func for ChatParamsChange

type CounterChange

type CounterChange struct {
	Count int
}

CounterChange struct for event with code 80

type CounterChangeHandler

type CounterChangeHandler func(m CounterChange)

CounterChangeHandler handler func for CounterChange

type DeleteMessages

type DeleteMessages struct {
	PeerID  int
	LocalID int
}

DeleteMessages struct for event with code 13

Deletings all messages in PeerID dialogs with IDs up to LocalID

type DeleteMessagesHandler

type DeleteMessagesHandler func(m DeleteMessages)

DeleteMessagesHandler handler func for DeleteMessages

type DialogFlag

type DialogFlag int

DialogFlag type

const (
	ImportantDialog  DialogFlag = 1 << iota // Important dialog
	UnansweredDialog                        // Dialog without a community reply
)

Each dialog has flags, which are values received by summing up any of the following parameters.

func (DialogFlag) Has

func (b DialogFlag) Has(flag DialogFlag) bool

Has func

type DialogFlagsReplace

type DialogFlagsReplace struct {
	PeerID int
	Flags  DialogFlag
}

DialogFlagsReplace struct for event with code 11

Replace dialog flags

type DialogFlagsReplaceHandler

type DialogFlagsReplaceHandler func(m DialogFlagsReplace)

DialogFlagsReplaceHandler handler func for DialogFlagsReplace

type DialogFlagsReset

type DialogFlagsReset struct {
	PeerID int
	Mask   DialogFlag
}

DialogFlagsReset struct for event with code 10

Reset dialog flags

type DialogFlagsResetHandler

type DialogFlagsResetHandler func(m DialogFlagsReset)

DialogFlagsResetHandler handler func for DialogFlagsReset

type DialogsFlagsSet

type DialogsFlagsSet struct {
	PeerID int
	Mask   DialogFlag
}

DialogsFlagsSet struct for event with code 12

Install dialog flags

type DialogsFlagsSetHandler

type DialogsFlagsSetHandler func(m DialogsFlagsSet)

DialogsFlagsSetHandler handler func for DialogsFlagsSet

type EditMessage

type EditMessage struct {
	MessageID      int
	Flags          MessageFlag
	PeerID         int
	Timestamp      time.Time
	NewText        string
	AdditionalData AdditionalData
	Attachments    LongPollAttachments
}

EditMessage struct for event with code 5

Edit message.

type EditMessageHandler

type EditMessageHandler func(m EditMessage)

EditMessageHandler handler func for EditMessage

type ExtraFields

type ExtraFields struct {
	PeerID         int       // destination ID
	Timestamp      time.Time // message sent time
	Text           string    // message text
	AdditionalData AdditionalData
	Attachments    LongPollAttachments // attachments, if mode = 2 was chosen
}

ExtraFields for a message object

https://vk.com/dev/using_longpoll_3, point 3.1

type FriendBecameOffline

type FriendBecameOffline struct {
	UserID    int
	Flags     int
	Timestamp time.Time
}

FriendBecameOffline struct for event with code 9

A friend UserID is offline

type FriendBecameOfflineHandler

type FriendBecameOfflineHandler func(m FriendBecameOffline)

FriendBecameOfflineHandler handler func for FriendBecameOffline

type FriendBecameOnline

type FriendBecameOnline struct {
	UserID    int
	Extra     int
	Timestamp time.Time
}

FriendBecameOnline struct for event with code 8

A friend UserID is online

type FriendBecameOnlineHandler

type FriendBecameOnlineHandler func(m FriendBecameOnline)

FriendBecameOnlineHandler handler func for FriendBecameOnline

type LongPollAttachments

type LongPollAttachments map[string]interface{}

LongPollAttachments type

type MessageFlag

type MessageFlag int

MessageFlag type

const (
	Unread       MessageFlag = 1 << iota // Message is unread
	Outbox                               // Message is outgoing
	Replied                              // Message was answered
	Important                            // Message is marked as important
	Chat                                 // Message sent via chat
	Friends                              // Message sent by a friend
	Spam                                 // Message marked as "Spam"
	Deleted                              // Message was deleted
	Fixed                                //	Message was user-checked for spam
	Media                                // Message has media content
	Hidden       MessageFlag = 1 << 16   // Greeting message from a community
	DeleteForAll             = 1 << 17   // Message was deleted for all
	NotDelivered             = 1 << 18   // Incoming message not delivered
)

Each message has a flag, which is a value received by summing up any of the following parameters

func (MessageFlag) Has

func (b MessageFlag) Has(flag MessageFlag) bool

Has function

type MessageFlagsChange

type MessageFlagsChange struct {
	MessageID int
	Flags     MessageFlag
	ExtraFields
}

MessageFlagsChange struct for event with code 1

Replace message flags

type MessageFlagsChangeHandler

type MessageFlagsChangeHandler func(m MessageFlagsChange)

MessageFlagsChangeHandler handler func for MessageFlagsChange

type MessageFlagsReset

type MessageFlagsReset struct {
	MessageID int
	Mask      MessageFlag
	ExtraFields
}

MessageFlagsReset struct for event with code 3

Reset message flags

type MessageFlagsResetHandler

type MessageFlagsResetHandler func(m MessageFlagsReset)

MessageFlagsResetHandler handler func for MessageFlagsReset

type MessageFlagsSet

type MessageFlagsSet struct {
	MessageID int
	Mask      MessageFlag
	ExtraFields
}

MessageFlagsSet struct for event with code 2

Install message flags

type MessageFlagsSetHandler

type MessageFlagsSetHandler func(m MessageFlagsSet)

MessageFlagsSetHandler handler func for MessageFlagsSet

type NewMessage

type NewMessage struct {
	MessageID int
	Flags     MessageFlag
	ExtraFields
}

NewMessage struct for event with code 4

Add a new message

type NewMessageHandler

type NewMessageHandler func(m NewMessage)

NewMessageHandler handler func for NewMessage

type NotificationSettingsChange

type NotificationSettingsChange struct {
	PeerID        int
	Sound         bool
	DisabledUntil int
}

NotificationSettingsChange struct for event with code 114

type NotificationSettingsChangeHandler

type NotificationSettingsChangeHandler func(m NotificationSettingsChange)

NotificationSettingsChangeHandler handler func for NotificationSettingsChange

type ReadInMessages

type ReadInMessages struct {
	PeerID  int
	LocalID int
}

ReadInMessages struct for event with code 6

Read all incoming messages received before message with LocalID

type ReadInMessagesHandler

type ReadInMessagesHandler func(m ReadInMessages)

ReadInMessagesHandler handler func for ReadInMessages

type ReadOutMessages

type ReadOutMessages struct {
	PeerID  int
	LocalID int
}

ReadOutMessages struct for event with code 7

Read all outgoing messages sent before message with LocalID

type ReadOutMessagesHandler

type ReadOutMessagesHandler func(m ReadOutMessages)

ReadOutMessagesHandler handler func for ReadOutMessages

type RestoreDeletedMessages

type RestoreDeletedMessages struct {
	PeerID  int
	LocalID int
}

RestoreDeletedMessages struct for event with code 14

Restore message

type RestoreDeletedMessagesHandler

type RestoreDeletedMessagesHandler func(m RestoreDeletedMessages)

RestoreDeletedMessagesHandler handler func for RestoreDeletedMessages

type TypeID

type TypeID int

TypeID chat change type identifier

const (
	ChatNameChange     TypeID = iota + 1 // The name of the conversation has changed
	ChatCoverChange                      // The cover of the conversation has changed
	ChatAdminAssigned                    // New administrator has been appointed.
	ChatPinMessage                       // Message pin
	ChatUserCome                         // User has joined the conversation
	ChatUserLeave                        // User left the conversation.
	ChatUserKicked                       // User was excluded from the conversation.
	ChatAdminDismissed                   // Administrator rights have been removed from the user
)

TypeID const

type UserCall

type UserCall struct {
	UserID int
	CallID int
}

UserCall struct for event with code 70

type UserCallHandler

type UserCallHandler func(m UserCall)

UserCallHandler handler func for UserCall

type UserTyping

type UserTyping struct {
	UserID int
	Flags  int
}

UserTyping struct for event with code 61

User UserID began typing in the conversation ChatID

type UserTypingChat

type UserTypingChat struct {
	UserID int
	ChatID int
}

UserTypingChat struct for event with code 62

User UserID began typing in the conversation ChatID

type UserTypingChatHandler

type UserTypingChatHandler func(m UserTypingChat)

UserTypingChatHandler handler func for UserTypingChat

type UserTypingHandler

type UserTypingHandler func(m UserTyping)

UserTypingHandler handler func for UserTyping

type UsersRecordingAudioMessage

type UsersRecordingAudioMessage struct {
	PeerID     int
	UserIDs    []int
	TotalCount int
	Ts         time.Time
}

UsersRecordingAudioMessage struct for event with code 64

type UsersRecordingAudioMessageHandler

type UsersRecordingAudioMessageHandler func(m UsersRecordingAudioMessage)

UsersRecordingAudioMessageHandler handler func for UsersRecordingAudioMessage

type UsersTyping

type UsersTyping struct {
	UserIDs    []int
	PeerID     int
	TotalCount int
	Ts         time.Time
}

UsersTyping struct for event with code 63

type UsersTypingHandler

type UsersTypingHandler func(m UsersTyping)

UsersTypingHandler handler func for UsersTyping

type Wrapper

type Wrapper struct {
	// contains filtered or unexported fields
}

Wrapper struct

func NewWrapper

func NewWrapper(lp *longpoll.Longpoll) *Wrapper

NewWrapper return *Wrapper for longpoll v3

func (Wrapper) OnChatInfoChange

func (w Wrapper) OnChatInfoChange(f ChatInfoChangeHandler)

OnChatInfoChange handler for ChatInfoChange

event with code 52

Chat info change

func (Wrapper) OnChatParamsChange

func (w Wrapper) OnChatParamsChange(f ChatParamsChangeHandler)

OnChatParamsChange handler for ChatParamsChange

event with code 51

One of the parameters (content, topic) of the conversation ChatID was changed. Self — 1 or 0 (whether the change was caused by the user).

func (Wrapper) OnCounterChange

func (w Wrapper) OnCounterChange(f CounterChangeHandler)

OnCounterChange handler for CounterChange

event with code 80

func (Wrapper) OnDeleteMessages

func (w Wrapper) OnDeleteMessages(f DeleteMessagesHandler)

OnDeleteMessages handler for DeleteMessages

event with code 13

Deletings all messages in PeerID dialogs with IDs up to LocalID

func (Wrapper) OnDialogFlagsReplace

func (w Wrapper) OnDialogFlagsReplace(f DialogFlagsReplaceHandler)

OnDialogFlagsReplace handler for DialogFlagsReplace

event with code 11

Replace dialog flags

func (Wrapper) OnDialogFlagsReset

func (w Wrapper) OnDialogFlagsReset(f DialogFlagsResetHandler)

OnDialogFlagsReset handler for DialogFlagsReset

event with code 10

Reset dialog flags

func (Wrapper) OnDialogsFlagsSet

func (w Wrapper) OnDialogsFlagsSet(f DialogsFlagsSetHandler)

OnDialogsFlagsSet handler for DialogsFlagsSet

event with code 12

Install dialog flags

func (Wrapper) OnEditMessage

func (w Wrapper) OnEditMessage(f EditMessageHandler)

OnEditMessage handler for EditMessage

event with code 5

Edit message.

func (Wrapper) OnFriendBecameOffline

func (w Wrapper) OnFriendBecameOffline(f FriendBecameOfflineHandler)

OnFriendBecameOffline handler for FriendBecameOffline

event with code 9

A friend UserID is offline

func (Wrapper) OnFriendBecameOnline

func (w Wrapper) OnFriendBecameOnline(f FriendBecameOnlineHandler)

OnFriendBecameOnline handler for FriendBecameOnline

event with code 8

A friend UserID is online

func (Wrapper) OnMessageFlagsChange

func (w Wrapper) OnMessageFlagsChange(f MessageFlagsChangeHandler)

OnMessageFlagsChange handler for MessageFlagsChange

event with code 1

Replace message flags

func (Wrapper) OnMessageFlagsReset

func (w Wrapper) OnMessageFlagsReset(f MessageFlagsResetHandler)

OnMessageFlagsReset handler for MessageFlagsReset

event with code 3

Reset message flags

func (Wrapper) OnMessageFlagsSet

func (w Wrapper) OnMessageFlagsSet(f MessageFlagsSetHandler)

OnMessageFlagsSet handler for MessageFlagsSet

event with code 2

Install message flags

func (Wrapper) OnNewMessage

func (w Wrapper) OnNewMessage(f NewMessageHandler)

OnNewMessage handler for NewMessage

event with code 4

Add a new message

func (Wrapper) OnNotificationSettingsChange

func (w Wrapper) OnNotificationSettingsChange(f NotificationSettingsChangeHandler)

OnNotificationSettingsChange handler for NotificationSettingsChange

event with code 114

func (Wrapper) OnReadInMessages

func (w Wrapper) OnReadInMessages(f ReadInMessagesHandler)

OnReadInMessages handler for ReadInMessages

event with code 6

Read all incoming messages received before message with LocalID

func (Wrapper) OnReadOutMessages

func (w Wrapper) OnReadOutMessages(f ReadOutMessagesHandler)

OnReadOutMessages handler for ReadOutMessages

event with code 7

Read all outgoing messages sent before message with LocalID

func (Wrapper) OnRestoreDeletedMessages

func (w Wrapper) OnRestoreDeletedMessages(f RestoreDeletedMessagesHandler)

OnRestoreDeletedMessages handler for RestoreDeletedMessages

event with code 14

Restore message

func (Wrapper) OnUserCall

func (w Wrapper) OnUserCall(f UserCallHandler)

OnUserCall handler for UserCall

event with code 70

func (Wrapper) OnUserTyping

func (w Wrapper) OnUserTyping(f UserTypingHandler)

OnUserTyping handler for UserTyping

event with code 61

User UserID began typing in the dialog. The event should happen once in ~5 seconds during continuous typing

func (Wrapper) OnUserTypingChat

func (w Wrapper) OnUserTypingChat(f UserTypingChatHandler)

OnUserTypingChat handler for UserTypingChat

event with code 62

User UserID began typing in the conversation ChatID

func (Wrapper) OnUsersRecordingAudioMessage

func (w Wrapper) OnUsersRecordingAudioMessage(f UsersRecordingAudioMessageHandler)

OnUsersRecordingAudioMessage handler for UsersRecordingAudioMessage

event with code 64

func (Wrapper) OnUsersTyping

func (w Wrapper) OnUsersTyping(f UsersTypingHandler)

OnUsersTyping handler for UsersTyping

event with code 63

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL