package telebot import ( "encoding/json" ) // Album lets you group multiple media (so-called InputMedia) // into a single message. // // On older clients albums look like N regular messages. type Album []InputMedia // InputMedia is a generic type for all kinds of media you // can put into an album. type InputMedia interface { // As some files must be uploaded (instead of referencing) // outer layers of Telebot require it. MediaFile() *File // NOTE: To add in v3. // Type() string } // Photo object represents a single photo file. type Photo struct { File Width int `json:"width"` Height int `json:"height"` // (Optional) Caption string `json:"caption,omitempty"` ParseMode ParseMode `json:"parse_mode,omitempty"` } type photoSize struct { File Width int `json:"width"` Height int `json:"height"` Caption string `json:"caption,omitempty"` } // MediaFile returns &Photo.File func (p *Photo) MediaFile() *File { return &p.File } // UnmarshalJSON is custom unmarshaller required to abstract // away the hassle of treating different thumbnail sizes. // Instead, Telebot chooses the hi-res one and just sticks to // it. // // I really do find it a beautiful solution. func (p *Photo) UnmarshalJSON(jsonStr []byte) error { var hq photoSize if jsonStr[0] == '{' { if err := json.Unmarshal(jsonStr, &hq); err != nil { return err } } else { var sizes []photoSize if err := json.Unmarshal(jsonStr, &sizes); err != nil { return err } hq = sizes[len(sizes)-1] } p.File = hq.File p.Width = hq.Width p.Height = hq.Height return nil } // Audio object represents an audio file. type Audio struct { File // Duration of the recording in seconds as defined by sender. Duration int `json:"duration,omitempty"` // (Optional) Caption string `json:"caption,omitempty"` Thumbnail *Photo `json:"thumb,omitempty"` Title string `json:"title,omitempty"` Performer string `json:"performer,omitempty"` MIME string `json:"mime_type,omitempty"` FileName string `json:"file_name,omitempty"` ParseMode ParseMode `json:"parse_mode,omitempty"` } // MediaFile returns &Audio.File func (a *Audio) MediaFile() *File { a.fileName = a.FileName return &a.File } // Document object represents a general file (as opposed to Photo or Audio). // Telegram users can send files of any type of up to 1.5 GB in size. type Document struct { File // (Optional) Thumbnail *Photo `json:"thumb,omitempty"` Caption string `json:"caption,omitempty"` MIME string `json:"mime_type"` FileName string `json:"file_name,omitempty"` ParseMode ParseMode `json:"parse_mode,omitempty"` } // MediaFile returns &Document.File func (d *Document) MediaFile() *File { d.fileName = d.FileName return &d.File } // Video object represents a video file. type Video struct { File Width int `json:"width"` Height int `json:"height"` Duration int `json:"duration,omitempty"` // (Optional) Caption string `json:"caption,omitempty"` Thumbnail *Photo `json:"thumb,omitempty"` SupportsStreaming bool `json:"supports_streaming,omitempty"` MIME string `json:"mime_type,omitempty"` FileName string `json:"file_name,omitempty"` ParseMode ParseMode `json:"parse_mode,omitempty"` } // MediaFile returns &Video.File func (v *Video) MediaFile() *File { v.fileName = v.FileName return &v.File } // Animation object represents a animation file. type Animation struct { File Width int `json:"width"` Height int `json:"height"` Duration int `json:"duration,omitempty"` // (Optional) Caption string `json:"caption,omitempty"` Thumbnail *Photo `json:"thumb,omitempty"` MIME string `json:"mime_type,omitempty"` FileName string `json:"file_name,omitempty"` } // MediaFile returns &Animation.File func (a *Animation) MediaFile() *File { a.fileName = a.FileName return &a.File } // Voice object represents a voice note. type Voice struct { File // Duration of the recording in seconds as defined by sender. Duration int `json:"duration"` // (Optional) MIME string `json:"mime_type,omitempty"` } // VideoNote represents a video message (available in Telegram apps // as of v.4.0). type VideoNote struct { File // Duration of the recording in seconds as defined by sender. Duration int `json:"duration"` // (Optional) Thumbnail *Photo `json:"thumb,omitempty"` Length int `json:"length,omitempty"` } // Contact object represents a contact to Telegram user type Contact struct { PhoneNumber string `json:"phone_number"` FirstName string `json:"first_name"` // (Optional) LastName string `json:"last_name"` UserID int `json:"user_id,omitempty"` } // Location object represents geographic position. type Location struct { // Latitude Lat float32 `json:"latitude"` // Longitude Lng float32 `json:"longitude"` // Period in seconds for which the location will be updated // (see Live Locations, should be between 60 and 86400.) LivePeriod int `json:"live_period,omitempty"` } // Venue object represents a venue location with name, address and // optional foursquare ID. type Venue struct { Location Location `json:"location"` Title string `json:"title"` Address string `json:"address"` // (Optional) FoursquareID string `json:"foursquare_id,omitempty"` FoursquareType string `json:"foursquare_type,omitempty"` } // Dice object represents a dice with a random value // from 1 to 6 for currently supported base emoji. type Dice struct { Type DiceType `json:"emoji"` Value int `json:"value"` }