track

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

type AudioTrackConfig struct {
	ID         string // ID is the stable media track identifier.
	StreamID   string // StreamID is the MediaStream identifier exposed to the remote peer.
	SampleRate int    // SampleRate is the source PCM sample rate in Hz.
	Channels   int    // Channels is the number of PCM channels in source frames.
	Bitrate    uint32 // Bitrate is the initial Opus target bitrate in bps.
	MTU        uint16 // MTU is the RTP packet size budget used during packetization and must be set explicitly.

	// Optional codec preferences used during TrackLocal binding.
	CodecPreferences []webrtc.RTPCodecParameters
}

type BandwidthEstimate struct {
	TimestampUs      int64   // TimestampUs is when the estimate was produced, in microseconds.
	TargetBitrateBps int64   // TargetBitrateBps is libwebrtc's current target send bitrate.
	AvailableSendBps int64   // AvailableSendBps is the estimated available uplink bitrate.
	PacingRateBps    int64   // PacingRateBps is the packet pacing rate suggested by the estimator.
	LossRate         float64 // LossRate is the recent packet loss fraction in the range [0,1].
}

type BandwidthEstimateSource func() *BandwidthEstimate

type Parameters struct {
	// Active enables or pauses output. Set it explicitly on each call because
	// SetParameters applies this struct as an absolute state, not a partial patch.
	Active                bool
	MaxBitrate            uint32  // MaxBitrate caps the active encoding bitrate in bps.
	MaxFramerate          float64 // MaxFramerate caps the active encoding frame rate.
	ScaleResolutionDownBy float64 // ScaleResolutionDownBy reduces output resolution by this factor.
	ScalabilityMode       string  // SVC mode (e.g., "L3T3_KEY", "L1T2")
	Priority              string  // "very-low", "low", "medium", "high"
}

type RTPPacketContext struct {
	TrackID          string
	StreamID         string
	RID              string
	SSRC             webrtc.SSRC
	PayloadType      webrtc.PayloadType
	CodecParameters  webrtc.RTPCodecParameters
	HeaderExtensions []webrtc.RTPHeaderExtensionParameter
	PacketIndex      int
	PacketCount      int
}

type RTPPacketMutator func(pkt *rtp.Packet, ctx RTPPacketContext) error

type RTPPacketObserver func(pkt *rtp.Packet, ctx RTPPacketContext)

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

type VideoTrackConfig struct {
	ID       string     // ID is the stable media track identifier.
	StreamID string     // StreamID is the MediaStream identifier exposed to the remote peer.
	RID      string     // RID is the RTP stream identifier used for simulcast encodings.
	Codec    codec.Type // Codec is the preferred libgowebrtc video codec.
	Width    int        // Width is the source frame width in pixels.
	Height   int        // Height is the source frame height in pixels.
	Bitrate  uint32     // Bitrate is the initial encoder target bitrate in bps.
	FPS      float64    // FPS is the initial encoder target frame rate.
	MTU      uint16     // MTU is the RTP packetization budget in bytes and must be set explicitly.

	// Auto adaptation is opt-in so helpers can choose browser-like defaults
	// explicitly instead of the base constructor guessing from zero values.
	AutoKeyframe   bool // PLI/FIR → RequestKeyFrame()
	AutoBitrate    bool // BWE → adjust bitrate
	AutoFramerate  bool // BWE → adjust framerate
	AutoResolution bool // BWE → scale resolution

	// Constraints (like browser MediaTrackConstraints)
	MinBitrate   uint32  // Floor for bitrate adaptation
	MaxBitrate   uint32  // Ceiling for bitrate adaptation
	MinFramerate float64 // Floor for framerate
	MaxFramerate float64 // Ceiling for framerate
	MinWidth     int     // Don't scale below this
	MinHeight    int     // Don't scale below this

	// Optional codec preferences used during TrackLocal binding.
	// When provided, Bind selects the best negotiated codec from this list.
	CodecPreferences []webrtc.RTPCodecParameters

	// SVC configures scalable or simulcast encoder output when supported.
	SVC *codec.SVCConfig
}