package chat import ( "context" "encoding/json" "net/http" "net/url" "github.com/google/go-querystring/query" ) type GetEmoteSetsParams struct { // An ID that identifies the emote set to get. Include this parameter for each emote set you want to get. // For example, emote_set_id=1234&emote_set_id=5678. You may specify a maximum of 25 IDs. // The response contains only the IDs that were found and ignores duplicate IDs. // // To get emote set IDs, use the Get Channel Emotes API. EmoteSetIDs []string `url:"emote_set_id,omitempty"` } type GetEmoteSetsResponse struct { // The list of emotes found in the specified emote sets. The list is empty if none of the IDs were found. // The list is in the same order as the set IDs specified in the request. Each set contains one or more emoticons. Data []EmoteSetEmote `json:"data"` // A templated URL. Use the values from the id, format, scale, and theme_mode fields to replace the like-named placeholder strings // in the templated URL to create a CDN (content delivery network) URL that you use to fetch the emote. // For information about what the template looks like and how to use it to fetch emotes. // See Emote CDN URL format: https://dev.twitch.tv/docs/irc/emotes#cdn-template // You should use this template instead of using the URLs in the images object. Template string `json:"template"` } type EmoteSetEmote struct { // An ID that identifies this emote. ID string `json:"id"` // The name of the emote. This is the name that viewers type in the chat window to get the emote to appear. Name string `json:"name"` // The image URLs for the emote. These image URLs always provide a static, non-animated emote image with a light background. // // NOTE: You should use the templated URL in the template field to fetch the image instead of using these URLs. Images EmoteImages `json:"images"` // The type of emote. The possible values are: // // bitstier — A custom Bits tier emote. // // follower — A custom follower emote. // // subscriptions — A custom subscriber emote. EmoteType string `json:"emote_type"` // An ID that identifies the emote set that the emote belongs to. EmoteSetID string `json:"emote_set_id"` // The ID of the broadcaster who owns the emote. OwnerID string `json:"owner_id"` // The formats that the emote is available in. // For example, if the emote is available only as a static PNG, the array contains only static. // But if the emote is available as a static PNG and an animated GIF, the array contains static and animated. // The possible formats are: // // animated — An animated GIF is available for this emote. // // static — A static PNG file is available for this emote. Formats []EmoteFormat `json:"format"` // The sizes that the emote is available in. // For example, if the emote is available in small and medium sizes, the array contains 1.0 and 2.0. // Possible sizes are: // // 1.0 — A small version (28px x 28px) is available. // // 2.0 — A medium version (56px x 56px) is available. // // 3.0 — A large version (112px x 112px) is available. Scales []EmoteScale `json:"scale"` // The background themes that the emote is available in. Possible themes are: // // dark, light ThemeMode []EmoteThemeMode `json:"theme_mode"` } // Gets emotes for one or more specified emote sets. // // An emote set groups emotes that have a similar context. For example, Twitch places all the subscriber emotes that a broadcaster uploads for their channel in the same emote set. // // Learn More: https://dev.twitch.tv/docs/irc/emotes // // Requires an app access token or user access token. func (c *Chat) GetEmoteSets(ctx context.Context, params *GetEmoteSetsParams) (*GetEmoteSetsResponse, error) { v, _ := query.Values(params) endpoint := c.baseUrl.ResolveReference(&url.URL{Path: "chat/emotes/set", RawQuery: v.Encode()}) req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint.String(), nil) if err != nil { return nil, err } res, err := c.client.Do(req) if err != nil { return nil, err } defer res.Body.Close() var data GetEmoteSetsResponse if err := json.NewDecoder(res.Body).Decode(&data); err != nil { return nil, err } return &data, nil }