mirror of
https://github.com/pion/mediadevices.git
synced 2025-09-26 20:41:46 +08:00
78 lines
2.7 KiB
Go
78 lines
2.7 KiB
Go
package codec
|
|
|
|
import (
|
|
"github.com/pion/mediadevices/pkg/io/audio"
|
|
"github.com/pion/mediadevices/pkg/io/video"
|
|
"github.com/pion/mediadevices/pkg/prop"
|
|
"github.com/pion/webrtc/v3"
|
|
)
|
|
|
|
// RTPCodec wraps webrtc.RTPCodec. RTPCodec might extend webrtc.RTPCodec in the future.
|
|
type RTPCodec struct {
|
|
*webrtc.RTPCodec
|
|
}
|
|
|
|
// NewRTPH264Codec is a helper to create an H264 codec
|
|
func NewRTPH264Codec(clockrate uint32) *RTPCodec {
|
|
return &RTPCodec{webrtc.NewRTPH264Codec(webrtc.DefaultPayloadTypeH264, clockrate)}
|
|
}
|
|
|
|
// NewRTPVP8Codec is a helper to create an VP8 codec
|
|
func NewRTPVP8Codec(clockrate uint32) *RTPCodec {
|
|
return &RTPCodec{webrtc.NewRTPVP8Codec(webrtc.DefaultPayloadTypeVP8, clockrate)}
|
|
}
|
|
|
|
// NewRTPVP9Codec is a helper to create an VP9 codec
|
|
func NewRTPVP9Codec(clockrate uint32) *RTPCodec {
|
|
return &RTPCodec{webrtc.NewRTPVP9Codec(webrtc.DefaultPayloadTypeVP9, clockrate)}
|
|
}
|
|
|
|
// NewRTPOpusCodec is a helper to create an Opus codec
|
|
func NewRTPOpusCodec(clockrate uint32) *RTPCodec {
|
|
return &RTPCodec{webrtc.NewRTPOpusCodec(webrtc.DefaultPayloadTypeOpus, clockrate)}
|
|
}
|
|
|
|
// AudioEncoderBuilder is the interface that wraps basic operations that are
|
|
// necessary to build the audio encoder.
|
|
//
|
|
// This interface is for codec implementors to provide codec specific params,
|
|
// but still giving generality for the users.
|
|
type AudioEncoderBuilder interface {
|
|
// RTPCodec represents the codec metadata
|
|
RTPCodec() *RTPCodec
|
|
// BuildAudioEncoder builds audio encoder by given media params and audio input
|
|
BuildAudioEncoder(r audio.Reader, p prop.Media) (ReadCloser, error)
|
|
}
|
|
|
|
// VideoEncoderBuilder is the interface that wraps basic operations that are
|
|
// necessary to build the video encoder.
|
|
//
|
|
// This interface is for codec implementors to provide codec specific params,
|
|
// but still giving generality for the users.
|
|
type VideoEncoderBuilder interface {
|
|
// RTPCodec represents the codec metadata
|
|
RTPCodec() *RTPCodec
|
|
// BuildVideoEncoder builds video encoder by given media params and video input
|
|
BuildVideoEncoder(r video.Reader, p prop.Media) (ReadCloser, error)
|
|
}
|
|
|
|
// ReadCloser is an io.ReadCloser with methods for rate limiting: SetBitRate and ForceKeyFrame
|
|
type ReadCloser interface {
|
|
Read() (b []byte, release func(), err error)
|
|
Close() error
|
|
// SetBitRate sets current target bitrate, lower bitrate means smaller data will be transmitted
|
|
// but this also means that the quality will also be lower.
|
|
SetBitRate(int) error
|
|
// ForceKeyFrame forces the next frame to be a keyframe, aka intra-frame.
|
|
ForceKeyFrame() error
|
|
}
|
|
|
|
// BaseParams represents an codec's encoding properties
|
|
type BaseParams struct {
|
|
// Target bitrate in bps.
|
|
BitRate int
|
|
|
|
// Expected interval of the keyframes in frames.
|
|
KeyFrameInterval int
|
|
}
|