mirror of
https://github.com/taigrr/wtf
synced 2025-01-18 04:03:14 -08:00
123 lines
3.5 KiB
Go
123 lines
3.5 KiB
Go
package helix
|
|
|
|
// Marker ...
|
|
type Marker struct {
|
|
ID string `json:"id"`
|
|
CreatedAt Time `json:"created_at"`
|
|
Description string `json:"description"`
|
|
PositionSeconds int `json:"position_seconds"`
|
|
URL string `json:"URL"`
|
|
}
|
|
|
|
// VideoMarker ...
|
|
type VideoMarker struct {
|
|
VideoID string `json:"video_id"`
|
|
Markers []Marker `json:"markers"`
|
|
}
|
|
|
|
// StreamMarker ...
|
|
type StreamMarker struct {
|
|
UserID string `json:"user_id"`
|
|
UserName string `json:"user_name"`
|
|
Videos []VideoMarker `json:"videos"`
|
|
}
|
|
|
|
// ManyStreamMarkers ...
|
|
type ManyStreamMarkers struct {
|
|
StreamMarkers []StreamMarker `json:"data"`
|
|
Pagination Pagination `json:"pagination"`
|
|
}
|
|
|
|
// StreamMarkersResponse ...
|
|
type StreamMarkersResponse struct {
|
|
ResponseCommon
|
|
Data ManyStreamMarkers
|
|
}
|
|
|
|
// StreamMarkersParams requires _either_ UserID or VideoID set
|
|
//
|
|
// UserID: fetches stream markers of the current livestream of the given user
|
|
// (VOD recording must be enabled).
|
|
// VideoID: fetches streams markers of the VOD.
|
|
type StreamMarkersParams struct {
|
|
UserID string `query:"user_id"`
|
|
VideoID string `query:"video_id"`
|
|
|
|
// Optional
|
|
After string `query:"after"`
|
|
Before string `query:"before"`
|
|
First int `query:"first,20"` // Limit 100
|
|
}
|
|
|
|
// GetStreamMarkers gets stream markers of a VOD or of the current live stream
|
|
// of an user being recorded as VOD.
|
|
//
|
|
// Required Scope: user:read:broadcast
|
|
func (c *Client) GetStreamMarkers(params *StreamMarkersParams) (*StreamMarkersResponse, error) {
|
|
resp, err := c.get("/streams/markers", &ManyStreamMarkers{}, params)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
markers := &StreamMarkersResponse{}
|
|
markers.StatusCode = resp.StatusCode
|
|
markers.Header = resp.Header
|
|
markers.Error = resp.Error
|
|
markers.ErrorStatus = resp.ErrorStatus
|
|
markers.ErrorMessage = resp.ErrorMessage
|
|
markers.Data.StreamMarkers = resp.Data.(*ManyStreamMarkers).StreamMarkers
|
|
markers.Data.Pagination = resp.Data.(*ManyStreamMarkers).Pagination
|
|
|
|
return markers, nil
|
|
}
|
|
|
|
// CreateStreamMarker ...
|
|
type CreateStreamMarker struct {
|
|
ID string `json:"id"`
|
|
CreatedAt Time `json:"created_at"`
|
|
Description string `json:"description"`
|
|
PositionSeconds int `json:"position_seconds"`
|
|
}
|
|
|
|
// ManyCreateStreamMarkers ...
|
|
type ManyCreateStreamMarkers struct {
|
|
CreateStreamMarkers []CreateStreamMarker `json:"data"`
|
|
}
|
|
|
|
// CreateStreamMarkerResponse ...
|
|
type CreateStreamMarkerResponse struct {
|
|
ResponseCommon
|
|
Data ManyCreateStreamMarkers
|
|
}
|
|
|
|
// CreateStreamMarkerParams ...
|
|
type CreateStreamMarkerParams struct {
|
|
UserID string `query:"user_id"`
|
|
|
|
// Optional
|
|
Description string `query:"description"`
|
|
}
|
|
|
|
// CreateStreamMarker creates a stream marker for a live stream at the current time.
|
|
// The user has to be the stream owner or an editor. Stream markers cannot be created
|
|
// in some cases, see:
|
|
// https://dev.twitch.tv/docs/api/reference/#create-stream-marker
|
|
//
|
|
// Required Scope: user:edit:broadcast
|
|
func (c *Client) CreateStreamMarker(params *CreateStreamMarkerParams) (*CreateStreamMarkerResponse, error) {
|
|
resp, err := c.post("/streams/markers", &ManyCreateStreamMarkers{}, params)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
markers := &CreateStreamMarkerResponse{}
|
|
markers.StatusCode = resp.StatusCode
|
|
markers.Header = resp.Header
|
|
markers.Error = resp.Error
|
|
markers.ErrorStatus = resp.ErrorStatus
|
|
markers.ErrorMessage = resp.ErrorMessage
|
|
markers.Data.CreateStreamMarkers = resp.Data.(*ManyCreateStreamMarkers).CreateStreamMarkers
|
|
|
|
return markers, nil
|
|
}
|