wrapper

package
v1.10.0 Latest Latest
Warning

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

Go to latest
Published: Jun 29, 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.

Deleting 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.

Deleting 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